Cross Segmentos - Backoffice RM - Integração - WebServices - Como executar Conceito via Webservices

Tempo aproximado para leitura: 00:03:20 min

Dúvida
Como executar um Conceito via Webservice RM?

Ambiente
Cross Segmentos - Backoffice RM - Integração - Todas as Versões.

Solução

O objetivo desse documento é esclarecer e exemplificar a execução de um novo Conceito via WebServices.

Para o exemplo, criamos um Conceito simples que possui como Conexão de Origem o DataServer GlbUsuarioData  e como Conexão de Destino um arquivo em XML. 
Conforme o utilizado na seguinte documentação:
Como realizar a exportação de dados do sistema para XML

Seguem as informações do Conceito configurado ao teste, este possui o ID 19:

Para executar um Novo Conceito via webservice é necessário utilizar o wsProcess: o webservice responsável pela execução de processos do sistema.
wsProcess

O método que deverá ser utilizado é o "ExecuteWithXmlParams", o qual possui dois parâmetros:

O parâmetro <tot:ProcessServerName> deve ser preenchido com o processo "ConConceptProcess".
O parâmetro <tot:strXmlParams> deve ser preenchido com o XML de Parâmetro de Jobs do processo de execução do Conceito.

No parâmetro"strXmlParams", deve ser adicionada a tag <![CDATA[ XML Extraído]]>. o XML de Parâmetro de Jobs deve ser passado nos colchetes com os devidos ajustes para executar o Conceito correto desejado.

Segue abaixo nossa documentação para Extrair o XML do Job:
Como identificar e extrair um XML exemplo de Processo

É na tag ConceptID do XML de Parâmetro de Jobs do Conceito, a qual é passado o ID do Conceito que será executado.

Request realizado no ExecuteWithXmlParams do WsProcess

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">
<soapenv:Header/>
<soapenv:Body>
<tot:ExecuteWithXmlParams>
<!--Optional:-->
<tot:ProcessServerName>ConConceptProcess</tot:ProcessServerName>
<!--Optional:-->
<tot:strXmlParams><![CDATA[seuXML]]></tot:strXmlParams>
</tot:ExecuteWithXmlParams>
</soapenv:Body>
</soapenv:Envelope>

Efetue as alterações conforme informado do <tot:strXmlParams>, para executar o XML do Conceito correto desejado, para o exemplo utilizaremos o ID de Conceito 19, conforme o conceito previamente criado. 



Assim que o processo for executado e este possuir o seguinte retorno conforme acima, indica que sua execução foi realizada corretamente:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ExecuteWithXmlParamsResponse xmlns="http://www.totvs.com/">
<ExecuteWithXmlParamsResult>1</ExecuteWithXmlParamsResult>
</ExecuteWithXmlParamsResponse>
</s:Body>
</s:Envelope>

Ao verificar a tela de Gerenciamento de Jobs do ambiente, podemos verificar que a execução do Conceito foi corretamente realizada pelo WebService:

Ao validar o diretório ao qual a Conexão de Destino gera o arquivo XML, podemos verificar que este foi corretamente gerado, possuindo todas as informações conforme a geração padrão do Conceito:

Saiba Mais:
Para mais informações, segue documentação abaixo:
Execução de Conceito via WebService