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 (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 (Download Attachment).
5. Löscht die hochgeladene Datei (Delete Attachment).
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-Datensatzlöschen ).

   
   

   

   
   

Voraussetzungen

Bevor Sie beginnen:

1. Schließen Sie die Schritte zur ServiceNow- Einrichtung 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. Geben Sie den AssetName für das Asset mit den Anmeldeinformationen ein, das Sie (während des Setups) für den Benutzernamen und das Kennwort Ihrer ServiceNow-Instanz erstellt haben (z. B. „ServiceNowSignin“).
3. Erstellen Sie eine SecureString -Variable für Ihren Kennwortwert (z. B. Kennwort) und geben Sie sie ein.
4. Erstellen und geben Sie eine String -Variable für Ihren Benutzernamenswert ein (z. B. Benutzername).
5. Fügen Sie eine zweite Get Credential- Aktivität hinzu.
6. Geben Sie den AssetName für das Asset mit den Anmeldeinformationen ein, das Sie (während des Setups) 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 Client Secret die Variable SecureString ein, die Sie in den obigen Schritten für Ihr Client Secret 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 Vorfallaus.
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 ( Add Single Field ) short_descriptionein.

    • 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 nach der Aktivität „Insert ServiceNow Record “ hinzu.

23. Geben Sie den folgenden Textein: „Datensatz erstellt: „+insertRecordResponse.Success.ToString+“ | sys_id: „+sysID (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 Vorfallaus.
27. Geben Sie in der Eigenschaft FileName 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 auswä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 nach der Aktivität „Insert ServiceNow Record “ hinzu.
32. Geben Sie den folgenden Textein: „Anhang hinzugefügt: „+addAttachmentResponse.Success.ToString+“ | sys_id: „+attachmentId (wobei „ attachmentId “ die Variable ist, die für die Eigenschaft „ AttachmentId “ oben erstellt wurde).
33. Fügen Sie die Aktivität Download Attachment nach der Aktivität Write Line hinzu.
34. Geben Sie den FilePath ein , in 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 ObjectSysId die Variable AttachmentId 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 Anhangaus.
4. Geben Sie im Feld sys_id - Wert die Variable AttachmentId 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 Aktivität nach der Aktivität Get ServiceNow Record hinzu.
8. Geben Sie in der Eigenschaft Condition getRecordResponse.Success=False und getRecordResponse.Message.Contains("No Record") ein, um zu bestimmen, ob der Anhangsdatensatz erfolgreich gelöscht wurde, indem Sie die Fehlermeldung überprüfen (wobei getRecordResponse die Variable ist, die Sie oben für die Eigenschaft ServiceNowStatus 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.

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

   3. Klicken Sie auf die Schaltfläche Konfigurieren innerhalb der Aktivität Anlage hinzufügen.

   4. Wählen Sie in der Dropdownliste Objekt auswählen die Option Vorfallaus.

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

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

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

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

12. 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 Eigenschaftseingaben/-ausgaben) finden Sie auf der Seite Aktivitäten . Dort finden Sie eine vollständige Aktivitätsliste und Links zu den Aktivitätsdetailseiten.