Descritivo de Exportação de Dados

Transcrição

1 Descritivo de Exportação de Dados SuperVisor Web 2011 Autotrac Comércio e Telecomunicações S/A

2 Autotrac Comércio e Telecomunicações S/A Matriz - Brasília DF Campus Universitário Darcy Ribeiro Gleba A, Autotrac Asa Norte CEP Fone: (61) Fax: (61) Bahia Rodovia BR 324, S/N, Km 102, CIS Subaé Feira de Santana-BA CEP Fone: (75) Fax: (75) Ceará Rodovia BR 116, n , km 12 Bairro Messejana Fortaleza-CE CEP Fone: (85) Fax: (85) Distrito Federal SCIA Quadra 10, Conjunto 2, Lote 07 Brasília-DF CEP Fone: (61) Fax: (61) Goiás Rodovia BR 153, km 506 Setor de Chácaras São Pedro CEP Aparecida de Goiânia- Fone: (62) Mato Grosso Rodovia dos Imigrantes, Km 8, Box 34 Bairro Capão Grande Várzea Grande - MT CEP Fone: (65) Minas Gerais Uberlândia Rua José Agostinho, nº 39, Bairro Custódio Pereira Uberlândia-MG CEP Fone: (34) Fax: (34) Minas Gerais Contagem Rua Thomaz Jefferson, nº 400 Jardim Industrial CEP Fone: (31) Fax: (31) Pará Rodovia BR 316, 2.938, km 11 Bairro Uriboca Marituba - PA CEP Fone: (91) Fax: (91) Paraná R. Ângela Gabardo Parolim, 201, Campo de Santana Curitiba - PR CEP Fone: (41) Fax: (41) Pernambuco Rodovia BR 101 Sul, Km 80,45 Bairro Comportas Jaboatão dos Guararapes-PE CEP Fone: (81) Fax: (81) Rio de Janeiro Av. Kennedy 179 Parque Boa Vista II Duque de Caxias - RJ CEP Fone: (21) Rio Grande do Sul Av. das Indústrias, 1237 Bairro São João CEP Fone: (51) Fax: (51) Santa Catarina Av. Tancredo de Almeida Neves, 7100 Bairro São Cristovão Concórdia - SC CEP Fone: (49) São Paulo Osasco Rua Vicente Rodrigues da Silva, 828/850, Jardim Piratininga CEP Osasco-SP Fone: (11) Fax: (11) São Paulo São Bernardo do Campo Estrada dos Casa, 2599 Bairro dos Casa CEP São Bernardo do Campo-SP Fone: (11) São Paulo São José do Rio Preto Av. Alfredo Folchini, 2600 Bairro Estância Jóquei Club São José do Rio Preto CEP Fone: (17) Fax: (17) Copyright 2011 Autotrac Comércio e Telecomunicações S.A. Todos os direitos reservados. Todos os dados e informações contidos ou divulgados neste documento são confidenciais e de propriedade da Autotrac Comércio e Telecomunicações S.A. e todos os direitos são expressamente reservados. Ao aceitar este material, o receptor concorda que suas informações serão mantidas em segredo e em custódia e não serão usados, copiados, reproduzidos em sua totalidade ou em parte, nem seu conteúdo será revelado em forma alguma a outros que não possuam permissão escrita da Autotrac Comércio e Telecomunicações S.A. AUTOTRAC, AUTOTRAC SATÉLITE, AUTOTRAC CELULAR, AUTOTRAC CAMINHONEIRO, SuperVisor e SuperVisor Web são marcas registradas e marcas de serviço da Autotrac Comércio e Telecomunicações S.A. WINDOWS e SQL Server são marcas registradas da Microsoft Corporation Em caso de dúvidas ligue para o plantão 24 horas (61) fevereiro-2011 V. 2-YYXAO C 2

