Zum Inhalt springen

Chroma (Beta) Suchdatensätze-Aktivität

Einführung

Eine Chroma (Beta) Suchdatensätze-Aktivität, die ihre Chroma (Beta)-Verbindung verwendet, ruft Datensätze aus einer Chroma-Sammlung ab und ist als Quelle in einem Vorgang gedacht.

Hinweis

Für den Beta-Zugang und um Feedback zu geben, kontaktieren Sie das Jitterbit-Produktteam.

Erstellen einer Chroma (Beta) Suchdatensätze-Aktivität

Eine Instanz einer Chroma (Beta) Suchdatensätze-Aktivität wird aus einer Chroma (Beta)-Verbindung unter Verwendung des Aktivitätstyps Suchdatensätze erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für Details siehe Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Chroma (Beta) Suchdatensätze-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Chroma (Beta) Suchdatensätze-Aktivität

Befolgen Sie diese Schritte, um eine Chroma (Beta) Suchdatensätze-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und wählen Sie eine Sammlung aus

In diesem Schritt geben Sie einen Namen für die Aktivität ein und wählen eine Sammlung aus. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte desselben Verbindungstyps konfiguriert haben, wird oben auf dem Bildschirm der aktuelle Endpunktname angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Chroma (Beta) Datensätze suchen-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Eine Sammlung auswählen: Dieser Abschnitt zeigt die in dem Chroma (Beta) Endpunkt verfügbaren Sammlungen an.

    • Ausgewählte Sammlung: Nachdem eine Sammlung ausgewählt wurde, wird sie hier aufgelistet.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Sammlungen zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Sammlungen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Sammlungen vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Sammlungen vom Chroma (Beta) Endpunkt neu zu laden. Dies kann nützlich sein, wenn Sammlungen zu Chroma hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Tabelle der Sammlungen verwendet werden.

    • Eine Sammlung auswählen: Klicken Sie innerhalb der Tabelle auf eine beliebige Stelle in einer Zeile, um eine Sammlung auszuwählen. Es kann nur eine Sammlung ausgewählt werden. Die Informationen, die für jede Sammlung verfügbar sind, werden vom Chroma (Beta) Endpunkt abgerufen:

      • Name: Der Name der Sammlung.

      • Description: Die Beschreibung der Sammlung.

    Hinweis

    Wenn die Tabelle nicht mit verfügbaren Sammlungen gefüllt wird, könnte die Chroma (Beta) Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

  • Save & Exit: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Next: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Discard Changes: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

Step 2: Specify settings

In diesem Schritt geben Sie die Suchkriterien für die Datensätze an. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

Hinweis

