Zum Inhalt springen

Coupa-Updateaktivität in Jitterbit Studio

Einführung

Eine Coupa-Update-Aktivität verwendet ihre Coupa-Verbindung, um Objektdaten in Coupa zu aktualisieren. Sie dient als Ziel zum Verarbeiten von Daten in einem Arbeitsvorgang.

Hinweis

Aufgrund einer Einschränkung in der Coupa Core Platform API kann die Coupa-Update-Aktivität keine Updates für das Objekt Approval durchführen. Bei Verwendung dieses Objekts in einem Arbeitsvorgang tritt ein Fehler zur Laufzeit auf.

Erstelle eine Coupa-Updateaktivität

Eine Instanz einer Coupa-Update-Aktivität wird über eine Coupa-Verbindung mit ihrem Aktivitätstyp Update erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehe den Aktivitätstyp auf die Entwurfsoberfläche oder kopiere den Aktivitätstyp und füge ihn auf der Entwurfsoberfläche ein. Weitere Informationen findest du unter Erstelle eine Aktivitäts- oder Tool-Instanz im Bereich Komponenten wiederverwenden.

Eine vorhandene Coupa-Update-Aktivität lässt sich an folgenden Stellen bearbeiten:

Konfiguriere eine Coupa-Updateaktivität

Führe diese Schritte aus, um eine Coupa-Update-Aktivität zu konfigurieren:

Schritt 1: Gib einen Namen ein und wähle ein Objekt aus

Gib in diesem Schritt einen Namen für die Aktivität ein und wähle ein Objekt aus. Die einzelnen Elemente der Benutzeroberfläche dieses Schritts werden nachfolgend beschrieben.

  • Endpunktmenü: Falls du mehrere Endpunkte des gleichen Connector-Typs konfiguriert hast, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicke auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen findest du unter Ändere den zugewiesenen Endpunkt im Bereich Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn du den Mauszeiger über den Namen des aktuellen Endpunkts bewegst. Klicke darauf, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Gib einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Coupa-Update-Aktivität eindeutig sein und darf keinen Schrägstrich / oder Doppelpunkt : enthalten.

  • Wähle ein Objekt aus: In diesem Bereich werden Objekte angezeigt, die im Coupa-Endpunkt verfügbar sind.

    • Ausgewähltes Objekt: Nach Auswahl eines Objekts wird es hier aufgeführt.

    • Suche: Gib einen beliebigen Spaltenwert in das Suchfeld ein, um die Liste der Objekte zu filtern. Bei der Suche wird die Groß- und Kleinschreibung nicht beachtet. Falls Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenresultate bei jedem Tastenanschlag in Echtzeit gefiltert. Um Objekte vom Endpunkt beim Suchen neu zu laden, gib Suchkriterien ein und führe dann eine Aktualisierung wie nachfolgend beschrieben durch.

    • Aktualisieren: Klicke auf das Aktualisierungssymbol oder das Wort Refresh, um Objekte vom Coupa-Endpunkt neu zu laden. Dies kann nützlich sein, wenn neue Objekte zu Coupa hinzugefügt worden sind. Durch diese Aktion werden alle Metadaten aktualisiert, die zum Erstellen der Tabelle der angezeigten Objekte in der Konfiguration verwendet werden.

    • Objekt auswählen: Klicke 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 aus Coupa.

  • Description: Die Beschreibung des Objekts aus Coupa.

Tipp

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

  • Continue on error: Wählen Sie diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Batch-Anforderung ein Fehler auftritt. Falls Fehler auftreten, werden diese in das Vorgangsprotokoll geschrieben.

  • Save & Exit: Klicken Sie, um die Konfiguration dieses Schritts zu speichern und die Aktivitätskonfiguration zu schließen.

  • Next: Klicken Sie, um die Konfiguration für diesen Schritt temporär zu speichern und zum nächsten Schritt zu gehen. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Finished klicken.

  • Discard Changes: Nach vorgenommenen Änderungen klicken Sie, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Es wird eine Meldung angezeigt, in der Sie aufgefordert werden zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Wähle ein Unterobjekt aus

