Objekte und Anhänge

Dieser Leitfaden soll Sie bei der Erstellung eines funktionierenden Beispiels unterstützen, das die folgenden ServiceNow-Aktivitäten verwendet:

• ServiceNow-Datensatz einfügen
• Add Attachment
• Download Attachment
• Delete Attachment
• Get ServiceNow Record
• Delete ServiceNow Record

Mit diesem Arbeitsbeispiel können Sie die Verbindung mit Ihrer ServiceNow-Instanz schnell überprüfen und sich mit den Eingabe-/Ausgabedatentypen der Aktivität vertraut machen.

Überblick

Nachdem Sie die Schritte in dieser Anleitung ausgeführt haben, verfügen Sie über eine Automatisierungs-Sequence, die Folgendes ausführt:

1. Stellt eine Verbindung mit Ihrer ServiceNow-Instanz her (ServiceNow Scope).

2. Erstellt einen neuen ServiceNow-Vorfall (ServiceNow-Datensatz einfügen).

3. Lädt eine Datei in den neuen Incident hoch (Anhang hinzufügen).

4. Lädt die hochgeladene Datei in einen lokalen Ordner herunter (Anhang herunterladen).

5. Löscht die hochgeladene Datei (Anhang löschen).

6. Überprüft, ob die Datei gelöscht wurde, indem versucht wird, den Anhangsdatensatz abzurufen, und die erwartete Fehlermeldung ausgegeben wird (Get ServiceNow Record, If).

7. Löscht den erstellten Incident (ServiceNow-Datensatz löschen).

   

Voraussetzungen

Bevor Sie beginnen:

1. Schließen Sie die Schritte zum Einrichten von ServiceNow ab.
2. Eine lokale Datei, die an einen ServiceNow-Datensatz angehängt werden soll.

Schritte

1. Erstellen Sie Ihr Projekt.
2. Testen Sie Ihr Projekt.

Erstellen Sie Ihr Projekt

1. Fügen Sie eine Aktivität Get Credential hinzu.

2. Geben Sie den AssetName für das Anmeldeinformations-Asset ein, das Sie (während der Einrichtung) für Ihren ServiceNow-Instanz-Benutzernamen und -Kennwort erstellt haben (z. B. ServiceNowSignin).

3. Erstellen und geben Sie eine SecureString -Variable für Ihren Kennwortwert ein (z. B. password).

4. Erstellen und geben Sie eine String -Variable für Ihren Benutzernamenswert ein (z. B. username).

5. Add a second Get Credential activity.

6. Geben Sie den AssetName für das Anmeldeinformations-Asset ein, das Sie (während der Einrichtung) für die Client-ID und den Geheimen Clientschlüssel Ihrer ServiceNow-Instanz erstellt haben (z. B. ServiceNowClients).

7. Erstellen und geben Sie eine SecureString -Variable für Ihren Kennwortwert ein (z. B. clientSecret).

8. Erstellen und geben Sie eine String -Variable für Ihren Benutzernamenswert ein (z. B. clientId).

9. Fügen Sie die Aktivität ServiceNow Scope nach den beiden Get Credential- Aktivitäten hinzu.

10. Geben Sie in der Eigenschaft Geheimer Clientschlüssel die Variable SecureString ein, die Sie in den obigen Schritten für Ihren geheimen Clientschlüssel erstellt haben (z. B. clientSecret).

11. Geben Sie in der Eigenschaft Client-ID die Variable String ein, die Sie für Ihre Client-ID erstellt haben (z. B. clientId).

12. In the Password property, enter the SecureString variable you created for your password in the steps above (e.g., password).

13. Geben Sie in der Eigenschaft Benutzername die String -Variable ein, die Sie für Ihren Benutzernamen erstellt haben (z. B. clientId).

14. Erstellen und geben Sie eine String -Variable für Ihre EndpunktURL ein (z. B. endpointURL).

15. Fügen Sie die Aktivität Insert ServiceNow Record innerhalb der Aktivität ServiceNow Scope hinzu.

16. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität ServiceNow Record einfügen .

17. Wählen Sie in der Dropdownliste Objekt auswählen die Option Incident aus.

18. Erstellen und geben Sie eine String -Variable für den sys_id- Wert ein (z. B. sysID)

19. Geben Sie im Textfeld Einzelnes Feld hinzufügen short_description ein.

    • Geben Sie einen Robot_description- Wert ein (z. B. UiPath-Attachment).

20. Click Done.

21. Erstellen und geben Sie eine ResponseStatus -Variable für den ServiceNowStatus- Wert ein (z. B. insertRecordResponse).

22. Fügen Sie eine Write Line- Aktivität nach der Aktivität Insert ServiceNow Record hinzu.

