Update ServiceNow Record

UiPath.ServiceNow.Activities.UpdateRecord

Die Aktivität Update ServiceNow Record verwendet die ServiceNow- Tabelle – 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 zur 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 Tabelle – 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 Objekt-Assistenten finden Sie auf der Seite Frameworks für Geschäftsaktivitäten .

• sys_id – Die ID des ServiceNow-Datensatzes, den Sie aktualisieren möchten. Um den sys_id- Wert abzurufen, können Sie einer der Methoden folgen, die in der Dokumentation zum eindeutigen Datensatzbezeichner (sys_id) von ServiceNow gezeigt werden, oder klicken Sie mit der rechten Maustaste auf den Datensatz in der ServiceNow-Benutzeroberfläche, und wählen Sie im Popup-Menü die Option sys_id kopieren aus.

Eigenschaften

Hinweis: Wenn Sie die Liste der Eigenschaften für das ausgewählte Objekt nicht sehen, auch wenn Sie die Option „Mehrere Felder hinzufügen“ verwenden, haben Sie möglicherweise keine ausreichenden 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 .