MASHUPS

Todos os direitos autorais reservados pela TOTVS S.A. Proibida a reproduo total ou parcial, bem como a armazenagem em sistema de recuperao e a transmisso, de qualquer modo ou por qualquer outro meio, seja este eletrnico, mecnico, de fotocpia, de gravao, ou outros, sem prvia autorizao por escrito da proprietria. O desrespeito a essa proibio configura em apropriao indevida dos direitos autorais e patrimoniais da TOTVS. Conforme artigos 122 e 130 da LEI no. 5.988 de 14 de Dezembro de 1973.

MASHUPS

Protheus 11

SUMRIO
INTRODUO ................................................................................................................................ 3 Consultas disponveis no Microsiga Protheus 11 .......................................................................... 3 CONFIGURAO ............................................................................................................................ 4 PROCEDIMENTOS .......................................................................................................................... 5 MANUTENO DE LOGS ............................................................................................................ 12 CONSULTA LOG ........................................................................................................................... 21 Parmetros .................................................................................................................................. 21

2 - MASHUPS

INTRODUO
No ambiente web so divulgadas diversas informaes com acesso irrestrito, que possibilitam consultas s informaes de interesse pblico. Pensando em permitir o aproveitamento dessa disponibilidade, a Totvs desenvolveu o recurso de Mashup. A estrutura da soluo de Mashup proposta, permite acessar o contedo desejado e inserir automaticamente no cadastro do Microsiga Protheus 11 que acionar o recurso. Para efetuar a pesquisa e a atualizao, basta fornecer as informaes solicitadas e que foram pr-configuradas pelo Administrador no ambiente "Configurador". Desta forma, os demais dados sero inseridos automaticamente, formulando um registro completo e atualizado de acordo com o contedo online.

Consultas disponveis no Microsiga Protheus 11

Relao das consultas: 1. Anatel Consultas de Tarifas DDD 2. Banco Central Cotao de Moedas 3. Correios Pesquisa de CEP 4. Correios Tarifa do Sedex 5. DETRAN MG Consulta de Veculo 6. Google Pesquisa na Internet 7. Google Traduo 8. INEP Cadastro de Escolas Brasileiras 9. MTE Classificao Brasileira de Ocupaes 10. Receita Federal Consulta de CNPJ 11. Receita Federal Consulta de CPF 12. Sintegra Consulta Nacional 13. Suframa Consulta Situao de Fornecedor 14. Yahoo Cotao de Aes.

MASHUPS - 3

CONFIGURAO
necessrio providenciar a configurao de Servidor HTTP, conforme consta no Totvs Wizard. Ex: Configurao no arquivo TOTVSAPPSERVER.ini:

[HTTP] enable=1 Port=90 Nota. Para a utilizao da funcionalidade MASHUP, necessrio que o acesso a INTERNET esteja habilitado. Fluxo Operacional

4 - MASHUPS

PROCEDIMENTOS
Na seqncia abaixo, ilustramos um exemplo de utilizao do Mashup nos mdulos de "Compras" e Folha de Pagamento. 1. Acessar o ambiente Configurador

MASHUPS - 5

2.

Execute o cadastro Mashups e clique no boto Incluir:

3.

Clique no boto Mashups

6 - MASHUPS

4.

Selecione um Mashup e confirme:

5. Preencha o alias da tabela ao qual o Mashup deve ser vinculado. Clique no boto Parmetros:

MASHUPS - 7

6. Sero exibidos todos os parmetros que devem ser enviados pelo Protheus e os retornos esperados pelo site. Preencha as informaes conforme as orientaes a seguir: Ordem: Campo de preenchimento automtico

Origem: define se a informao ser fornecida por um campo do Protheus ou se ser solicitada para o usurio no momento da execuo do Mashup. Quando no for definida a origem para o parmetro do tipo Table ser exibido um browser com todas as informaes da tabela para que o usurio possa selecionar. Tipo Objeto: Deve ser informado o tipo de objeto a ser exibido para o usurio quando selecionada a origem Usurio. 1. A caixa de seleo deve ser utilizada para exibir informaes no formato lista e somente est disponibilizada para os tipos List e Table. No caso do tipo Table, deve ser informado o campo Coluna com a coluna que desejar exibir. 2. A opo "get" exibe um campo para o usurio digitar a informao. Coluna: Utilizada pelo parmetro do tipo Table quando selecionado o tipo de objeto Caixa de Seleo. Parmetro: Preenchimento automtico. Exibe o nome do parmetro esperado pelo Site. 8 - MASHUPS