3 Índice Introdução...4 Objetivo... 4 Aplicabilidade... 4 Funcionamento... 4 Interface de Exportação de Dados do SuperVisor Web...5 Configurando a Interface de Exportação de Dados do SuperVisor Web...6 Observações Importantes... 6 Banco de Dados de Exportação... 6 Fonte de Dados ODBC... 6 Configurando uma Fonte de Dados ODBC... 6 Informações Disponíveis para a Interface de Exportação de Dados... 8 Mensagens de Retorno... 8 Posicionamentos... 8 Instalação da Interface de Exportação de Dados do SuperVisor Web... 9 Configurando o SuperVisor Web Interface de Exportação Tabelas e Campos da Interface de Exportação...15 Mensagem de Retorno Campos da tabela Implementando a Exportação Chave Primária...16 Campos Obrigatórios...16 Resumo da Exportação...17 Posições Campos da Tabela Implementando a Exportação Chave Primária...18 Campos Obrigatórios...18 Resumo da Exportação...19 Apêndice A Scripts da Base de Exportação...20 Base de Dados de Exportação Tabelas Mensagem de Retorno Posições Apêndice B Caracteres Permitidos...23 Tecnologia Satelital Tecnologia Celular Apêndice D Status de Erro para Mensagem de Envio - Celular...24 Índice de Figuras...25 Descritivo de Exportação de Dados V. 2-YYXAO C 3

4 INTRODUÇÃO Objetivo Este documento tem o objetivo descrever o funcionamento do processo de exportação de dados do SuperVisor Web para outros sistemas, utilizando acesso direto a qualquer banco de dados. Aplicabilidade Esta ferramenta deverá ser utilizada por clientes que possuem seus respectivos sistemas de gestão e controle e necessitam das informações oriundas dos Sistemas da Autotrac (Satelital ou Celular) em suas aplicações. Funcionamento O desenvolvimento desta tecnologia foi feita para o SuperVisor Web, possibilitando a gravação de informações na base de dados do cliente, além de permitir ao usuário a seleção das informações que deverão ser exportadas. 4

5 INTERFACE DE EXPORTAÇÃO DE DADOS DO SUPERVISOR WEB A Interface de Exportação de Dados do SuperVisor Web é responsável por gravar as informações recebidas pelo produto em outro banco de dados, utilizando para isso um driver ODBC compatível. Os dados a serem exportados permanecem nos servidores da Autotrac até o momento em que são baixados e devidamente gravados no banco ou arquivo desejado. A Exportação de Dados do SuperVisor Web é composta por uma interface de administração e um serviço que executa de forma automática as operações gravação. É recomendável que esta aplicação seja instalada no mesmo servidor de dados da exportação, para evitar que problemas locais de rede interfiram neste processo. Descritivo de Exportação de Dados V. 2-YYXAO C 5

6 CONFIGURANDO A INTERFACE DE EXPORTAÇÃO DE DADOS DO SUPERVISOR WEB Observações Importantes Para a Exportação de Dados do SuperVisor Web conectar-se na base do cliente, é necessário utilizar uma Fonte de Dados ODBC. Dessa forma, qualquer banco de dados disponível no mercado, que tenha seu respectivo driver ODBC, poderá ser utilizado. Banco de Dados de Exportação Para receber as informações exportadas, é necessário uma base de dados e/ou um arquivo corretamente configurado nas opções da Fonte de Dados ODBC. Se for utilizado uma base de dados, esta deverá ter uma estrutura compatível com os campos e tabelas cadastradas na Interface de Exportação do SuperVisor Web. Tanto o nome das tabelas quanto o nome dos campos podem ser configurados pelo usuário. As tabelas e os campos em seu formato padrão serão descritos em detalhes em outro tópico. Consulte também o Apêndice A, que possui todos os scripts necessários para se construir o cenário indicado para utilizar a Interface de Exportação de Dados do SuperVisor Web. Estes scripts foram desenvolvidos para serem utilizados com o Microsoft SQL Server Fonte de Dados ODBC Deve-se criar uma fonte de dados ODBC de Sistema para permitir que o SuperVisor Web corretamente na base designada para trabalhar com a Interface de Exportação de Dados. grave Uma fonte de dados de sistema ODBC armazena informações sobre como conectar-se ao provedor de dados indicado. Esta fonte de Sistema é visível a todos os usuários do servidor de exportação, incluindo todos os serviços do NT. Configurando uma Fonte de Dados ODBC 1. Acesse em Painel de Controle, Ferramentas Administrativas, a opção Fonte de Dados (ODBC). 2. Selecione a guia Fonte de dados de sistema. 3. Clique em Adicionar e em seguida, selecione o driver para a fonte de dados desejada. No nosso exemplo, foi selecionado o driver para SQL Server. Clique em concluir e a tela a seguir aparecerá: 6

