Escolar Documentos
Profissional Documentos
Cultura Documentos
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
Histórico de Revisão
1. Objetivo
2. Programas
MNTA281.PRW
MNTA280.PRX
NGIMPRTTXT.PRW
UPDMNT79.PRW
3. Tabelas
4
Entre as principais tabelas envolvidas no processo estão:
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.
5
5. Descrição do processo
uMov.me
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.
Passos básicos:
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..
*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”.
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:
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
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:
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’:
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’:
15
Após isso direcionar-se para a aba ‘Mapeamento dos campos’ e preencher a grid de mapeamento de
campos conforme imagem abaixo:
Item
Itens nas Seções
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’:
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:
22
6. Observações gerais
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.
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).
8. Anexos
25