---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# cabrillo.attachments - cliente

# cabrillo.attachments - cliente {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

O namespace para Cabrillo JS funções de anexo. Isso permite adicionar e exibir anexos.

## cabrillo.attachments - addFile(cadeia de caracteres "tableName", cadeia de caracteres sysId, parâmetros de objeto, opções de cadeia de caracteres) {#ariaid-title2}

Apresenta um seletor de documentos e carrega o arquivo selecionado.
Importante:  
Este método está obsoleto. Em vez disso, use o método [addFiles()](https://servicenow-prod.fluidtopics.net/Cmb_PLnnBnCp_FWnM_Wz~A#CA-addFiles_S_S_O_S "Apresenta um seletor de documentos para selecionar e carregar arquivos.").
{#CA-addFile_S_S_O_S__table_yt5_3qw_2bb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tableName | Cadeia de caracteres | Nome da tabela do registro ao qual o anexo será anexado. |
| sysID | Cadeia de caracteres | O sys_id do registro ao qual o anexo será anexado. |
| parâms | Objeto | Não usado. Defina como nulo. |
| opções | Cadeia de caracteres | Não usado. Defina como nulo. |
[Tabela 1. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| promessa | Se for bem-sucedido, um objeto Cabrillo.Attachment. Se a operação falhar, um erro. |
[Tabela 2. Retorna]

{#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(cadeia de caracteres "tableName", cadeia de caracteres sysId, parâmetros de objeto, opções de objeto) {#ariaid-title3}

Apresenta um seletor de documentos para selecionar e carregar arquivos.
{#CA-addFiles_S_S_O_S__table_yt5_3qw_2bb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tableName | Cadeia de caracteres | Nome da tabela que contém o registro ao qual o arquivo será anexado. |
| sysID | Cadeia de caracteres | Sys_id do registro ao qual o arquivo será anexado. |
| parâms | Objeto | Opcional. Reservado para uso futuro. Defina como nulo. |
| opções | Objeto | Opcional. Configurações adicionais para carregar arquivos. { "isSingleSelection": Boolean } |
| opções.éSingleSelection | Booliano | Opcional. Sinalizador que indica se o seletor de documentos para carregar arquivos permite a seleção múltipla. Valores válidos: * verdadeiro: somente um arquivo para carregar pode ser selecionado por vez. * falso: vários arquivos para carregar podem ser selecionados de uma só vez. {#CA-addFiles_S_S_O_S__ul_nkl_n4f_xwb} Padrão: falso |
[Tabela 3. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Promessa | Contém anexos criados com sucesso e erros. Se vários arquivos forem selecionados, um Cabrillo.Attachment será criado para cada arquivo carregado com sucesso, enquanto uma mensagem de erro será gerada para cada carregamento malsucedido. Tipo de dados: objeto { "attachments": [Array], "errors": [Array] } |
| Promessa.anexos | Contém todos os anexos criados com sucesso. Tipo de dados: matriz "attachments": [Cabrillo.Attachment] |
| Promessa.erros | Contém erros. Tipo de dados: matriz "errors": ["String"] |
[Tabela 4. Retorna]

{#CA-addFiles_S_S_O_S__table_wgq_ynf_xwb}  
Este exemplo cria um botão para adicionar vários anexos a um registro de incidente e verifica se há erros de carregamento.

    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.Anexo de anexo, Cabrillo.Rect sourceRect, String sourceBase64Image) {#ariaid-title4}

Apresenta um seletor de documentos e carrega o arquivo selecionado.
Nota:  
O escalonamento usando um parâmetro sourceRect com uma imagem sourceBase64 só tem suporte no iOS. O Android ignora esses parâmetros e abre a imagem sem uma animação de escalonamento.
{#CA-viewFile_CA_CR_S__table_wvb_ybf_wbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| anexo | Cabrillo.Anexo | Descreve o anexo a ser exibido. |
| sourceRect | Cabrillo.Rect | Opcional. Descreve o retângulo de origem da imagem a ser escalonada. |
| sourceBase64Image | Cadeia de caracteres | Opcional. Uma representação em base64 da imagem de origem a ser escalonada. |
[Tabela 5. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| promessa | Se for bem-sucedido, um objeto não resolvido, caso contrário, um erro. |
[Tabela 6. Retorna]

{#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);
    });

Para dimensionar uma imagem que foi tocada em um visualizador de imagens nativo, o método viewFile() aceita argumentos opcionais para o retângulo da imagem na página, bem como uma miniatura codificada em base64 da imagem. A miniatura é dimensionada para a imagem em tamanho real com uma animação.

    // 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);
    });