7 Figura 1 Tela de criação de uma nova fonte de dados ODBC 4. Preencha os dados conforme solicitado e clique em avançar: 4.1. Nome: Nome da fonte de dados. Este nome será cadastrado na Interface de Exportação de Dados do SuperVisor Web como Nome do DSN : da fonte de dados 4.3. Servidor: Nome ou IP do servidor onde está localizada a base de exportação Figura 2 Tela de identificação de acesso de uma fonte de dados ODBC Descritivo de Exportação de Dados V. 2-YYXAO C 7

8 5. Selecione a opção de logon Com autenticação do SQL Server usando ident. de logon e senha inseridos pelo usuário. 6. Digite os dados do usuário para este logon (Identificação de logon e senha). Clique em avançar. Neste momento será feita uma validação dos dados do servidor e usuário. Figura 3 Tela de configuração do banco padrão para a fonte de dados ODBC 7. Marque a opção Alterar o banco de dados padrão para:, e selecione o banco de dados de exportação. Clique em avançar e depois em concluir. Faça um teste de conexão e, caso obtenha êxito no teste, finalize o assistente. Informações Disponíveis para a Interface de Exportação de Dados Através da interface de exportação de dados do SuperVisor Web é possível configurar quais as informações serão disponibilizadas em um arquivo ou banco de dados de exportação. As informações disponíveis são divididas em dois grupos ou tabelas: Mensagens de Retorno Mensagens recebidas dos veículos, no formato livre ou macro/formulário. Posicionamentos Armazena todas as posições enviadas pelos veículos, inclusive as que são oriundas de uma ignição desligada, confirmação de recebimento ou leitura, solicitadas aos veículos (adicionais) e as posições geradas automaticamente. 8

9 Instalação da Interface de Exportação de Dados do SuperVisor Web A Interface de Exportação de Dados do Supervisor Web é a aplicação responsável pela gravação dos dados de exportação no banco de dados do cliente. Para instalar este aplicativo, clique duas vezes no arquivo Setup.exe, localizado na pasta do instalador. 1. Na tela exibida, clicar em avançar. Descritivo de Exportação de Dados V. 2-YYXAO C 9

10 2 - Na próxima tela indique o caminho onde deseja salvar o aplicativo, clicando em Alterar e logo após em Avançar. Caso queira manter o local padrão clique apenas em Avançar. 3 Clique em Instalar para iniciar a instalação. 10

11 4 Confirme o término da instalação clicando em concluir. Configurando o SuperVisor Web Interface de Exportação 1. No local onde foi salvo o aplicativo Supervisor Web Interface de Exportação, execute o arquivo SVWebII.exe para exibir as configurações de exportação. A tela Configuração - Exportação será aberta. Figura 4 - Menu Principal Descritivo de Exportação de Dados V. 2-YYXAO C 11

12 2. Na primeira opção, Configurações Gerais, será necessário inserir os dados: Número da licença para utilização da aplicação Dados de autenticação do DSN (usuário e senha da fonte de dados) Endereço do servidor local, Endereço do servidor da Autotrac, Porta TCP que será utilizada na conexão com o gateway da aplicação. Porta TCP responsável pela atualização automática do Exportador. Figura 5 - Exemplo de configurações OBS: As informações de Identificação do servidor, bem como o Alias da companhia, serão atualizados após a primeira conexão do aplicativo de exportação com a HUB (AUTOTRAC). Após preencher os campos com as informações desejadas, clique em Atualizar. Os dados serão gravados e será exibido o menu principal da aplicação. 12

