Base de Conhecimento

A partir da versão 04.54 da mobile na plataforma Android o uMov.me armazena dados de auditoria no momento da execução da atividade. São dados relativos aos dispositivos móveis e seu estado no momento da coleta das informações. Esses dados podem ser capturados via API, conforme mostrado abaixo. Somente é possível realizar a busca desses dados via API e não é permitida a inclusão.

Descrição de um registro de auditoria

Busca Por Lista de Auditoria

GET /CenterWeb/api/{$apiKey}/auditing.xml

Se preferir ainda, pode refinar as pesquisas enviando parâmetros na requisição, para isso é necessário adicionar parâmetros igual realizamos em uma requisição HTTP. O mais comum é filtrar a auditoria coletada em uma execução:

GET /CenterWeb/api/{$apiKey}/auditing.xml?history={HISTORY_ID}

history: pesquisar por um determinado histórico

O resultado de uma requisição deve ser o seguinte:

<result>

<resourceName>auditing</resourceName>

<size>1</size>

<entries>

<entry id="38" link="/auditing/38.xml"/>

</entries>

</result>

Busca Por uma Auditoria Específica

Ao realizar a busca informando o Id da auditoria, o sistema irá buscar todos os dados da auditoria, conforme mostrado no exemplo abaixo:

GET /CenterWeb/api/{$apiKey}/auditing/{AUDITING_ID}.xml

<auditing>

<id>38</id>

<date>2014-07-18 15:01:58</date>

<moment>0</moment>

<agent>

<id>7</id>

<name>Administrador</name>

<login>master</login>

<active>true</active>

</agent>

<schedule>

<id>655470042</id>

<alternativeIdentifier>999</alternativeIdentifier>

<hour>15:00</hour>

</schedule>

<history>

<id>999</id>

</history>

<auditingValues>

<auditingValue id="81" link="/auditingValue/81.xml"/>

<auditingValue id="82" link="/auditingValue/82.xml"/>

<auditingValue id="83" link="/auditingValue/83.xml"/>

<auditingValue id="84" link="/auditingValue/84.xml"/>

<auditingValue id="85" link="/auditingValue/85.xml"/>

<auditingValue id="86" link="/auditingValue/86.xml"/>

<auditingValue id="87" link="/auditingValue/87.xml"/>

<auditingValue id="88" link="/auditingValue/88.xml"/>

<auditingValue id="89" link="/auditingValue/89.xml"/>

<auditingValue id="90" link="/auditingValue/90.xml"/>

<auditingValue id="91" link="/auditingValue/91.xml"/>

</auditingValues>

</auditing>

Descrição de um valor da auditoria

Busca Por uma Valor Específico da Auditoria

Ao realizar a busca informando o Id do valor da auditoria, o sistema irá buscar todos os dados do valor da auditoria, conforme mostrado no exemplo abaixo:

GET /CenterWeb/api/{$apiKey}/auditingValue/{AUDITIONVALUE_ID}.xml

<auditingValue>

<id>81</id>

<keyInformation>PlatformOS</keyInformation>

<valueInformation>ANDROID</valueInformation>

</auditingValue>

Pode ser realizada a busca por um valor filtrando pela chave que deseja ser encontrada:

GET /CenterWeb/api/{$apiKey}/auditingValue.xml?keyInformation=PlatformOS

Busca Hierárquica da Auditoria de um Histórico

É possível também buscar todos os valores de auditoria de um histórico específico em uma única chamada. Para isso, pode ser executada a seguinte chamada:

GET /CenterWeb/api/{$apiKey}/auditingHierarchical/{HISTORY_ID}.xml

<auditing>

<id>38</id>

<date>2014-07-18 15:01:58</date>

<moment>0</moment>

<agent>

<id>7</id>

</agent>

<schedule>

<id>655470042</id>

</schedule>

<history>

<id>8988776655448482</id>

</history>

<auditingValues>

<auditingValue>

<id>81</id>

<keyInformation>PlatformOS</keyInformation>

<valueInformation>ANDROID</valueInformation>

</auditingValue>

<auditingValue>

<id>82</id>

<keyInformation>uMovVersion</keyInformation>

<valueInformation>4,54</valueInformation>

</auditingValue>

<auditingValue>

<id>83</id>

<keyInformation>PlatformAPILevel</keyInformation>

<valueInformation>19</valueInformation>

</auditingValue>

<auditingValue>

<id>84</id>

<keyInformation>IMSI</keyInformation>

<valueInformation>724065103161737</valueInformation>

</auditingValue>

<auditingValue>

<id>85</id>

<keyInformation>IMEI</keyInformation>

<valueInformation>356891050533910</valueInformation>

</auditingValue>

<auditingValue>

<id>86</id>

<keyInformation>BatteryLevel</keyInformation>

<valueInformation>45</valueInformation>

</auditingValue>

<auditingValue>

<id>87</id>

<keyInformation>DeviceSerialNumber</keyInformation>

<valueInformation>cc1d6e58</valueInformation>

</auditingValue>

<auditingValue>

<id>88</id>

<keyInformation>DeviceManufacturer</keyInformation>

<valueInformation>samsung</valueInformation>

</auditingValue>

<auditingValue>

<id>89</id>

<keyInformation>DeviceModel</keyInformation>

<valueInformation>GT-I9505</valueInformation>

</auditingValue>

<auditingValue>

<id>90</id>

<keyInformation>PhoneNumber</keyInformation>

<valueInformation>UNAVAILABLE_PHONE_NUMBER</valueInformation>

</auditingValue>

<auditingValue>

<id>91</id>

<keyInformation>SignalLevel</keyInformation>

<valueInformation>UNAVAILABLE_SIGNAL_LEVEL</valueInformation>

</auditingValue>

</auditingValues>

</auditing>

Para executar a busca filtrando por alguns valores específicos, pode ser realizada a chamada da seguinte forma:

GET /CenterWeb/api/{$apiKey}/auditingHierarchical/{HISTORY_ID}.xml?values=PlatformOS,IMEI

Nesse caso, o sistema retorna todos os dados listados acima, porém somente com os valores PlatformOS e IMEI, conforme informado no filtro. É possível filtrar por vários campos, somente incluindo uma vírgula (,) entre os valores da pesquisa.

Auditing (Auditoria)