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 (ServiceNow Scope) her.
2. Erstellt einen neuen ServiceNow-Vorfall (Insert ServiceNow Record).
3. Lädt eine Datei in den neuen Vorfall 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 Vorfall (ServiceNow-Datensatz löschen).
   
   

   

   
   

Voraussetzungen

Bevor Sie beginnen:

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

Schritte

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

Erstellen Ihres Projekts

1. Fügen Sie eine Aktivität Get Credential hinzu .
2. Geben Sie den AssetName für das Anmeldeinformations-Asset ein, den Sie (während des Setups) für den Benutzernamen und das Kennwort Ihres ServiceNow-Instanz erstellt haben (z. B. ServiceNowSignin).
3. Erstellen und geben Sie eine SecureString -Variable für Ihr Kennwort ein (z. B. password).
4. Erstellen und geben Sie eine String -Variable für den Wert Ihres Benutzernamens ein (z. B. username).
5. Fügen Sie eine zweite Get Credential- Aktivität hinzu.
6. Geben Sie den AssetName für das Anmeldeinformationsasset ein, den Sie (während des Setups) für die Client-ID und das Clientgeheimnis Ihrer ServiceNow-Instanz erstellt haben (z. B. ServiceNowClients).
7. Erstellen und geben Sie eine SecureString -Variable für Ihr Kennwort ein (z. B. clientSecret).
8. Erstellen und geben Sie eine String -Variable für den Wert Ihres Benutzernamens ein (z. B. clientId).
9. Fügen Sie die Aktivität ServiceNow Scope nach den beiden Aktivitäten Get Credential 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. Geben Sie in der Eigenschaft Kennwort die Variable SecureString ein, die Sie in den obigen Schritten für Ihr Kennwort erstellt haben (z. B. password).
13. Geben Sie in der Eigenschaft Benutzername die Variable String ein, die Sie für Ihren Benutzernamen erstellt haben (z. B. clientId).
14. Erstellen und geben Sie eine String -Variable für Ihre EndpointURL 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 innerhalb der Aktivität „ Insert ServiceNow Record “ (dadurch öffnet sich der Objektassistent).
17. Wählen Sie in der Dropdownliste Objekt auswählen die Option Vorfall 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 short_description- Wert ein (z. B. UiPath-Attachment).
20. Klicken Sie auf Fertig.
21. Erstellen und geben Sie eine ResponseStatus -Variable für den ServiceNowStatus- Wert ein (z. B. insertRecordResponse).
22. Fügen Sie eine Aktivität Write Line nach der Aktivität Insert ServiceNow Record hinzu.
23. Geben Sie folgenden Text: "Datensatz erstellt: "+insertRecordResponse.Success.ToString+" | sys_id: "+sysID ein (wobei sysID die Variable ist, die für das Wertfeld sys_id oben erstellt wurde).
    
    

    

    
    
24. Fügen Sie die Aktivität Add Attachment nach der Aktivität Write Line hinzu.
25. Klicken Sie auf die Schaltfläche Konfigurieren innerhalb der Aktivität Add Attachment .
26. Wählen Sie in der Dropdownliste Objekt auswählen die Option Vorfall 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 ObjectSysId 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 AttachmentId- Eigenschaft 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 Aktivität Write Line nach der Aktivität Insert ServiceNow Record hinzu.
32. Geben Sie folgenden Text ein: "Attachment added: "+addAttachmentResponse.Success.ToString+ " | sys_id: "+attachmentId (wobei attachmentId die Variable ist, die für die AttachmentId -Eigenschaft oben erstellt wurde).
33. Fügen Sie die Aktivität Download Attachment nach der Aktivität Write Line hinzu.
34. Geben Sie den Dateipfad ein , unter den Sie die Datei herunterladen möchten (z. B. "C:\UiPath_Projects\Downloads").
35. Geben Sie in der Eigenschaft SysId die AttachmentId -Variable 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 ObjectSysId die AttachmentId -Variable ein, die Sie für die Aktivität Add Attachment 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. Klicken Sie auf die Schaltfläche Konfigurieren innerhalb der Aktivität „Insert ServiceNow Record “.
3. Wählen Sie in der Dropdownliste Objekt auswählen die Option Anhang aus.
4. Geben Sie im Feld sys_id - Wert die AttachmentId -Variable ein, die Sie für die Aktivität Add Attachment erstellt haben (z. B. attachmentId).
5. Klicken Sie auf Fertig.
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 Anhangdatensatz erfolgreich gelöscht wurde, indem Sie die Fehlermeldung überprüfen (wobei getRecordResponse die Variable ist, die Sie für die Eigenschaft ServiceNowStatus oben erstellt haben).
9. Fügen Sie im Feld Then -Anweisung eine Write Line- Aktivität hinzu.
   1. Geben Sie in der Eigenschaft Text "Test bestanden: "+getRecordResponse.Message ein.
10. Fügen Sie die Aktivität Delete ServiceNow Record nach der Aktivität Write Line hinzu.
    1. Klicken Sie auf die Schaltfläche Konfigurieren innerhalb der Aktivität Add Attachment .
    2. Wählen Sie in der Dropdownliste Objekt auswählen die Option Vorfall 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. Fügen Sie eine Write Line- Aktivität nach der Aktivität Delete ServiceNow Record hinzu.
    1. Geben Sie in der Eigenschaft Text "Datensatz gelöscht:" +deleteRecordResponse.Success.ToString ein.
12. Fügen Sie im Feld Else Statement eine Write Line- Aktivität hinzu.
    1. Geben Sie in der Eigenschaft Text "Test fehlgeschlagen: "+getRecordResponse.Message ein.
13. Klicken Sie auf Ausführen und überprüfen Sie, ob das Fenster Ausgabe ( Output ) die erwarteten Werte für die Schreibzeile enthält.
    
    

    

    
    

Alles erledigt!

Weitere Informationen zu den ServiceNow-Aktivitäten (einschließlich Beispiele für die Ein- und Ausgabe von Eigenschaften), finden Sie auf der Seite Aktivitäten mit einer vollständigen Aktivitätsliste und Links zu den Detailseiten der Aktivitäten.