13 3. Na opção Contas, serão exibidas as contas que possuem exportação habilitada. Nessa mesma tela, clicando em cada conta, é possível visualizar as permissões liberadas para cada uma, conforme imagem a seguir. Importante: A aplicação só irá exportar os dados que estiverem marcados na tela acima. 4. A opção Campos/Tabelas permite a configuração de todos os campos e tabelas que serão exportados na base de dados do cliente. Figura 6 Tela Configuração de Tabelas e Campos Selecionando a conta e o tipo de dados, é possível alterar o nome da tabela bem como o nome dos campos, de acordo com o banco de exportação do cliente. Descritivo de Exportação de Dados V. 2-YYXAO C 13

14 Os nomes das tabelas e dos campos selecionados deverão ser os mesmos das tabelas e campos criados na base de dados de exportação. Estes nomes poderão ser alterados de acordo com a necessidade (marcando o campo e apertando a tecla F2 do teclado). Os campos em negrito são obrigatórios e não poderão ser desmarcados da exportação. É possível também marcar vários campos da tabela que serão exportados. Para salvar qualquer alteração realizada nessa tela, clique em Gravar Tabela/Campos. 5. O servidor que hospedará o aplicativo Supervisor Web Interface de Exportação no ambiente do cliente será controlado pela Autotrac através de licença e identificação do servidor. A licença será fornecida pela Autotrac através do Call Center. Cada cliente terá direito a uma licença, que credenciará os servidores que utilizarão o aplicativo Supervisor Web Interface de Exportação. A Identificação de cada servidor será gerada automaticamente pela Autotrac. Cada servidor terá uma identificação única. Se houver a necessidade de migrar o aplicativo de exportação para outro servidor, será necessário liberar a licença. Para isso, use a opção Liberar Licença. Digite a identificação no campo Identificação, e pressione o botão liberar. Pronto! A licença poderá ser utilizada em outro servidor. 14

15 TABELAS E CAMPOS DA INTERFACE DE EXPORTAÇÃO A seguir estão descritos todas as tabelas e todos os campos disponíveis na Interface de Exportação do SuperVisor Web. Os nomes das tabelas e campos podem ser configuráveis pelo usuário, bem como quais campos serão utilizados pela base de dados da exportação. Mensagem de Retorno Nome sugerido para a tabela: ReturnMessage_IIRTN Campos da tabela Campo Nome Padrão Tipo de Dados Ref. SQL AccountNumber IIRTN_AccountNumber Número da conta/subconta ou UC fixa INT/4 MctAddres IIRTN_MctAddres Número serial do MCT ou UCC INT/4 GRMN IIRTN_GRMN Número serial da mensagem, atribuído pela Autotrac INT/4 ReplyGFMN IIRTN_ReplyGFMN Número serial da mensagem original, no caso de se tratar de uma mensagem de resposta INT/4 Status dos alarmes dos sensores externos: ExternalSensorAlarm IIRTN_ExternalSensorAlarm 0 Nenhum alarme de sensor ativado 1 Alarme de sensor Tinyint/1 Prioridade da mensagem: MsgPriority IIRTN_MsgPriority 0 Mensagem Normal Tinyint/1 8 Botão de Pânico 9 Mensagem de Emergência Status da ignição do veículo: VehicleIgnition IIRTN_VehicleIgnition 0 Desconhecida Tinyint/1 1 Ligada 2 Desligada Número da macro: Tecnologia Satelital 0 Mensagem Livre MacroNumber IIRTN_MacroNumber 1 63 Número da Macro Tinyint/1 Tecnologia Celular 0 Mensagem Livre Descritivo de Exportação de Dados V. 2-YYXAO C 15

