Aufbereitungs-IDs

Wenn Sie eine angepasste Aufbereitung, die Sie für eine Objektgruppe erstellt haben, auf eine andere Objektgruppe anwenden möchten, müssen Sie die eindeutige ID kennen, die für die Aufbereitung bei ihrer Erstellung generiert wurde. Verwenden Sie die API zum Auflisten von Aufbereitungen aus dem Projekt, in dem die benutzerdefinierte Aufbereitung verwendet wird. Die zurückgegebene Liste enthält Informationen zur Aufbereitungs-ID.

Bei vordefinierten Aufbereitungen ändern sich die eindeutigen IDs nicht. In der folgenden Tabelle sind die IDs aufgelistet, die jedem vordefinierten Aufbereitungstyp zugeordnet sind. Außerdem sind die Objektgruppensprachen angegeben, für die die Aufbereitung unterstützt wird. Eine Aufbereitung kann nur auf eine Objektgruppe angewendet werden, wenn die Objektgruppensprache von der Aufbereitung unterstützt wird.

Weitere Informationen zu allen unterstützten Sprachen finden Sie unter Sprachunterstützung.

Aufbereitungen mithilfe der API anwenden

Führen Sie die folgenden Schritte aus, um eine Aufbereitung mithilfe der API anzuwenden:

1. Bestimmen Sie die Basis URL für den Endpunkt und das Token oder den API-Schlüssel für Ihre Bereitstellung.

   Weitere Informationen finden Sie unter Angepasste Anwendungen mit der API erstellen.

2. Rufen Sie die Projekt-ID für Ihr Projekt ab.

   Rufen Sie über die Produktbenutzerschnittstelle die Seite Integrieren und implementieren > API-Informationen anzeigen auf und kopieren Sie dann die Projekt-ID.

3. Wenn Sie die ID der Sammlung nicht kennen, auf die Sie die Aufbereitung anwenden möchten, rufen Sie eine Liste Ihrer Sammlungen ab, um sie zu finden.

   Beispiel:

   GET $authentication $url/v2/projects/$project_id/collections?version=2019-11-22
   

   Die collection_id wird zurückgegeben.

4. Senden Sie eine GET-Anforderung, um die Konfiguration der Sammlung zurückzugeben, die die angewendeten Aufbereitungen auflistet.

   Beispiel:

   GET $authentication $url/v2/projects/$project_id/collections/$collection_id?version=2019-11-22
   

   Die Aufbereitungs-IDs für die vordefinierten Aufbereitungen finden Sie unter Aufbereitungs-IDs.

5. Fügen Sie die Aufbereitung hinzu, die Sie anwenden möchten.

   Um beispielsweise die Aufbereitung Schlüsselwörter hinzuzufügen, können Sie die Aufbereitung in die Aufbereitungsliste einschließen. Rufen Sie zuerst die ID aus der Tabelle ab.

   Die Aufbereitungs-ID für Schlüsselwörter lautet 701db916-fc83-57ab-0000-000000000018. Um anzugeben, dass die Aufbereitung für Schlüsselwörter auf den Inhalt im Feld text der Dokumente in der Objektgruppe angewendet werden soll, kann sie wie folgt im JSON-Format dargestellt werden:

   {
       "enrichment_id" : "701db916-fc83-57ab-0000-000000000018",
       "fields" : [ "text" ]
   }
   

   Alle Aufbereitungen, die Sie angeben, ersetzen die Standardaufbereitungen. Wenn Sie also eine Standardaufbereitung beibehalten wollen, vergessen Sie nicht, sie in die Liste der Aufbereitungen aufzunehmen, die Sie auf die Sammlung anwenden. Eine Liste der Standardaufbereitungen pro Projekttyp finden Sie unter Standardaufbereitungen pro Projekttyp.

   Um beispielsweise die Aufbereitung Entitäten beizubehalten und die Aufbereitung Schlüsselwörter hinzuzufügen, könnten Sie Folgendes im Anforderungshauptteil angeben.

   "enrichments": [
     {
       "enrichment_id": "701db916-fc83-57ab-0000-00000000001e",
       "fields": [
         "text"
       ]
     },
     {
       "enrichment_id": "701db916-fc83-57ab-0000-000000000018",
       "fields": [
         "text"
       ]
     }
   ]
   

6. Übergeben Sie den aktualisierten JSON-Anforderungshauptteil mit der Methode update collection, um die Aufbereitung auf Ihre Sammlung anzuwenden.

   Beispiel:

   POST $authentication -d '$requestBody' $url/v2/projects/$project_id/collections/$collection_id?version=2019-11-22