Pré-preenchimento do Forms com layouts fluíveis prepopulating-forms-with-flowable-layouts1

Incluir arquivos de projeto

Inclua arquivos JAR do cliente, como adobe-forms-client.jar, no caminho de classe do 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 ao chamar o DocumentBuilderFactory class' newInstance método.

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

• Chame o DocumentBuilder do objeto newDocument método 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 uma Element objeto que representa o elemento raiz. Transmita um valor de string que represente o nome do elemento para a variável createElement método. Converter o valor de retorno em Element. Em seguida, anexe o elemento raiz ao documento chamando o Document do objeto appendChild e transmita o objeto de elemento raiz como um argumento. As linhas de código a seguir mostram essa lógica de aplicação:

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

• Crie o elemento de cabeçalho da fonte de dados XML chamando o Document do objeto createElement método. Transmita um valor de string que represente o nome do elemento para a variável createElement método. Converter o valor de retorno em Element. Em seguida, anexe o elemento de cabeçalho ao elemento raiz chamando o root do objeto appendChild e transmita 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 aplicação:

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

• Crie um elemento filho que pertença ao elemento de cabeçalho chamando o Document do objeto createElement e passe um valor de string que represente o nome do elemento. Converter o valor de retorno em Element. Em seguida, defina um valor para o elemento filho chamando seu appendChild e transmita 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 chamando o do 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 aplicação:

   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 Entender subgrupos de dados.)

• Crie o elemento de detalhes da fonte de dados XML chamando o Document do objeto createElement método. Transmita um valor de string que represente o nome do elemento para a variável createElement método. Converter o valor de retorno em Element. Em seguida, anexe o elemento de detalhes ao elemento raiz chamando o root do objeto appendChild e transmita o objeto do elemento de detalhe 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 aplicação:

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

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

   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 de detalhes. Para criar corretamente a origem de dados XML usada para preencher o formulário de ordem de compra, você deve anexar os seguintes elementos XML ao elemento de detalhes: txtDescription, numQty, e numUnitPrice.

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

Converter a fonte de dados XML

• Criar um javax.xml.transform.Transformer ao invocar o javax.xml.transform.Transformer estática do objeto newInstance método.
• Criar um Transformer ao invocar o TransformerFactory do objeto newTransformer método.
• Criar um ByteArrayOutputStream usando seu construtor.
• Criar um javax.xml.transform.dom.DOMSource usando seu construtor e transmitindo o org.w3c.dom.Document objeto criado na etapa 1.
• Criar um javax.xml.transform.dom.DOMSource usando seu construtor e transmitindo o ByteArrayOutputStream objeto.
• Preencha o Java ByteArrayOutputStream ao invocar o javax.xml.transform.Transformer do objeto transform e transmitindo o javax.xml.transform.dom.DOMSource e a variável javax.xml.transform.stream.StreamResult objetos.
• Crie uma matriz de bytes e aloque o tamanho da variável ByteArrayOutputStream à matriz de bytes.
• Preencha a matriz de bytes chamando o ByteArrayOutputStream do objeto toByteArray método.
• Criar 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 passe os seguintes valores:

• Um valor de cadeia de caracteres que especifica o nome de design do formulário, incluindo a extensão de nome de arquivo.
• A com.adobe.idp.Document objeto que contém dados a serem mesclados com o formulário. Certifique-se de usar o com.adobe.idp.Document objeto 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 do Forms.
• A java.util.HashMap objeto que armazena anexos de arquivo. Este é um parâmetro opcional e você pode especificar null se não quiser anexar arquivos ao formulário.

A variável renderPDFForm o 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.

• Criar um javax.servlet.ServletOutputStream objeto usado para enviar um fluxo de dados de formulário para o navegador da web cliente.
• Criar um com.adobe.idp.Document ao invocar o FormsResult do objeto getOutputContent método.
• Criar um java.io.InputStream ao invocar o com.adobe.idp.Document do objeto getInputStream método.
• Crie uma matriz de bytes para preenchê-la com o fluxo de dados de 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 de formulário para o navegador web cliente. Passe a matriz de bytes para o write método.

Incluir arquivos de projeto

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

Criar uma fonte de dados XML na memória

• Criar um Java DocumentBuilderFactory ao chamar o DocumentBuilderFactory class' newInstance método.

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

