DocumentaçãoAEM as a Cloud ServiceGuia do usuário

Adicionar o Forms Portal a uma página do AEM Sites publish-forms-on-portal

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined

O Adobe recomenda o uso de Componentes principaisde captura de dados moderna e extensível para criar um novo Forms Adaptávelou adicionar o Forms Adaptável às páginas do AEM Sites. Esses componentes representam um avanço significativo na criação do Forms adaptável, garantindo experiências de usuário impressionantes. Este artigo descreve a abordagem mais antiga para criar o Forms adaptável usando componentes de base.

Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

Em um cenário típico de implantação de portal centrada em formulários, o desenvolvimento de formulários e o desenvolvimento de portal são duas atividades distintas. Enquanto os designers de formulários criam e armazenam formulários em um repositório, os desenvolvedores da Web criam um aplicativo da Web para listar formulários e manipular o envio de formulários. Os Forms são copiados para o nível da Web, pois não há comunicação entre o repositório de formulários e o aplicativo web.

Esses cenários geralmente resultam em problemas de gerenciamento e atrasos de produção. Por exemplo, se houver uma versão mais recente de um formulário disponível no repositório, você precisará substituir o formulário no nível da Web, modificar o aplicativo da Web e reimplantar o formulário no site público. A reimplantação do aplicativo Web pode causar algum tempo de inatividade do servidor. Normalmente, o tempo de inatividade do servidor é uma atividade planejada e, portanto, as alterações não podem ser enviadas para o site público instantaneamente.

A AEM Forms fornece componentes de portal que reduzem as despesas gerais de gerenciamento e os atrasos de produção. Os componentes equipam os desenvolvedores da Web para criar e personalizar um Forms Portal em sites criados usando o Adobe Experience Manager (AEM).

Os componentes do Portal de formulários permitem adicionar a seguinte funcionalidade:

  • Listar formulários em layouts personalizados. Pronto para uso, são fornecidos a Exibição de lista e os Layouts de exibição de cartão. Você pode criar seus próprios layouts personalizados.
  • Permite exibir metadados personalizados e ações personalizadas ao listá-los.
  • Listar formulários publicados pela interface do usuário do AEM Forms na instância de publicação em que os componentes do Forms Portal estão sendo usados.
  • Permitir que os usuários finais renderizem formulários no formato HTML e PDF.
  • Habilitar a pesquisa de formulários com base no título e na descrição.
  • Use o CSS personalizado para personalizar a aparência do portal.
  • Criar links para formulários.
  • Lista rascunhos e envios relacionados ao Adaptive Forms criados pelo usuário.

Componentes de uma página do Forms Portal forms-portal-components

A AEM Forms fornece os seguintes componentes do portal prontos para uso:

  • Pesquisar e listar: este componente permite listar formulários do repositório de formulários na página do portal e fornece opções de configuração para listar formulários com base em critérios especificados.

  • Rascunhos e envios: enquanto o componente Pesquisa e listagem exibe formulários que são tornados públicos pelo autor do Forms, o componente Rascunhos e envios exibe formulários que são salvos como rascunho para concluir e enviar formulários posteriormente. Este componente fornece experiência personalizada para qualquer usuário conectado.

  • Link: este componente permite criar um link para um formulário em qualquer lugar da página.

Você pode importar os componentes prontos para uso do Forms Portal do Arquétipo de Projetos AEM. Após a importação, execute as seguintes configurações:

Importar componentes do portal do Forms import-forms-portal-components-aem-archetype

