---
sourceDocument: Interface do usuário da Now Platform Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-user-interface

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interface do usuário da Now Platform Yokohama

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Anexando arquivos a registros das páginas do portal

# Anexando arquivos a registros das páginas do portal {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura

Os anexos podem ser adicionados a registros das páginas do portal navegando pelo sistema de arquivos, colando arquivos da área de transferência ou arrastando e soltando arquivos.

Por padrão, vários widgets do sistema base aceitam anexos de usuários do portal usando um ou mais desses métodos. Para modificar como os usuários do portal podem adicionar anexos, você pode clonar e editar widgets para personalizar a experiência de anexo de arquivo conforme descrito nos procedimentos a seguir.

Para acompanhar como os usuários do portal anexam arquivos a registros de páginas em seu portal, consulte o evento Anexar arquivo SP em Análise da experiência do usuáriopara Portal de serviços. Para obter mais informações sobre eventos disponíveis, consulte [Portal de serviços eventos](https://servicenow-prod.fluidtopics.net/drvXVOgU1fQXavDnIXkpeA "Exibição Portal de serviçoseventos para obter informações sobre como um portal está sendo usado em sua organização.").

## Adicione anexos colando ou soltando arquivos {#ariaid-title2}

Permita que os usuários do portal anexem arquivos colando ou soltando arquivos na caixa de diálogo Adicionar anexos.

### Antes de Iniciar

Por padrão, os widgets do sistema base Formulário, Anexos de tíquete, Conversas de tíquete e Item do catálogo SC são compatíveis com a adição de anexos colando ou soltando arquivos na caixa de diálogo Adicionar anexos, em vez de apenas navegar pelo sistema de arquivos.

Para configurar esta funcionalidade para outros widgets, você pode clonar ou criar um widget que ofereça suporte à adição de anexos com o. `sp-attachment-button `diretiva. Para obter mais informações sobre clonagem de widgets, consulte [Clone um widget](https://servicenow-prod.fluidtopics.net/M1xLK~1NlVn7RPA~cbwRzA "Aproveite o código existente clonando e editando um widget existente.").  
Nota:  
Os widgets do sistema base são somente leitura para que você possa se beneficiar de atualizações futuras. Para fazer mudanças, você pode clonar widgets do sistema de base. No entanto, os widgets clonados são considerados personalizados e não se beneficiam de atualizações futuras dos widgets dos quais foram clonados.

Função necessária: sp_admin ou administrador

### Procedimento

1. Navegar até TudoPortal de serviçosConfiguração do Portal de serviços.
2. Selecione Editor de widget .
3. No menu Editar um widget existente, selecione o widget que você clonou.
4. Em Modelo HTML do widget, localize o. `sp-attachment-button `elemento.
5. Configure atributos para `sp-attachment-button `elemento.  
   * `modal `: Habilita o suporte copiar-colar e arrastar e soltar quando definido como `verdadeiro `.

     Para desativar o suporte copiar-colar e arrastar e soltar, defina-o como `falso `.
   * `extensões compatíveis `: Exibe uma lista de extensões de arquivo compatíveis para anexos na parte inferior da caixa de diálogo Adicionar anexos.

     Para listar as extensões de arquivo compatíveis especificadas pelo glide.attachment.extensionspropriedade do sistema, defina-a como `::data.supportedAttachmentExtensions) `.
   {#add-attachments-pasting-dropping-files__ul_j4v_2wf_sxb}  

       <sp-attachment-button modal="true" supported-extensions="{{::data.supportedAttachmentExtensions}}"></sp-attachment-button>

6. Selecione Salvar.

### Resultado

Em uma página com o widget, você pode colar ou soltar arquivos sobre a caixa de diálogo Adicionar anexo para anexá-los ao registro, conforme mostrado no exemplo a seguir.  
Nota:  
Esta funcionalidade não é compatível com experiências móveis. Não há suporte para colar anexos no Firefox.

## Adicione uma zona de arrastar e soltar para anexar arquivos {#ariaid-title3}

Permita que os usuários do portal soltem anexos em uma zona dedicada de uma página para anexar arquivos rapidamente a um registro.

### Antes de Iniciar

Para configurar uma zona de anexos de arrastar e soltar em uma página, você deve clonar ou criar um widget que ofereça suporte à adição de anexos chamando `AttachmentHandler `definido como uma instância de `Now AttachmentHandler `em seu client script. Para obter um exemplo de um widget como este, consulte [Widget de formulário](https://servicenow-prod.fluidtopics.net/gbN8Zly0h7WCeomZeQQWig "O widget de formulário é um formulário de plataforma no Portal de serviçosIU com algumas diferenças. Você pode usar este widget do sistema de base como está no portal ou cloná-lo para atender às suas próprias necessidades de negócios."). Para obter mais informações sobre clonagem de widgets, consulte [Clone um widget](https://servicenow-prod.fluidtopics.net/M1xLK~1NlVn7RPA~cbwRzA "Aproveite o código existente clonando e editando um widget existente.").  
Nota:  
Os widgets do sistema base são somente leitura para que você possa se beneficiar de atualizações futuras. Para fazer mudanças, você pode clonar widgets do sistema de base. No entanto, os widgets clonados são considerados personalizados e não se beneficiam de atualizações futuras dos widgets dos quais foram clonados.

Função necessária: sp_admin ou administrador

### Por Que e Quando Desempenhar Esta Tarefa

Por padrão, os usuários do portal podem adicionar anexos em muitas páginas do sistema base selecionando o ícone Adicionar anexos ( ![Ícone de anexo]()) Para abrir a caixa de diálogo Adicionar anexos. Com uma zona de anexos de arrastar e soltar, os usuários do portal podem adicionar anexos com menos cliques. Por exemplo, você pode soltar anexos sobre uma área de uma solicitação de catálogo ou um formulário.  
Neste exemplo, a zona é uma área sobre o corpo de um widget de formulário. A zona só fica visível ao mover um arquivo sobre ela.Figura 1. Zona de anexo sobre um widget

### Procedimento

1. Navegar até TudoPortal de serviçosConfiguração do Portal de serviços.
2. Selecione Editor de widget .
3. No menu Editar um widget existente, selecione o widget que você clonou para adicionar a zona de anexo.
4. Em Modelo HTML do widget, adicione o. `Attachment-picker attachment-handler: "AttachmentHandler" `diretiva como um atributo de a. `<div>`ou `<section>`elemento.  
   A zona pode incluir o widget inteiro ou apenas parte dele.  

       <div sp-attachment-picker attachment-handler="attachmentHandler">

5. **Opcional:** Configure atributos para `sp-attachment-picker `diretiva.  
   * `disable-picker-overlay: "verdadeiro" `: Desativa a exibição de uma sobreposição sobre a zona de anexo quando você arrasta um arquivo sobre ela. Por padrão, a sobreposição está habilitada.
   * `OnFilePick `: Implementa a lógica personalizada acionando um evento quando qualquer arquivo é selecionado. Defina o valor como uma função que usa as referências de todos os arquivos selecionados como uma matriz como o primeiro parâmetro. Por exemplo, `"Arquivo-pick" `. Exemplos de lógica personalizada que podem ser implementados incluem a visualização de arquivos, validações personalizadas ou lógica de carregamento personalizada. Se este atributo estiver configurado, o. `Attachment-handler: "AttachmentHandler" `o atributo não é necessário e pode ser removido.
   {#add-attachments-zone-to-page__ul_g11_xlw_cxb}
6. **Opcional:** Oculte a zona de anexo em dispositivos móveis.
   1. Adicione o. `"IsDesktopBrowser" `diretiva para `sp-attachment-picker `diretiva.  

          <div sp-attachment-picker attachment-handler="attachmentHandler" ng-if="isDesktopBrowser">

   2. Em Script do cliente do widget, adicione o script a seguir.  

          $scope.isNative = cabrillo.isNative();
          $scope.isMobileBrowser = spUtil.isMobile() && !$scope.isNative;
          $scope.isDesktopBrowser = !$scope.isNative && !$scope.isMobileBrowser;

   {#add-attachments-zone-to-page__substeps_wm1_kgf_sxb}
7. Selecione Salvar.

### Resultado

Em uma página com o widget, você pode arrastar um ou mais arquivos selecionados sobre a zona de anexo e soltá-los para anexá-los ao registro.

## Adicione uma seção de anexos a um widget {#ariaid-title4}

Permita que os usuários do portal colem, soltem ou naveguem até arquivos em uma seção de um widget para anexar arquivos rapidamente a um registro.

### Antes de Iniciar

Para configurar uma seção de anexos em um widget, você deve clonar ou criar um widget que ofereça suporte à adição de anexos chamando `AttachmentHandler `definido como uma instância de `Now AttachmentHandler `em seu client script. Para obter um exemplo de um widget como este, consulte [Widget de formulário](https://servicenow-prod.fluidtopics.net/gbN8Zly0h7WCeomZeQQWig "O widget de formulário é um formulário de plataforma no Portal de serviçosIU com algumas diferenças. Você pode usar este widget do sistema de base como está no portal ou cloná-lo para atender às suas próprias necessidades de negócios."). Para obter mais informações sobre clonagem de widgets, consulte [Clone um widget](https://servicenow-prod.fluidtopics.net/M1xLK~1NlVn7RPA~cbwRzA "Aproveite o código existente clonando e editando um widget existente.").  
Nota:  
Os widgets do sistema base são somente leitura para que você possa se beneficiar de atualizações futuras. Para fazer mudanças, você pode clonar widgets do sistema de base. No entanto, os widgets clonados são considerados personalizados e não se beneficiam de atualizações futuras dos widgets dos quais foram clonados.

Função necessária: sp_admin ou administrador

### Por Que e Quando Desempenhar Esta Tarefa

Por padrão, os usuários do portal podem adicionar anexos em muitas páginas do sistema base selecionando o ícone Adicionar anexos ( ![Ícone de anexo]()) Para abrir a caixa de diálogo Adicionar anexos. Com uma seção Anexos, os usuários do portal podem adicionar anexos com menos cliques.  
Neste exemplo, a seção Anexos é adicionada à parte inferior de um widget de item do catálogo.Figura 2. Seção de anexo em um widget

### Procedimento

1. Navegar até TudoPortal de serviçosConfiguração do Portal de serviços.
2. Selecione Editor de widget .
3. No menu Editar um widget existente, selecione o widget que você clonou para adicionar a seção de anexo.
4. Em Modelo HTML do widget, adicione o. `sp-attachment-picker `diretiva como um elemento em que você deseja que a seção anexos apareça.  

       <sp-attachment-picker attachment-handler="attachmentHandler"></sp-attachment-picker>

5. **Opcional:** Configure atributos para `sp-attachment-picker `diretiva.  
   * `disable-picker-overlay: "verdadeiro" `: Desativa a exibição de uma sobreposição sobre a seção de anexo quando você arrasta um arquivo sobre ela. Por padrão, a sobreposição está habilitada.
   * `OnFilePick `: Implementa a lógica personalizada acionando um evento quando qualquer arquivo é selecionado. Defina o valor como uma função que usa as referências de todos os arquivos selecionados como uma matriz como o primeiro parâmetro. Por exemplo, `"Arquivo-pick" `. Exemplos de lógica personalizada que podem ser implementados incluem a visualização de arquivos, validações personalizadas ou lógica de carregamento personalizada.
   {#add-attachments-section-widget__ul_g11_xlw_cxb}
6. **Opcional:** Oculte a seção de anexo em dispositivos móveis.
   1. Adicione o. `"IsDesktopBrowser" `diretiva para `sp-attachment-picker `diretiva.  

          <sp-attachment-picker attachment-handler="attachmentHandler" ng-if="isDesktopBrowser"></sp-attachment-picker>

   2. Em Script do cliente do widget, adicione o script a seguir.  

          $scope.isNative = cabrillo.isNative();
          $scope.isMobileBrowser = spUtil.isMobile() && !$scope.isNative;
          $scope.isDesktopBrowser = !$scope.isNative && !$scope.isMobileBrowser;

   {#add-attachments-section-widget__substeps_wm1_kgf_sxb}
7. Selecione Salvar.

### Resultado

Em uma página com o widget, você pode colar ou soltar um ou mais arquivos selecionados sobre a seção de anexo para anexá-los ao registro.  
Nota:  
Não há suporte para colar anexos no Firefox.

