Pré-preenchimento do Forms com layouts flutuantes prepopulating-forms-with-flowable-layouts1

Incluir arquivos de projeto

Inclua arquivos JAR do cliente, como adobe-forms-client.jar, no caminho de classe do seu projeto Java. Para obter informações sobre a localização desses arquivos, consulte Inclusão de arquivos da biblioteca Java do AEM Forms.

Criar uma fonte de dados XML na memória

• Criar um Java DocumentBuilderFactory chamando o DocumentBuilderFactory classe" newInstance método .

• Criar um Java DocumentBuilder chamando o DocumentBuilderFactory do objeto newDocumentBuilder método .

• Chame o DocumentBuilder do objeto newDocument para instanciar um org.w3c.dom.Document objeto.

• Crie o elemento raiz da fonte de dados XML, chamando o org.w3c.dom.Document do objeto createElement método . Isso cria um Element objeto que representa o elemento raiz. Passe um valor de string representando o nome do elemento para a createElement método . Converta o valor de retorno para Element. Em seguida, anexe o elemento raiz ao documento, chamando a função Document do objeto appendChild e passe o objeto do elemento raiz como um argumento. As linhas de código a seguir mostram essa lógica de aplicativo:

   Element root = (Element)document.createElement("transaction");  document.appendChild(root);

• Crie o elemento de cabeçalho da fonte de dados XML, chamando a função Document do objeto createElement método . Passe um valor de string representando o nome do elemento para a createElement método . Converta o valor de retorno para Element. Em seguida, anexe o elemento de cabeçalho ao elemento raiz chamando a função root do objeto appendChild e passe o objeto do elemento de cabeçalho como um argumento. Os elementos XML anexados ao elemento de cabeçalho correspondem à parte estática do formulário. As linhas de código a seguir mostram essa lógica de aplicativo:

   Element header = (Element)document.createElement("header");  root.appendChild(header);

• Crie um elemento filho que pertence ao elemento de cabeçalho, chamando a função Document do objeto createElement e transmita um valor de string que represente o nome do elemento. Converta o valor de retorno para Element. Em seguida, defina um valor para o elemento filho, chamando seu appendChild e passe o Document do objeto createTextNode como um argumento. Especifique um valor de string que apareça como o valor do elemento filho. Finalmente, anexe o elemento filho ao elemento de cabeçalho ao chamar o elemento de cabeçalho appendChild e transmita o objeto de elemento filho como um argumento. As linhas de código a seguir mostram essa lógica de aplicativo:

   Element poNum= (Element)document.createElement("txtPONum");  poNum.appendChild(document.createTextNode("8745236985"));  header.appendChild(LastName);