Felder mit einem Variablen-Symbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Symbol klicken, um eine Liste der vorhandenen Variablen anzuzeigen.

  • Endpoint menu: Wenn Sie mehrere Endpunkte desselben Verbindungstyps konfiguriert haben, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Edit endpoint: Erscheint, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungsconfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Suche nach: Wählen Sie die Methode aus, um nach Datensätzen zu suchen, eine der Optionen Hybrid, ID (Standard), Meta, Semantisch oder Text.

    • Hybrid: Wählen Sie diese Option, um eine Kombination aus ID, Meta, Semantisch und Text-Suchoptionen zu verwenden. Die durch ID, Metadaten, Suche nach Textfilter und Semantisch offenbarten Optionen werden in den jeweiligen Bereichen weiter unten beschrieben.

    • ID: Wählen Sie diese Option, um nach spezifischen Datensatz-IDs zu suchen.

      • IDs: Definieren Sie die IDs, nach denen in der Tabelle gesucht werden soll.

        Klicken Sie auf das Hinzufügen-Symbol , um eine Zeile zur Tabelle hinzuzufügen und einen ID-Wert einzugeben.

        Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol in der rechten Spalte.

        Um eine einzelne Zeile zu bearbeiten oder zu löschen, fahren Sie mit der Maus über die rechte Spalte und verwenden Sie das Bearbeiten-Symbol oder das Löschen-Symbol .

        Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.

    • Meta: Wählen Sie diese Option, um mit einem Metadatenfilter zu suchen.

      • Metadaten-Schlüsselname: Geben Sie den Metadaten-Schlüsselname für den Filter ein.

      • Metadaten-Operator: Wählen Sie einen der Optionen Enthält (Standard), Gleich, Enthält_nicht, Nicht_Gleich oder Regex, um den Operator anzugeben, der zwischen dem Metadaten-Schlüssel und dem Wert für die Filterung verwendet werden soll. Zum Beispiel, filtern Sie nach einem Schlüssel (Metadaten-Schlüsselname), der Enthält einen bestimmten Wert (Metadatenwert).

      • Metadatenwert: Geben Sie den Metadatenwert für den Filter ein.

      • Meta-Werttyp: Wählen Sie einen der Optionen Boolean, Int oder String (Standard), um den Typ des Wertes für Metadatenwert anzugeben.

    • Text: Wählen Sie diese Option, um mit einem Textfilter zu suchen.

      • Text-Operator: Wählen Sie einen der Optionen Enthält (Standard), Enthält_nicht oder Regex, um den Operator anzugeben, der für die Textfilterung verwendet werden soll.

      • Textwert: Geben Sie den Textwert für den Filter ein.

    • Semantisch: Wählen Sie diese Option, um mit Vektor-Einbettungen zu suchen. Vektor-Einbettungen werden von Chroma generiert, um anzuzeigen, wie nah verwandte Werte beieinander liegen, und werden typischerweise verwendet, um falsch geschriebene Wörter oder ähnliche Konzepte zu Wörtern in der Suche zu berücksichtigen.

      • Einbettungen: Geben Sie die Einbettungswerte als Array ein, gegen die gesucht werden soll. Zum Beispiel [0.1, 0.2, 0.3].

      • Top Nächste: Geben Sie die Anzahl der besten Ergebnisse ein, die in die Suche einbezogen werden sollen. Standardmäßig sind die besten 10 semantisch ähnlichen Ergebnisse enthalten.

      Hinweis

      Für weitere Informationen zur Konfiguration des Vektorindex für Vektoreinbettungen siehe die VectorIndexConfig Dokumentation von Chroma.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Limit: Geben Sie die Anzahl der Ergebnisse ein, auf die die Suchantwort begrenzt werden soll. Das Limit beträgt standardmäßig 10.
    • Offset: Geben Sie die Anzahl der Ergebnisse ein, um die die Suchantwort verschoben werden soll. Der Offset beträgt standardmäßig 0.
    • Einbettungen einbeziehen: Wählen Sie aus, um Einbettungen in die Suchantwort einzubeziehen. Standardmäßig ausgewählt.
    • Entfernungen einbeziehen: Wählen Sie aus, um Entfernungswerte in die Suchantwort einzubeziehen. Standardmäßig ausgewählt.
    • URIs einbeziehen: Wählen Sie aus, um URIs in die Suchantwort einzubeziehen. Standardmäßig ausgewählt.
    • Dokumente einbeziehen: Wählen Sie aus, um Dokumente in die Suchantwort einzubeziehen. Standardmäßig ausgewählt.
    • Metadaten einbeziehen: Wählen Sie aus, um Metadaten in die Suchantwort einzubeziehen. Standardmäßig ausgewählt.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 3: Überprüfen Sie die Datenschemas

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Datenschema: Diese Datenschemas werden von angrenzenden Transformationen geerbt und während der Transformationszuordnung erneut angezeigt.

    Der Chroma (Beta) Connector verwendet die Chroma REST API. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom Chroma (Beta) Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, wie zum Beispiel in einer benachbarten Transformation.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Chroma (Beta) Datensätze suchen Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration des Vorgangs, indem Sie andere Aktivitäten, Transformationen oder Skripte als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Weitere Einzelheiten finden Sie im Aktivitätsaktionsmenü in Connector-Grundlagen.

Chroma (Beta) Datensätze suchen Aktivitäten können als Quelle mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, führen Sie die Bereitstellung und Ausführung der Operation durch und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.