Objets et pièces jointes

L'objectif de ce guide est de vous aider à créer un exemple de travail qui utilise les activités ServiceNow suivantes :

• Insérer l'enregistrement ServiceNow
• Add Attachment
• Download Attachment
• Delete Attachment
• Get ServiceNow Record
• Delete ServiceNow Record

Cet exemple de travail vous permet de vérifier rapidement la connexion à votre instance ServiceNow et de vous familiariser avec les types de données d'entrée/de sortie de l'activité.

Vue d'ensemble (Overview)

Une fois les étapes de ce guide terminées, vous disposerez d'une séquence d'automatisation qui effectuera les opérations suivantes :

1. Établit une connexion à votre instance de ServiceNow (Étendue ServiceNow).

2. Crée un incident ServiceNow (Insert ServiceNow Record).

3. Télécharge un fichier vers le nouvel incident (Ajouter une pièce jointe).

4. Télécharge le fichier téléchargé dans un dossier local (Télécharger la pièce jointe).

5. Supprime le fichier téléchargé (Supprimer la pièce jointe).

6. Vérifie que le fichier a été supprimé en essayant de récupérer l'enregistrement de la pièce jointe et en affichant le message d'erreur attendu (Obtenir l'enregistrement ServiceNow, Si).

7. Supprime l'incident créé (Supprimer l'enregistrement ServiceNow).

   

Prérequis

Avant de commencer :

1. Suivez les étapes de Configuration de ServiceNow.
2. Un fichier local à joindre à un enregistrement ServiceNow.

Étapes

1. Créez votre projet.
2. Testez votre projet.

Construisez votre projet

1. Ajoutez une activité Obtenir l'identifiant .

2. Saisissez l' Nom de l'actif de la ressource d'informations d'identification que vous avez créée lors de la Configuration) pour le nom d'utilisateur et le mot de passe de votre instance de ServiceNow (par exemple, ServiceNowSignin).

3. Créez et entrez une variable SecureString pour la valeur de votre Mot de passe (par exemple, password).

4. Créez et entrez une variable String pour la valeur de votre Nom d'utilisateur (par exemple, username).

5. Add a second Get Credential activity.

6. Saisissez l' Nom de l'actif de la ressource d'informations d'identification que vous avez créée lors de la Configuration) pour votre ID client de votre instance ServiceNow et la Clé secrète du client (par exemple, ServiceNowClients).

7. Créez et entrez une variable SecureString pour la valeur de votre Mot de passe (par exemple, clientSecret).

8. Créez et entrez une variable String pour la valeur de votre Nom d'utilisateur (par exemple, clientId).

9. Ajoutez l’activité Étendue ServiceNow après les deux activités Obtenir l’identifiant .

10. Dans la propriété Clé secrète du client , saisissez la variable SecureString que vous avez créée pour votre clé secrète du client lors des étapes ci-dessus (par exemple, clientSecret).

11. Dans la propriété ID client , saisissez la variable String que vous avez créée pour votre ID client (par exemple, clientId).

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

13. Dans la propriété Nom d'utilisateur , entrez la variable String que vous avez créée pour votre nom d'utilisateur (par exemple, clientId).

14. Créez et entrez une variable String pour votre URLPointTerminaison (par ex. endpointURL).

15. Ajoutez l’activité Insérer un enregistrement ServiceNow dans l’activité Étendue ServiceNow .

16. Cliquez sur le bouton Configurer dans l’activité Insérer l’enregistrement ServiceNow. Cela ouvre l’Assistant Objet.

17. Dans la liste déroulante Sélectionner un objet , sélectionnez Incident.

18. Créez et entrez une String pour la valeur sys_id (par exemple, sysID)

19. À l'aide de la zone de texte Ajouter un champ unique , saisissez short_description.

    • Saisissez une valeur short_description (par exemple, UiPath-Attachment).

20. Click Done.

21. Créez et saisissez une variable ResponseStatus pour la valeur StatutServiceNow (par exemple, insertRecordResponse).