• Chame o DocumentBuilder do objeto newDocument método 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 uma Element objeto que representa o elemento raiz. Transmita um valor de string que represente o nome do elemento para a variável createElement método. Converter o valor de retorno em Element. Em seguida, anexe o elemento raiz ao documento chamando o Document do objeto appendChild e transmita o objeto de elemento raiz como um argumento. As linhas de código a seguir mostram essa lógica de aplicação:

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

• Crie o elemento de cabeçalho da fonte de dados XML chamando o Document do objeto createElement método. Transmita um valor de string que represente o nome do elemento para a variável createElement método. Converter o valor de retorno em Element. Em seguida, anexe o elemento de cabeçalho ao elemento raiz chamando o root do objeto appendChild e transmita 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 aplicação:

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

• Crie um elemento filho que pertença ao elemento de cabeçalho chamando o Document do objeto createElement e passe um valor de string que represente o nome do elemento. Converter o valor de retorno em Element. Em seguida, defina um valor para o elemento filho chamando seu appendChild e transmita 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 chamando o do 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 aplicação:

   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 Entender subgrupos de dados.)

• Crie o elemento de detalhes da fonte de dados XML chamando o Document do objeto createElement método. Transmita um valor de string que represente o nome do elemento para a variável createElement método. Converter o valor de retorno em Element. Em seguida, anexe o elemento de detalhes ao elemento raiz chamando o root do objeto appendChild e transmita o objeto do elemento de detalhe 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 aplicação:

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

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

   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 de detalhes. Para criar corretamente a origem de dados XML usada para preencher o formulário de ordem de compra, você deve anexar os seguintes elementos XML ao elemento de detalhes: txtDescription, numQty, e numUnitPrice.

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

Converter a fonte de dados XML

• Criar um javax.xml.transform.Transformer ao invocar o javax.xml.transform.Transformer estática do objeto newInstance método.
• Criar um Transformer ao invocar o TransformerFactory do objeto newTransformer método.
• Criar um ByteArrayOutputStream usando seu construtor.
• Criar um javax.xml.transform.dom.DOMSource usando seu construtor e transmitindo o org.w3c.dom.Document objeto criado na etapa 1.
• Criar um javax.xml.transform.dom.DOMSource usando seu construtor e transmitindo o ByteArrayOutputStream objeto.
• Preencha o Java ByteArrayOutputStream ao invocar o javax.xml.transform.Transformer do objeto transform e transmitindo o javax.xml.transform.dom.DOMSource e a variável javax.xml.transform.stream.StreamResult objetos.
• Crie uma matriz de bytes e aloque o tamanho da variável ByteArrayOutputStream à matriz de bytes.
• Preencha a matriz de bytes chamando o ByteArrayOutputStream do objeto toByteArray método.
• Criar um BLOB objeto usando seu construtor e invocando seu setBinaryData e transmitem a matriz de bytes.

Renderizar um formulário pré-preenchido

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

• Um valor de cadeia de caracteres que especifica o nome de design do formulário, incluindo a extensão de nome de arquivo.
• A BLOB objeto que contém dados a serem mesclados com o formulário. Certifique-se de usar o 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 do Forms.
• A java.util.HashMap objeto 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 de 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 do local).
• Um vazio com.adobe.idp.services.holders.FormsResultHolder objeto que conterá os resultados desta operação.

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

• Criar um FormResult obtendo o valor do com.adobe.idp.services.holders.FormsResultHolder do objeto value membro de dados.
• Criar um BLOB objeto que contém dados de formulário chamando o FormsResult do objeto getOutputContent método.
• Obter o tipo de conteúdo do BLOB ao invocar seu getContentType método.
• Defina o javax.servlet.http.HttpServletResponse tipo de conteúdo do objeto chamando seu setContentType e transmitindo o tipo de conteúdo do BLOB objeto.
• Criar um javax.servlet.ServletOutputStream objeto usado para gravar o fluxo de dados de 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 o BLOB do objeto getBinaryData método. Esta tarefa atribui o conteúdo do FormsResult à matriz de bytes.
• Chame o javax.servlet.http.HttpServletResponse do objeto write para enviar o fluxo de dados de formulário para o navegador web cliente. Passe a matriz de bytes para o write método.