Update ServiceNow Record

UiPath.ServiceNow.Activities.UpdateRecord

Die Aktivität Update ServiceNow Record verwendet die ServiceNow Table – PUT API, um einen bestimmten Datensatz (sys_id) zu aktualisieren.

Nach der Aktualisierung 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.

Tipp:

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

Die AktivitätenUpdate 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 zu vermeiden, dass Datensätze direkt in Produktionstabellen aktualisiert werden, wird empfohlen, die Aktivität Insert ImportSet Records zu verwenden, um einen neuen Datensatz zu aktualisieren.

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 Update ServiceNow Record innerhalb der Aktivität ServiceNow Scope hinzu.
4. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität ServiceNow-Datensatz aktualisieren (dadurch wird der Objekt-Assistentgeöffnet).
5. Wählen Sie das Objekt aus, das Sie aktualisieren möchten, und geben Sie mindestens die sys_id des Datensatzes ein.
6. Erstellen und geben Sie eine ResponseStatus -Variable für die Ausgabeeigenschaft ein.
   • Ihre Eingabeeigenschaftswerte werden an die Table – PUT API gesendet.
   • Die API gibt den Wert ResponseStatus an Ihre Ausgabeeigenschaftsvariable zurück.

Im Textkörper der Aktivität

Um Ihre ServiceNow-Datensatz -Eigenschaftswerte aktualisieren 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, den Sie aktualisieren möchten. Um den sys_id- Wert abzurufen, können Sie eine der Methoden befolgen, die in der ServiceNow-Dokumentation zur eindeutigen Datensatz-ID (sys_id) gezeigt werden, oder mit der rechten Maustaste auf den Datensatz in der ServiceNow-Benutzeroberfläche klicken und die Option sys_id kopieren im Popoutmenü auswählen.

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 aktualisieren 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 .