16 1 100 Número da Macro Versão da macro: MacroVersion IIRTN_MacroVersion 0 Mensagem Livre Tinyint/1 => 1 Número da Versão da Macro Tipo da mensagem: BinaryDatatype IIRTN_BinaryDatatype Tinyint/1 0 Formato Texto Latitude IIRTN_Latitude Latitude em graus decimais referente à posição do veículo no momento do envio da mensagem de retorno Decimal Decimal P: 8 S: 6 Longitude IIRTN_Longitude Longitude em graus decimais referente à posição do veículo no momento do envio da mensagem de retorno Decimal Decimal P: 8 S: 6 PositionTime IIRTN_PositionTime Data/hora correspondente à posição do veículo no momento do envio da mensagem de retorno Data/hora Datetime MessageTime Landmark IIRTN_MessageTime IIRTN_Landmark Data/hora em que a mensagem foi recebida na central da Autotrac Data/hora Datetime Posição do veículo em relação às referências cadastradas no SuperVisor Web Texto Varchar/255 Text IIRTN_Text Texto da mensagem Texto Varchar/4000 Subtipo da mensagem: Tecnologia Satelital MsgSubType IIRTN_MsgSubType 0 Mensagem Texto (livre ou macro) Smallint/2 Tecnologia Celular MsgTag IIRTN_MsgTag 1001 Mensagem Texto (livre ou macro) Tag da mensagem (válido para mensagem entre contas) Texto Varchar/10 Implementando a Exportação CHAVE PRIMÁRIA Recomenda-se criar um campo com auto-incremento e defini-lo como chave da tabela. CAMPOS OBRIGATÓRIOS Para a tabela de Mensagem de Retorno, é obrigatório ter alguns campos criados nas tabelas, pois os mesmos não podem ser desmarcados da interface do SuperVisor Web. Os seguintes campos são obrigatórios: Campo Nome Padrão Tipo de Dados Ref. SQL GRMN IIRTN_GRMN Número serial da mensagem, atribuído pela Autotrac INT/4 16

17 Subtipo da mensagem: Tecnologia Satelital 0 Mensagem Texto (livre ou macro) MsgSubtype IIRTN_MsgSubtype Tecnologia Celular Smallint/ Mensagem Texto (livre ou macro) RESUMO DA EXPORTAÇÃO As mensagens de retorno gravadas na exportação podem ser divididas em dois grupos, satelital e celular, através do campo MsgSubtype, onde o valor 0 (zero) corresponde à satelital e 1001 à celular. Descritivo de Exportação de Dados V. 2-YYXAO C 17

18 Posições Nome sugerido para a tabela: PositionHistory_IIPOS Campos da Tabela Campo Nome Padrão Tipo de Dados Ref. SQL AccountNumber IIPOS_AccountNumber Número da conta/subconta ou UC fixa INT/4 MctAddress IIPOS_MctAddress Número serial do MCT ou UCC INT/4 Status dos alarmes dos sensores externos: ExternalSensorAlarm IIPOS_ExternalSensorAlarm 0 Nenhum alarme de sensor ativado 1 Alarme de sensor Tinyint/1 Latitude IIPOS_Latitude Latitude em graus decimais referente à posição do veículo Decimal Decimal P: 8 S: 6 Longitude IIPOS_Longitude Longitude em graus decimais referente à posição do veículo Decimal Decimal P: 8 S: 6 TimePosition IIPOS_TimePosition Data/hora correspondente à posição do veículo Data/hora Datetime Status da ignição do veículo: VehicleIgnition IIPOS_VehicleIgnition 0 Desconhecida Tinyint/1 1 Ligada 2 Desligada Landmark IIPOS_Landmark Posição do veículo em relação às referências cadastradas no SuperVisor Texto Varchar/255 Web MctName IIPOS_MctName Nome do veículo Texto Varchar/255 Implementando a Exportação CHAVE PRIMÁRIA Deve-se criar um campo com um nome qualquer (exemplo: IIPOS_ID), do tipo inteiro auto-incrementável, para servir como chave primária. CAMPOS OBRIGATÓRIOS Para a tabela de Posições, é obrigatório ter alguns campos criados nas tabelas, pois os mesmos não podem ser desmarcados da interface de exportação do SuperVisor Web. Campo Nome Padrão Tipo de Dados Ref. SQL AccountNumber IIPOS_AccountNumber Número da conta/subconta ou UC fixa INT/4 MctAddress IIPOS_MctAddress Número serial do MCT ou UCC INT/4 18

19 RESUMO DA EXPORTAÇÃO As seguintes posições recebidas dos veículos são copiadas para a base de dados de exportação: posições solicitadas (avulsas) posição gerada quando o veículo transmite o recibo ao receber uma mensagem posição gerada quando o veículo transmite o recibo ao confirmar a leitura de uma mensagem posição gerada quando o veículo transmite o recibo ao receber um comando posição gerada quando o SuperVisor Web recebe uma mensagem do veículo posição gerada quando o SuperVisor Web recebe um alerta enviado pelo veículo Descritivo de Exportação de Dados V. 2-YYXAO C 19

