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 o local desses arquivos, consulte Incluindo arquivos da biblioteca Java do AEM Forms.

Criar uma fonte de dados XML na memória

• Crie um objeto Java DocumentBuilderFactory chamando o método newInstance da classe DocumentBuilderFactory.

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

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

• Crie o elemento raiz da fonte de dados XML invocando o método createElement do objeto org.w3c.dom.Document. Isso cria um objeto Element que representa o elemento raiz. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método createElement. Converter o valor de retorno em Element. Em seguida, anexe o elemento raiz ao documento chamando o método appendChild do objeto Document e passe o objeto de elemento raiz como 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 método createElement do objeto Document. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método createElement. Converter o valor de retorno em Element. Em seguida, anexe o elemento de cabeçalho ao elemento raiz chamando o método appendChild do objeto root e transmita o objeto de 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 método createElement do objeto Document e passe um valor de cadeia de caracteres que represente o nome do elemento. Converter o valor de retorno em Element. Em seguida, defina um valor para o elemento filho chamando seu método appendChild e passe o método createTextNode do objeto Document 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 método appendChild do elemento de cabeçalho e passe o objeto de elemento filho como 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 Noções básicas sobre subgrupos de dados.)

• Crie o elemento de detalhes da fonte de dados XML chamando o método createElement do objeto Document. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método createElement. Converter o valor de retorno em Element. Em seguida, anexe o elemento de detalhes ao elemento raiz chamando o método appendChild do objeto root e passe o objeto do elemento de detalhes 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 método createElement do objeto Document e passe um valor de cadeia de caracteres que represente o nome do elemento. Converter o valor de retorno em Element. Em seguida, defina um valor para o elemento filho chamando seu método appendChild e passe o método createTextNode do objeto Document 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 detalhes, chamando o método appendChild do elemento de detalhes, e passe o objeto do 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 fonte de dados XML usada para preencher o formulário de ordem de compra, anexe 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

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

Renderizar um formulário pré-preenchido

Invoque o método renderPDFForm do objeto FormsServiceClient 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.
• Um objeto com.adobe.idp.Document que contém dados para mesclar com o formulário. Use o objeto com.adobe.idp.Document criado nas etapas um e dois.
• Um objeto PDFFormRenderSpec que armazena opções de tempo de execução.
• Um objeto URLSpec que contém valores de URI exigidos pelo serviço Forms.
• Um objeto 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 método renderPDFForm retorna um objeto FormsResult que contém um fluxo de dados de formulário que deve ser gravado no navegador Web cliente.

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

Incluir arquivos de projeto

• Crie classes de proxy Java que consomem o serviço WSDL do Forms. (Consulte Criação de classes 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

• Crie um objeto Java DocumentBuilderFactory chamando o método newInstance da classe DocumentBuilderFactory.

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

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

• Crie o elemento raiz da fonte de dados XML invocando o método createElement do objeto org.w3c.dom.Document. Isso cria um objeto Element que representa o elemento raiz. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método createElement. Converter o valor de retorno em Element. Em seguida, anexe o elemento raiz ao documento chamando o método appendChild do objeto Document e passe o objeto de elemento raiz como 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 método createElement do objeto Document. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método createElement. Converter o valor de retorno em Element. Em seguida, anexe o elemento de cabeçalho ao elemento raiz chamando o método appendChild do objeto root e transmita o objeto de 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 método createElement do objeto Document e passe um valor de cadeia de caracteres que represente o nome do elemento. Converter o valor de retorno em Element. Em seguida, defina um valor para o elemento filho chamando seu método appendChild e passe o método createTextNode do objeto Document 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 método appendChild do elemento de cabeçalho e passe o objeto de elemento filho como 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 Noções básicas sobre subgrupos de dados.)

• Crie o elemento de detalhes da fonte de dados XML chamando o método createElement do objeto Document. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método createElement. Converter o valor de retorno em Element. Em seguida, anexe o elemento de detalhes ao elemento raiz chamando o método appendChild do objeto root e passe o objeto do elemento de detalhes 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 método createElement do objeto Document e passe um valor de cadeia de caracteres que represente o nome do elemento. Converter o valor de retorno em Element. Em seguida, defina um valor para o elemento filho chamando seu método appendChild e passe o método createTextNode do objeto Document 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 detalhes, chamando o método appendChild do elemento de detalhes, e passe o objeto do 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 fonte de dados XML usada para preencher o formulário de ordem de compra, anexe 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

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

Renderizar um formulário pré-preenchido

Invoque o método renderPDFForm do objeto FormsService 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.
• Um objeto BLOB que contém dados para mesclar com o formulário. Use o objeto BLOB criado nas etapas um e dois.
• Um objeto PDFFormRenderSpecc que armazena opções de tempo de execução. Para obter mais informações, consulte Referência da API do AEM Forms.
• Um objeto URLSpec que contém valores de URI exigidos pelo serviço Forms.
• Um objeto 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 objeto com.adobe.idp.services.holders.BLOBHolder vazio preenchido pelo método. Isso é usado para armazenar o formulário de PDF renderizado.
• Um objeto javax.xml.rpc.holders.LongHolder vazio preenchido pelo método. (Esse argumento armazenará o número de páginas no formulário).
• Um objeto javax.xml.rpc.holders.StringHolder vazio preenchido pelo método. (Esse argumento armazenará o valor do local).
• Um objeto com.adobe.idp.services.holders.FormsResultHolder vazio que conterá os resultados desta operação.

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

• Crie um objeto FormResult obtendo o valor do membro de dados value do objeto com.adobe.idp.services.holders.FormsResultHolder.
• Crie um objeto BLOB que contenha dados de formulário invocando o método getOutputContent do objeto FormsResult.
• Obtenha o tipo de conteúdo do objeto BLOB invocando seu método getContentType.
• Defina o tipo de conteúdo do objeto javax.servlet.http.HttpServletResponse invocando seu método setContentType e transmitindo o tipo de conteúdo do objeto BLOB.
• Crie um objeto javax.servlet.ServletOutputStream usado para gravar o fluxo de dados de formulário no navegador da Web cliente, chamando o método getOutputStream do objeto javax.servlet.http.HttpServletResponse.
• Crie uma matriz de bytes e preencha-a chamando o método getBinaryData do objeto BLOB. Esta tarefa atribui o conteúdo do objeto FormsResult à matriz de bytes.
• Invoque o método write do objeto javax.servlet.http.HttpServletResponse para enviar o fluxo de dados de formulário para o navegador Web cliente. Passar a matriz de bytes para o método write.