Wählen Sie in diesem Schritt ein Unterobjekt aus. Nachfolgend werden die einzelnen Elemente der Benutzeroberfläche dieses Schritts beschrieben.

  • Select an Object: Dieser Bereich zeigt Unterobjekte an, die im Coupa-Endpunkt verfügbar sind.

    • Selected object: Das im vorherigen Schritt ausgewählte Objekt wird hier aufgelistet.

    • Selected sub object: Nach Auswahl eines Unterobjekts wird es hier aufgelistet.

    • Search: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Unterobjekte zu filtern. Bei der Suche wird die Groß- und Kleinschreibung nicht beachtet. Falls Unterobjekte bereits in der Tabelle angezeigt werden, werden die Ergebnisse in Echtzeit bei jedem Tastendruck gefiltert. Um Unterobjekte beim Suchen vom Endpunkt neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie nachfolgend beschrieben.

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

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

      • Name: Der Name des Unterobjekts aus Coupa.

      • Type: Der Typ des Unterobjekts aus Coupa.

      • Description: Die Beschreibung des Unterobjekts aus Coupa.

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

    • Enable read only fields: Wählen Sie diese Option, um schreibgeschützte Felder aus Coupa verfügbar zu machen. Das Aktivieren dieser Option führt zu sehr großen Datenschemas.

    • Show all fields: Wählen Sie diese Option, um die Felder der Knoten created-by und updated-by in das Antwortschema einzubeziehen. Standardmäßig werden diese Knoten ohne ihre Felder generiert. Das Aktivieren dieser Option führt zu sehr großen Datenschemas.

  • Back: Klicken Sie, um die Konfiguration für diesen Schritt temporär zu speichern und zum vorherigen Schritt zurückzugehen.

  • Next: Klicken Sie, um die Konfiguration für diesen Schritt temporär zu speichern und zum nächsten Schritt zu gehen. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Finished klicken.

  • Discard Changes: Nach vorgenommenen Änderungen klicken Sie, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Es wird eine Meldung angezeigt, in der Sie aufgefordert werden zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Überprüfe die Datenschemas

Alle aus dem Endpunkt generierten Request- oder Response-Schemas werden angezeigt. Nachfolgend werden die einzelnen Elemente der Benutzeroberfläche dieses Schritts beschrieben.

Hinweis

Aufgrund einer Einschränkung in der Coupa Core Platform API kann die Coupa-Aktivität Update keine Aktualisierungen für das Objekt Approval durchführen. Bei Verwendung dieses Objekts in einer Operation tritt zur Laufzeit ein Fehler auf.

  • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Datenschema, um den Bearbeitungsmodus für dieses Datenschema aufzurufen. Im Editor können Sie Knoten und Felder hinzufügen, löschen und neu anordnen sowie deren Datentypen ändern. Alle Vorkommen von Knoten und Feldern sind mit einer [0, 1]-Kardinalität definiert. Änderungen an den Datenschemas müssen vom Endpunkt akzeptiert werden und sollten nur nach Rücksprache mit der verfügbaren Dokumentation für den Endpunkt vorgenommen werden. Nach Bearbeitung der Datenschemas wird oben im betreffenden Schema ein Datum der letzten Bearbeitung angezeigt, das darauf hinweist, dass das Schema manuell bearbeitet wurde. Das Aktualisieren der Schemas setzt diese auf ihre Standardstrukturen zurück.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Refresh, um Schemas vom Coupa-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, wo auf dasselbe 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 Meldung 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 Update schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgängsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in demselben oder in verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsfläche verfügbar. Details finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Coupa-Aktivitäten vom Typ Update können mit diesen Vorgangsmuster als Ziel verwendet werden:

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

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen ihn aus, und überprüfen Sie das Verhalten anhand der Vorgangsprotokolle.