20 APÊNDICE A SCRIPTS DA BASE DE EXPORTAÇÃO Os scripts a seguir foram criados utilizando todas as opções da Interface de Exportação do SuperVisor Web. Os nomes das tabelas e dos campos utilizados foram os sugeridos/padrões indicados nesta documentação. Estes scripts foram feitos para serem utilizados com o Microsoft SQL Server Base de Dados de Exportação Script para a criação do banco de dados da exportação. O nome padrão do banco é Exporta, e o caminho default utilizado é "C:\Arquivos de programas\microsoft SQL Server\MSSQL\data". Caso seja necessário, crie a base de dados primeiro e execute os outros scripts nesta nova base. Nome padrão: Exporta IF EXISTS (SELECT name FROM master.dbo.sysdatabases WHERE name = N'Exporta') DROP DATABASE [Exporta] CREATE DATABASE [Exporta] ON (NAME = N'Exporta_Data', FILENAME = N'C:\Arquivos de programas\microsoft SQL Server\MSSQL\data\Exporta_Data.MDF', SIZE = 2, FILEGROWTH = 10%) LOG ON (NAME = N'Exporta_Log', FILENAME = N'C:\Arquivos de programas\microsoft SQL Server\MSSQL\data\Exporta_Log.LDF', SIZE = 1, FILEGROWTH = 10%) COLLATE Latin1_General_CI_AS Tabelas Para a criação das três tabelas usadas pela Interface de Exportação do SuperVisor Web, foram criados os scripts abaixo, separados para cada uma das tabelas 1. Uma breve descrição foi acrescentada nas propriedades estendidas de cada campo. Mensagem de Retorno Nome padrão: ReturnMessage_IIRTN USE EXPORTA if exists (select * from dbo.sysobjects where id = object_id(n'[dbo].[returnmessage_iirtn]') and OBJECTPROPERTY(id, N'IsUserTable') = 1) drop table [dbo].[returnmessage_iirtn] CREATE TABLE [dbo].[returnmessage_iirtn] ( [IIRTN_AccountNumber] [int] NOT NULL, [IIRTN_MctAddres] [int] NOT NULL, [IIRTN_GRMN] [int] NOT NULL, [IIRTN_ReplyGFMN] [int] NULL, [IIRTN_ExternalSensorAlarm] [tinyint] NULL, [IIRTN_MsgPriority] [tinyint] NULL, [IIRTN_VehicleIgnition] [tinyint] NULL, [IIRTN_MacroNumber] [tinyint] NULL, [IIRTN_MacroVersion] [tinyint] NULL, 1 O nome do banco de dados utilizado é o padrão. Caso seja utilizado outro banco, alterar também nas clausulas USE de cada script de criação das tabelas. 20

21 [IIRTN_BinaryDatatype] [tinyint] NULL, [IIRTN_Latitude] [decimal](8, 6) NULL, [IIRTN_Longitude] [decimal](8, 6) NULL, [IIRTN_PositionTime] [datetime] NULL, [IIRTN_MessageTime] [datetime] NULL, [IIRTN_Landmark] [varchar] (255) COLLATE Latin1_General_CI_AS NULL, [IIRTN_Text] [varchar] (4000) COLLATE Latin1_General_CI_AS NULL, [IIRTN_MsgSubtype] [smallint] NULL, [IIRTN_MsgTag] [varchar] (10) COLLATE Latin1_General_CI_AS NULL, CONSTRAINT [PK_ReturnMessage_IIRTN] PRIMARY KEY CLUSTERED ( [IIRTN_AccountNumber], [IIRTN_MctAddres], [IIRTN_GRMN] ) ON [PRIMARY] ) ON [PRIMARY] exec sp_addextendedproperty N'MS_Description', N'Número da conta/subconta ou UC fixa', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_AccountNumber' exec sp_addextendedproperty N'MS_Description', N'Tipo da mensagem', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_BinaryDatatype' exec sp_addextendedproperty N'MS_Description', N'Status dos alarmes dos sensores externos', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_ExternalSensorAlarm' exec sp_addextendedproperty N'MS_Description', N'Número serial da mensagem, atribuído pela Autotrac', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_GRMN' exec sp_addextendedproperty N'MS_Description', N'Posição do veículo em relação às referências cadastradas no SuperVisor Web', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_Landmark' exec sp_addextendedproperty N'MS_Description', N'Latitude em graus decimais referente à posição do veículo no momento do envio da mensagem de retorno', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_Latitude' exec sp_addextendedproperty N'MS_Description', N'Longitude em graus decimais referente à posição do veículo no momento do envio da mensagem de retorno', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_Longitude' exec sp_addextendedproperty N'MS_Description', N'Número da macro', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_MacroNumber' exec sp_addextendedproperty N'MS_Description', N'Versão da macro', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_MacroVersion' exec sp_addextendedproperty N'MS_Description', N'Número serial do MCT ou UCC', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_MctAddres' exec sp_addextendedproperty N'MS_Description', N'Data/hora em que a mensagem foi recebida na central da Autotrac', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_MessageTime' exec sp_addextendedproperty N'MS_Description', N'Prioridade da mensagem', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_MsgPriority' exec sp_addextendedproperty N'MS_Description', N'Subtipo da mensagem', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_MsgSubtype' exec sp_addextendedproperty N'MS_Description', N'Tag da mensagem (válido para mensagem entre contas)', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_MsgTag' exec sp_addextendedproperty N'MS_Description', N'Data/hora correspondente à posição do veículo no momento do envio da mensagem de retorno', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_PositionTime' exec sp_addextendedproperty N'MS_Description', N'Número serial da mensagem original, no caso de se tratar de uma mensagem de resposta', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_ReplyGFMN' exec sp_addextendedproperty N'MS_Description', N'Texto da mensagem', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_Text' exec sp_addextendedproperty N'MS_Description', N'Status da ignição do veículo', N'user', N'dbo', N'table', N'ReturnMessage_IIRTN', N'column', N'IIRTN_VehicleIgnition' Descritivo de Exportação de Dados V. 2-YYXAO C 21

