Démarrage rapide : Objets et pièces jointes

Vue d'ensemble (Overview)

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

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 ServiceNow (Étendue ServiceNow (ServiceNow Scope)).
2. Crée un incident ServiceNow (Insérer un enregistrement ServiceNow ( Insérer un enregistrement ServiceNow) ).
3. Télécharge un fichier dans le nouvel incident ( Ajouter une pièce jointe (Add Attachment)).
4. Télécharge le fichier téléchargé dans un dossier local (Télécharger la pièce jointe (Download Attachment) ).
5. Supprime le fichier téléchargé ( Supprimer la pièce jointe (Delete Attachment) ).
6. Vérifie que le fichier a été supprimé en essayant de récupérer l'enregistrement de 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 ( 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

Construisez votre projet

1. Ajouter une activité.
2. Saisissez AssetName pour l'actif d'identification que vous avez créé (lors de la configuration) pour le nom d'utilisateur et le mot de passe de votre instance 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 saisissez une variable String pour la valeur de votre nom d' utilisateur (par exemple, nom d' utilisateur).
5. Ajoutez une deuxième activité Obtenir l' identifiant (Get Credential ).
6. Saisissez le nom de l' actif pour l'actif d'identification que vous avez créé (lors de la configuration) pour l'ID de client et la clé secrète de votre instance ServiceNow (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 (ServiceNow Scope) après les deux activités Obtenir les informations d'identification ( Get Credential ).
10. Dans la propriété Clé secrète du client (Client Secret ), entrez la variable SecureString que vous avez créée pour votre clé secrète du client dans les étapes ci-dessus (par exemple, clientSecret).
11. Dans la propriété ID de client ( Client Id ), entrez la variable String que vous avez créée pour votre ID de client (par exemple, clientId).
12. Dans la propriété Mot de passe (Password), entrez la variable SecureString que vous avez créée pour votre mot de passe dans les étapes ci-dessus (par exemple, password).
13. Dans la propriété Nom d'utilisateur (Username), 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 URL de point de terminaison (par exemple, URL de point de terminaison)
15. Ajoutez l’activité Insert ServiceNow Record à l’intérieur de l’activité ServiceNow Scope .
16. Cliquez sur le bouton Configurer (Configure) à l'intérieur de l'activité Insérer un enregistrement ServiceNow ( Insert ServiceNow Record ) (cela ouvre l'assistant d'objet.
17. Dans la liste déroulante Sélectionner un objet ( Select Object ), sélectionnez Incident.
18. Créez et entrez une variable String pour la valeur sys_id (par exemple, sysID)

19. À l'aide de la zone de texte Ajouter un seul champ (Add Single Field) , entrez short_description.

    • Saisissez une valeur short_description (par exemple, "UiPath-Attachment").
20. Cliquez sur Terminé (Done).
21. Créez et entrez une variable ResponseStatus pour la valeur ServiceNowStatus (par exemple, insertRecordResponse).
22. Ajoutez une activité après l'activité Insert ServiceNow Record .

23. Saisissez le textesuivant : « Record created: "+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é Add Attachment après l'activité Write Line .
25. Cliquez sur le bouton Configurer (Configure) dans l’activité Ajouter une pièce jointe (Add Attachment ).
26. Dans la liste déroulante Sélectionner un objet ( Select Object ), sélectionnez Incident.
27. Dans la propriété NomFichier ( FileName ), entrez le chemin d'accès complet à votre fichier local (par exemple, "C:\UiPath_Projects\DemoFile.docx") ou cliquez sur le bouton Choisir un fichier (Choose File) dans l'activité.
28. Dans la propriété ObjectSysId , entrez la variable sys_id que vous avez créée pour l'activité Insérer un enregistrement (par exemple, sysID)
29. Créez et entrez une variable String pour la propriété AttachmentId (par exemple, attachmentId).
30. Créez et entrez une variable ResponseStatus pour la valeur ServiceNowStatus (par exemple, addAttachmentResponse).
31. Ajoutez une activité après l'activité Insert ServiceNow Record .
32. Saisissez le textesuivant : « Attachment added: "+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 (Download Attachment ) après l'activité Écrire une ligne (Write Line) .
34. Saisissez le chemin d'accès au fichier dans lequel 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é Delete Attachment après l'activité Download Attachment .

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 (Get ServiceNow Record) après l'activité Supprimer la pièce jointe (Delete Attachment ).
2. Cliquez sur le bouton Configurer (Configure) à l'intérieur de l'activité Insérer un enregistrement ServiceNow (Insert ServiceNow Record) .
3. Dans la liste déroulante Sélectionner un objet ( Select Object ), sélectionnez Attachment(Pièce jointe) .
4. Dans le champ sys_id Value (Valeur sys_id), saisissez la variable AttachmentId que vous avez créée pour l'activité Ajouter une pièce jointe (par exemple, attachmentId)
5. Cliquez sur Terminé (Done).
6. Créez et entrez une variable ResponseStatus pour la valeur ServiceNowStatus (par exemple, getRecordResponse).
7. Ajoutez une activité après l'activité Obtenir l' enregistrement ServiceNow (Get ServiceNow Record) .
8. Dans la propriété Condition , entrez 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é ServiceNowStatus ci-dessus ).

9. Dans la zone Instruction Puis ( Then ), ajoutez une activité Écrire une ligne (Write Line) .

   1. Dans la propriété Texte , saisissez « Test passé : » +getRecordResponse.Message.

   2. Ajoutez l'activité Supprimer l'enregistrement ServiceNow ( Delete ServiceNow Record ) après l'activité Écrire une ligne (Write Line) .

   3. Cliquez sur le bouton Configurer (Configure) à l'intérieur de l'activité Ajouter une pièce jointe (Add Attachment ).

   4. Dans la liste déroulante Sélectionner un objet ( Select Object ), sélectionnez Incident.

   5. Dans la propriété Id (Id), entrez la variable sys_id que vous avez créée pour l'activité Insérer un enregistrement (par exemple, sysID).

   6. Créez et entrez une variable ResponseStatus pour la valeur ServiceNowStatus (par exemple, deleteRecordResponse).

10. Ajoutez une activité Write Line après l'activité Delete ServiceNow Record .

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

11. Dans la zone Instruction Sinon ( Else ), ajoutez une activité Écrire une ligne (Write Line) .

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

12. Cliquez sur Exécuter ( Run ) et vérifiez que la fenêtre Sortie (Output) inclut les valeurs de ligne d'écriture attendues.

    
    

    

    
    

Vous avez terminé !

Pour en savoir plus sur les activités ServiceNow (y compris des exemples d'entrées/sorties de propriétés), consultez la page Activités (Activities) pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.