Rechercher une action de pièce jointe

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 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 pour Rechercher une action d’enregistrement 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 pour convertir cette valeur de chaîne en sortie d’enregistrement Rechercher une action 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é comme un 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 vos 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 des enregistrements d’incident afin de les copier dans les enregistrements de problèmes associés. 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 de l’étape 1 du flux montrant 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 de déclenchement a au moins deux pièces jointes 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"
  }
]