Cherwell Post Records-Aktivität
Einführung
Eine Cherwell Post Records-Aktivität, die ihre Cherwell-Verbindung verwendet, erstellt oder aktualisiert Benutzerdatensätze in Cherwell und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.
Um Geschäftsdatenobjekte zu erstellen oder zu aktualisieren, siehe Cherwell Put Records-Aktivität.
Erstellen einer Cherwell Post Records-Aktivität
Eine Instanz einer Cherwell Post Records-Aktivität wird aus einer Cherwell-Verbindung unter Verwendung des Aktivitätstyps Post Records 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. Weitere Details finden Sie unter Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.
Eine vorhandene Cherwell Post Records-Aktivität kann von diesen Orten aus bearbeitet werden:
- Die Entwurfsfläche (siehe Komponentenaktionsmenü in Entwurfsfläche).
- Der Komponenten-Tab im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Tab).
Konfigurieren einer Cherwell Post Records-Aktivität
Befolgen Sie diese Schritte, um eine Cherwell Post Records-Aktivität zu konfigurieren:
-
Schritt 1: Geben Sie einen Namen ein
Geben Sie einen Namen für die Aktivität ein. -
Schritt 2: Überprüfen Sie die Datenschemas
Alle Anforderungs- oder Antwortschemas, die von dem Endpunkt generiert werden, werden angezeigt.
Schritt 1: Geben Sie einen Namen ein
In diesem Schritt geben Sie einen Namen für die Aktivität ein. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.
-
Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Cherwell Post Records-Aktivität einzigartig sein und darf keine Schrägstriche (
/
) oder Doppelpunkte (:
) enthalten. -
Speichern & Beenden: Wenn aktiviert, 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 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 fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 2: Überprüfen der Datenschemas
Alle Anforderungs- oder Antwortschemas, die vom Endpunkt generiert werden, werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.
- Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und während der Transformationszuordnung erneut angezeigt.
!!! note "Hinweis" Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.
Der Cherwell-Connector verwendet die Cherwell REST API CSM 9.5.0. Konsultieren Sie die API-Dokumentation für Informationen zu den Schema-Knoten und -Feldern.
Die Anforderungs- und Antwortdatenschemas bestehen aus diesen Knoten und Feldern:
Anforderungs-Schema Knoten/Feld | Beschreibung |
---|---|
BusObId | Die interne ID eines Geschäftstypobjekts |
displayName | Der Anzeigename eines Feldes |
loginId | Cherwell-Benutzername |
password | Cherwell-Passwort |
securityGroupId | Die interne ID einer Sicherheitsgruppe |
userInfoFields | Eine Liste von Objekten, die mit Benutzerinformationsfeldern verbunden sind |
userInfo | Benutzerinformationen |
dirty | Flag, das anzeigt, dass Feldwerte aktualisiert werden müssen, wenn true |
Antwortschema Knoten/Feld | Beschreibung |
---|---|
FehlgeschlageneDatensätze | Fehlgeschlagene Datensätze |
Fehler | Fehler |
fehlerNachricht | Fehlermeldung |
ErfolgreicheDatensätze | Erfolgreiche Datensätze |
Erfolg | Erfolg |
busObÖffentlicheId | Die öffentliche ID eines Geschäftsobjekts |
-
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom Cherwell-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, wie 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: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.
Nächste Schritte
Nachdem Sie eine Cherwell Post Records-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration der Operation, indem Sie andere Aktivitäten oder Werkzeuge als operationale Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Operationen zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.
Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsfläche zugänglich. Für Details siehe Aktivitätsaktionsmenü in Connector-Grundlagen.
Cherwell Post Records-Aktivitäten können als Ziel mit diesen Betriebsmustern verwendet werden:
- Transformationsmuster
- Zwei-Transformationsmuster (als erstes oder zweites Ziel)
Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Ort und verwenden Sie dann diesen temporären Ort in der Skriptfunktion.
Wenn Sie bereit sind, setzen Sie die Operation in Betrieb und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.