Para importar componentes prontos para uso do Forms Portal no AEM Forms as a Cloud Service, execute as seguintes etapas:

  1. Clonar o repositório Git do Cloud Manager na instância de desenvolvimento local: O repositório Git do Cloud Manager contém um projeto AEM padrão. É baseado no Arquétipo AEM. Clonar o Repositório Git da Cloud Manager usando o Gerenciamento de conta Git por autoatendimento da interface do usuário do Cloud Manager para trazer o projeto para o ambiente de desenvolvimento local. Para obter detalhes sobre como acessar o repositório, consulte Acessando Repositórios.

  2. Criar Experience Manager Forms como um projeto [Cloud Service]: Criar Experience Manager Forms como um projeto [Cloud Service] com base no Arquétipo AEM 27 ou posterior. O arquétipo ajuda os desenvolvedores a iniciar o desenvolvimento facilmente para o AEM Forms as a Cloud Service. Ele também inclui alguns exemplos de temas e modelos para ajudá-lo a começar rapidamente.

    Para criar um projeto as a Cloud Service Experience Manager Forms, abra o prompt de comando e execute o comando abaixo. Para incluir configurações, temas e modelos específicos do Forms, defina includeForms=y.

    code language-shell 
    mvn -B archetype:generate -DarchetypeGroupId=com.adobe.aem -DarchetypeArtifactId=aem-project-archetype -DarchetypeVersion=30 -DaemVersion="cloud" -DappTitle="My Site" -DappId="mysite" -DgroupId="com.mysite" -DincludeForms="y"

    Além disso, altere appTitle, appId e groupId no comando acima para refletir seu ambiente.

    Depois que o projeto estiver pronto, atualize a propriedade <core.forms.components.version>x.y.z</core.forms.components.version> no pom.xml de nível superior do projeto Arquétipo para refletir a versão mais recente do core-forms-components no seu projeto AEM Archetype.

  3. Implantar o projeto no ambiente de desenvolvimento local: Você pode usar o seguinte comando para implantar no ambiente de desenvolvimento local

    mvn -PautoInstallPackage clean install

    Para obter a lista completa de comandos, consulte Compilando e Instalando

  4. Implante o código em seu AEM Forms ambiente as a Cloud Service.

Configurar o armazenamento do Azure para o Adaptive Forms configure-azure-storage-adaptive-forms

A Experience Manager Forms Integração de Dados fornece a configuração de armazenamento do Azure para integrar formulários com os serviços de armazenamento do Azure. O Modelo de Dados de Formulário (FDM) pode ser usado para criar o Forms Adaptável que interage com o servidor Azure para habilitar fluxos de trabalho de negócios.

Criar configuração de armazenamento do Azure create-azure-storage-configuration

Antes de executar essas etapas, verifique se você tem uma conta de armazenamento do Azure e uma chave de acesso para autorizar o acesso à conta de armazenamento Azure.

  1. Navegue até Ferramentas > Cloud Service > Armazenamento do Azure.
  2. Selecione uma pasta para criar a configuração e selecione Criar.
  3. Especifique um título para a configuração no campo Título.
  4. Especifique o nome da conta de armazenamento Azure no campo Conta de Armazenamento do Azure.

Configurar o Conector de armazenamento unificado para o Forms Portal configure-usc-forms-portal

Execute as seguintes etapas para configurar o Conector de armazenamento unificado para fluxos de trabalho AEM:

  1. Navegue até Ferramentas > Forms > Conector de Armazenamento Unificado.
  2. Na seção Portal do Forms, selecione Azure na lista suspensa Armazenamento.
  3. Especifique o caminho de configuração para a configuração de armazenamento do Azure no campo Caminho de Configuração de Armazenamento.
  4. Selecione Publish e Salvar para salvar a configuração.

Habilitar Componentes do Portal Forms enable-forms-portal-components

Para usar qualquer componente principal (incluindo os componentes de portal prontos para uso) em um site do Adobe Experience Manager (AEM), você deve criar um componente proxy e habilitá-lo para o seu site. Para criar um componente proxy e habilitar componentes do portal, consulte Usando Componentes Principais.

Depois que um componente de portal é ativado, você pode usá-lo na instância de autor da página de sites.

Adicionar e configurar componentes do portal do Forms configure-forms-portal-components

Você pode criar e personalizar o Forms Portal em sites criados usando AEM adicionando e configurando os componentes do portal. Verifique se os componentes estão habilitados antes de usá-los no Portal do Forms.

Para adicionar um componente, arraste e solte o componente do painel Componentes no contêiner de layout da página ou selecione o ícone adicionar no contêiner de layout e adicione o componente da caixa de diálogo Inserir novo componente.

Configurar o componente de rascunhos e envios configure-drafts-submissions-component

O componente Rascunhos e envios exibe formulários que são salvos como rascunho para preencher formulários posteriormente e enviados. Para configurar, selecione o componente e, em seguida, selecione o ícone Configurar . Na caixa de diálogo Rascunhos e Envios, especifique o título para indicar a listagem de formulários como rascunho ou formulários enviados. Selecione também se o componente deve listar formulários de rascunho ou formulários enviados no formato de cartão ou lista.

Ícone Rascunhos

Ícone de envios

Configurar o componente de pesquisa e listagem configure-search-lister-component

O componente de Pesquisa e listagem é usado para listar formulários adaptáveis em uma página e implementar a pesquisa nos formulários listados.

Ícone de Pesquisa e Lister