• Adicione todos os elementos restantes ao elemento de cabeçalho repetindo a última subetapa para cada campo que aparece na parte estática do formulário (no diagrama de fonte de dados XML, esses campos são mostrados na seção A. (Consulte Como entender subgrupos de dados.)

• Crie o elemento detalhado da fonte de dados XML, chamando a função Document do objeto createElement método . Passe um valor de string representando o nome do elemento para a createElement método . Converta o valor de retorno para Element. Em seguida, anexe o elemento de detalhes ao elemento raiz chamando a função root do objeto appendChild e passe o objeto de elemento detail como um argumento. Os elementos XML anexados ao elemento de detalhes correspondem à parte dinâmica do formulário. As linhas de código a seguir mostram essa lógica de aplicativo:

   Element detail = (Element)document.createElement("detail");  root.appendChild(detail);

• Crie um elemento filho que pertence ao elemento de detalhes chamando a função Document do objeto createElement e transmita um valor de string que represente o nome do elemento. Converta o valor de retorno para Element. Em seguida, defina um valor para o elemento filho, chamando seu appendChild e passe o Document do objeto createTextNode como um argumento. Especifique um valor de string que apareça como o valor do elemento filho. Finalmente, anexe o elemento filho ao elemento detalhado ao chamar a função do elemento detalhado appendChild e transmita o objeto de elemento filho como um argumento. As linhas de código a seguir mostram essa lógica de aplicativo:

   Element txtPartNum = (Element)document.createElement("txtPartNum");  txtPartNum.appendChild(document.createTextNode("00010-100"));  detail.appendChild(txtPartNum);

• Repita a última subetapa para todos os elementos XML a serem anexados ao elemento detalhado. Para criar corretamente a fonte de dados XML usada para preencher o formulário de pedido de compra, você deve anexar os seguintes elementos XML ao elemento detalhado: txtDescription, numQtye numUnitPrice.

• Repita as duas últimas subetapas para todos os itens de dados usados para pré-preencher o formulário.

Converter a fonte de dados XML

• Crie um javax.xml.transform.Transformer chamando o javax.xml.transform.Transformer estático do objeto newInstance método .
• Crie um Transformer chamando o TransformerFactory do objeto newTransformer método .
• Crie um ByteArrayOutputStream usando seu construtor.
• Crie um javax.xml.transform.dom.DOMSource usando seu construtor e passando o org.w3c.dom.Document objeto criado na etapa 1.
• Crie um javax.xml.transform.dom.DOMSource usando seu construtor e passando o ByteArrayOutputStream objeto.
• Preencha o Java ByteArrayOutputStream chamando o javax.xml.transform.Transformer do objeto transform e a aprovação do javax.xml.transform.dom.DOMSource e javax.xml.transform.stream.StreamResult objetos.
• Crie uma matriz de bytes e aloque o tamanho da variável ByteArrayOutputStream para a matriz de bytes.
• Preencha a matriz de bytes chamando o ByteArrayOutputStream do objeto toByteArray método .
• Crie um com.adobe.idp.Document usando seu construtor e transmitindo a matriz de bytes.

Renderizar um formulário pré-preenchido

Chame o FormsServiceClient do objeto renderPDFForm e transmita os seguintes valores:

• Um valor de string que especifica o nome do design de formulário, incluindo a extensão de nome de arquivo.
• A com.adobe.idp.Document objeto que contém dados para mesclar com o formulário. Certifique-se de usar a variável com.adobe.idp.Document criado nas etapas um e dois.
• A PDFFormRenderSpec objeto que armazena opções de tempo de execução.
• A URLSpec objeto que contém valores de URI exigidos pelo serviço Forms.
• A java.util.HashMap que armazena anexos de arquivo. Este é um parâmetro opcional e você pode especificar null se não quiser anexar arquivos ao formulário.

O renderPDFForm método retorna um FormsResult objeto que contém um fluxo de dados de formulário que deve ser gravado no navegador da Web do cliente.

• Crie um javax.servlet.ServletOutputStream objeto usado para enviar um fluxo de dados de formulário para o navegador da Web cliente.
• Crie um com.adobe.idp.Document chamando o FormsResult objeto "s getOutputContent método .
• Crie um java.io.InputStream chamando o com.adobe.idp.Document do objeto getInputStream método .
• Crie uma matriz de bytes para preenchê-la com o fluxo de dados do formulário, chamando o InputStream do objeto read e transmitindo a matriz de bytes como um argumento.
• Chame o javax.servlet.ServletOutputStream do objeto write para enviar o fluxo de dados do formulário para o navegador da Web cliente. Transmita a matriz de bytes para a write método .

Incluir arquivos de projeto

• Crie classes proxy Java que consomem o WSDL do serviço Forms. (Consulte Criação de classes proxy Java usando o Apache Axis.)
• Inclua as classes proxy Java no caminho da classe.

Criar uma fonte de dados XML na memória

• Criar um Java DocumentBuilderFactory chamando o DocumentBuilderFactory classe" newInstance método .

• Criar um Java DocumentBuilder chamando o DocumentBuilderFactory do objeto newDocumentBuilder método .

• Chame o DocumentBuilder do objeto newDocument para instanciar um org.w3c.dom.Document objeto.

• Crie o elemento raiz da fonte de dados XML, chamando o org.w3c.dom.Document do objeto createElement método . Isso cria um Element objeto que representa o elemento raiz. Passe um valor de string representando o nome do elemento para a createElement método . Converta o valor de retorno para Element. Em seguida, anexe o elemento raiz ao documento, chamando a função Document do objeto appendChild e passe o objeto do elemento raiz como um argumento. As linhas de código a seguir mostram essa lógica de aplicativo:

   Element root = (Element)document.createElement("transaction");  document.appendChild(root);

• Crie o elemento de cabeçalho da fonte de dados XML, chamando a função Document do objeto createElement método . Passe um valor de string representando o nome do elemento para a createElement método . Converta o valor de retorno para Element. Em seguida, anexe o elemento de cabeçalho ao elemento raiz chamando a função root do objeto appendChild e passe o objeto do elemento de cabeçalho como um argumento. Os elementos XML anexados ao elemento de cabeçalho correspondem à parte estática do formulário. As linhas de código a seguir mostram essa lógica de aplicativo:

   Element header = (Element)document.createElement("header");  root.appendChild(header);

• Crie um elemento filho que pertence ao elemento de cabeçalho, chamando a função Document do objeto createElement e transmita um valor de string que represente o nome do elemento. Converta o valor de retorno para Element. Em seguida, defina um valor para o elemento filho, chamando seu appendChild e passe o Document do objeto createTextNode como um argumento. Especifique um valor de string que apareça como o valor do elemento filho. Finalmente, anexe o elemento filho ao elemento de cabeçalho ao chamar o elemento de cabeçalho appendChild e transmita o objeto de elemento filho como um argumento. As linhas de código a seguir mostram essa lógica de aplicativo:

   Element poNum= (Element)document.createElement("txtPONum");  poNum.appendChild(document.createTextNode("8745236985"));  header.appendChild(LastName);

• Adicione todos os elementos restantes ao elemento de cabeçalho repetindo a última subetapa para cada campo que aparece na parte estática do formulário (no diagrama de fonte de dados XML, esses campos são mostrados na seção A. (Consulte Como entender subgrupos de dados.)

• Crie o elemento detalhado da fonte de dados XML, chamando a função Document do objeto createElement método . Passe um valor de string representando o nome do elemento para a createElement método . Converta o valor de retorno para Element. Em seguida, anexe o elemento de detalhes ao elemento raiz chamando a função root do objeto appendChild e passe o objeto de elemento detail como um argumento. Os elementos XML anexados ao elemento de detalhes correspondem à parte dinâmica do formulário. As linhas de código a seguir mostram essa lógica de aplicativo:

   Element detail = (Element)document.createElement("detail");  root.appendChild(detail);

• Crie um elemento filho que pertence ao elemento de detalhes chamando a função Document do objeto createElement e transmita um valor de string que represente o nome do elemento. Converta o valor de retorno para Element. Em seguida, defina um valor para o elemento filho, chamando seu appendChild e passe o Document do objeto createTextNode como um argumento. Especifique um valor de string que apareça como o valor do elemento filho. Finalmente, anexe o elemento filho ao elemento detalhado ao chamar a função do elemento detalhado appendChild e transmita o objeto de elemento filho como um argumento. As linhas de código a seguir mostram essa lógica de aplicativo:

   Element txtPartNum = (Element)document.createElement("txtPartNum");  txtPartNum.appendChild(document.createTextNode("00010-100"));  detail.appendChild(txtPartNum);

• Repita a última subetapa para todos os elementos XML a serem anexados ao elemento detalhado. Para criar corretamente a fonte de dados XML usada para preencher o formulário de pedido de compra, você deve anexar os seguintes elementos XML ao elemento detalhado: txtDescription, numQtye numUnitPrice.

• Repita as duas últimas subetapas para todos os itens de dados usados para pré-preencher o formulário.

Converter a fonte de dados XML

• Crie um javax.xml.transform.Transformer chamando o javax.xml.transform.Transformer estático do objeto newInstance método .
• Crie um Transformer chamando o TransformerFactory do objeto newTransformer método .
• Crie um ByteArrayOutputStream usando seu construtor.
• Crie um javax.xml.transform.dom.DOMSource usando seu construtor e passando o org.w3c.dom.Document objeto criado na etapa 1.
• Crie um javax.xml.transform.dom.DOMSource usando seu construtor e passando o ByteArrayOutputStream objeto.
• Preencha o Java ByteArrayOutputStream chamando o javax.xml.transform.Transformer do objeto transform e a aprovação do javax.xml.transform.dom.DOMSource e javax.xml.transform.stream.StreamResult objetos.
• Crie uma matriz de bytes e aloque o tamanho da variável ByteArrayOutputStream para a matriz de bytes.
• Preencha a matriz de bytes chamando o ByteArrayOutputStream do objeto toByteArray método .
• Crie um BLOB usando seu construtor e chamando seu setBinaryData e transmita a matriz de bytes.

Renderizar um formulário pré-preenchido

Chame o FormsService do objeto renderPDFForm e transmita os seguintes valores:

• Um valor de string que especifica o nome do design de formulário, incluindo a extensão de nome de arquivo.
• A BLOB objeto que contém dados para mesclar com o formulário. Certifique-se de usar a variável BLOB objeto criado nas etapas um e dois.
• A PDFFormRenderSpecc objeto que armazena opções de tempo de execução. Para obter mais informações, consulte Referência da API do AEM Forms.
• A URLSpec objeto que contém valores de URI exigidos pelo serviço Forms.
• A java.util.HashMap que armazena anexos de arquivo. Este é um parâmetro opcional e você pode especificar null se não quiser anexar arquivos ao formulário.
• Um vazio com.adobe.idp.services.holders.BLOBHolder objeto preenchido pelo método . Isso é usado para armazenar o formulário PDF renderizado.
• Um vazio javax.xml.rpc.holders.LongHolder objeto preenchido pelo método . (Esse argumento armazenará o número de páginas no formulário).
• Um vazio javax.xml.rpc.holders.StringHolder objeto preenchido pelo método . (Esse argumento armazenará o valor da localidade).
• Um vazio com.adobe.idp.services.holders.FormsResultHolder que conterá os resultados desta operação.

O renderPDFForm O método preenche a variável com.adobe.idp.services.holders.FormsResultHolder objeto que é passado como o último valor do argumento com um fluxo de dados de formulário que deve ser gravado no navegador da Web do cliente.

• Crie um FormResult obtendo o valor da variável com.adobe.idp.services.holders.FormsResultHolder do objeto value membro de dados.
• Crie um BLOB objeto que contém dados de formulário chamando o FormsResult do objeto getOutputContent método .
• Obtenha o tipo de conteúdo da variável BLOB ao invocar seu getContentType método .
• Defina as javax.servlet.http.HttpServletResponse tipo de conteúdo do objeto, chamando seu setContentType e a transmissão do tipo de conteúdo do BLOB objeto.
• Crie um javax.servlet.ServletOutputStream objeto usado para gravar o fluxo de dados do formulário no navegador da Web cliente, chamando o javax.servlet.http.HttpServletResponse do objeto getOutputStream método .
• Crie uma matriz de bytes e preencha-a chamando a variável BLOB do objeto getBinaryData método . Essa tarefa atribui o conteúdo da FormsResult para a matriz de bytes.
• Chame o javax.servlet.http.HttpServletResponse do objeto write para enviar o fluxo de dados do formulário para o navegador da Web cliente. Transmita a matriz de bytes para a write método .