ServiceNow-Datensatz einfügen

UiPath.ServiceNow.Activities.InsertRecord

Die Aktivität ServiceNow-Datensatz einfügen verwendet die ServiceNow- Tabelle – POST -API, um ein neues Datensatzobjekt einzufügen.

Nach dem Einfügen des Datensatzes gibt die Aktivität den Status der Anforderung (Erfolgs-/Fehlerinformationen) in einem ResponseStatus -Objekt (ServiceNowStatus) aus, das Sie in nachfolgenden Aktivitäten (z. B. bedingte Logik) verwenden können.

Diese Aktivität gibt auch den sys_id- Wert des neuen Datensatzobjekts zurück. Wenn Sie beispielsweise ein ServiceNow- Vorfallobjekt einfügen möchten, können Sie den sys_id- Wert ausgeben, indem Sie eine String -Variable im Objektassistenten hinzufügen (siehe Beispiel unten).

Tipp:

Dieses Aktivitätenpaket bietet drei verschiedene Methoden zum Einfügen eines Datensatzes: Insert ServiceNow Record,Upsert Recordsoder Insert ImportSet Records.

Die AktivitätenInsert ServiceNow Record und Upsert Records verwenden REST-APIs, um direkt in eine Produktionstabelle zu schreiben. Die Aktivität Insert ImportSet Records verwendet die REST-Importsatz-API, um in eine Importsatztabelle zu schreiben, aus der die Daten in die Zielproduktionstabelle umgewandelt werden.

Um das direkte Einfügen von Datensätzen in Produktionstabellen zu vermeiden, wird empfohlen, die Aktivität Upsert ServiceNow Record zu verwenden, um einen neuen Datensatz einzufügen.

Ausführliche Informationen, einschließlich der Fehlerbehebung bei der Leistung von Importsätzen, finden Sie unter Importsätze in der ServiceNow-Dokumentation.

Weitere Informationen zur Verwendung von Importsätzen finden Sie unter Webdienst-Importsatz und Importieren von Daten mithilfe von Importsätzen in der ServiceNow-Dokumentation.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie die Aktivität ServiceNow Scope zu Ihrem Projekt hinzu.
3. Fügen Sie die Aktivität Insert ServiceNow Record innerhalb der Aktivität ServiceNow Scope hinzu.
4. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität ServiceNow-Datensatz einfügen (dadurch wird der Objekt-Assistentgeöffnet).
5. Wählen Sie das Objekt aus, das Sie einfügen möchten, und fügen Sie die Felder (mit Werten) hinzu, die Sie ausfüllen möchten.
6. Erstellen Sie eine ResponseStatus -Variable für die Output- Eigenschaft, und geben Sie sie ein.
   • Ihre Eingabeeigenschaftswerte werden an die Table – POST API gesendet.
   • Die API gibt den Wert ResponseStatus an Ihre Ausgabeeigenschaftsvariable zurück.
     
     

     

     
     

Im Textkörper der Aktivität

Um Ihre ServiceNow-Datensatz -Eigenschaftswerte einfügen einzugeben, müssen Sie den Objekt-Assistenten verwenden, indem Sie auf die Schaltfläche Konfigurieren klicken.

Weitere Informationen zum Objektassistentenfinden Sie auf der Seite Business Activity Frameworks .

• sys_id - Die ID des ServiceNow-Datensatzes, der erstellt wird. Geben Sie eine String -Variable ein. Die sys_id wird von ServiceNow automatisch generiert, wenn Sie Ihren neuen Datensatz einfügen. Um diesen Wert zur Verwendung in anderen Aktivitäten abzurufen, erstellen und geben Sie eine String -Variable im Objektassistenten ein (Beispiel unten).

Eigenschaften

Hinweis: Wenn Sie trotz der Option „Mehrere Felder hinzufügen“ keine Liste der Eigenschaften für das ausgewählte Objekt sehen, verfügen Sie möglicherweise nicht über ausreichende Berechtigungen in ServiceNow, um Objektmetadaten anzuzeigen und Daten zu ändern. Weitere Informationen finden Sie unter Beheben von Berechtigungsproblemen.

Erweitert (Advanced)

• AdditionalFields – Ein DataRow , das die Spalten und Werte enthält, die Sie einfügen möchten. Die Spaltennamen müssen mit den Namen übereinstimmen, die in der ServiceNow-Datenbanktabelle für den ausgewählten Objekttyp angezeigt werden.

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Strings- oder String-Variablen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• ServiceNowStatus – Der Status der Anforderung (Erfolgs-/Fehlerinformationen). Geben Sie eine ResponseStatus -Variable ein (UiPath.BAF.Models.ResponseStatus). Das ResponseStatus -Objekt enthält drei Eigenschaften, die Sie in anderen Aktivitäten verwenden können.
  • Success – Boolean – Gibt an, ob die API-Anforderung erfolgreich war.
  • ErrorCode – String – Der Antwortfehler, wenn die API-Anforderung nicht erfolgreich ist (Success=False).
  • Message – String – Die Fehlermeldung.

Beispiel

Die folgende Abbildung zeigt ein Beispiel für die Aktivitätsabhängigkeitsbeziehung und Eingabe-/Ausgabe-Eigenschaftswerte.

Schritt-für-Schritt-Anweisungen und Beispiele finden Sie in der Schnellstartanleitung .