Tipo: Preenchimento automtico. Exibe o tipo do parmetro esperado pelo Site. Obrigatrio: Preenchimento automtico. Exibe o tipo do parmetro esperado pelo Site. Validao: Permite adicionar uma validao para as informaes fornecidas pela origem Usurio.

MASHUPS - 9

7. Fornea os dados referentes a cada campo a ser preenchido. Confirme o cadastro e saia do ambiente Configurador. Acesse o ambiente Faturamento. Execute o cadastro de Clientes.

10 - MASHUPS

8.

Clique no boto Incluir. Informe o CEP do cliente e clique no boto Mashup

9. Sero exibidos todos os Mashups configurados atravs do ambiente Configurador vinculado a tabela. Clique no boto Executar.

10. Aguarde o retorno das informaes pelo Site. Clique no boto OK para aplicar as informaes enviadas pelo Site.

MASHUPS - 11

MANUTENO DE LOGS
Esta rotina permite o controle de log de alteraes detalhado das operaes registradas no Protheus, disponibilizando informaes sobre os campos e contedos modificados. Nesta rotina so definidas as tabelas, os campos e as operaes de manuteno que devero ser registradas no arquivo de Log. Exemplo: Pode-se configurar que o campo Nome do Cliente (A1_NOME) deve ser registrado, no log, apenas na operao de incluso de registro e o campo "Limite de Crdito" (A1_LC), dever ser registrado nas operaes de incluso e alterao. Importante: Todas as rotinas do sistema so influenciadas por essa configurao. Procedimentos Para realizar a configurao do log: 1. Ao selecionar a opo de configurao de log, ser apresentada a janela principal da rotina.

12 - MASHUPS

2. Atravs desta janela possvel pesquisar, incluir, visualizar, alterar e excluir um campo ou uma tabela configurada. Pesquisar O sistema permite pesquisar um campo para visualizao, alterao ou excluso do log. Procedimentos Para pesquisar arquivos: 1. 2. Na janela de manuteno de log, clique no boto "Pesquisar; O sistema apresenta ao lado esquerdo da tela os campos para pesquisa;

Digite, no primeiro campo, o nome do campo para pesquisar. 3. Configure a forma de pesquisa atravs da rea "Opes", definindo: Coincidir Maisculas e Minsculas Localizar Palavra Inteira

4. Para prosseguir pesquisa, clique no boto "Procurar" e, para limpar a informao de busca, clique no boto "Limpar" e digite o novo contedo. 5. Com a pesquisa finalizada, clique novamente sobre o boto "Pesquisar.

MASHUPS - 13

Incluir Nesta opo, pode-se definir uma tabela e os campos que devem receber o controle de log. Para definir o log para uma tabela: 1. Clique no boto "Incluir" para adicionar a tabela e os campos para controle de log. Ser apresentada a janela "Configurao de Log de Campos", para selecionar a tabela e os campos.

2. No campo "Tabela", informe o nome da tabela e clique no boto "Consultar Estrutura". Ser apresentada a janela "Estrutura de Arquivo", onde possvel selecionar os campos da tabela informada.

14 - MASHUPS

3. Selecione os campos cujos controles de logs devem ser gravados pelo sistema, ou, se desejar, selecione todos os campos atravs da caixa de verificao "Inverter todos". Na rea "Tipo de LOG", deve ser marcadas as operaes que devem ser monitoradas: Incluso - Grava toda incluso que for realizada no campo. Alterao - Grava toda alterao que for realizada no campo. Excluso - Grava toda excluso que for realizada no campo.

4. Depois de selecionados os campos, clique no boto "OK". O sistema retorna janela principal com campos selecionados.

MASHUPS - 15

5. Nesta janela, pode-se tambm pesquisar ou mudar o tipo de log dos campos selecionados. Procedimentos Para pesquisar um campo ou operao: 1. Clique no boto "Pesquisar" para localizar um campo ou uma operao.

Ser apresentada a janela pesquisa.

16 - MASHUPS

2. Nesta janela, pode-se pesquisar por "Campo" ou "Operao" em seguida, informe a chave de pesquisa. Na caixa de verificao possvel selecionar a opo de pesquisa por: Busca a partir do item posicionado - A pesquisa ser realizada a partir do item selecionado. Acima - A pesquisa ser realizada somente acima do item selecionado.

