PDF ビューアー

PDF ビューアーウィジェットは、テキストの強調表示や一致箇所への自動スクロールを伴うキーワード検索などの基本機能に加え、テキストや領域の注釈の表示、作成、インタラクションなどの高度な機能をサポートし、ユーザーによるタグ付けワークフローを実現します。

この機能には、以下をはじめとする多くの拡張機能があります。

• ドキュメント全体でキーワードに一致する箇所を検索するための文字列変数の受け入れ。
• ユーザーが入力したキーワードに一致する箇所を検索する組み込みの検索機能。
• 一致箇所の強調表示（現在の一致箇所は緑、その他は紫）とヒット件数の表示。
• 最初の検索結果への移動、およびその他のヒット箇所間の移動。
• MediaReferences（メディアセット）のサポート。
• 既存の注釈オブジェクトの表示。
• 設定されたアクションによる注釈の作成。
• 選択時のイベント、プロパティ表示用のツールチップ、カスタム色によるハイライトなど、カスタマイズ可能な注釈のインタラクション。

設定オプション

ウィジェットの設定では、複数のメディア入力ソースに加え、ページ番号とテキストの変数入力をサポートしています。ページ番号の変数入力により、PDF 内の指定されたページに移動します。設定されたテキスト入力は検索バーに入力され、その検索語でキーワード検索が実行されます。ウィジェットを設定しなくても、PDF 表示で任意の検索語を手動で入力できます。PDF ドキュメントの注釈の設定を開始するには、注釈を有効にするオプションを選択し、注釈を設定するセクションを参照します。

• PDF ソースのオプションを設定する：

  • ウィジェットに PDF を表示するためのメディアソースを選択します。ドロップダウンには、利用可能な対応メディアソースの一覧が表示されます。現在対応しているメディアソースは、Compass、データセット、Media Reference、および添付ファイルです。メディアソースを選択すると、そのメディアソースの設定が利用可能になります。メディアソースの例には、次のものがあります。
    • Compass: PDF のメディアソースとして Palantir ファイルシステムを使用します。この選択肢を選択する場合は、次の項目を指定します。
      • Blobster RID: 対象の PDF の Blobster RID を指定する文字列変数です。
    • データセット： PDF のメディアソースとしてデータセットを使用します。この選択肢を選択する場合は、次の項目を指定します。
      • データセット RID: 対象の PDF を含むデータセットの RID を指定する文字列変数です。
      • ファイルパス： 対象の PDF のデータセット内のファイルパスを指定する文字列変数です。
      • ブランチ： データセットの branchID を指定する文字列変数です。ブランチを指定しない場合は、master ブランチになります。
    • Media Reference: 単一のオブジェクトを含むオブジェクトセットを定義し、PDF の Media Reference 型のプロパティを選択します。
      • 単一のオブジェクトを含むオブジェクトセット： 対象の PDF のオブジェクトセット変数です。選択するオブジェクトセットには、単一のオブジェクトが含まれている必要があります。
      • プロパティ： 選択したオブジェクトセットに含まれる、対象の PDF の Media Reference 型のプロパティです。
    • 添付ファイル： 単一のオブジェクトを含むオブジェクトセットを定義し、PDF のメディアソースとして添付ファイルプロパティを選択します。この選択肢を選択する場合は、次の項目を指定します。
      • 単一のオブジェクトを含むオブジェクトセット： 対象の PDF のオブジェクトセット変数です。選択するオブジェクトセットには、単一のオブジェクトが含まれている必要があります。
      • プロパティ： 選択したオブジェクトセットに含まれる、対象の PDF の添付ファイルプロパティです。

• 入力変数を設定する：

  • ページ番号をカスタマイズする： 数値変数を使用して、ユーザーが現在表示しているページ番号を取得する機能、および/またはウィジェットに現在表示されているページを変更する機能の有効/無効を切り替えます。
  • 初期検索をカスタマイズ： 文字列変数を使用して、ウィジェット内の検索に使用するキーワードを事前入力する機能の有効/無効を切り替えます。

