Incorporando objetos em ações de formulário

Você pode projetar suas ações de formulário para exibir imagens ou arquivos PDF, para simplesmente personalizar a aparência com logotipos e ícones ou para fornecer materiais que possam ajudar os usuários do Action Center a concluir a ação.

This feature is available with the Create Form Task activity only.

Para incorporar objetos, você usa as propriedades na seção Armazenamento da atividade Create Form Task para vincular a um Bucket de armazenamento e a atividade Upload Storage File para adicionar arquivos.

Você pode incorporar qualquer tipo de objeto compatível com depósitos de armazenamento.

O vídeo abaixo mostra como um arquivo PDF incorporado se comporta no Action Center:

Pré-requisitos

Para usar os recursos de incorporação de objetos em ações de formulário, os usuários precisam das seguintes permissões:

Tipo de Usuário	Permissões
Action Center user	This user needs the following permissions at folder level: View for Storage Bucket and View for Storage File.
Robot user	This user needs the following permissions at folder level: View and Edit for Storage Bucket, and View and Create for Storage File.

Incorporando imagens de buckets de armazenamento

Para que os usuários do Action Center experimentem um melhor desempenho, recomendamos que você incorpore imagens que foram carregadas anteriormente em um Bucket de armazenamento.

Para incorporar uma imagem em uma ação de formulário:

1. Use activities, such as the Upload Storage File activity, to upload the image to the storage bucket that is used by the Create Form Task activity. As part of this step, create a String variable to store the path where the file is uploaded, for example imagePath.
   Importante:

   O upload do bucket de armazenamento converte o sinal + em um espaço, o que pode resultar em um erro durante a renderização do formulário.

2. In the Create Form Task activity, click the ellipsis (...) to the right of FormData and add an argument with the _storage keyword as a suffix:
   • Nome: image_storage.
   • Direction: In.
   • Type: String.
   • Valor: imagePath.
   Observação:

   The _storage keyword is used to indicate that this is an object that is available in the activity's storage bucket. For the value, we added the variable where we stored the path to the uploaded image.

   Dica:

   For images smaller than 2 KB, such as logos or icons, you can skip this step. In the following step where the image_storage argument is used, use the imagePath variable instead.

3. Add an HTML Element component and configure it as follows:
   • HTML Tag: div.
   • Content: <img src="{{ data.image_storage }}" />. This maps the storage file argument to the form component. Using the <img> tag displays the image in the form. Alternatively, you can use <a src="{{ data.image_storage }}" target=_blank> to add a link that opens the image in a new window.
   • Refresh On Change: selected.
   Observação:

   Você pode adicionar links para arquivos específicos referenciando-os na tag <a href="https://link-to-file"></a> . Você pode ignorar quaisquer erros de validação que aparecem no campo Conteúdo , eles não afetam a renderização do formulário no runtime.

Importante:

TIFF files are not supported inside Form Actions. As an alternative, try the following:

• Converta os arquivos TIFF em JPEG ou PNG antes de carregá-los em um depósito de armazenamento, usando atividades personalizadas dentro do fluxo de trabalho com o qual você está trabalhando.
• Faça referência ao arquivo dentro do depósito de armazenamento, usando uma tag <href> .

Fluxo de trabalho amostral

Para seguir as etapas do tutorial e experimentar por conta própria, baixe o fluxo de trabalho de exemplo.

Incorporando arquivos PDF de buckets de armazenamento

A incorporação de um arquivo PDF de um bucket de armazenamento é diferente para formulários regulares do que para formulários avançados. Os formulários avançados oferecem um desempenho de renderização melhorado e uso avançado dos componentes e sua lógica. Você pode criar formulários avançados selecionando Habilitar formulários avançados na atividade Criar tarefa de formulário .

Formas regulares

Você também pode adicionar arquivos PDF que foram carregados em um depósito de armazenamento a uma Ação de formulário para que os usuários da Action Center possam revisá-los.

Para incorporar um PDF em uma tarefa de formulário regular:

1. Use activities, such as the Upload Storage File activity, to upload the PDF file to the storage bucket that is used by the Create Form Task activity. As part of this step, create a String variable to store the path where the file is uploaded, for example docPath.
2. In the Create Form Task activity, click the ellipsis (...) to the right of FormData and add an argument with the _storage keyword as a suffix:
   • Nome: doc_storage.
   • Direction: In.
   • Type: String.
   • Valor: docPath.
     Importante:

     A palavra-chave _storage é usada para indicar que esse é um objeto que está disponível dentro do bucket de armazenamento da atividade. Para o valor, adicionamos a variável onde armazenamos o caminho para o arquivo PDF carregado.

3. Add an HTML Element component to the form and specify the following:
   • HTML Tag: div.
   • Content: <embed src={{ data.doc_storage }} width="600px" height="500px"></embed>.
   • Refresh On Change: cleared.
4. Save your changes and close the component window, to return to the Form Designer window.
5. Clique em Editar JSON ícone para o Elemento HTML.
6. Under the Component JSON, search for "refreshOn" and set its value to the form data attribute, so that you have "refreshOn": "doc_storage".
7. Certifique-se de que o texto gerado automaticamente para o campo _storage esteja disponível no formulário. Pode ser marcado como um campo oculto.
   Importante:

   Se você usar o UiPath.FormActivitiyLibrary v1.1.10, observe que o Componente JSON não lista a opção "refreshOn" . No entanto, é possível adicionar manualmente a chave "refreshOn" e definir seu valor como mencionado acima.

Baixe este exemplo aqui.

Formulários avançados

Para incorporar um PDF em uma tarefa de formulário avançada:

1. Use atividades, como a atividade Upload Storage File , para carregar o arquivo PDF no bucket de armazenamento usado pela atividade Criar tarefa de formulário . Especifique o caminho do arquivo no campo Caminho da atividade Upload de arquivo de armazenamento . Para este exemplo, insira sample.pdf.
2. Na atividade Criar tarefa de formulário , clique nas reticências (...) à direita de DadosDoFormulário e adicione um argumento com as seguintes configurações:
   • Chave: pdf.
   • Direction: In.
   • Type: String.
   • Valor: "sample.pdf".
3. Adicione um componente PDF ao formulário e especifique o nome do argumento adicionado anteriormente como o Nome da propriedade. Para este exemplo, especifique pdf.
4. Save your changes and close the component window, to return to the Form Designer window.

Baixe este exemplo aqui.