umov.me Solicitação de Serviço Projeto Roadmap 2013/2014 DOCUMENTAÇÃO TÉCNICA

Transcrição

1 1

2 umov.me Solicitação de Serviço Projeto Roadmap 2013/2014 DOCUMENTAÇÃO TÉCNICA 2

3 SUMÁRIO 1. Objetivo Programas Tabelas Configurações de ambiente Updates Parâmetros Menu Outras configurações Descrição do processo Observações gerais FAQ Frequented Asked Questions Anexos

4 Especificação de Requisitos Projeto: Roadmap 2013/2014 Item: SS: umov.me Solicitação de Serviço Estratégia: Novas Histórico de Revisão Data Versão Descrição Autor 1 Desenvolvimento da Documentação André Felipe Joriatti 03/03/ Detalhamento de Observações Gerais Sidnei Trevizan 1. Objetivo O objetivo deste documento é elaborar uma especificação acerca da configuração e implantação da integração de aplicação umov.me elaborada para reporte de Solicitação de Serviço via dispositivo móvel para o produto Protheus TOTVS no segmento Manufatura módulo Manutenção de Ativos, essa especificação visa abordar apenas a configuração da ferramenta TWS (gerenciador de integrações desenvolvido pela TOTVS S.A.) de forma a permitir a comunicação entre a aplicação para dispositivos móveis com o ERP Protheus portanto a configuração do aplicativo no center.umov.me deve estar previamente realizada antes de iniciar os procedimentos propostos neste documento. 2. Programas MNTA281.PRW MNTA280.PRX NGIMPRTTXT.PRW UPDMNT79.PRW 3. Tabelas Não foram criadas novas tabelas para atender o escopo da especificação 4

5 Entre as principais tabelas envolvidas no processo estão: TQB Solicitação de Serviço ST9 Bens TAF Localizações A tabela de TQB Solicitações de Serviço é usada na importação de dados da aplicação para o Protheus, onde os reportes da atividade de Solicitação de Serviço são integrados ao módulo Manutenção de Ativos como Solicitações de Serviço abertas via dispositivo móvel. As tabelas ST9 e TAF, Bens e Localizações respectivamente, estão relacionadas ao processo de exportação de dados do ERP para a aplicação, uma vez que no aplicativo a Solicitação de Serviço é aberta a partir da seleção de um Bem ou Localização para o Serviço que deve ser executado. 4. Configurações de ambiente 4.1 Updates A utilização do processo de integração do módulo Manutenção de Ativos com aplicação umov.me exige a execução do update UPDMNT79 no ambiente. 4.2 Parâmetros Não é necessária configuração de parâmetros para os processos. 4.3 Menu Nenhuma configuração de menu se faz necessária para atender a especificação. 4.4 Outras configurações Requisitos para integração de Protheus SIGAMNT com umov.me: Produto TOTVS TWS (gerenciador de integrações TOTVS para integrar Protheus a plataforma umov.me) que deve ser adquirido em contato com TOTVS; Conta em center.umov.me (para ter acesso ao sistema servidor do aplicativo); Aplicativo instalado no dispositivo móvel em uso, que pode ser obtido gratuitamente por meio do endereço get.umov.me (acessar este endereço a partir do navegador do dispositivo). 5

6 5. Descrição do processo umov.me A tecnologia umov.me trata-se de uma plataforma de desenvolvimento de aplicativos móveis de forma gráfica a partir de templates de processos a serem configurados e customizados conforme a demanda que a regra de negócio sugere, foi desenvolvida pela empresa Trevizan Tecnologia, a ideia foi adquirida pela TOTVS S.A. que detém determinada percentagem sobre a empresa e trabalhando em parceria com a mesma criou projetos para desenvolver aplicações de mobilidade que venham sanar a necessidade de clientes TOTVS nos mais distintos segmentos de negócios. A tecnologia umov.me se divide em 2 ferramentas fundamentais: Center: sistema web para criação e configuração de aplicativos umov.me. Para acessar o center deve se usar o link center.umov.me e informar no nome de usuário o nome do usuário administrador de aplicações seguido de ponto mais o nome do ambiente, conforme exemplo: usuário.ambiente e no campo de senha apenas informar a senha do usuário; Aplicação: trata-se do executável do aplicativo que deve ser baixado conforme a plataforma em uso por meio do link get.umov.me para acessar a aplicação configurada por meio do center, deve se usar a seguinte forma de login: no campo de login digitar usuário seguido de ponto mais o nome do ambiente como usuário.ambiente, no campo de senha apenas digitar a senha do usuário. P.S.: toda a documentação a respeito da tecnologia umov.me pode ser consultada no link kb.umov.me TWS A ferramenta TWS trata-se de uma aplicação criada pela TOTVS S.A. para gerenciar integrações entre seus produtos, o mesmo está sendo usado no processo de integração do Protheus com os aplicativos desenvolvidos sobre o conceito umov.me, neste documento será apresentado apenas o processo básico de configuração do TWS para lidar com integrações umov.me. Configuração da integração de aplicativos umov.me com Protheus para solução de Solicitação de Serviço do produto Protheus: Passos básicos: Configuração da aplicação no Center umov.me, ajustando o modelo de exportação de execução da Atividade de Solicitação de Serviço e demais modelos de importação; 6

