Anexando arquivos a registros das páginas do portal

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 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.

    Adicione anexos colando ou soltando arquivos

    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.

    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é Tudo > Portal de serviços > Configuraçã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) .

      <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.

    Opção para escolher, soltar ou colar arquivos na caixa de diálogo Adicionar anexos

    Adicione uma zona de arrastar e soltar para anexar arquivos

    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. Para obter mais informações sobre clonagem de widgets, consulte Clone um widget.

    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
    Arrastar um arquivo sobre a zona de anexo em um widget de formulário

    Procedimento

    1. Navegar até Tudo > Portal de serviços > Configuraçã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.
    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;
    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

    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. Para obter mais informações sobre clonagem de widgets, consulte Clone um widget.

    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
    Uma seção para adicionar anexos no widget de item do catálogo

    Procedimento

    1. Navegar até Tudo > Portal de serviços > Configuraçã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.
    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;
    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.