22. Ajoutez une activité Écrire une ligne sous l’activité Insérer l'enregistrement ServiceNow .

23. Saisissez le texte suivant : "Enregistrement créé : "+insertRecordResponse.Success.ToString+" | sys_id: "+sysID (où sysID est la variable créée pour le champ sys_id Value ci-dessus).

    

24. Ajoutez l’activité Ajouter une pièce jointe à l’activité Écrire une ligne .

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

26. Dans la liste déroulante Sélectionner un objet , sélectionnez Incident.

27. Dans la propriété Nom de fichier , entrez le chemin complet vers votre fichier local (par exemple, "C:\UiPath_Projects\DemoFile.docx") ou cliquez sur le bouton Choisir le fichier dans l'activité.

28. Dans la propriété ObjectSysId , entrez la variable sys_id que vous avez créée pour l'activité Insert Record (par ex., sysID)

29. Créez et entrez une variable String pour la propriété AttachmentId (par ex. attachmentId).

30. Créez et saisissez une variable ResponseStatus pour la valeur StatutServiceNow (par exemple, addAttachmentResponse).

31. Ajoutez une activité Écrire une ligne sous l’activité Insérer l'enregistrement ServiceNow .

32. Saisissez le texte suivant : "Pièce jointe ajoutée : "+addAttachmentResponse.Success.ToString+ " | sys_id: "+attachmentId (où attachmentId est la variable créée pour la propriété AttachmentId ci-dessus).

33. Ajoutez l’activité Télécharger la pièce jointe après l’activité Écrire une ligne .

34. Entrez le CheminFichier où vous souhaitez télécharger le fichier (par exemple, "C:\UiPath_Projects\Downloads").

35. Dans la propriété SysId , entrez la variable AttachmentId que vous avez créée pour l'activité Ajouter une pièce jointe (par exemple, attachmentId).

36. Ajoutez l’activité Supprimer la pièce jointe après l’activité Télécharger la pièce jointe .

37. Dans la propriété ObjectSysId , entrez la variable AttachmentId que vous avez créée pour l'activité Ajouter une pièce jointe (par exemple, attachmentId).

    

Tester votre projet

1. Ajoutez l’activité Obtenir l’enregistrement ServiceNow après l’activité Supprimer la pièce jointe .

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

3. Dans la liste déroulante Sélectionner un objet , sélectionnez Pièce jointe.

4. Dans le champ Valeur sys_id , entrez la variable AttachmentId que vous avez créée pour l'activité Add Attachment (ex. : attachmentId)

5. Click Done.

6. Créez et saisissez une variable ResponseStatus pour la valeur StatutServiceNow (par exemple, getRecordResponse).

7. Ajoutez une activité Si après l’activité Obtenir l'enregistrement ServiceNow .

8. Dans la propriété Condition , saisissez getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record") pour déterminer si l'enregistrement de la pièce jointe a été supprimé avec succès en vérifiant le message d'erreur (où getRecordResponse est la variable que vous avez créée pour la propriété StatutServiceNow ci-dessus).

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

   1. Dans la propriété Texte , saisissez "Test réussi :"+getRecordResponse.Message.

10. Ajoutez l’ activité Supprimer l’enregistrement ServiceNow après l’activité Écrire une ligne .

    1. Click the Configure button inside the Add Attachment activity.
    2. Dans la liste déroulante Sélectionner un objet , sélectionnez Incident.
    3. Dans la propriété Id , entrez la variable sys_id que vous avez créée pour l'activité Insert Record (par exemple, sysID).
    4. Créez et saisissez une variable ResponseStatus pour la valeur StatutServiceNow (par exemple, deleteRecordResponse).

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

    1. Dans la propriété Texte , saisissez "Enregistrement supprimé : "+deleteRecordResponse.Success.ToString.

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

    1. Dans la propriété Texte , saisissez "Échec du test : "+getRecordResponse.Message.

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

    

Vous avez terminé !

Pour en savoir plus sur les activités ServiceNow, consultez la page Activités pour obtenir une liste complète des activités et des liens vers les pages de détails de l'activité.