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.

Nach dem Abrufen der Datensätze gibt die Aktivität das Ergebnis der Abfrage als DataTable -Objekt (Result) und den Status der Anforderung (Erfolgs-/Fehlerinformationen) in einem ResponseStatus -Objekt (ServiceNowStatus) aus. Beide Ausgaben können als Eingabevariablen in nachfolgenden Aktivitäten verwendet werden (z. B. bedingte Logik).

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 Search ServiceNow Records innerhalb der Aktivität ServiceNow Scope hinzu.
4. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität Search ServiceNow Records (dadurch wird der Objekt-Assistentgeöffnet).
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 Table – GET API gesendet.
   • Die API gibt die Werte DataTable und ResponseStatus an Ihre Ausgabeeigenschaftsvariablen zurück.
     
     

     

     
     

Im Textkörper der Aktivität

Um Ihre Search ServiceNow Records -Eigenschaftswerte einzugeben und/oder Ihre Abfrageeingaben zu testen, können Sie den Objekt-Assistenten verwenden, indem Sie auf die Schaltfläche Konfigurieren klicken.

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

• Object – Der Typ des ServiceNow-Objekts, das Sie abrufen möchten. Verwenden Sie den Objektassistenten , um ein Objekt auszuwählen, oder geben Sie eine gültige String - oder String -Variable ein. Wenn Sie den Objektassistenten zum Auswählen Ihres Objekts verwenden, müssen Sie ihn auch verwenden, um Ihre Auswahl zu ändern. Änderungen, die ohne Verwendung des Objektassistenten vorgenommen werden, führen dazu, dass die Aktivität ordnungsgemäß fehlschlägt.

Eigenschaften

Allgemein

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

Eingabe

• Abfrage – Die Filterparameter. Geben Sie eine String - oder String -Variable ein.
  • Geben Sie Ihre Abfrage im Format der mit ServiceNow codierten Abfragezeichenfolge 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.
  • Um Ihre Abfrage zu testen, öffnen Sie den Objekt-Assistenten, geben Sie Ihre String (ohne Anführungszeichen ("") ein und klicken Sie auf die Schaltfläche Abfrage testen , um die Ergebnisse anzuzeigen.
  • Die Abfrage String , die Sie im Objekt-Assistenten eingeben, füllt auch die Eigenschaft Abfrage im Eigenschaftenbereichaus.

    Weitere Informationen zum einfachen Erstellen von Abfragen finden Sie unter Verwenden der Suche nach ServiceNow-Datensätzen .

Sonstiges

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

Ausgabe

• Ergebnis – Die Ergebnisse der Abfrage. Geben Sie eine DataTable -Variable ein.
• 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 den Schnellstartanleitungen .