Zum Inhalt springen

Coupa Query-Aktivität in Jitterbit Studio

Einführung

Eine Coupa Query-Aktivität verwendet ihre Coupa-Verbindung, um Objektdaten in Coupa abzufragen. Sie ist als Quelle vorgesehen, um Daten in einem Vorgang bereitzustellen.

Erstellen einer Coupa Query-Aktivität

Eine Instanz einer Coupa Query-Aktivität wird aus einer Coupa-Verbindung mithilfe des Aktivitätstyps Query erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Leinwand oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Leinwand ein. Weitere Informationen finden Sie unter Aktivitäts- oder Tool-Instanz erstellen in Komponenten wiederverwenden.

Eine vorhandene Coupa Query-Aktivität kann an diesen Positionen bearbeitet werden:

Konfigurieren einer Coupa Query-Aktivität

Führen Sie diese Schritte aus, um eine Coupa Query-Aktivität zu konfigurieren:

Schritt 1: Name eingeben und Objekt auswählen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und wählen Sie ein Objekt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, wird oben auf dem Bildschirm ein Menü mit dem Namen des aktuellen Endpunkts angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den Namen des aktuellen Endpunkts bewegen. Klicken Sie hier, um die Verbindungskonfiguration 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 Coupa Query-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Objekt auswählen: In diesem Abschnitt werden im Coupa-Endpunkt verfügbare Objekte angezeigt.

    • Ausgewähltes Objekt: Nach Auswahl eines Objekts wird es hier aufgelistet.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche berücksichtigt keine Groß-/Kleinschreibung. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenresultate bei jedem Tastendruck in Echtzeit gefiltert. Um Objekte vom Endpunkt beim Suchen zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objekte vom Coupa-Endpunkt erneut zu laden. Dies kann hilfreich sein, wenn Coupa neue Objekte hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Objekttabelle verwendet werden.

    • Objekt auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Objekt auszuwählen. Es kann nur ein Objekt ausgewählt werden. Die für jedes Objekt verfügbaren Informationen werden vom Coupa-Endpunkt abgerufen:

      • Name: Der Name des Objekts von Coupa.

      • Beschreibung: Die Beschreibung des Objekts von Coupa.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Objekten gefüllt wird, war die Coupa-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass die Verbindung besteht, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  • Speichern & Beenden: Klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

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

  • Änderungen verwerfen: Klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Subobjekt auswählen

Wählen Sie in diesem Schritt ein Subobjekt aus. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Objekt auswählen: In diesem Bereich werden die im Coupa-Endpunkt verfügbaren Subobjekte angezeigt.

    • Ausgewähltes Objekt: Das im vorherigen Schritt ausgewählte Objekt wird hier aufgelistet.

    • Ausgewähltes Subobjekt: Nach Auswahl eines Subobjekts wird es hier aufgelistet.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Subobjekte zu filtern. Die Suche wird nicht nach Groß- und Kleinschreibung unterschieden. Wenn Subobjekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit bei jedem Tastendruck gefiltert. Um Subobjekte beim Suchen aus dem Endpunkt neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie nachfolgend beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Subobjekte aus dem Coupa-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Subobjekte zu Coupa hinzugefügt wurden. Mit dieser Aktion werden alle Metadaten aktualisiert, die zum Erstellen der in der Konfiguration angezeigten Subobjekttabelle verwendet werden.

    • Subobjekt auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Subobjekt auszuwählen. Es kann nur ein Subobjekt ausgewählt werden. Die für jedes Subobjekt verfügbaren Informationen werden aus dem Coupa-Endpunkt abgerufen:

      • Name: Der Name des Subobjekts aus Coupa.

      • Typ: Der Typ des Subobjekts aus Coupa.

      • Beschreibung: Die Beschreibung des Objekts aus Coupa.

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

    • Alle Felder anzeigen: Wählen Sie diese Option aus, um die Felder der Knoten created-by und updated-by in das Antwortschemata einzubeziehen. Standardmäßig werden diese Knoten ohne ihre Felder generiert. Diese Option führt zu sehr großen Datenschemata.

  • 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 zu fahren. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Datenschemata überprüfen

Alle aus dem Endpunkt generierten Request- oder Response-Schemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschema: Diese Datenschemata werden von angrenzenden Transformationen übernommen und werden während der Transformationszuordnung erneut angezeigt.

    Der Coupa-Konnektor verwendet die Coupa R46 Core Platform API. Weitere Informationen zu den Schemataknoten und Feldern finden Sie in der API-Dokumentation.

  • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Datenschema, um den Bearbeitungsmodus für dieses Datenschema zu öffnen. Der Editor ermöglicht das Hinzufügen, Löschen und Neuorganisieren von Knoten und Feldern sowie das Ändern ihrer Datentypen. Alle Vorkommen von Knoten und Feldern werden als [0, 1] Kardinalität festgelegt. An den Endpunkt vorgenommene Änderungen an den Datenschemata müssen zulässig sein und sollten nur nach Rücksprache mit der verfügbaren Dokumentation für den Endpunkt vorgenommen werden. Nach Schemaänderungen wird ein Bearbeitungsdatum oben im betreffenden Schema angezeigt, um anzuzeigen, dass das Schema manuell bearbeitet wurde. Das Aktualisieren der Schemata setzt die Schemata auf ihre Standardstrukturen zurück.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Coupa-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf das gleiche Schema verwiesen wird, z. B. in einer angrenzenden 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: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Coupa-Aktivität vom Typ Query schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Designoberfläche verfügbar. Weitere Informationen finden Sie unter Menü für Aktivitätsaktionen in Connector-Grundlagen.

Coupa-Aktivitäten vom Typ Query können als Quelle mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Scripting-Funktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Scripting-Funktion.

Stellen Sie den Vorgang bereit und führen Sie ihn aus, wenn Sie bereit sind, und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.