API de pièce jointe

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

    • L’API de pièces jointes fournit des points de terminaison qui vous permettent de charger et d’interroger des pièces jointes.

    Vous pouvez charger ou récupérer un seul fichier à chaque demande.

    L’API Attachment respecte toutes les limitations du système sur les fichiers chargés, telles que la taille maximale du fichier et les types de pièces jointes autorisés. Vous pouvez contrôler ces paramètres à l’aide des propriétés com.glide.attachment.max_size, 1024 Mo par défaut, et glide.attachment.extensions.

    Remarque :
    L’API de pièce jointe accepte toutes les valeurs de type de contenu (*/*). Spécifiez le type de contenu du fichier lors du chargement d’une pièce jointe. Le type de contenu est stocké avec les métadonnées du fichier, ce qui permet à d’autres outils d’identifier et d’analyser correctement le fichier.

    La vidéo suivante fournit plus d’informations sur l’API de pièce jointe :

    Pièces jointes Exigences du rôle API

    Pour créer des pièces jointes, l’enregistrement utilisateur utilisé pour authentifier la requête HTTP avec ServiceNow doit avoir tous les rôles requis pour créer des enregistrements de pièce jointe [sys_attachment]. Il doit également disposer de tous les rôles requis pour lire et écrire des enregistrements sur la table cible, tels que le rôle itil pour ajouter des pièces jointes aux enregistrements d’incidents.

    Par défaut, il n’existe pas de rôle unique permettant à un utilisateur d’ajouter des pièces jointes. Vous pouvez créer un rôle pour autoriser explicitement l’ajout de pièces jointes, puis affecter ce rôle au compte d’utilisateur utilisé pour effectuer la demande.

    Pièce jointe : DELETE /now/attachment/{sys_id}

    Cette méthode supprime la pièce jointe associée à une valeur sys_id spécifique.

    Format d'URL

    URL versionnée : /api/now/v1/attachment/{sys_id}

    URL par défaut : /api/now/attachment/{sys_id}

    Paramètres de demande pris en charge

    Tableau 1. Paramètres de chemin d'accès
    Nom Description
    sys_id Sys_id valeur de la pièce jointe à supprimer.

    Type de données : chaîne
    Tableau 2. Paramètres de requête
    Nom Description
    Aucun
    Tableau 3. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 4. En-têtes de demandes
    En-tête Description
    Aucun
    Tableau 5. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 6. Codes d'état
    Code d'état Description
    204 Indique que la demande a été exécutée avec succès.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    404 Introuvable. L’élément demandé est introuvable.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse (JSON ou XML)

    Nom Description
    Aucun

    Demande cURL

    curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5" \
--request DELETE \
--user 'username':'password'

    ""

    Pièce jointe : GET /now/attachment

    Renvoie les métadonnées pour plusieurs pièces jointes.

    Format d'URL

    URL versionnée : api/now/v1/attachment

    URL par défaut : api/now/attachment

    Paramètres de demande pris en charge

    Tableau 7. Paramètres de chemin d'accès
    Nom Description
    Aucun
    Tableau 8. Paramètres de requête
    Nom Description
    sysparm_limit Limite à appliquer à la pagination.
    Remarque :
    Des valeurs de sysparm_limit anormalement élevées peuvent avoir un impact sur les performances du système.

    Type de données : chaîne

    Par défaut : 1 000
    sysparm_offset Nombre d’enregistrements à exclure de la requête. Utilisez ce paramètre pour obtenir plus d’enregistrements que ce qui est spécifié dans sysparm_limit. Par exemple, si sysparm_limit est définie sur 500, mais qu’il existe des enregistrements supplémentaires que vous souhaitez interroger, vous pouvez spécifier une valeur sysparm_offset de 500 pour obtenir le deuxième ensemble d’enregistrements.

    Type de données : chaîne

    Par défaut : 0
    sysparm_query Requête codée. Les requêtes de l’API de pièce jointe sont relatives à la table Pièces jointes [sys_attachment].

    Par exemple : (sysparm_query=file_name=attachment.doc)

    La requête codée prend en charge le tri par. Pour trier les réponses en fonction de certains champs, utilisez les clauses ORDERBY et ORDERBYDESC dans sysparm_query. Par exemple, sysparm_query=ORDERBYfile_name^ORDERBYDESCtable_Name trie les résultats par ordre croissant par nom d’abord, puis par ordre décroissant par nom de table.

    Type de données : chaîne
    Tableau 9. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 10. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json
    Tableau 11. En-têtes de réponses
    En-tête Description
    Type de contenu Le type de contenu de la réponse. Pour les demandes de métadonnées, il s’agit du type de contenu des métadonnées, et non du type de contenu des fichiers en pièce jointe.
    Lien Liens pour télécharger les pièces jointes.

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 12. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse (JSON ou XML)

    Nom Description
    Les informations renvoyées dépendent des pièces jointes sélectionnées.

    Demande cURL

    curl "https://instance.servicenow.com/api/now/attachment?sysparm_limit=1" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

    {
  "result": [
    {
      "table_sys_id": "5054b6f8c0a800060056addcf551ecf8",
      "size_bytes": "462",
      "download_link": "https://instance.service-now.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file",
      "sys_updated_on": "2009-05-21 04:12:21",
      "sys_id": "615ea769c0a80166001cf5f2367302f5",
      "image_height": "",
      "sys_created_on": "2009-05-21 04:12:21",
      "file_name": "blocks.swf",
      "sys_created_by": "glide.maint",
      "compressed": "true",
      "average_image_color": "",
      "sys_updated_by": "glide.maint",
      "sys_tags": "",
      "table_name": "content_block_programmatic",
      "image_width": "",
      "sys_mod_count": "0",
      "content_type": "application/x-shockwave-flash",
      "size_compressed": "485"
    }
  ]
}

    Pièce jointe : GET /now/attachment/{sys_id}/fichier

    Renvoie la pièce jointe du fichier binaire avec une valeur sys_id spécifique.

    Format d'URL

    URL versionnée : /api/now/v1/attachment/{sys_id}/file

    URL par défaut : /api/now/attachment/{sys_id}/file

    Paramètres de demande pris en charge

    Tableau 13. Paramètres de chemin d'accès
    Nom Description
    sys_id Sys_id de l’enregistrement de pièce jointe à partir duquel renvoyer des données binaires.
    Tableau 14. Paramètres de requête
    Nom Description
    Aucun
    Tableau 15. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 16. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Par exemple, utilisez image/jpeg ou image/png pour accepter exclusivement les fichiers image JPEG ou PNG. Pour autoriser tous les types d’images, spécifiez image/* ; Pour autoriser n’importe quel type de fichier, spécifiez */*.

    Faire défaut:*/*
    Tableau 17. En-têtes de réponses
    En-tête Description
    X-Attachment-Metadata (Pièce jointe X) Métadonnées sur le fichier renvoyé, telles que la taille, le nom et le type de fichier.

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 18. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse (JSON ou XML)

    Nom Description
    Pièce jointe de fichier binaire

    Demande cURL

    curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file" \
--request GET \
--header "Accept:*/*" \
--user "username":"password"
    Binary response not shown.

    Pièce jointe : GET /now/attachment/{sys_id}

    Renvoie les métadonnées du fichier joint avec une valeur de sys_id spécifique.

    Format d'URL

    URL versionnée : /api/now/v1/attachment/{sys_id}

    URL par défaut : /api/now/attachment/{sys_id}

    Paramètres de demande pris en charge

    Tableau 19. Paramètres de chemin d'accès
    Nom Description
    sys_id Sys_id de l’enregistrement de pièce jointe pour lequel récupérer les métadonnées.
    Tableau 20. Paramètres de requête
    Nom Description
    Aucun
    Tableau 21. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 22. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json
    Tableau 23. En-têtes de réponses
    En-tête Description
    Type de contenu Le type de contenu de la réponse. Pour les demandes de métadonnées, il s’agit du type de contenu des métadonnées, et non du type de contenu des fichiers en pièce jointe.

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 24. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    404 Indique que la pièce jointe spécifiée n’existe pas ou que l’utilisateur actuel ne peut pas y accéder.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse (JSON ou XML)

    Nom Description
    Métadonnées spécifiques à la pièce jointe spécifiée.

    Demande cURL

    curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
    {
  "result": {
    "table_sys_id": "5054b6f8c0a800060056addcf551ecf8",
    "size_bytes": "462",
    "download_link": "https://instance.service-now.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file",
    "sys_updated_on": "2009-05-21 04:12:21",
    "sys_id": "615ea769c0a80166001cf5f2367302f5",
    "image_height": "",
    "sys_created_on": "2009-05-21 04:12:21",
    "file_name": "blocks.swf",
    "sys_created_by": "glide.maint",
    "compressed": "true",
    "average_image_color": "",
    "sys_updated_by": "glide.maint",
    "sys_tags": "",
    "table_name": "content_block_programmatic",
    "image_width": "",
    "sys_mod_count": "0",
    "content_type": "application/x-shockwave-flash",
    "size_compressed": "485"
  }
}

    Pièce jointe : POST /now/attachment/file

    Charge un fichier binaire spécifié en tant que pièce jointe à un enregistrement spécifié.

    Remarque :
    Le fichier à joindre doit être spécifié après le dernier paramètre de la liste des paramètres de demande transmis.

    Format d'URL

    URL versionnée : /api/now/v1/attachment/file

    URL par défaut : /api/now/attachment/file

    Paramètres de demande pris en charge

    Tableau 25. Paramètres de chemin d'accès
    Nom Description
    Aucun
    Tableau 26. Paramètres de requête
    Nom Description
    encryption_context Sys_id d’un enregistrement de contexte de chiffrement. Spécifiez ce paramètre pour autoriser uniquement les utilisateurs avec le contexte de chiffrement spécifié à accéder à la pièce jointe. Pour plus d’informations sur les enregistrements de contexte de chiffrement, reportez-vous à la section Column Level Encryption.

    Type de données : chaîne

    Par défaut : le fichier est chiffré à l’aide d’un contexte de chiffrement accessible à l’utilisateur, sinon le fichier joint n’est chiffré à l’aide d’aucun contexte de chiffrement.
    file_name Requis. Nom à donner à la pièce jointe.

    Type de données : chaîne
    table_name Requis. Nom de la table à laquelle joindre le fichier.

    Type de données : chaîne
    table_sys_id Requis. Sys_id de l’enregistrement dans la table spécifiée dans table_name laquelle vous souhaitez joindre le fichier.

    Type de données : chaîne
    Tableau 27. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    <chaîne> Chemin d’accès au fichier binaire à joindre à l’enregistrement spécifié.

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 28. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json
    Type de contenu Type de contenu du fichier à joindre, tel que image/jpeg ou */*. Cet en-tête est obligatoire pour publier les pièces jointes.
    Tableau 29. En-têtes de réponses
    En-tête Description
    Emplacement URL de la nouvelle pièce jointe.

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 30. Codes d'état
    Code d'état Description
    201 Indique que la requête a été exécutée avec succès.
    400 Indique qu’un ou plusieurs paramètres obligatoires étaient manquants dans la demande.
    404 Indique que l’enregistrement spécifié par les paramètres and table_sys_id n’existe table_name pas ou n’est pas accessible à l’utilisateur actuel.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse (JSON ou XML)

    Élément Description
    résultat Métadonnées de la pièce jointe demandée.

    Type de données : objet

    "result": {
  "average_image_color": "String",
  "compressed": "String", 
  "content_type": "String",
  "created_by_name": "String",
  "download_link": "String",
  "file_name": "String",
  "image_height": "String",
  "image_width": "String",
  "size_bytes": "String",
  "size_compressed": "String",
  "sys_created_by": "String",
  "sys_created_on": "String",
  "sys_id": "String",
  "sys_mod_count": "String",
  "sys_tags": "String",
  "sys_updated_by": "String",
  "sys_updated_on": "String",
  "table_name": "String",
  "table_sys_id": "String",
  "updated_by_name": "String"
}
    result.average_image_color Si la pièce jointe est une image, la somme de toutes les couleurs.

    Type de données : chaîne

    Unité : RVB ou nombre de pixels.
    résultat.compressé Marqueur indiquant si le fichier joint a été compressé.
    Valeurs valides :
    • true : le fichier a été compressé.
    • faux : le fichier n’a pas été compressé.

    Type de données : chaîne
    result.content_type Type de contenu du fichier joint associé, par exemple image, jpeg ou application/x-shockwave-flash.

    Type de données : chaîne
    result.created_by_name Nom complet de l’entité qui a créé le fichier joint à l’origine.

    Type de données : chaîne
    result.download_link URL de téléchargement de la pièce jointe sur l’instance ServiceNow .

    Type de données : chaîne
    result.file_name Nom du fichier de la pièce jointe.

    Type de données : chaîne
    result.image_height S’il s’agit d’un fichier image, la hauteur de l’image.

    Type de données : chaîne

    Unité : Pixels
    result.image_width S’il s’agit d’un fichier image, la largeur de l’image.

    Type de données : chaîne

    Unité : Pixels
    result.size_bytes Taille de la pièce jointe.

    Type de données : chaîne

    Unité : octets
    result.size_compressed Taille du fichier compressé en pièce jointe. Si le fichier n’est pas compressé, vide.

    Type de données : chaîne

    Unité : octets
    result.sys_created_by Entité qui a créé le fichier de pièce jointe à l’origine.

    Type de données : chaîne
    result.sys_created_on Date et heure auxquelles le fichier de pièce jointe a été initialement enregistré dans l’instance.

    Type de données : chaîne
    result.sys_id Sys_id du fichier joint.

    Type de données : chaîne
    result.sys_mod_count Nombre de fois où le fichier joint a été modifié (chargé sur l’instance).

    Type de données : chaîne
    result.sys_balises Toutes les balises système associées au fichier en pièce jointe.

    Type de données : chaîne
    result.sys_updated_by Entité qui a mis à jour le fichier de pièce jointe pour la dernière fois.

    Type de données : chaîne
    result.sys_updated_on Date et heure de la dernière mise à jour du fichier en pièce jointe.

    Type de données : chaîne
    result.table_name Nom de la table à laquelle la pièce jointe est associée.

    Type de données : chaîne
    result.table_sys_id Sys_id de la table associée à la pièce jointe.

    Type de données : chaîne
    result.updated_by_name Nom complet de l’entité qui a mis à jour le fichier joint pour la dernière fois.

    Type de données : chaîne

    Demande cURL

    curl "https://instance.servicenow.com/api/now/attachment/file?table_name=incident&table_sys_id=d71f7935c0a8016700802b64c67c11c6&file_name=Issue_screenshot" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type: image/jpeg" \
--user "username":"password" \
--data-binary "@ location of the file on file system"
    {
  "result": {
    "table_sys_id": "d71f7935c0a8016700802b64c67c11c6",
    "size_bytes": "36597",
    "download_link": "https://instance.servicenow.com/api/now/attachment/6ea10fe64f411200adf9f8e18110c739/file",
    "sys_updated_on": "2016-01-22 15:14:07",
    "sys_id": "6ea10fe64f411200adf9f8e18110c739",
    "image_height": "",
    "sys_created_on": "2016-01-22 15:14:07",
    "file_name": "Issue_screenshot",
    "sys_created_by": "admin",
    "compressed": "true",
    "average_image_color": "",
    "sys_updated_by": "admin",
    "sys_tags": "",
    "table_name": "incident",
    "image_width": "",
    "sys_mod_count": "0",
    "content_type": "image/jpeg",
    "size_compressed": "25130"
  }
}

    Pièce jointe : POST /now/attachment/upload

    Charge une pièce jointe de fichier partitionné.

    La méthode POST en plusieurs parties n’accepte aucun paramètre. Vous devez spécifier le nom de la table et les valeurs sys_id enregistrement dans le corps du formulaire. Consultez l’exemple cURL pour obtenir un exemple de requête en plusieurs parties/form-data.

    Important :
    Lors de l’auto-test de démarrage (POST) en plusieurs parties, assurez-vous que le contenu du fichier ne figure que dans la partie finale du message. Les parties antérieures doivent contenir uniquement des métadonnées telles que le nom de la table et le sys_id d’enregistrement.

    Format d'URL

    URL versionnée : /api/now/v1/attachment/upload

    URL par défaut : /api/now/attachment/upload

    Paramètres de demande pris en charge

    Tableau 31. Paramètres de chemin d'accès
    Nom Description
    Aucun
    Tableau 32. Paramètres de requête
    Nom Description
    Aucun
    Tableau 33. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 34. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json
    Type de contenu Type de contenu de la demande. Définissez cette valeur sur multipart/form-data lors de l’utilisation de la méthode POST en plusieurs parties.
    Tableau 35. En-têtes de réponses
    En-tête Description
    Emplacement URL de la nouvelle pièce jointe.

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 36. Codes d'état
    Code d'état Description
    201 Indique que la requête a été exécutée avec succès.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    404 Introuvable. L’élément demandé est introuvable.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse (JSON ou XML)

    Élément Description
    résultat Métadonnées de la pièce jointe demandée.

    Type de données : objet

    "result": {
  "average_image_color": "String",
  "compressed": "String", 
  "content_type": "String",
  "created_by_name": "String",
  "download_link": "String",
  "file_name": "String",
  "image_height": "String",
  "image_width": "String",
  "size_bytes": "String",
  "size_compressed": "String",
  "sys_created_by": "String",
  "sys_created_on": "String",
  "sys_id": "String",
  "sys_mod_count": "String",
  "sys_tags": "String",
  "sys_updated_by": "String",
  "sys_updated_on": "String",
  "table_name": "String",
  "table_sys_id": "String",
  "updated_by_name": "String"
}
    result.average_image_color Si la pièce jointe est une image, la somme de toutes les couleurs.

    Type de données : chaîne

    Unité : RVB ou nombre de pixels.
    résultat.compressé Marqueur indiquant si le fichier joint a été compressé.
    Valeurs valides :
    • true : le fichier a été compressé.
    • faux : le fichier n’a pas été compressé.

    Type de données : chaîne
    result.content_type Type de contenu du fichier joint associé, par exemple image, jpeg ou application/x-shockwave-flash.

    Type de données : chaîne
    result.created_by_name Nom complet de l’entité qui a créé le fichier joint à l’origine.

    Type de données : chaîne
    result.download_link URL de téléchargement de la pièce jointe sur l’instance ServiceNow .

    Type de données : chaîne
    result.file_name Nom du fichier de la pièce jointe.

    Type de données : chaîne
    result.image_height S’il s’agit d’un fichier image, la hauteur de l’image.

    Type de données : chaîne

    Unité : Pixels
    result.image_width S’il s’agit d’un fichier image, la largeur de l’image.

    Type de données : chaîne

    Unité : Pixels
    result.size_bytes Taille de la pièce jointe.

    Type de données : chaîne

    Unité : octets
    result.size_compressed Taille du fichier compressé en pièce jointe. Si le fichier n’est pas compressé, vide.

    Type de données : chaîne

    Unité : octets
    result.sys_created_by Entité qui a créé le fichier de pièce jointe à l’origine.

    Type de données : chaîne
    result.sys_created_on Date et heure auxquelles le fichier de pièce jointe a été initialement enregistré dans l’instance.

    Type de données : chaîne
    result.sys_id Sys_id du fichier joint.

    Type de données : chaîne
    result.sys_mod_count Nombre de fois où le fichier joint a été modifié (chargé sur l’instance).

    Type de données : chaîne
    result.sys_balises Toutes les balises système associées au fichier en pièce jointe.

    Type de données : chaîne
    result.sys_updated_by Entité qui a mis à jour le fichier de pièce jointe pour la dernière fois.

    Type de données : chaîne
    result.sys_updated_on Date et heure de la dernière mise à jour du fichier en pièce jointe.

    Type de données : chaîne
    result.table_name Nom de la table à laquelle la pièce jointe est associée.

    Type de données : chaîne
    result.table_sys_id Sys_id de la table associée à la pièce jointe.

    Type de données : chaîne
    result.updated_by_name Nom complet de l’entité qui a mis à jour le fichier joint pour la dernière fois.

    Type de données : chaîne

    PUBLIER les valeurs obligatoires en plusieurs parties

    Lors de l’envoi d’une demande POST en plusieurs parties pour charger une pièce jointe, incluez les données de la pièce jointe dans le corps du message, et non dans les paramètres d’URL. Vous devez spécifier ces valeurs dans le corps du message :
    Tableau 37. Valeurs obligatoires
    Valeur Description
    Type de contenu Type de contenu du fichier, inclus dans le corps du message pour les téléchargements en plusieurs parties.
    Remarque :
    Le type de contenu doit être défini dans la partie fichier du message POST, et non dans les données du formulaire. Consultez l’exemple de message en plusieurs parties POST pour obtenir un exemple de message en plusieurs parties.

    Type de données : chaîne
    table_name Nom de la table à laquelle vous souhaitez joindre le fichier.

    Type de données : chaîne
    table_sys_id Sys_id de l’enregistrement sur la table spécifiée à laquelle vous souhaitez joindre le fichier.

    Type de données : chaîne

    Demande cURL

    curl "https://instance.servicenow.com/api/now/attachment/upload" \
--request POST \
--header "Accept:application/json"\
--user "username":"password"\
--header "Content-Type:multipart/form-data"\
 -F 'table_name=incident' \
 -F 'table_sys_id=d71f7935c0a8016700802b64c67c11c6'\
 -F 'uploadFile=@ location of the file on file system'
\
    {
  "result": {
    "table_sys_id": "d71f7935c0a8016700802b64c67c11c6",
    "size_bytes": "36597",
    "download_link": "https://instance.service-now.com/api/now/attachment/994adbc64f511200adf9f8e18110c796/file",
    "sys_updated_on": "2016-02-02 14:00:21",
    "sys_id": "994adbc64f511200adf9f8e18110c796",
    "image_height": "",
    "sys_created_on": "2016-02-02 14:00:21",
    "file_name": "banner-CS0001345_v1_1.jpeg",
    "sys_created_by": "admin",
    "compressed": "true",
    "average_image_color": "",
    "sys_updated_by": "admin",
    "sys_tags": "",
    "table_name": "incident",
    "image_width": "",
    "sys_mod_count": "0",
    "content_type": "image/jpeg",
    "size_compressed": "25130"
  }
}