7 Direcionar-se para a ferramenta TWS para cadastrar o aplicativo informando o ambiente ao qual o mesmo deve se conectar no Protheus; Realizar a carga inicial de Itens (Bens e Localizações) e Itens nas Seções (Bens e Localizações na seção de Solicitação de Serviço da Atividade de Solicitação de Serviço) para que todos os Bens e Localizações do ambiente sejam enviados ao aplicativo estando disponíveis para abertura de S.S Configuração do TWS para integração com aplicativo: *a aplicação deve ter sido previamente configurada no Center umov.me, para configuração da aplicação consultar o documento anexo a especificação: Documentação Técnica - umov.me.docx. Direcionar-se para a ferramenta TWS no menu em Configuração Inicial 7

8 Será direcionado para a tela de configuração dos DbAccess em que o TWS terá acesso, informar como produto Protheus, no campo de Url do WS informar conforme o exemplo: para o campo Url do EAI informar conforme o exemplo: Para a listagem de DbAccess onde o TWS deverá se conectar, informar para cada um: Host: endereço do DbAccess; Porta: porta do DbAccess; Banco de Dados: informar o tipo de Banco de dados que estará sendo acessado; Alias: informar o nome da conexão ODBC de acesso do DbAccess. 8

9 Após informar os dados, confirmar a tela e direcionar-se para o menu em Configuração Aplicativos : 9

10 Em Configuração Aplicativos, selecionar a opção Incluir do menu da rotina, e incluir um novo aplicativo, informando no campo Tenante o nome do ambiente do aplicativo previamente criado no center.umov.me para o campo usuário FTP, informar o usuário administrador do aplicativo seguido de ponto mais o nome do ambiente (usuário.ambiente) no campo senha FTP informar a senha deste mesmo usuário, informar ainda como Rotina de Execução MNTA281. Após informar todos os dados, usar o botão Recuperar Token e informar usuário e senha do aplicativo conforme solicitado para que o TWS recupere o token do aplicativo umov.me para integração com o Produto. Após concluir o cadastro do aplicativo, direcionar-se para a opção Estrutura disponível no menu da rotina de Configuração Aplicativos em Ações relacionadas: Verificar que a tela de Estrutura trouxe os Layouts (modelos de exportação) que foram previamente cadastrados no center.umov.me: Item Itens nas Seções Que são traduzidos para o Protheus como sendo: Bem Bens nas seções 10

11 Configuração da exportação de Item Bem Clicar sobre a linha do Item no grid de Layout e direcionar-se para a sessão de Data Sets informar o nome no campo Data Set com sendo ITENS - BENS, informar como Tipo do Data Set o tipo Query, para o campo DBAccess informar a conexão DbAccess anteriormente configurada, para o campo Evento deixar a opção Todos após isso clicar sobre o botão na grid de Data Sets: Quando clicar no botão o TWS irá buscar as configurações do modelo de exportação de Item no servidor do aplicativo anteriormente cadastrado e tornará disponível os campos do mesmo na aba Mapeamento dos Campos conforme abaixo: 11

12 Direcionar-se para a aba Query e informar a consulta SQL conforme abaixo e clicar no botão Gerar Estrutura : 12

