Usar o serviço de script de execução no AEM Forms no JEE Workbench para criar dados XML using-execute-script-service-forms-jee-workbench

Há muito XML envolvido com workflows de gerenciamento de processos do AEM Forms no JEE, por exemplo: informações XML podem ser criadas em um processo e enviadas para um aplicativo do Flex no AEM Forms no JEE Workspace, usadas para configurações de sistemas ou transmitindo informações de e para formulários. Há muitas instâncias em que um desenvolvedor do AEM Forms no JEE precisa gerenciar XML e, muitas vezes, isso requer que o XML seja gerenciado por meio de um processo do AEM Forms no JEE.

Ao lidar com configurações XML simples, é possível usar o Set Value serviço, que é um AEM Forms padrão no serviço JEE. Este serviço define o valor de um ou mais itens de dados no modelo de dados de processo. Para cenários de lógica condicional simples "se isso, então aquilo", esse serviço pode atender à finalidade.

No entanto, em situações mais complexas, o serviço de Definir valor não é tão eficaz. Nessas situações, é necessário confiar em um conjunto mais robusto de comandos de programação, como os fornecidos por uma linguagem de programação como o Java™. Usar o Java™ para criar XML complexos pode ser muito mais fácil e mais claro do que criar um documento XML a partir de texto simples no serviço de Definir valor. Além disso, é mais fácil incluir programação condicional em Java™ do que em um serviço de Definir valor.

Uso do Serviço de Execução de Script em um Processo using-execute-script-service-in-process

No conjunto dos serviços padrão do AEM Forms no JEE disponíveis no AEM Forms no JEE Workbench, está o Execute Script serviço. Este serviço permite que você execute scripts em processos e fornece a executeScript operação para fazer isso.

Criar um aplicativo e um processo com o serviço "Executar script" definido como uma atividade create-an-application

Em geral, a criação de aplicativos e processos está fora do escopo deste tutorial, mas por causa dessa instrução, um aplicativo chamado "DemoApplication02" foi criado. Supondo que um aplicativo já tenha sido criado, é necessário criar um processo nesse aplicativo para chamar o serviço executeScript. Para adicionar um processo ao aplicativo que inclua o Execute Script serviço:

Adicionar um script ao processo com o serviço "Executar script" add-script-to-process-with-execute-script

Depois que o processo tiver sido criado com a atividade "Executar Script" Service definida, é possível adicionar um script a esse processo. Para adicionar um script a esse processo:

Criando XML Usando o Serviço de Script de Execução create-xml-execute-script-service

Depois que um processo é criado com o serviço Executar script incluído, é possível usar esse script para criar XML. Você escreveria os scripts descritos abaixo na caixa de texto descrita em Adicionar um script ao processo com o Execute Script seção de serviço acima.

Sobre a tecnologia do Execute Script Service

Para saber quais são as habilidades e limitações do serviço Execute Script, é preciso conhecer os fundamentos tecnológicos do serviço. O AEM Forms no JEE usa o analisador do Apache Xerces Document Object Model (DOM) para criar e armazenar variáveis XML em processos. Xerces é uma implementação Java™ da especificação Document Object Model da W3C; definida aqui. A especificação DOM é uma maneira padrão de manipular XML que existe desde 1998. A implementação Java™ do Xerces, Xerces-J, é compatível com a versão 1.0 do DOM Nível 2.

As classes Java™ usadas para armazenar variáveis XML são:

DocumentImpl é uma subclasse de NodeImpl, então pode-se supor que qualquer variável de processo XML é uma derivação de NodeImpl. Você pode encontrar a documentação do NodeImpl aqui.

Um exemplo de criação XML usando o serviço Executar script

Este é um exemplo de criação de XML, em um serviço Executar script. O processo tem um nó de variável do tipo XML. O resultado desta atividade é um documento XML. O que esse documento faz ou como se aplica ao processo geral está fora do escopo deste tutorial; em última análise, se resume ao que o XML é necessário fazer no aplicativo geral. Como foi mencionado na introdução, o XML pode ser usado para muitos propósitos no AEM Forms em formulários e processos JEE, esta é simplesmente uma explicação de como codificar a atividade Executar script para produzir um documento XML simples.

Um JavaScript simples para XML de saída seria semelhante a:

import org.apache.xerces.dom.DocumentImpl;

import org.w3c.dom.Document;

import org.w3c.dom.Element;



Document document = new DocumentImpl();

Element topLevelResources = document.createElement("resources");

Element resource = document.createElement("resource");

resource.setAttribute("id", "first item id");

resource.setAttribute("value", "first item value");

topLevelResources.appendChild(resource);

document.appendChild(topLevelResources);

patExecContext.setProcessDataValue("/process_data/node", document);

O resultado desse script simples é um novo documento XML com um nó de variável definido como:

<resources>

<resource id="first item id" value="first item value"/>

</resources>

Usando um loop iterativo para adicionar nós ao XML

Os nós também podem ser adicionados a uma variável XML existente no processo. A variável, nó, contém o objeto XML criado.

Document document = patExecContext.getProcessDataValue("/process_data/node");

NodeList childNodes = document.getChildNodes();

int numChildren = childNodes.getLength();

for (int i = 0; i < numChildren; i++)

{

Node currentChild = childNodes.item(i);

if (currentChild.getNodeType() == Node.ELEMENT_NODE)

{

// found the top-level node

Element newResource = document.createElement("resource");

newResource.setAttribute("id", "second item id");

newResource.setAttribute("value", "second item value");

currentChild.appendChild(newResource);

break;

}

}

patExecContext.setProcessDataValue("/process_data/node", document);
The variable node in the XML is now set to:

<resources>

<resource id="first item id" value="first item value"/>

<resource id="second item id" value="second item value"/>

</resources>