23. Geben Sie den folgenden Text ein: "Datensatz erstellt: "+insertRecordResponse.Success.ToString+" | sys_id: "+sysID (bei der sysID die Variable ist, die für das obige sys_id- Wertfeld erstellt wurde).

    

24. Fügen Sie die Aktivität Add Attachment nach der Aktivität Write Line hinzu.

25. Click the Configure button inside the Add Attachment activity.

26. Wählen Sie in der Dropdownliste Objekt auswählen die Option Incident aus.

27. Geben Sie in der Eigenschaft Dateiname den vollständigen Pfad zu Ihrer lokalen Datei ein (z. B. "C:\UiPath_Projects\DemoFile.docx") oder klicken Sie in der Aktivität auf die Schaltfläche Datei wählen .

28. Geben Sie in der Eigenschaft ObjektSysID die Variable sys_id ein, die Sie für die Aktivität Datensatz einfügen erstellt haben (z. B. sysID)

29. Erstellen und geben Sie eine String -Variable für die Eigenschaft Anhangs-ID ein (z. B. attachmentId).

30. Erstellen und geben Sie eine ResponseStatus -Variable für den ServiceNowStatus- Wert ein (z. B. addAttachmentResponse).

31. Fügen Sie eine Write Line- Aktivität nach der Aktivität Insert ServiceNow Record hinzu.

32. Geben Sie den folgenden Text ein: "Attachment hinzugefügt: "+addAttachmentResponse.Success.ToString+ " | sys_id: "+attachmentId ( wobei attachmentId die Variable ist, die für die obige Eigenschaft AttachmentId erstellt wurde).

33. Fügen Sie die Aktivität Download Attachment nach der Aktivität Write Line hinzu.

34. Geben Sie den Dateipfad ein, an den Sie die Datei herunterladen möchten (z. B. "C:\UiPath_Projects\Downloads").

35. Geben Sie in der Eigenschaft SysId die Variable AttachmentId ein, die Sie für die Aktivität Add Attachment erstellt haben (z. B. attachmentId).

36. Fügen Sie die Aktivität Delete Attachment nach der Aktivität Download Attachment hinzu.

37. Geben Sie in der Eigenschaft ObjektSysID die Variable AttachmentId ein, die Sie für die Aktivität Anhang hinzufügen erstellt haben (z. B. attachmentId).

    

Testen Sie Ihr Projekt

1. Fügen Sie die Aktivität Get ServiceNow Record nach der Aktivität Delete Attachment hinzu.

2. Click the Configure button inside the Insert ServiceNow Record activity.

3. Wählen Sie in der Dropdownliste Objekt auswählen die Option Anhang.

4. Geben Sie im Feld sys_id Value die Variable AttachmentId ein, die Sie für die Aktivität Add Attachment erstellt haben (z. B. attachmentId)

5. Click Done.

6. Erstellen und geben Sie eine ResponseStatus -Variable für den ServiceNowStatus- Wert ein (z. B. getRecordResponse).

7. Fügen Sie eine If- Aktivität nach der Get ServiceNow Record- Aktivität hinzu.

8. Geben Sie in der Eigenschaft Bedingung getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record") ein, um zu bestimmen, ob der Anlagendatensatz erfolgreich gelöscht wurde, indem die Fehlermeldung überprüft wird ( wobei getRecordResponse die Variable ist, die Sie für die Eigenschaft ServiceNowStatus oben erstellt haben).

9. In the Then statement box, add a Write Line activity.

   1. Geben Sie in der Eigenschaft Text „Test bestanden: “ +getRecordResponse.Message ein.

10. Fügen Sie die Delete ServiceNow-Datensatz nach der Aktivität Write Line hinzu.

    1. Click the Configure button inside the Add Attachment activity.
    2. Wählen Sie in der Dropdownliste Objekt auswählen die Option Incident aus.
    3. Geben Sie in der Eigenschaft Id die Variable sys_id ein, die Sie für die Aktivität „Insert Record“ erstellt haben (z. B. sysID).
    4. Erstellen und geben Sie eine ResponseStatus -Variable für den ServiceNowStatus- Wert ein (z. B. deleteRecordResponse).

11. Add a Write Line activity after the Delete ServiceNow Record activity.

    1. Geben Sie in der Eigenschaft Text „Datensatz gelöscht: “ +deleteRecordResponse.Success.ToString ein.

12. In the Else statement box, add a Write Line activity.

    1. Geben Sie in der Eigenschaft Text „Test fehlgeschlagen:“ +getRecordResponse.Message ein.

13. Click Run and verify the Output window includes the expected write line values.

    

Alles erledigt!

Weitere Informationen zu den ServiceNow-Aktivitäten ( einschließlich Eigenschaftseingaben/-ausgaben) finden Sie auf der Seite Aktivitäten für eine vollständige Liste der Aktivitäten und Links zu den Seiten mit den Aktivitätsdetails.