22 Posições Nome padrão: PositionHistory_IIPOS USE EXPORTA if exists (select * from dbo.sysobjects where id = object_id(n'[dbo].[positionhistory_iipos]') and OBJECTPROPERTY(id, N'IsUserTable') = 1) drop table [dbo].[positionhistory_iipos] CREATE TABLE [dbo].[positionhistory_iipos] ( [IIPOS_ID] [int] IDENTITY (1, 1) NOT NULL, [IIPOS_AccountNumber] [int] NOT NULL, [IIPOS_MctAddress] [int] NOT NULL, [IIPOS_ExternalSensorAlarm] [tinyint] NULL, [IIPOS_Latitude] [decimal](8, 6) NULL, [IIPOS_Longitude] [decimal](8, 6) NULL, [IIPOS_TimePosition] [datetime] NULL, [IIPOS_VehicleIgnition] [tinyint] NULL, [IIPOS_Landmark] [varchar] (255) COLLATE Latin1_General_CI_AS NULL, [IIPOS_MctName] [varchar] (255) COLLATE Latin1_General_CI_AS NULL, CONSTRAINT [PK_PositionHistory_IIPOS] PRIMARY KEY CLUSTERED ( [IIPOS_ID] ) ON [PRIMARY] ) ON [PRIMARY] exec sp_addextendedproperty N'MS_Description', N'Número da conta/subconta ou UC fixa', N'user', N'dbo', N'table', N'PositionHistory_IIPOS', N'column', N'IIPOS_AccountNumber' exec sp_addextendedproperty N'MS_Description', N'Status dos alarmes dos sensores externos', N'user', N'dbo', N'table', N'PositionHistory_IIPOS', N'column', N'IIPOS_ExternalSensorAlarm' exec sp_addextendedproperty N'MS_Description', N'ID da tabela (auto-incremento)', N'user', N'dbo', N'table', N'PositionHistory_IIPOS', N'column', N'IIPOS_ID' exec sp_addextendedproperty N'MS_Description', N'Posição do veículo em relação às referências cadastradas no SuperVisor Web', N'user', N'dbo', N'table', N'PositionHistory_IIPOS', N'column', N'IIPOS_Landmark' exec sp_addextendedproperty N'MS_Description', N'Latitude em graus decimais referente à posição do veículo', N'user', N'dbo', N'table', N'PositionHistory_IIPOS', N'column', N'IIPOS_Latitude' exec sp_addextendedproperty N'MS_Description', N'Longitude em graus decimais referente à posição do veículo', N'user', N'dbo', N'table', N'PositionHistory_IIPOS', N'column', N'IIPOS_Longitude' exec sp_addextendedproperty N'MS_Description', N'Número serial do MCT ou UCC', N'user', N'dbo', N'table', N'PositionHistory_IIPOS', N'column', N'IIPOS_MctAddress' exec sp_addextendedproperty N'MS_Description', N'Nome do veículo', N'user', N'dbo', N'table', N'PositionHistory_IIPOS', N'column', N'IIPOS_MctName' exec sp_addextendedproperty N'MS_Description', N'Data/hora correspondente à posição do veículo', N'user', N'dbo', N'table', N'PositionHistory_IIPOS', N'column', N'IIPOS_TimePosition' exec sp_addextendedproperty N'MS_Description', N'Status da ignição do veículo', N'user', N'dbo', N'table', N'PositionHistory_IIPOS', N'column', N'IIPOS_VehicleIgnition' 22

