Rechercher une action de pièce jointe

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 pastille de données.

    Rôles et disponibilité

    Disponible en tant qu’action Studio de workflow ServiceNow de base. Les utilisateurs disposant du rôle flow_designer ou administrateur 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

    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 pour Rechercher une action d’enregistrement trouver un enregistrement source approprié.

    Sorties

    Ces sorties apparaissent dans le panneau 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 pour Rechercher une action d’enregistrement 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é en tant qu’objet contenant l’ID système, le nom du fichier et la taille du 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 l’enregistrement source est mappé à l’incident déclencheur.

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

    Détails d’exécution pour l’étape 1 du flux affichant une chaîne d’ID système spécifique renvoyée en tant que 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 a deux pièces jointes ou plus correspondant à la requête de recherche, l’action remplit la sortie de la 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"
  }
]