---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# cabrillo.attachments : client

# cabrillo.attachments : client {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture

Espace de noms pour Cabrillo JS les fonctions de pièce jointe. Cela permet d'ajouter et d'afficher des pièces jointes.

## cabrillo.attachments - addFile(String tableName, String sysId, Object params, Options de chaîne) {#ariaid-title2}

Présente un sélecteur de document et télécharge le fichier sélectionné.
Important :  
Cette méthode est obsolète. Utilisez plutôt la méthode [addFiles().](https://servicenow-prod.fluidtopics.net/JVYRe3bUCsgEue7NOqbEyA#CA-addFiles_S_S_O_S "Présente un sélecteur de document permettant de sélectionner et de charger des fichiers.")
{#CA-addFile_S_S_O_S__table_yt5_3qw_2bb__entry__3}

| Nom | Type | Description |
|-|-|-|
| tableName | Chaîne | Nom de la table de l'enregistrement auquel joindre la pièce jointe. |
| sysID | Chaîne | La sys_id de l'enregistrement à laquelle joindre la pièce jointe. |
| paramètres | Objet | Inutilisé. Défini sur null. |
| options | Chaîne | Inutilisé. Défini sur null. |
[Tableau 1. Paramètres]

{#CA-addFile_S_S_O_S__table_yt5_3qw_2bb} {#CA-addFile_S_S_O_S__table_zt5_3qw_2bb__entry__2}

| Type | Description |
|-|-|
| promesse | En cas de succès, un objet Cabrillo.Attachment. En cas d'échec de l'opération, une erreur se produit. |
[Tableau 2. Renvoie]

{#CA-addFile_S_S_O_S__table_zt5_3qw_2bb}  

    var table = 'incident';
    var sysID = 'a9e30c7dc61122760116894de7bcc7bd';

    cabrillo.attachments.addFile(table,
        sysID, 
        null,
        null
    ).then(function(attachment) {
        if (attachment) {
            console.log('Added a new file.', attachment);
        } else {
            console.log('User cancelled adding an attachment.');
        }
    }, function(error) {
        console.log('Failed to attach new file.', error);
    });

## cabrillo.attachments - addFiles(String tableName, String sysId, Object params, Object options) {#ariaid-title3}

Présente un sélecteur de document permettant de sélectionner et de charger des fichiers.
{#CA-addFiles_S_S_O_S__table_yt5_3qw_2bb__entry__3}

| Nom | Type | Description |
|-|-|-|
| tableName | Chaîne | Nom de la table qui contient l'enregistrement auquel joindre le fichier. |
| sysID | Chaîne | Sys_id de l'enregistrement auquel joindre le fichier. |
| paramètres | Objet | Facultatif. Réservé pour une utilisation future. Défini sur null. |
| options | Objet | Facultatif. Paramètres supplémentaires pour le chargement des fichiers. { "isSingleSelection": Boolean } |
| options.isSingleSelection | Booléen | Facultatif. Marqueur indiquant si le sélecteur de documents pour le chargement des fichiers autorise la sélection multiple. Valeurs valides : * vrai : un seul fichier à charger peut être sélectionné à la fois. * false : plusieurs fichiers à charger peuvent être sélectionnés simultanément. {#CA-addFiles_S_S_O_S__ul_nkl_n4f_xwb} Valeur par défaut : false |
[Tableau 3. Paramètres]

{#CA-addFiles_S_S_O_S__table_yt5_3qw_2bb} {#CA-addFiles_S_S_O_S__table_wgq_ynf_xwb__entry__2}

| Type | Description |
|-|-|
| Promesse | Contient les pièces jointes créées avec succès et toutes les erreurs. Si plusieurs fichiers ont été sélectionnés, une pièce jointe Cabrillo est créée pour chaque fichier téléchargé avec succès tandis qu'un message d'erreur est généré pour chaque téléchargement infructueux. Type de données : objet { "attachments": [Array], "errors": [Array] } |
| Promesse.pièces jointes | Contient toutes les pièces jointes créées avec succès. Type de données : tableau "attachments": [Cabrillo.Attachment] |
| Erreurs.promesses | Contient toutes les erreurs. Type de données : tableau "errors": ["String"] |
[Tableau 4. Renvoie]

{#CA-addFiles_S_S_O_S__table_wgq_ynf_xwb}  
Cet exemple crée un bouton permettant d'ajouter plusieurs pièces jointes à un enregistrement d'incident et vérifie les erreurs de chargement.

    this.attachMultipleFilesButton = function() {
       c.log("Attempting to add multiple attachments to INC0010453");
       var table = 'incident';
       var sysID = 'fc74aefa1bfb2c10181499f1b24bcb3c';

       cabrillo.attachments.addFiles(table, sysID).then(function(result) {
          if (result) {
             handleMultipleResult(result)
          } else {
             c.log('User cancelled adding an attachment.');
          }
       }, function(error) {
          c.log('Failed to attach new files.', error);
       });
    }

    // A helper function to handle addFiles results 
    function handleMultipleResult(result) {
       c.log('Added multiple attachments.', result);
       if (result.attachments) {
          c.log('Number of new attachments', result.attachments.length);
       }
       if (result.errors) {
          c.log('Number of errors during upload', result.errors.length);
       }
    }

## cabrillo.attachments -viewFile(Cabrillo.Attachment attachment, Cabrillo.Rect sourceRect, String sourceBase64Image) {#ariaid-title4}

Présente un sélecteur de document et télécharge le fichier sélectionné.
Remarque :  
La mise à l'échelle à l'aide d'un paramètre sourceRect avec une image sourceBase64 n'est prise en charge que sur iOS. Android ignore ces paramètres et ouvre l'image sans animation de mise à l'échelle.
{#CA-viewFile_CA_CR_S__table_wvb_ybf_wbb__entry__3}

| Nom | Type | Description |
|-|-|-|
| attachment | Cabrillo.Pièce jointe | Décrit la pièce jointe à afficher. |
| sourceRect (en anglais seulement) | Cabrillo.Rect | Facultatif. Décrit le rectangle source de l'image à mettre à l'échelle. |
| sourceBase64Image | Chaîne | Facultatif. Représentation base64 de l'image source à mettre à l'échelle. |
[Tableau 5. Paramètres]

{#CA-viewFile_CA_CR_S__table_wvb_ybf_wbb} {#CA-viewFile_CA_CR_S__table_xvb_ybf_wbb__entry__2}

| Type | Description |
|-|-|
| promesse | En cas de succès, un objet non résolu, sinon une erreur. |
[Tableau 6. Renvoie]

{#CA-viewFile_CA_CR_S__table_xvb_ybf_wbb}  

    // A Cabrillo.Attachment dictionary to view
    var attachment = {
        sys_id: '8e99daa3ff133100ba13ffffffffff2d',
        content_type: 'image/jpeg',
        path: '8e99daa3ff133100ba13ffffffffff2d.iix'
    };

    cabrillo.attachments.viewFile(attachment,
        null,
        null
    ).then(function() {
        // It worked. Nothing to do here.
    }, function(error) {
        console.log('Failed to view file.', error);
    });

Pour mettre à l'échelle une image qui a été tapée dans une visionneuse d'images native, la méthode viewFile() accepte les arguments facultatifs pour le rectangle de l'image sur la page, ainsi qu'une miniature codée base64 de l'image. La vignette est mise à l'échelle de l'image en taille réelle avec une animation.

    // Grab image metadata from an image that was tapped
    var imageMetadata = imageMetadataFromEvent(event);

    // Optional rect of image on page
    var imageRect = imageMetadata.rect;

    // Optional base64 encoded image to scale up into native viewer
    var base64EncodedImage = imageMetadata.base64;

    // A Cabrillo.Attachment dictionary to view
    var attachment = {
        sys_id: '8e99daa3ff133100ba13ffffffffff2d',
        content_type: 'image/jpeg',
        path: '8e99daa3ff133100ba13ffffffffff2d.iix'
    }

    cabrillo.attachments.viewFile(attachment,
        imageRect,
        base64EncodedImage
    ).then(function() {
        // It worked. Nothing to do here.
    }, function(error) {
        console.log('Failed to view file.', error);
    });