13 SELECT 'B' AS TIPO, T9_CODBEM AS CODITEM, T9_NOME AS NOMEITEM FROM ST9T10 ST9 /* Informar tabela de bens conforme empresa de cadastro do aplicativo */ WHERE ST9.T9_FILIAL = 'código da filial' AND ST9.D_E_L_E_T_!= '*' AND ST9.T9_SITMAN = 'A' AND ST9.T9_SITBEM = 'A' UNION SELECT 'L' AS TIPO, TAF_CODNIV AS CODITEM, TAF_NOMNIV AS NOMEITEM FROM TAFT10 TAF /* Informar tabela de localizações conforme empresa de cadastro do aplicativo */ WHERE TAF.TAF_FILIAL = 'código da filial' AND TAF.D_E_L_E_T_!= '*' ORDER BY CODITEM Direcionar-se para a aba Mapeamento dos Campos e preencher a grid conforme a imagem abaixo: 13

14 Alterar o campo Campos chave do cadastro do Layout de Itens e colocar como chave o valor: CODITEM : Configuração da exportação de Itens nas seções Bens atrelados as atividades Após preencher a grid direcionar-se para a sessão de Layout novamente e clicar sobre a opção Itens das seções: Preencher o Data Set de Itens nas seções, informar como nome (campo Data Set ) ITENS NAS SEÇÕES BENS NAS SEÇÕES, informar como Tipo do Data Set o tipo Query, para o campo DbAccess informar a conexão DbAccess anteriormente configurada, para o campo Evento deixar a opção Todos após isso clicar sobre o botão da linha do Data Set: 14

15 Quando clicar no botão o TWS irá buscar as configurações do modelo de exportação de Item no servidor do aplicativo anteriormente cadastrado e tornará disponível os campos do mesmo, na aba Mapeamento dos Campos. Após isso direcionar-se para a aba Query e informar a consulta SQL conforme imagem abaixo e clicar no botão Gerar Estrutura : SELECT T9_CODBEM CODITEM FROM ST9T10 ST9 /* Informar tabela de bens conforme empresa de cadastro do aplicativo */ WHERE ST9.T9_FILIAL = 'código da filial' AND ST9.T9_SITMAN = 'A' AND ST9.T9_SITBEM = 'A' AND ST9.D_E_L_E_T_!= '*' UNION SELECT TAF_CODNIV CODITEM FROM TAFT10 TAF /* Informar tabela de localizações conforme empresa de cadastro do aplicativo */ WHERE TAF.TAF_FILIAL = 'código da filial' AND TAF.D_E_L_E_T_!= '*' ORDER BY CODITEM 15

16 Após isso direcionar-se para a aba Mapeamento dos campos e preencher a grid de mapeamento de campos conforme imagem abaixo: Ao término do preenchimento da grid de Mapeamento de Campos do Layout de Itens nas Seções, concluir a tela de informações da Estrutura e direcionar-se para a opção Importação/Exportação disponível no menu em Ações Relacionadas. Na tela de configuração de Importação/Exportação, informar a configuração de Importação para os dois Layouts anteriormente cadastrados: Item Itens nas Seções As configurações de Importação/Exportação servem para determinar a frequência de sincronização destes cadastros do Protheus para com o servidor do aplicativo, sendo assim, é nessa rotina que o usuário deve informar a periodicidade com que o ERP envia o cadastro de Item (Bem) e Item na Seção (Bens na seção, para que os bens enviados estejam disponíveis para abertura de S.S.) para a aplicação. Para determinar a recorrência das importações de arquivos do umov.me para o Protheus, utilizar o botão Recorrência : Para definir a recorrência de exportação de Item, deve se posicionar o cursor sobre o mesmo no browse de layouts e utilizar o botão Recorrência para realizar o agendamento de exportação: 16

17 P.S.: repetir o mesmo processo para determinar a exportação de Itens nas Seções. Realizar exportação manual para a carga inicial dos Bens e Localizações para o aplicativo, posicionar o cursor sobre o layout de Item e utilizar a opção Exportação Manual disponível no botão de Ações Relacionadas da tela do cadastro e repetir esse mesmo processo para o layout de Itens das seções : 17

18 5.2 Demonstração de uso do aplicativo: Na tela inicial do aplicativo, informar dados conforme abaixo e selecionar o botão OK : Campo Login : usuário.ambiente Campo Senha : senha Selecionar o botão Solicitação de Serviço : 18

19 Será direcionado para a próxima de tela de Abertura de Solicitação de Serviço, selecionar a opção Abertura de S.S. : 19

