- インデックス文書を作成する
既存のドキュメントエクストラクタを使ってインデックス文書を作成する方法
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
既存のドキュメントエクストラクターを使って 、Ingestion APIを使ってプルソースにインデックス文書を追加できます。これを行うと、新しい抽出ロジックを定義する必要はありません。
!注 また、新しいドキュメントエクストラクタを使う か、属性値を渡すことでインデックスドキュメントを作成することもできます。
!注Ingestion APIを使って高度なウェブクローラーのようなプルソースにインデックス文書を追加すれば、新しいドキュメントエクストラクタを作成したり既存のものを使うことができます。
Ingestion APIを使ってAPIのプッシュソースにインデックスドキュメントを追加する場合、POST requestの一部として抽出ロジックをインラインで提供する必要があります。
ユースケースによっては、既存のドキュメントエクストラクタを使ってファイルからインデックスドキュメントを作成したり、URLから作成したりできます。
-
ファイルからインデックスドキュメントを作成するには、{base-URL}/ingestion/v1/domains/{domainID}/sources/{sourceID}/entities/{entityID}/file/{documentID}?locale={locale}にPOST呼び出しを行います。このエンドポイントは、呼び出しを行うマシン上のファイルからインデックスドキュメントを作成したい場合は使ってください。リクエストでは、インデックスしたいファイルへのパスを渡します。例えば /Users/Jane/Documents/Summer/summer_activites.pdfです。
!重要Searchはローカルのファイルシステムから直接ファイルにアクセスすることはできません。リクエストの一環としてファイルをアップロードするには、マルチパートフォームデータを使用する必要があります。
-
URLからインデックス文書を作成するには、{base-URL}/ingestion/v1/domains/{domainID}/sources/{sourceID}/entities/{entityID}/url/{documentID}?locale={locale}にPOST呼び出しを行います。リクエストでは、インデックスしたいURLを*https://archive.doc.sitecore.com/xp/en/legacy-docs/web-forms-for-marketers-8.0.pdf*に渡します。Sitecore Search URLにアクセスし、属性値を抽出し、URLを表すインデックスドキュメントを作成します。
!重要URLはサポートされているコンテンツタイプのファイル(例えば.pdfや.docx)を指ささなければなりません。この方法はHTMLコンテンツを返すURLのインデックスには使えません。
この例では、URL https://archive.doc.sitecore.com/xp/en/legacy-docs/web-forms-for-marketers-8.0.pdfからインデックスドキュメントを作成します。 型 と 名前 属性は固定値ですが、それ以外の属性についてはドキュメントエクストラクタで定義されたロジックを使いたいDocs JavaScript 。そのためには、{base-URL}/ingestion/v1/domains/{domainId}/sources/{sourceId}/entities/{entityId}/url/{documentId}にPOST電話をかけてください。
以下はサンプルのPOST cURLコールです:
curl --location '{{base-url}}/ingestion/v1/domains/{{domain}}/sources/{{source}}/entities/{{entity}}/url/{{documentId}}?locale={{locale}}' \
--header 'Authorization: {{api_key}}' \
--form 'url="https://archive.doc.sitecore.com/xp/en/legacy-docs/web-forms-for-marketers-8.0.pdfurl"' \
--form 'fields="{\"items\": {\"type\":\"docs\",\"name\":\"Web Forms for Marketers\"}}"' \
--form 'extractorName="Docs JavaScript"'
申請が成功した場合、以下の文200回答が届きます:
{ "enqueued": true }
返信では、enqueuedはSearchがこの文書をインデックスキューに追加したことを意味します。数分後、SearchのContent Collectionセクションで新しい文書が表示されます。