ServiceNow-Datensätze durchsuchen

UiPath.ServiceNow.Activities.SearchRecords

Die Aktivität Search ServiceNow Records verwendet die ServiceNow Table – GET API, um bestimmte Datensätze (Object) mithilfe Ihrer codierten Abfragezeichenfolge (Query) abzurufen.

After retrieving the records, the activity outputs the result of the query as a DataTable object (Result) and the status of the request (success/failure information) in a ResponseStatus object (ServiceNowStatus). Both of these outputs can be used as input variables in subsequent activities (e.g., conditional logic).

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. Add the Search ServiceNow Records activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Search ServiceNow Records activity (this opens the Object Wizard).
5. Wählen Sie das Objekt aus, das Sie abrufen möchten, und geben Sie Werte für die Eingabeeigenschaften ein.
6. Erstellen und geben Sie die Variablen DataTable und ResponseStatus für die Ausgabeeigenschaften ein.

   • Ihre Eingabeeigenschaftswerte werden an die Tabelle – GET -API gesendet.

   • Die API gibt die Werte DataTable und ResponseStatus an Ihre Ausgabeeigenschaftsvariablen zurück.

     

Im Textkörper der Aktivität

To enter your Search ServiceNow Records property values and/ test your Query inputs, you can use the Object Wizard by clicking the Configure button.

Weitere Informationen zum Objekt-Assistenten finden Sie auf der Seite Frameworks für Geschäftsaktivitäten .

• Object - The type of ServiceNow object that you want to retrieve. Use the Object Wizard to select an object or enter a valid String or String variable. If you use the Object Wizard to select your object, you must also use it to change your selection. Changes made without using the object wizard causes the activity to fail gracefully.

Eigenschaften

Allgemein

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

Eingabe

• Query - The filter parameters. Enter a String or String variable.

  • Geben Sie Ihre Abfrage gemäß dem von ServiceNow codierten Abfragezeichenfolgenformat ein (z. B. "sysparm_query=short_descriptionLIKEUiPath&sysparm_fields=number,short_description").
  • Um Ihre Abfrage zu erstellen, wird empfohlen, dass Sie die Schritte zum Generieren einer codierten Abfragezeichenfolge durch einen Filter in der ServiceNow-Dokumentation ausführen.
  • To test your query, open the Object Wizard, enter your String (without quotes ("")) and click the Test Query button to see the results.
  • The query String that you enter in the Object Wizard also populates the Query property in the Properties Panel.

  Weitere Informationen zum einfachen Erstellen von Abfragen finden Sie unter Verwenden von Search ServiceNow Records.

Sonstiges

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

Ausgabe

• Result - The results of the Query. Enter a DataTable variable.
• ServiceNowStatus - The status of the request (success/failure information). Enter a ResponseStatus variable (UiPath.BAF.Models.ResponseStatus). The ResponseStatus object includes three properties that you can use in other activities.
  • Success - Boolean - Specifies whether the API request was successful.
  • ErrorCode - String - The response error if the API request is unsuccessful (Success=False).
  • Message - String - The error message.

Beispiel

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

Eine Schritt-für-Schritt-Anleitung und Beispiele finden Sie in den Schnellstartanleitungen .