Base de Conhecimento

Os conectores externos se resumem em qualquer aplicação web chamada pelo uMov.Mobile. Esta chamada pode estar associada a um evento ou a uma fórmula de valor em um campo de seção.

Chamada de conectores em fórmulas de valor

Para alimentar um campo da seção no uMov.me através de conector externo é preciso seguir os seguintes passos:

1. Criar no uMov.me a atividade, seção e campo que será alimentado com o resultado do conector;

2. Configurar a chamada do conector no uMov.Center (lembrando que esta operação deve ser realizada em http://center.umov.me/CenterWeb/connector, pois ainda não temos interface disponível);

3. Configurar a fórmula de valor no campo de seção para chamar o conector criado, sendo que o campo a ser criado deve ser um campo multimídia do tipo xml (no artigo Campo Multimídia - Opções Disponíveis temos o passo a passo de como criar o campo).

Protocolo de comunicação

A comunicação entre uMov.me e conectores é implementada sobre o protocolo HTTP/HTTPS usando verbos conhecidos do protocolo como GET e POST para realizar as requisições.

Originalmente o formato suportado é XML - eXtensible Markup Language, baseado nos conceitos REST (Representational State Transfer).

Post (Input)

No post que o uMov.mobile realiza no serviço web é possível configurar quais informações serão enviadas no corpo da requisição: dados da pessoa, do local, da tarefa e/ou da atividade. Desta forma é possível compartilhar qualquer informação que esteja no dispositivo móvel.

Abaixo estão listados exemplos dos XML que o uMov.me irá enviar.

Vale ressaltar que os campos existentes podem sofrer alterações de acordo com as customizações de cada ambiente.

<event>

<workspaceId>{ID DO AMBIENTE QUE O EVENTO OCORREU}</workspaceId>

<workspace>{NOME DO AMBIENTE QUE O EVENTO OCORREU}</workspace>

<name>{NOME DO EVENTO OCORRIDO}</name>

<eventPlataformId>{IDENTIFICAÇAO DO EVENTO PLATAFORMA ASSOCIADO AO EVENTO EXECUTADO}</eventPlataformId>

<actionParameter>{PARAMETRO INSERIDO PELO USUARIO NO CADASTRO DA ACAO DE UM EVENTO}</actionParameter>

<connectorParameter>{PARAMETRO INSERIDO PELO USUARIO AO CADASTRAR UM CONECTOR}</connectorParameter>

</eventParameter>

</eventParameter>

</eventParameters>

</event>

<agent>

</agentType>

<recordDate1>{FORMATO yyyy-mm-dd}</recordDate1>

<recordDate2>{FORMATO yyyy-mm-dd}</recordDate2>

<recordDate3>{FORMATO yyyy-mm-dd}</recordDate3>

<recordDate4>{FORMATO yyyy-mm-dd}</recordDate4>

<recordDate5>{FORMATO yyyy-mm-dd}</recordDate5>

</customFieldValue>

</customFieldValues>

</customField>

</customFieldValue>

</customFieldValues>

</customField>

</customFieldValue>

</customFieldValue>

</customFieldValue>

</customFieldValue>

</customFieldValue>

</customFieldValue>

</customFieldValues>

</customField>

</customFields>

</agent>

<recordDate1>{FORMATO yyyy-mm-dd}</recordDate1>

<recordDate2>{FORMATO yyyy-mm-dd}</recordDate2>

<recordDate3>{FORMATO yyyy-mm-dd}</recordDate3>

<recordDate4>{FORMATO yyyy-mm-dd}</recordDate4>

<recordDate5>{FORMATO yyyy-mm-dd}</recordDate5>

<insertDateTime>{FORMATO yyyy-mm-dd hh:mm:ss}</insertDateTime>

<agentInsert>{ID DO AGENTE}</agentInsert>

<lastUpdateDateTime>{FORMATO yyyy-mm-dd hh:mm:ss}</lastUpdateDateTime>

<agentLastUpdate>{ID DO AGENTE}</agentLastUpdate>

<accountable>{ID DO AGENTE RESPONSAVEL PELO LOCAL DE ATENDIMENTO}</accountable>

</customFieldValue>

</customFieldValues>

</customField>

</customFieldValue>

</customFieldValues>

</customField>

</customFieldValue>

</customFieldValue>

</customFieldValue>

</customFieldValue>

</customFieldValue>

</customFieldValue>

</customFieldValues>

</customField>

</customFields>

</serviceLocal>

<hour>{FORMATO 24hs HH:mm}</hour>

<date>{FORMATO yyyy-mm-dd}</date>

<executionDate>{FORMATO yyyy-mm-dd}</executionDate>

<executionHour>{FORMATO 24hs HH:mm}</executionHour>

<executionStartDate>{FORMATO yyyy-mm-dd}</executionStartDate>

<executionStartTime>{FORMATO 24hs HH:mm}</executionStartTime>

<executionEndDate>{FORMATO yyyy-mm-dd}</executionEndDate>

<executionEndTime>{FORMATO 24hs HH:mm}</executionEndTime>

<agent>

</agent>

</serviceLocal>

</activity>

</activity>

</activities>

</customFieldValue>

</customFieldValue>

</customFieldValues>

</customField>

</customFieldValue>

</customFieldValue>

</customFieldValues>

</customField>

</customFields>

</schedule>

<dataSource>{EXECUTADA PELO MOBILE = 0 - EXECUTADA PELO uMov.CENTER = 1}</dataSource>

</activity>

<startTimeOnSystem>{FORMATO yyyy-mm-dd hh:mm:ss}</startTimeOnSystem>

<finishTimeOnSystem>{FORMATO yyyy-mm-dd hh:mm:ss}</finishTimeOnSystem>

</section>

<item>

</item>

</sectionField>

<!--

LISTA = Valores separados por @

LISTA unica = String("carro")

Alfanumerico = String("moto")

LOGICO = conforme valores inseridos pelo usuário

DATA = yyyy-mm-dd

HORA = HH:mm

NUMERICO = 12.45 ou 12

-->

</activityHistoryItem>

</section>

<item>

</item>

</sectionField>

</activityHistoryItem>

</activityHistoryItems>

</activityHistorical>

</activity>

<startTimeOnSystem>{FORMATO yyyy-mm-dd hh:mm:ss}</startTimeOnSystem>

<finishTimeOnSystem>{FORMATO yyyy-mm-dd hh:mm:ss}</finishTimeOnSystem>

</section>

<item>

</item>

</sectionField>

</activityHistoryItem>

</section>

<item>

</item>

</sectionField>

</activityHistoryItem>

</activityHistoryItems>

</activityHistorical>

</historicals>

<iconColor>{cor dos ícones de menus e elementos de lista (1=verde umov, 2=branco, 3=preto, 4=cinza)}</iconColor>

<buttonIconColor>{cor dos ícones de botões (1=branco, 2=preto, 3=cinza)}</buttonIconColor>

<buttonAndHeaderColor>{cor dos botões e cabeçalhos}</buttonAndHeaderColor>

<buttonFocussedColor>{cor dos botões em foco}</buttonFocussedColor>

<buttonTextColor>{cor dos textos sobre os botões}</buttonTextColor>

<otherTextColor>{cor dos demais textos}</otherTextColor>

<backgroundColor>{cor de fundo da tela}</backgroundColor>

<footerColor>{cor do rodapé}</footerColor>

<linkMainImage>{link do imagem da tela inicial}</linkMainImage>

<linkMenuImage>{link do imagem do menu principal}</linkMenuImage>

</mobileAppearance>

<iconColor>{cor dos ícones dos menus (0-preto, 1-branco)}</iconColor>

<headerColor>{cor do cabeçalho}</headerColor>

<menuBackgroundColor>{cor de fundo do menu}</menuBackgroundColor>

<menuPrimaryColor>{cor primaria do menu}</menuPrimaryColor>

<menuPrimaryTextColor>{cor do texto do menu primario do menu}</menuPrimaryTextColor>

<menuSecondaryColor>{cor secondaria do menu}</menuSecondaryColor>

<menuSecondaryTextColor>{cor do testo do menu secundario}</menuSecondaryTextColor>

<otherTextColor>{cor dos demais textos}</otherTextColor>

<backgroundColor>{cor de fundo da tela}</backgroundColor>

<footerColor>{cor do rodapé}</footerColor>

<linkMainImage>{link do imagem da tela inicial}</linkMainImage>

<linkMenuImage>{link do imagem do menu principal}</linkMenuImage>

</centerAppearance>

</context>

Result (Output)

<code>{CODIGO DE RETORNO}</code>

<message>{MENSAGEM TEXTO RESULTANDO DA OPERAÇAO}</message>

<type>{CARACTER REPRESENTANDO O TIPO DA INFORMAÇÃO}</type>

<entry>

<internalValue>{VALOR PARA TRATAMENTO INTERNO}</internalValue>

<value>{VALOR DO RESULTADO}</value>

</entry>

</entries>

<data>

<dataType>{CARACTER REPRESENTANDO O TIPO DA INFORMAÇÃO}</dataType>

<internalValue>{VALOR PARA TRATAMENTO INTERNO}</internalValue>

<value>{VALOR DO RESULTADO}</value>

</valueEntry>

</values>

<entity>{NOME DA ENTIDADE QUE RECEBERA A ATRIBUICAO}</entity>

<identifier>{IDENTIFICADOR ALTERNATIVO DO REGISTRO QUE VAI RECEBER A ATRIBUICAO}</identifier>

<itemIdentifier>{IDENTIFICADOR ALTERNATIVO DO ITEM QUE VAI RECEBER A ATRIBUICAO}</itemIdentifier>

</destination>

</destinations>

</data>

</dataset>

</additional>

</result>

<entry>

<value>Segunda</value>

</entry>

<entry>

<value>Terca</value>

</entry>

<entry>

<value>Quarta</value>

</entry>

</entries>

</result>

<entry>

<value>É A FAVOR</value>

</entry>

</entries>

</result>

<entry>

</entry>

</entries>

</result>

<entry>

</entry>

</entries>

</result>

<entry>

<value>aHR0cHM6Ly93d3cuZ29vZ2xlLmNvbS5ici8jaGw9cHQtQlImZ3NfbmY9MSZjcD0xMCZnc19pZD0xMiZ4aHI9dCZxPWd1YXJkYSttdW5pY2lwYWwmcGY9cCZzY2xpZW50PXBzeS1hYiZzaXRlPSZzb3VyY2U9aHAmb3E9Z3VhcmRhK21pbiZhcT0wcyZhcWk9Zy1zMWcyZy1zMSZhcWw9JmdzX2w9JnBieD0xJmJhdj1vbi4yLG9yLnJfZ2Mucl9wdy5yX2NwLixjZi5vc2ImZnA9ODU5YTQyMzkzODYxMTA4JmJpdz0xMjc2JmJpaD03MDY=</value>

</entry>

</entries>

</result>

<entry>

<value>Empresa XYZ</value>

</entry>

</entries>

</result>

<entry>

</entry>

</entries>

</result>

======

Segue exemplo do XML que deve ser retornado para popular um campo lista:

<entry>

<value>Segunda</value>

</entry>

<entry>

<value>Terca</value>

</entry>

<entry>

<value>Quarta</value>

</entry>

</entries>

</result>

Conectores Externos