23 APÊNDICE B CARACTERES PERMITIDOS Para se enviar mensagens corretamente através da Interface de Exportação do SuperVisor Web, deve-se usar apenas os caracteres listados abaixo. A mensagem que conter caracteres inválidos, não será enviada e o campo MsgStatus receberá o valor -1. Tecnologia Satelital A B C D E F G H I J K L M N O P Q R S T U V W X Y Z % = : ; ( ),.! /? Ç É + $ - * # Tecnologia Celular A B C D E F G H I J K L M N O P Q R S T U V W X Y Z % = : ; ( ),.! & + $ - * # Descritivo de Exportação de Dados V. 2-YYXAO C 23

24 APÊNDICE D STATUS DE ERRO PARA MENSAGEM DE ENVIO - CELULAR O campo MsgStatus e o campo ConfirmStatus da tabela de exportação de mensagens de envio podem assumir os seguintes códigos de status, quando a Interface de exportação do SuperVisor Web falha ao transmitir uma mensagem de envio para a tecnologia celular: : Mensagem está em fila. Não há informação de entrega disponível : Mensagem foi enviada, mas não foi confirmado o recebimento pela UC de destino : Mensagem foi enviada, mas ainda não foi confirmado o recebimento pela UC de destino : Mensagem foi enviada, e não foi confirmado o recebimento pela UC de destino : Mensagem foi cancelada : Não foi possível armazenar mensagem na fila apropriada. Submeta novamente a mensagem : Falha GMN especificado inválido ou não existente nos registros do ANMC : Falha - Destino inválido : Falha - Mensagem duplicada, mensagem ignorada : Falha Número de formulário inválido : Falha Versão de formulário inválido : Falha Caractere inválido no texto da mensagem : Falha Número do grupo de formulário inválido : Falha Sem permissão de envio para a UC destinatária : Falha Sem permissão de recebimento para a UC destinatária : Falha Mensagem bloqueada ou excluída por Ação : Falha Mensagem não entregue por tempo excedido : Falha Mensagem não entregue por erro de processamento : Falha Mensagem não entregue por excesso de tempo esperando resposta de outra UC : Condição de erro não-definida 24

25 ÍNDICE DE FIGURAS Figura 1 Tela de criação de uma nova fonte de dados ODBC... 7 Figura 2 Tela de identificação de acesso de uma fonte de dados ODBC... 7 Figura 3 Tela de configuração do banco padrão para a fonte de dados ODBC... 8 Figura 4 - Menu Principal Figura 5 - Exemplo de configurações Figura 6 Tela Configuração de Tabelas e Campos Descritivo de Exportação de Dados V. 2-YYXAO C 25