• 注釈を設定する：

  • 既存の注釈を表示： レイヤーごとに1個の注釈オブジェクトセットを設定できます。注釈を有効にするには、レイヤーを1つ以上追加して設定する必要があります。各レイヤーには、次の設定可能な項目があります。

    • 注釈レイヤー名： 注釈レイヤーの名前を設定します。この名前の項目は、ウィジェットの設定パネル内にのみ表示されます。

    • オブジェクトセット： レイヤー内に表示する注釈オブジェクトセットを入力します。

    • ページのプロパティ： 注釈オブジェクトが PDF のどのページにあるかを指定する Integer 型のオブジェクトプロパティを選択します。

    • 境界ボックスのプロパティ： 注釈オブジェクトの境界ボックスの座標を指定する文字列配列型のオブジェクトプロパティを選択します。配列内の各文字列要素は、境界ボックスの左上 (x1, y1) と右下 (x2, y2) の角を表す JSON オブジェクトを文字列化したものにしてください。

      • 注釈には複数の境界ボックスを設定できるため、配列が必要です。たとえば、3行のテキストには、各行に1個ずつ、計3個の境界ボックスが必要です。有効な境界ボックスのプロパティの例は、[ "{"x1":0.0, "y1":2.5, "x2":50.0, "y2":10.1}", "{"x1":2.0, "y1":12, "x2":35.0, "y2":14.2}" ] です。

    • 選択された注釈： 初期状態で選択する注釈オブジェクトを指定する入力と、ドキュメント上で現在選択されている注釈を含む出力の両方として使用するオブジェクトセットを選択します。

    • 選択時のイベント： 注釈の選択時にトリガーする Workshop イベントを設定します。

    • ツールチップに表示するプロパティ： このレイヤーの注釈を選択したときにツールチップのポップオーバーに表示するプロパティを追加します。

    • 既存の注釈を編集または削除する（アクション経由）： 注釈オブジェクトのツールチップのポップオーバーに表示される注釈レイヤーのアクションを設定します。

      • アクションアイコン： ポップオーバー内でこのアクションを表すアイコンを選択します。アイコンが設定されていない場合は、デフォルトで鉛筆アイコンが使用されます。
      • アクションラベル： ポップオーバー内のアクションアイコンのホバー時と、アクションフォームのヘッダーに表示されるアクションの表示名を設定します。
      • 注釈に対するアクション： ポップオーバーからトリガーできるアクションを設定します。カーソルが置かれたオブジェクトは、カーソルが置かれたオブジェクト変数を使用して参照できます。アクションの詳細については、アクションタイプのドキュメントを参照してください。

    • ハイライト色：

      • 固定： レイヤー内のすべての注釈の表示に使用する固定の色を設定します。
      • 色のプロパティ： レイヤー内の注釈のハイライトの色分けを指定する文字列型のオブジェクトプロパティを設定します。この文字列プロパティは、色の16進コード形式（たとえば「#FBD065」）である必要があります。文字列プロパティに有効な16進コードが含まれていない場合、ハイライトの色分けは GOLD5 (#FBD065) になります。
      • カスタムルール： レイヤー内の注釈のハイライトの色分けを決める条件付き書式設定ルールを指定します。設定された条件付き書式設定ルールのいずれにも一致しない場合、注釈のハイライト色は GOLD5 (#FBD065) になります。

    • ハイライト内にテキストを表示： 注釈オブジェクトのプロパティを選択し、その値をドキュメント上のハイライトされた領域内にテキストとして直接表示します。設定すると、注釈は色付きの長方形だけを表示するのではなく、ハイライトされた領域内にプロパティ値を表示します。

  • 注釈を作成する（アクションまたはイベント経由）： テキストおよび/または領域を新たに選択したときに実行するアクションまたはイベントを設定します。
    • アクションまたはイベントのアイコン： 新たに選択したときにアクションのポップオーバー内でこのアクションを表すアイコンを選択します。
    • アクションまたはイベントのラベル： このラベルは、アクションのポップオーバー内でアクションにカーソルを置いたときにツールチップとして表示されます。このアクションにアイコンが設定されていない場合、このラベルがアクションのポップオーバーに表示されます。
    • 選択タイプに使用： テキストの選択時、領域の選択時、またはその両方で、このアクションをアクションのポップオーバーに表示するかどうかを指定します。
    • アクションまたはイベント： アクションのポップオーバーからトリガーできるアクションまたはイベントを設定します。
      • アクションパラメーターを設定する際には、特別なパラメーター値を使用して、現在選択されているテキストまたは領域のデータを参照できます。
        • ページ番号： 現在選択されているテキストまたは領域があるドキュメントのページ番号です。この選択肢は、Integer 型のパラメーターで選択できます。
        • 選択座標： 現在選択されているテキストまたは領域の境界ボックスを表す文字列の配列です。この選択肢は、文字列配列型のパラメーターで選択できます。
        • ハイライトされたテキスト： テキストの選択時は、選択部分の文字列内容です。領域の選択時は、値が空の文字列になります。この選択肢は、文字列型のパラメーターで選択できます。
  • 注釈までスクロール： 注釈オブジェクトセット内のオブジェクトまで自動的にスクロールする機能の有効/無効を切り替えます。これにより、指定した注釈まで自動的にスクロールできます。

• その他のオプションを設定する：

  • ユーザーが選択したテキストを出力： ユーザーが選択したテキストを文字列変数に取得し、ウィジェットから出力する機能の有効/無効を切り替えます。
  • ユーザーが選択した座標を出力する： ユーザーが選択した座標を文字列配列変数に取得し、ウィジェットから出力する機能の有効/無効を切り替えます。
  • ユーザーが選択したページ番号を出力する： ユーザーが選択を行ったページの番号を数値変数に取得し、ウィジェットから出力する機能の有効/無効を切り替えます。
  • PDF のダウンロードを有効にする： ウィジェットに表示されている PDF をユーザーがダウンロードできる機能の有効/無効を切り替えます。