1
uMov.me Solicitação de Serviço
Projeto Roadmap 2013/2014
DOCUMENTAÇÃO
TÉCNICA
2
SUMÁRIO
1.
Objetivo ........................................................................................................................................... 4
2.
Programas ........................................................................................................................................ 4
3.
Tabelas ............................................................................................................................................. 4
4.
Configurações de ambiente ............................................................................................................... 5
4.1 Updates ....................................................................................................................................... 5
4.2 Parâmetros .................................................................................................................................. 5
4.3 Menu ........................................................................................................................................... 5
4.4 Outras configurações.................................................................................................................... 5
5.
Descrição do processo ....................................................................................................................... 6
6.
Observações gerais ........................................................................................................................... 23
7.
FAQ – Frequented Asked Questions ................................................................................................... 25
8.
Anexos ............................................................................................................................................. 25
3
Especificação de Requisitos
Projeto: Roadmap 2013/2014
SS: 018469 – uMov.me Solicitação de Serviço
Item:
Estratégia: Novas
Histórico de Revisão
Data
03/03/2015
1.
Versão
Descrição
Autor
1
Desenvolvimento da Documentação
André Felipe Joriatti
2
Detalhamento de Observações Gerais
Sidnei Trevizan
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.
3.
Programas

MNTA281.PRW

MNTA280.PRX

NGIMPRTTXT.PRW

UPDMNT79.PRW
Tabelas
Não foram criadas novas tabelas para atender o escopo da especificação
4
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.
4.1
Configurações de ambiente
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
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


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..
5.1 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
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:
http://endereço_servidor:porta/TWSSERVICE.apw, para o campo Url do EAI informar conforme o
exemplo: http://endereço_servidor:porta/EAISERVICE.apw. 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
Após informar os dados, confirmar a tela e direcionar-se para o menu em ‘Configuração Aplicativos’:
9
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
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
Direcionar-se para a aba ‘Query’ e informar a consulta SQL conforme abaixo e clicar no botão
‘Gerar Estrutura’:
12
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
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
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
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
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
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
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
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
Será apresentado a tela de pergunta para confirmação da abertura da S.S., escolher a opção ‘Sim’:
21
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
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:
http://store.umov.me/smartmobile/index.php/solicitac-o-de-manutenc-o-de-ativos-protheus.html,
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 http://support.umov.me/ 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
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 http://support.umov.me/ que estas
sejam feitas automaticamente. Ao entrar em contato informe: ambiente, usuário, e o
nome dos modelos a serem configurados.
24
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