20 Será direcionado para a tela de escolha do tipo de S.S. se para Bem ou para Localização, selecionar a opção desejada: Na próxima tela, selecionar o Bem ou Localização que deseja abrir Solicitação de Serviço, será direcionado para a tela de abertura de Solicitação de Serviço, informar os dados e confirmar por meio do botão OK : 20

21 Será apresentado a tela de pergunta para confirmação da abertura da S.S., escolher a opção Sim : 21

22 Será apresentada a tela para confirmar se deseja realizar sincronismo com o center.umov.me, selecionar opção desejada: A Solicitação de Serviço será importada para o ambiente no Protheus conforme a periodicidade de importações definida no TWS. 22

23 6. Observações gerais Abaixo serão apresentados pontos de importância, dúvidas ou dificuldades encontradas na implantação do aplicativo em cliente beta. Com isto se pretende dar maior agilidade e respostas para próximas implantações. 1. Sobre o ambiente Center umov.me. É imprescindível que este esteja corretamente configurado antes da configuração do Totvs TWS: Foi verificado que a implantação dos aplicativos (por parte da Totvs) para os clientes será feito através de cópia de um ambiente já criado, este está disponibilizado em: porém quando é feito a cópia, algumas funcionalidades e informações não são herdadas para o novo aplicativo. a. Perfil do ambiente: no momento da cópia o ambiente possui o perfil de usuário, é necessário entrar em contato com e solicitar o perfil de desenvolvimento, desta forma será possível prosseguir com os itens posteriores. b. Cadastro de Atividades: é necessário verificar se há atividade cadastrada para o ambiente atual e se esta possui um ID para Integração destinado a sua seção. Direcione-se ao Menu\Criação\Atividades. Clique no ícone de edição da atividade Solicitação de Serviço, em Lista de Seções clique no ícone de edição. Verifique o campo ID para Integração, deve possuir o conteúdo SolicitacaoServico, sem aspas. c. Atividade Padrão: é necessário verificar se a atividade cadastrada está indicada como uma atividade padrão. Desta forma direcione-se para Menu\ Criação\ Configurações\ Parâmetros. No item 5 Atividade Padrão, selecione a atividade de Solicitação de Serviço. d. Código de Usuário: é necessário informar o código de usuário Protheus a qual ambiente será sincronizado as solicitações de serviço abertas. Direcione-se ao Menu\ Administração\Pessoas, clique sobre o ícone editar, desta forma informe o campo Código do Usuário. No item 5 O quê? na mesma página, vincule a atividade criada, e após clique em salvar. e. Atividade em Locais: verifique se há atividade selecionada para o local cadastrado, se não houver vincule em Menu\ Administração\ Locais, clique no ícone de edição. f. Modelo de Exportação: na cópia do ambiente o modelo de exportação não é copiado, desta forma é necessário realizar novamente o cadastro. Em Menu\Gestão\Exportar Dados, clique em Gerenciar Modelos. Na janela aberta clique sobre o ícone de Adicionar, selecione Exportação de Execução para o tipo de exportação. Selecione a atividade disponível de Solicitação de Serviço, será apresentada nova janela. Siga o exemplo da imagem abaixo, para os Campos Cadastrais deixar ativo apenas os campos Subgrupo do Item Identificador e Item Identificador, a ordem é importante conforme a imagem. 23

24 Obs.: para desativar os campos clique no ícone de edição e para mover clique e arraste o ícone de movimentação. g. Modelos de Importação: verifique se há modelos de importação cadastrados. Os modelos de Item e Item das Seções devem estar cadastrados conforme o ambiente do qual foi efetuado a cópia, não se perdem com a cópia. h. Automatização de Importação e Exportação: para o correto funcionamento de importações e exportações é necessário solicitar ao que estas sejam feitas automaticamente. Ao entrar em contato informe: ambiente, usuário, e o nome dos modelos a serem configurados. 24

25 2. Sobre o Protheus TOTVS TWS. Para a correta configuração dos aplicativos no Totvs TWS, é necessário que este já contenha a configuração desde o momento da implantação, com os parâmetros informados no appserver.ini e com a configuração inicial informada (apresentada nas páginas 8 e 9 deste documento). a. Configuração do aplicativo: na implantação em cliente, não foram identificados maiores problemas quanto a configuração do aplicativo, porém é necessário seguir com rigor os passos apresentados neste documento (páginas 9 ao 17). 7. FAQ Frequented Asked Questions 8. Anexos 25