3. Depois de selecionados os itens necessrios para pesquisar, clique no boto "Ok".

MASHUPS - 17

Procedimentos Para selecionar o tipo de log para um determinado campo: 1. Selecione o campo que deseja alterar e clique no boto - Selecionar tipo de log.

Ser apresentada a janela de "Tipo de Log".

2.

Na rea "Selecione o tipo de operao" pode-se selecionar os seguintes itens: Incluso - Grava toda incluso que for realizada no campo. Alterao - Grava toda alterao que for realizada no campo. Excluso - Grava toda excluso que for realizada no campo.

3. Na rea "Tipo de Atualizao", pode-se selecionar o tipo de atualizao desejada: Atualizar o campo selecionado Esta opo atualiza somente o campo selecionado; Atualizar somente campos no preenchidos - Esta opo atualiza somente os campos que no possuem operaes definidas. 4. Atualizar todos os campos - Esta opo atualiza todos os campos da tabela. Aps definir todos os tipos de log, clique no boto "OK".

O sistema retorna para a janela anterior, com as alteraes realizadas. 18 - MASHUPS

5.

Confira se est correto e clique no boto "Ok".

Visualizar O sistema permite visualizar os campos selecionados, sem que seja possvel alterar seus dados. Procedimentos Para visualizar uma definio de log para uma tabela: 1. Nesta janela, posicione o cursor sobre qualquer registro do alias desejado e clique no boto "Visualizar; O sistema apresenta a janela com os dados dos campos selecionados da tabela.

2. Alterar

Clique no boto "Ok" para finalizar.

O sistema permite alterar a definio de logs das tabelas, marcando ou desmarcando campos e redefinindo as operaes gravadas. Procedimentos Para alterar os campos: 1. Nesta janela, posicione sobre qualquer registro do alias desejado e clique no boto "Alterar". Ser apresentada a janela com os campos da tabela selecionada para alterao. 2. Aps realizar as alteraes necessrias, clique no boto "OK".

MASHUPS - 19

Excluir O sistema permite excluir todos os campos da tabela posicionada. Procedimentos Para excluir o campo: 1. Nesta janela, posicione sobre qualquer registro do alias desejado e clique no boto "Excluir". Ser apresentada a janela com os campos da tabela selecionada para excluso. 2. Clique no boto "Ok para excluir a tabela.

Todo controle de log da tabela ser excludo. Dica: Se desejar excluir um nico campo utilize o boto "Alterar". Selecione o campo desejado e pressione DEL, a linha ficar cinza, ento, clique em "Ok" para excluir o campo.

20 - MASHUPS

CONSULTA LOG
Para visualizar os logs que foram registrados conforme configurado na rotina "Manuteno/Configurao de Log", necessrio utilizar a opo "Consulta Log". A visualizao do log ser efetuada por tabela, podendo ser filtrada por: Usurios; Data e hora do registro;

Procedimentos Para consultar o arquivo log: 1. Ao selecionar a opo de "Consulta Log", ser apresentada a janela principal da rotina. 2. Nesta janela possvel configurar os parmetros para consultar os logs.

Parmetros
No boto "Parmetros" pode-se configurar o filtro para a consulta. Procedimentos Para configurar os parmetros: 1. Na janela de manuteno, clique no boto "Parmetros" para configurar a consulta. Ser apresentada a janela de "Parmetros". 2. Nesta janela, informe os dados para realizar a consulta. Tabela/Alias - Informe o nome da tabela a ser consultada.

Usurio de? / Usurio at? - Informe o intervalo de usurios para selecionar as informaes. Data de? / Data at? - Informe o intervalo da data para seleo. Hora de? / Hora at? - Informe o intervalo de hora para seleo. MASHUPS - 21

3.

Aps configurado todos os parmetros, clique no boto "Ok".

O sistema retorna a janela de manuteno, clique no boto de "Ok", para consultar o log. Ser apresentada a janela "Consulta de Log de Cadastros", onde possvel verificar todas as incluses, alteraes e excluses que foram realizadas, conforme a definio configurada. 4. Para visualizar, de um duplo clique no registro.

5. Ser apresentada a janela de consulta, com todos dados do usurio que realizou a as modificaes e os dados cadastrados no sistema. 6. 7. Aps visualizar, clique no boto "Ok" para sair da consulta. Clique no boto "Ok" para finalizar a rotina.

22 - MASHUPS