Schnellstart – Objekte und Anhänge

Überblick

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.

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

Erstellen Sie Ihr Projekt

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

2. Enter the AssetName for the credential asset you created (during the Setup) for your ServiceNow instance username and password (e.g., "ServiceNowSignin").

3. Create and enter a SecureString variable for your Password value (e.g., password).

4. Create and enter a String variable for your Username value (.e.g, username).

5. Add a second Get Credential activity.

6. Enter the AssetName for the credential asset you created (during the Setup) for your ServiceNow instance Client Id and Client Secret (e.g., "ServiceNowClients").

7. Create and enter a SecureString variable for your Password value (e.g., clientSecret).

8. Create and enter a String variable for your Username value (.e.g, clientId).

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

10. In the Client Secret property, enter the SecureString variable you created for your Client Secret in the steps above (e.g., clientSecret).

11. In the Client Id property, enter the String variable you created for your Client Id (e.g., clientId).

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

13. In the Username property, enter the String variable you created for your username (e.g., clientId).

14. Create and enter a String variable for your EndpointURL (e.g., 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. In Select Object drop-down list, select Incident.

18. Create and enter a String variable for the sys_id Value (e.g., sysID)

19. Using the Add Single Field textbox, enter short_description.

    • Enter a short_description Value (e.g., "UiPath-Attachment").

20. Click Done.

21. Create and enter a ResponseStatus variable for the ServiceNowStatus value (e.g., insertRecordResponse).

22. Fügen Sie eine Aktivität nach der Aktivität ServiceNow Record einfügen hinzu.

23. Enter the following Text: "Record created: "+insertRecordResponse.Success.ToString+" | sys_id: "+sysID (where sysID is the variable created for the sys_id Value field above).

    

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. In the Select Object drop-down list, select Incident.

27. In the FileName property, enter the full path to your local file (e.g., "C:\UiPath_Projects\DemoFile.docx") or click the Choose File button in the activity.

28. In the ObjectSysId property, enter the sys_id variable you created for the Insert Record activity (e.g., sysID)

29. Create and enter a String variable for the AttachmentId property (e.g., attachmentId).

30. Create and enter a ResponseStatus variable for the ServiceNowStatus value (e.g., addAttachmentResponse).

31. Fügen Sie eine Aktivität nach der Aktivität ServiceNow Record einfügen hinzu.

32. Enter the following Text: "Attachment added: "+addAttachmentResponse.Success.ToString+ " | sys_id: "+attachmentId (where attachmentId is the variable created for the AttachmentId property above).

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

34. Enter the FilePath where you want to download the file (e.g., "C:\UiPath_Projects\Downloads").

35. In the SysId property, enter the AttachmentId variable you created for the Add Attachment activity (e.g., attachmentId).

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

37. In the ObjectSysId property, enter the AttachmentId variable you created for the Add Attachment activity (e.g., 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. In the Select Object drop-down list, select Attachment.

4. In the sys_id Value field, enter the AttachmentId variable you created for the Add Attachment activity (e.g., attachmentId)

5. Click Done.

6. Create and enter a ResponseStatus variable for the ServiceNowStatus value (e.g., getRecordResponse).

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

8. In the Condition property, enter getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record") to determine if the attachment record was successfully deleted by checking the error message (where getRecordResponse is the variable your created for the ServiceNowStatus property above).

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

   1. In the Text property, enter "Test passed: "+getRecordResponse.Message.
   2. Fügen Sie die Delete ServiceNow-Datensatz nach der Aktivität Write Line hinzu.
   3. Click the Configure button inside the Add Attachment activity.
   4. In the Select Object drop-down list, select Incident.
   5. In the Id property, enter the sys_id variable you created for the Insert Record activity (e.g., sysID).
   6. Create and enter a ResponseStatus variable for the ServiceNowStatus value (e.g., deleteRecordResponse).

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

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

    1. In the Text property, enter "Test failed: "+getRecordResponse.Message.

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