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.

Esse recurso está disponível apenas com a atividade Criar tarefa de formulário .

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
Usuárioda Action Center	Este usuário precisa das seguintes permissões no nível da pasta: Visualizar para depósito de armazenamento e Visualizar para arquivo de armazenamento.
usuáriodo robô	Este usuário precisa das seguintes permissões no nível da pasta: Exibir e editar para depósito de armazenamentoe Exibir e criar para arquivo de armazenamento.

Incorporando imagens de buckets de armazenamento

Para que os usuários do Actions 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 atividades, como a atividade Carregar arquivo de armazenamento , para carregar a imagem no depósito de armazenamento usado pela atividade Criar tarefa de formulário . Como parte desta etapa, crie uma variável String para armazenar o caminho onde o arquivo é carregado, por exemplo imagePath.
   Importante: o upload do depósito de armazenamento converte o sinal + em um espaço, o que pode resultar em um erro durante a renderização do formulário.
2. Na atividade Create Form Task , clique nas reticências (...) à direita de FormData e adicione um argumento com a palavra-chave _storage como sufixo:
   • Nome: image_storage.
   • Direção: Em.
   • Tipo: Corda.
   • Valor: imagePath.
   Observação: a palavra-chave _storage é usada para indicar que este é um objeto disponível no depósito de armazenamento da atividade. Para o valor, adicionamos a variável onde armazenamos o caminho para a imagem carregada.
   Dica: para imagens menores que 2 KB, como logotipos ou ícones, você pode pular esta etapa. Na etapa seguinte em que o argumento image_storage é usado, use a variável imagePath .
3. Adicione um componente Elemento HTML e configure-o da seguinte maneira:
   • Marca HTML: div.
   • Conteúdo: <img src="{{ data.image_storage }}" />. Isso mapeia o argumento do arquivo de armazenamento para o componente de formulário. Usar a tag <img> exibe a imagem no formulário. Alternativamente, você pode usar <a src="{{ data.image_storage }}" target=_blank> para adicionar um link que abre a imagem em uma nova janela.
   • Atualizar ao alterar: selecionado.
   Observação: você pode adicionar links a arquivos específicos referenciando-os na tag <a href="https://link-to-file"></a> . Você pode ignorar quaisquer erros de validação que apareçam no campo Conteúdo , eles não afetam a renderização do formulário em tempo de execução.

Importante: Arquivos TIFF não são suportados dentro de ações de formulário. Como alternativa, tente o seguinte:

• 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 você mesmo, baixe o fluxo de trabalho de amostra.

Incorporando arquivos PDF de buckets de armazenamento

Incorporar um arquivo PDF de um bucket de armazenamento é diferente para formulários regulares e formulários avançados. Os formulários avançados oferecem um desempenho de renderização aprimorado 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 atividades, como a atividade Carregar arquivo de armazenamento , para carregar o arquivo PDF no depósito de armazenamento usado pela atividade Criar tarefa de formulário . Como parte desta etapa, crie uma variável String para armazenar o caminho onde o arquivo é carregado, por exemplo docPath.
2. Na atividade Create Form Task , clique nas reticências (...) à direita de FormData e adicione um argumento com a palavra-chave _storage como sufixo:
   • Nome: doc_storage.
   • Direção: Em.
   • Tipo: Corda.
   • Valor: docPath.
     Importante: A palavra-chave _storage é usada para indicar que este é um objeto que está disponível dentro do depósito de armazenamento da atividade. Para o valor, adicionamos a variável onde armazenamos o caminho para o arquivo PDF carregado.

3. Adicione um componente Elemento HTML ao formulário e especifique o seguinte:

   • Marca HTML: div.
   • Conteúdo: <embed src={{ data.doc_storage }} width="600px" height="500px"></embed>.
   • Atualizar ao alterar: desmarcado.
4. Salve suas alterações e feche a janela do componente para retornar à janela do Form Designer .
5. Clique em Editar JSON ícone para o Elemento HTML.
6. Em Component JSON, procure por "refreshOn" e defina seu valor para o atributo de dados do formulário, para que você tenha "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 Storage File . 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.
   • Direção: Em.
   • Tipo: Corda.
   • 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. Salve suas alterações e feche a janela do componente para retornar à janela do Form Designer .

Baixe este exemplo aqui.