Add Attachment

UiPath.ServiceNow.Activities.AddAttachment

L'activité Ajouter une pièce jointe utilise l'API ServiceNow Attachment - POST pour télécharger un fichier (Attachment) vers un objet d'enregistrement spécifique (Object et ObjectSysId).

Après avoir téléchargé le fichier, l'activité génère le sys_id de la pièce jointe (AttachmentId) et l'état du téléchargement (informations de réussite/échec) dans un objet ResponseStatus (ServiceNowStatus). Ces deux sorties peuvent être utilisées comme variables d'entrée dans des activités ultérieures (p. ex., AttachmentId dans Télécharger la pièce jointe (Download Attachment), Supprimer la pièce jointe ( Delete Attachment ) et StatutServiceNow ( ServiceNowStatus ) dans une logique conditionnelle).

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Terminez les étapes de configuration .
2. Ajoutez l'activité ServiceNow Scope à votre projet.
3. Ajoutez l’activité Ajouter une pièce jointe à l’activité Étendue de ServiceNow .
4. Cliquez sur le bouton Configurer à l'intérieur de l'activité Ajouter une pièce jointe (cela ouvre l ' Assistant d'objet).
5. Sélectionnez l' objet auquel vous souhaitez ajouter le fichier et entrez des valeurs pour les propriétés d' entrée .
6. Créez et entrez une variable String et une ResponseStatus pour les propriétés de sortie .
   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API Attachment - POST .
   • L'API renvoie les valeurs String (sys_id) et ResponseStatus à vos variables de propriété de sortie.
     
     

     

     
     

Dans le corps de l’activité

Pour saisir les valeurs de votre propriété Ajouter une pièce jointe ( Add Attachment ), cliquez sur le bouton Configurer (Configure) pour ouvrir l' Assistant Objet et sélectionner un objet ServiceNow (vous avez également la possibilité de saisir l'objet en tant que String).

Pour en savoir plus sur l ' Assistant Objet, consultez la page Cadres d'activité métier (Business Activity Frameworks) .

• Objet (Object ) - Le type d'objet ServiceNow vers lequel vous souhaitez télécharger votre fichier. Utilisez l' Assistant Objet pour sélectionner un objet ou entrez une variable String ou String valide.
• Fichier : le fichier à joindre. Ce champ prend en charge uniquement les variables Strings ou String .
• ID système (Sys ID ) - ID de l'enregistrement auquel joindre le fichier. Ce champ prend en charge uniquement les variables Strings ou String .

Propriétés

Commun

• NomAffichage (DisplayName) : nom affiché de l'activité. Ce champ prend uniquement en charge les variables Strings et String.

Entrée

• NomFichier : le chemin d'accès local complet au fichier que vous souhaitez télécharger. Saisissez une variable String ou String .
• ObjectSysId : le sys_id de l'enregistrement ServiceNow vers lequel vous souhaitez télécharger votre fichier. Saisissez une variable String ou String . Pour obtenir la valeur sys_id , vous pouvez suivre l'une des méthodes indiquées dans la documentation ServiceNow unique record identifier (sys_id) ou cliquer avec le bouton droit sur l'enregistrement dans l'interface utilisateur de ServiceNow et sélectionner l'option Copier sys_id dans le menu contextuel.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

• AttachmentId - sys_id de la pièce jointe. Saisissez une String variable. La variable que vous créez pour cette propriété peut être utilisée comme variable d'entrée dans des activités ultérieures (par exemple, Obtenir l'enregistrement ServiceNow ( Get ServiceNow Record), Télécharger la pièce jointe (Download Attachment), etc.).
• ServiceNowStatus : le statut de la demande (informations de réussite/échec). Saisissez une variable ResponseStatus (UiPath.BAF.Models.ResponseStatus). L'objet ResponseStatus comprend trois propriétés que vous pouvez utiliser dans d'autres activités.
  • Success - Boolean - Spécifie si la requête API a réussi.
  • Code d'erreur - String - L'erreur de réponse si la requête API échoue (Success=False).
  • Message - String - Le message d'erreur.

Exemple

L'image suivante montre un exemple de la relation de dépendance d'activité et des valeurs de propriété d'entrée/sortie.

Pour obtenir des instructions étape par étape et des exemples, consultez le guide de démarrage rapide .