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 de ServiceNow).
2. Crée un incident ServiceNow (Insérer un enregistrement ServiceNow ( Insérer un enregistrement ServiceNow) ).
3. Télécharge un fichier vers 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).
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 (Delete ServiceNow Record).
   
   

   

   
   

Prérequis

Avant de commencer :

1. Terminez les étapes de configuration de ServiceNow.
2. Un fichier local à joindre à un enregistrement ServiceNow.

Étapes

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

Construire votre projet

1. Ajoutez une activité Obtenir l' identifiant (Get Credential ).
2. Saisissez le Nom de l'actif ( AssetName) de l'actif d'informations d'identification que vous avez créé (lors de la configuration) pour votre nom d'utilisateur et votre mot de passe d'instance ServiceNow (par exemple, ServiceNowSignin).
3. Créez et entrez une variable SecureString pour la valeur de votre Mot de passe (Password, par exemple, password).
4. Créez et entrez une variable String pour la valeur de votre Nom d'utilisateur (Username, par exemple, username).
5. Ajoutez une deuxième activité Obtenir l' identifiant (Get Credential ).
6. Saisissez le Nom de la ressource ( AssetName) de la ressource d'informations d'identification que vous avez créée (lors de la configuration) pour votre ID client et votre clé secrète du client d'instance ServiceNow (par exemple, ServiceNowClients).
7. Créez et entrez une variable SecureString pour la valeur de votre Mot de passe (Password, par exemple, clientSecret).
8. Créez et entrez une variable String pour la valeur de votre Nom d'utilisateur (Username, 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 de client (Client Secret) dans les étapes ci-dessus (par exemple, clientSecret).
11. Dans la propriété ID client ( Client Id ), entrez la variable String que vous avez créée pour votre ID 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 URLPointTerminaison (par exemple, endpointURL).
15. Ajoutez l’activité Insérer l’enregistrement ServiceNow à l’intérieur de l’activité Étendue ServiceNow .
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 String variable pour la valeur sys_id (par exemple, sysID)
19. À l'aide de la boîte de texte Ajouter un champ unique (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 StatutServiceNow (par exemple, insertRecordResponse).
22. Ajoutez une activité Write Line après l'activité Insert ServiceNow Record .
23. Entrez le texte suivant : "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é Ajouter une pièce jointe ( Add Attachment ) après l'activité Ligne d' écriture (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 , entrez le chemin complet d'accès à votre fichier local (par exemple, "C:\UiPath_Projects\DemoFile.docx") ou cliquez sur le bouton Choisir le 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 StatutServiceNow (par exemple, addAttachmentResponse).
31. Ajoutez une activité Write Line après l'activité Insert ServiceNow Record .
32. Entrez le texte suivant : "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é Ligne d’ écriture (Write Line) .
34. Saisissez le Chemin d'accès au fichier ( FilePath) 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 (Delete Attachment ) après l’activité Télécharger la pièce jointe (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).
    
    

    

    
    

Testez 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 Pièce jointe ( Attachment).
4. Dans le champ Valeur sys_id (sys_id Value ), entrez la variable AttachmentId que vous avez créée pour l'activité Ajouter une pièce jointe ( Add Attachment ) (par exemple, attachmentId)
5. Cliquez sur Terminé (Done).
6. Créez et entrez une variable ResponseStatus pour la valeur StatutServiceNow (par exemple, getRecordResponse).
7. Ajoutez une activité If après l'activité Get ServiceNow Record .
8. Dans la propriété Condition (Condition), saisissez getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record") pour déterminer si l'enregistrement de 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. Dans la zone Instruction Puis ( Then ), ajoutez une activité Écrire une ligne (Write Line) .
   1. Dans la propriété Texte (Text), saisissez « Test réussi : » +getRecordResponse.Message.
10. Ajoutez l'activité Delete ServiceNow Record après l'activité Write Line .
    1. Cliquez sur le bouton Configurer (Configure) dans l’activité Ajouter une pièce jointe (Add Attachment ).
    2. Dans la liste déroulante Sélectionner un objet ( Select Object ), sélectionnez Incident.
    3. Dans la propriété Id (Id), entrez la variable sys_id que vous avez créée pour l'activité Insert Record (Insérer un enregistrement) (par exemple, sysID).
    4. Créez et entrez une variable ResponseStatus pour la valeur StatutServiceNow (par exemple, deleteRecordResponse).
11. Ajoutez une activité Write Line après l'activité Delete ServiceNow Record .
    1. Dans la propriété Texte (Text), saisissez « Enregistrement supprimé : » +deleteRecordResponse.Success.ToString.
12. 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.
13. 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.