Instrução de Trabalho – Integração de Inserção de Narrativas

1. Objetivo.

O objetivo desta Instrução de Trabalho (IT) é apresentar o modo e como funciona a integração de inserção de narrativas. Dentro do sistema, isto equivale a um comentário em uma ocorrência já aberta.

2. Modo de Proceder.

Utilizamos o SOAP (Protocolo Simples de Acesso a Objetos) para realizar as integrações, facilitando a comunicação com qualquer tipo de aplicação disponível no mercado seja ela Web ou Client Server.

As informações dos serviços disponíveis ficam em https://www.[caminho do seu sistema]/webservices .

Neste endereço, irá encontrar diversos métodos de integrações. Para a Integração de Abertura de Ocorrência, utilizaremos o Método Dados ServiceDesk.

Ao clicar no método poderá verificar todos os parâmetros disponíveis.

No final do documento há um link para a Página de Teste dos Formulários.

A página de testes permite simular um envio à API sem utilização de nenhum software adicional. Ao final do formulário são listados todos os campos do webservice com suas descrições.

Ao gerar o XML de comunicação, é importante não alterar a ordem dos campos, nem tampouco removê-los. Deixe-os com valor nulo ou no máximo como uma string vazia se não for possível manda-los como nulo.

Atente-se à obrigatoriedade de certos campos. Caso tenha dúvida sobre quais informações devem ser passadas, entre em contato com a consultoria da Multidados.

3. Exemplo de XML de Envio.

<soapenv:Envelopexmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:urn="urn:server.Multidados">
<soapenv:Header/>
<soapenv:Body>
<urn:DadosNarrativasOCsoapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<USUARIO_WSxsi:type="xsd:string">usuario_webservice</USUARIO_WS>
<SENHA_WSxsi:type="xsd:string">senha_webservice</SENHA_WS>
<N_OCORRENCIAxsi:type="xsd:string">8559</N_OCORRENCIA>
<DATA_HORA_ATENDIMENTOxsi:type="xsd:string"></DATA_HORA_ATENDIMENTO>
<COD_OPERADORxsi:type="xsd:string">operador_financeiro</COD_OPERADOR>
<NOME_OPERADORxsi:type="xsd:string">JosefinadaSilva</NOME_OPERADOR>
<DESCRICAOxsi:type="xsd:string">EsteéumcomentáriofeitonaminhaOCusandoaAPISOAP</DESCRICAO>
<FILE1_NAMExsi:type="xsd:string">anexo1.png</FILE1_NAME>
<FILE1_BIN_CONTENTxsi:type="xsd:string">iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABGdBTUEAAK/INwWK6QAAABl0RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAAInSURBVHjaYvz//z8DJQAggJgYKAQAAcTCOIFRluEPw2OGr0DeNyD+DsR/QDJAzAbErEhsFiifjUGZjZ0hmZmZQRcggFgY/jJsBGqoBgpvx2sVyKf/GKSAZBJQfdqvPww/GFkYQgECiInpL9NvVg7WxQy/GRxxavzFIAwkywVkBPZJykg2A135iOEngxNQ7CJAADH9//R/lbCWsDCHHMcihh8MlgyMSJp/M4gDXZjBIs1yVNpXuoNfll/91e1X24Gaw4DqnoCUAAQQy/8P/0+/+/HuF1MIkwzDO4alDA8YQoDi14C2JjDIMyQwWjGas5myMXw4+YHh6/avqxmYGdIYOBg+wOwACCBGhhQGMaDC7QwFDEYMr4Ai8xnuAp34lsGOwYzBAsgXBeINQLyFYQIDF0MDAy/DR3CAcjAwMHIxMAAEEAswYF4x3GE4xXAdaIA6UCKcQZmBCYglwV5gYJgKDLJTDP0M7AyVQNv/ogcRQAAxAf3DwPCF4TTDJaAkyAXsQMwNxA+BeBYQ7wNq/M9Qhk0zCAAEEAvDZyD5l+EYwwWgs/WA3gHF8xOws38w3GbIAxo2mwFPcgMIIBawuX8ZbgA1XWV4ATTgF9i/74ERVQz083wGAmkVIIBYwP78B8Q/gY49BkwLzxleAzXHAVPdDpQoxQEAAogZGFwMYIX/gU5+zmDO8AkYLywMe8BiLEhJGZlmhrAZgWyAAGKkNDcCBBDFuREgwADDUYv001UhNgAAAABJRU5ErkJggg==</FILE1_BIN_CONTENT>
<FILE2_NAMExsi:type="xsd:string"></FILE2_NAME>
<FILE2_BIN_CONTENTxsi:type="xsd:string"></FILE2_BIN_CONTENT>
<FILE3_NAMExsi:type="xsd:string"></FILE3_NAME>
<FILE3_BIN_CONTENTxsi:type="xsd:string"></FILE3_BIN_CONTENT>
<JSON_ANEXOSxsi:type="xsd:string"></JSON_ANEXOS>
</urn:DadosNarrativasOC>
</soapenv:Body>
</soapenv:Envelope>

4. Exemplo de retorno de sucesso.

<SOAP-ENV:EnvelopeSOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:DadosNarrativasOCResponsexmlns:ns1="urn:server.Multidados">
<returnxsi:type="xsd:string">T</return>
</ns1:DadosNarrativasOCResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

5. Segurança da Informação.

Para utilizar os métodos de nosso webservice é necessário um usuário e senha cadastrados no sistema e a liberação dos IP que farão a comunicação com o serviço.

Com isso eliminamos qualquer tipo de comunicação externa que não tenhamos conhecimento prévio.

A Liberação dos IPs que utilizam os webservices é realizada pela Equipe Técnica da Multidados.