Para configurar, selecione o componente e, em seguida, selecione o ícone Configurar . A caixa de diálogo Pesquisa e Lister é aberta.

  1. Na guia Exibir, configure o seguinte:

    • Em Título, especifique o título do componente de Pesquisa e Listagem. Um título indicativo permite que os usuários executem uma pesquisa rápida na lista de formulários.
    • Na lista Layout, selecione o layout para representar os formulários no formato de cartão ou lista.
    • Selecione Ocultar Pesquisa e Ocultar Classificação para ocultar a pesquisa e a classificação por recursos.
    • Em Dica de Ferramenta, forneça a dica de ferramenta que aparece quando você passa o mouse sobre o componente.

  2. Na guia Pasta de ativos, especifique o local de onde os formulários são extraídos e listados na página. Você pode configurar vários locais de pastas.

  3. Na guia Resultados, configure o número máximo de formulários a serem exibidos por página. O padrão é oito formulários por página.

O componente Link permite fornecer links para um formulário adaptável na página. Para configurar, selecione o componente e, em seguida, selecione o ícone Configurar . A caixa de diálogo Editar Componente de Link é aberta.

  1. Na guia Exibir, forneça a legenda do link e a dica de ferramenta para facilitar a identificação dos formulários representados pelo link.
  2. Na guia Informações do ativo, especifique o caminho do repositório onde o ativo está armazenado.
  3. Na guia Parâmetros de consulta, especifique os parâmetros adicionais no formato de par de valor-chave. Quando o link for clicado, esses parâmetros adicionais serão transmitidos junto com o formulário.

Configurar o envio assíncrono de formulários usando o Adobe Sign configure-asynchronous-form-submission-using-adobe-sign

Você pode configurar o para enviar um formulário adaptável somente quando todos os recipients tiverem concluído a cerimônia de assinatura. Siga as etapas abaixo para definir a configuração usando o Adobe Sign.

  1. Na instância do autor, abra um Formulário adaptável no modo de edição.
  2. No painel esquerdo, selecione o ícone Propriedades e expanda a opção ASSINATURA ELETRÔNICA.
  3. Selecione Habilitar Adobe Sign. Várias opções de configuração são exibidas.
  4. Na seção Enviar o formulário, selecione a opção depois que cada destinatário concluir a cerimônia de assinatura para configurar a ação Enviar Formulário, onde o formulário é enviado pela primeira vez a todos os destinatários para assinatura. Depois que todos os recipients tiverem assinado o formulário, somente então o formulário será enviado.

Salvar Forms Adaptável Como Rascunhos save-adaptive-forms-as-drafts

Você pode salvar formulários como rascunhos para preenchê-los posteriormente. Há duas maneiras pelas quais um formulário é salvo como rascunho:

  • Crie uma regra "Salvar formulário" em um componente de formulário, por exemplo, um botão. Ao clicar no botão, os acionadores da regra e o formulário são salvos como rascunho.
  • Habilite o recurso de Salvamento automático, que salva o formulário de acordo com o evento especificado ou após um intervalo configurado de tempo.

Criar regras para salvar um formulário adaptável como rascunho rule-to-save-adaptive-form-as-draft

Para criar uma regra "Salvar formulário" em um componente de formulário, por exemplo, um botão, siga as etapas abaixo:

  1. Na instância do autor, abra um Formulário adaptável no modo de edição.
  2. No painel esquerdo, selecione ícone Componentes e arraste o componente Botão para o formulário.
  3. Selecione o componente Botão e selecione o ícone Configurar .
  4. Selecione o ícone Editar Regras para abrir o Editor de Regras.
  5. Selecione Criar para configurar e criar a regra.
  6. Na seção Quando, selecione "foi clicado" e na seção Então, selecione as opções "Salvar Formulário".
  7. Selecione Concluído para salvar a regra.

Ativar salvamento automático enable-auto-save

Você pode configurar o recurso de salvamento automático para um formulário adaptável da seguinte maneira:

  1. Na instância do autor, abra um Formulário adaptável no modo de edição.
  2. No painel esquerdo, selecione o ícone Propriedades e expanda a opção SALVAR AUTOMATICAMENTE.
  3. Marque a caixa de seleção Habilitar para habilitar o salvamento automático do formulário. Você pode configurar o seguinte:
  • Por padrão, o Evento de formulário adaptável está definido como "true", o que implica que o formulário é salvo automaticamente após cada evento.
  • Em Trigger, configure o para acionar o salvamento automático com base na ocorrência de um evento ou após um intervalo de tempo específico.

Consulte também see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab