Action Rechercher une pièce jointe

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Recherche une pièce jointe associée à un enregistrement et renvoie l’ID système de la pièce jointe sous forme de pluie de données.

    Rôles et disponibilité

    Disponible en tant qu’action Studio de workflow ServiceNow principale. Les utilisateurs disposant du rôle flow_designer ou admin peuvent ajouter une action à un flux et définir les détails de la configuration.

    Entrées

    Fournissez une valeur pour chaque entrée dont votre flux a besoin. Pour ajouter des valeurs dynamiques, vous pouvez également glisser-déplacer les pilules du panneau de données ou les sélectionner dans le sélecteur de pilules.

    Nom du fichier
    Type de données : String

    Le nom de la pièce jointe que vous souhaitez rechercher. Vous pouvez laisser cette entrée vide pour rechercher toutes les pièces jointes d’un enregistrement.

    Enregistrement source
    Type de données : Record

    Enregistrement contenant une ou plusieurs pièces jointes à rechercher. Vous pouvez utiliser le Rechercher une action d’enregistrement pour trouver un enregistrement source approprié.

    Sorties

    Ces résultats apparaissent dans le panneau de données. Vous pouvez les utiliser comme entrées ailleurs dans votre flux.

    ID système de la pièce jointe
    Type de données : String

    ID système de la première pièce jointe correspondante. Vous pouvez utiliser le Rechercher une action d’enregistrement pour convertir cette valeur de chaîne en sortie d’enregistrement.

    Liste des pièces jointes
    Type de données : String

    Chaîne au format JSON contenant toutes les pièces jointes qui correspondent à la requête de recherche. Chaque élément correspondant est formaté sous la forme d’un objet contenant l’ID système, le nom du fichier et la taille de fichier en octets de la pièce jointe. Vous pouvez utiliser une action personnalisée pour analyser cet objet selon les besoins.

    Rechercher des pièces jointes à partir d’enregistrements d’incidents

    Configuration de l’action Rechercher une pièce jointe où l’entrée Nom de fichier est vide et où l’enregistrement source est mappé à l’incident déclencheur.

    Cet exemple recherche des pièces jointes à partir d’enregistrements d’incidents afin qu’elles puissent être copiées dans des enregistrements de problèmes connexes. L’entrée Nom de fichier est vide pour trouver toutes les pièces jointes de l’enregistrement source. L’entrée Enregistrement source utilise la pastille de données d’enregistrement de déclencheur d’incident.

    Détails de l’exécution de l’étape 1 du flux affichant une chaîne d’ID système spécifique renvoyée en sortie.

    Dans cet exemple, les détails d’exécution du flux montrent que l’incident déclencheur n’avait qu’une seule pièce jointe. La sortie ID système de la pièce jointe répertorie l’ID système de l’enregistrement de pièce jointe sous forme de valeur de chaîne. La sortie de la liste des pièces jointes est vide, car il n’y avait qu’une seule pièce jointe associée à l’enregistrement source.

    Lorsque l’enregistrement d’incident déclencheur possède au moins deux pièces jointes correspondant à la requête de recherche, l’action remplit la sortie Liste des pièces jointes avec une chaîne JSON.
    [
  {
    "sys_id": "a8008849db7e4210497c1a481396193c",
    "file_name": "Root Cause Analysis",
    "file_size_in_bytes": "48955"
  },
  {
    "sys_id": "c0a298356f102100758ecb512e3ee409",
    "file_name": "Pasted Image",
    "file_size_in_bytes": "97236"
  }
]