TOTVS - Microsiga Protheus Gesto de Empresas

05/05/2011

TOTVS - Microsiga Protheus Gesto de Empresas

Sumrio
Sumrio ........................................................................................................................................... 2 1 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 Conceitos Bsicos................................................................................................................... 3 Objetivos Instrucionais........................................................................................................... 3 Descrio ............................................................................................................................... 3 Entidades da Gesto de Empresas .......................................................................................... 3 Acesso ................................................................................................................................... 4 Grupo de Empresas - 01 ......................................................................................................... 4 Grupo de Empresas - 02 ......................................................................................................... 4 Grupo de Empresas - 03 ......................................................................................................... 4 Grupo de Empresas - 04 ......................................................................................................... 5 Empresas ............................................................................................................................... 5

1.10 Unidade de Negcios ............................................................................................................. 6 1.11 Filial ....................................................................................................................................... 6 1.12 Campos Concatenados - 01 .................................................................................................... 6 1.13 Campos Concatenados - 02 .................................................................................................... 7 1.14 Campos Concatenados - 03 .................................................................................................... 7 1.15 Campos Concatenados - 04 .................................................................................................... 7 1.16 Procedimentos para uso da Gesto de Empresas ................................................................... 8 1.17 Importando Gesto de Empresas - 01 .................................................................................... 8 1.18 Importando Gesto de Empresas - 02 .................................................................................... 8 1.19 Autorizao de Empresas ....................................................................................................... 9 1.20 Utilizao ............................................................................................................................... 9 1.21 Tamanho padro do cdigo da Filial ....................................................................................... 9 1.22 Funes ................................................................................................................................. 9 1.23 Impresso .............................................................................................................................. 11 1.24 Concluso .............................................................................................................................. 12

TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0

TOTVS - Microsiga Protheus Gesto de Empresas

Conceitos Bsicos

Ol! Seja bem vindo ao treinamento sobre a Gesto de Empresas.

1.1

Objetivos Instrucionais

Ao trmino deste treinamento voc aprender a configurar a Gesto de Empresas.

1.2

Descrio

A Gesto de Empresas, presente na Linha de Produtos Microsiga Protheus verso TOTVS 2011, permite compartilhar as definies do Modelo de Dados entre as empresas configuradas no sistema, alm de introduzir o conceito de Unidade de Negcio. Importante: Modelo de Dados ou Dicionrio de Dados o conjunto de informaes que define as caractersticas das tabelas de cadastro do sistema.

1.3

Entidades da Gesto de Empresas

importante entender as entidades envolvidas na Gesto de Empresas. Grupo de Empresas: conjunto de empresas que esto ligadas entre si por razes diversas e que compartilham as mesmas definies do Modelo de Dados. Empresas: conjunto de filiais ou unidades de negcios que esto dentro da mesma dependncia jurdica ou fiscal. Unidades de Negcio: conjunto de filiais que esto dentro da mesma atividade econmica. Filial: estabelecimento empresarial dependente de outro, que pratica atos com validade jurdica ou fiscal. Observao: O Grupo de Empresas e as Filiais so obrigatrias para o uso do sistema. O uso de Empresas e Unidades de Negcios ir depender da configurao da Gesto de Empresas.

Grupo de Empresas

Empresas

Unidade de Negcios

Filiais

TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0

TOTVS - Microsiga Protheus Gesto de Empresas

1.4

Acesso

O Atalho para o grupo de rotinas responsvel pela configurao da Gesto de Empresas : Configurador / Ambiente / Empresas. Sendo possvel ento acessar as rotinas de: Grupo de Empresas. Empresas. Unidades de Negcios. Filiais.

1.5

Grupo de Empresas - 01

Ao inserir um novo Grupo de Empresas: Preencha os campos Cdigo e Descrio do Grupo de Empresas. O campo Tamanho define a quantidade de caracteres permitido no preenchimento do campo Filial. O campo Leiaute define o formato para preenchimento do campo Filial. Importante: Exemplo de leiaute EEUUFFFF, onde: E=Empresa, U=Unidade e F=Filial.

1.6

Grupo de Empresas - 02

Aps definir o campo Leiaute o sistema ir alimentar automaticamente a Grid para preenchimento das informaes da Sequncia, criando uma linha para cada caractere definido no "Leiaute", sendo os campos Sequncia, Sigla e Ordem, preenchidos automaticamente e sem permisso de alterao. E o campo Mscara que, se preenchido, permite definir a composio para preenchimento do campo Filial. possvel, por exemplo, obrigar o usurio a preencher a letra E no inicio do campo Filial, respeitando assim o padro definido pela empresa. A seguir estudaremos em detalhes o preenchimento do campo Mascara.

1.7

Grupo de Empresas - 03

Este um exemplo de preenchimento da Mscara. possvel restringir os caracteres permitidos na digitao do campo Filial. Neste exemplo, o primeiro caractere da Empresa deve conter os numricos de 0 a 9 e, o segundo caractere, os numricos de 5 a 9. Importante: Os caracteres permitidos para o preenchimento da mscara vo de 0 9, de A Z, e os caracteres: Trao, que define um intervalo de preenchimento; Virgula, que um separador de caracteres permitidos; Exclamao, que permite o uso de qualquer caractere numrico ou alfanumrico.

TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0

TOTVS - Microsiga Protheus Gesto de Empresas

1.8

Grupo de Empresas - 04

Pressione Confirmar ser exibida a mensagem Deseja criar o Dicionrio de Dados agora? O Dicionrio de Dados independente para cada empresa. Ser exibida uma janela de seleo com trs opes: Criar o Dicionrio de Dados a partir de uma base existente, respeitando o modelo definido em uma Empresa cadastrada anteriormente. Com registros padro, que criar o Dicionrio de Dados a partir do arquivo de configurao padro do sistema. No criar agora, abortando a criao do Dicionrio de Dados neste momento. Se preferir dar inicio criao, selecione o Pas para a incio da gerao do Dicionrio de Dados.

1.9

Empresas

Ao inserir uma nova Empresa: Preencha o campo Grupo, criado anteriormente, ao qual pertence a Empresa. Preencha os campos Cdigo e Descrio desta Empresa. Importante: O Campo Cdigo deve respeitar a mscara e a quantidade de caracteres definidos no cadastro do Grupo de Empresas. Qualquer divergncia ser informada pelo sistema.

TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0

TOTVS - Microsiga Protheus Gesto de Empresas

1.10 Unidade de Negcios

Ao inserir uma nova Unidade de Negcios: Preencha o campo Grupo, criado anteriormente, ao qual pertence a Unidade. Preencha o campo Empresa, criado anteriormente, ao qual pertence a Unidade. Preencha os campos Cdigo e Descrio desta Unidade de Negcios. Importante: O Campo Cdigo deve respeitar a mscara e a quantidade de caracteres definidos no cadastro do Grupo de Empresas. Qualquer divergncia ser informada pelo sistema.

1.11 Filial

Ao inserir uma nova Filial: Preencha o campo Grupo, criado anteriormente, ao qual pertence a Filial. Preencha o campo Empresa, criado anteriormente, ao qual pertence a Filial. Preencha o campo Unidade de Negcio, criado anteriormente, ao qual pertence a Filial. Preencha os campos Cdigo e Descrio desta Filial.

Para finalizar preencha os dados cadastrais da Filial, como Nome, CNPJ e Endereo. Saiba mais: O novo cdigo da Filial ser o conjunto das informaes preenchidas nas entidades. Exemplo de nova Filial E01001001. Importante: o Campo Cdigo deve respeitar a mscara e a quantidade de caracteres definidos no cadastro do Grupo de Empresas. Qualquer divergncia ser informada pelo sistema.

1.12 Campos Concatenados - 01

Para a atualizao de campos no normalizados, no qual a informao de Filial faz parte de um trecho do contedo do campo, dever ser criada uma funo composta pela sigla do mdulo + UpdFConj() retornando um array padronizado. Este tratamento deve ser realizado apenas pelos responsveis pelo Ambiente (Mdulo). Importante: As rotinas de atualizao de todos os mdulos sero executadas no momento da Importao, por este motivo a correta nomenclatura das Funes importante.

TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0

TOTVS - Microsiga Protheus Gesto de Empresas

1.13 Campos Concatenados - 02

Exemplo da montagem da funo de atualizao, se baseando no mdulo de Gesto de Pessoal.

1.14 Campos Concatenados - 03

Estrutura do array de retorno funo de atualizao, onde n a linha referente um determinado campo: A Primeira posio do array o Alias da tabela. A Segunda posio o nome do campo. A Terceira posio o Tamanho original do campo. A Quarta posio a Posio inicial para a gravao do campo Filial, caso esta posio no seja preenchida o campo em questo ser considerado um clone do campo Filial e ter apenas seu tamanho alterado. A Quinta posio o Bloco de cdigo que processara uma Funo customizada para atualizao dos dados.

A seguir, detalharemos o preenchimento da "Quinta" posio do array.

1.15 Campos Concatenados - 04

A Quinta posio do array receber o Bloco de Cdigo que processar uma Funo customizada para atualizao dos dados. Esta posio do vetor s deve ser preenchida nos casos em que a rotina padro de converso no deva ser utilizada. Neste caso, a Quarta posio do array deve receber o valor Zero. Veja o exemplo: No momento da execuo, o Bloco de Cdigo receber os campos descritos, que podero ser utilizados na execuo da rotina de atualizao customizada: TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0 7

TOTVS - Microsiga Protheus Gesto de Empresas

Alias da Tabela. Nome do Campo. Tamanho Real, numrico com o tamanho padro do Campo na linha de Produtos Microsiga Protheus. Filial Original, numrico com o Cdigo da Filial original do campo. Tamanho Origem, numrico com o tamanho original do campo, passvel de customizao. Tamanho Destino, numrico com o novo tamanho do campo, aps a converso.

1.16 Procedimentos para uso da Gesto de Empresas

Aps o cadastro das entidades e a criao das rotinas de atualizao existem duas maneiras para configurar o uso sistema com a Gesto de empresas: Importar Gesto de Empresas. Iniciar o sistema sem informaes na Base de Dados.

1.17 Importando Gesto de Empresas - 01

Atravs do atalho Configurador / Ambiente / Empresas / Import. Gest. Empr. voc ter acesso rotina que ir preparar todas as tabelas do sistema para o uso da Gesto de Empresas.

1.18 Importando Gesto de Empresas - 02

Passos para importao da Gesto de Empresas: Clique em Avanar para configurar a importao. Selecione as Filiais que devero ser atualizadas. Selecione a Filial destino. Indique o compartilhamento das tabelas, se sero exclusivas ou compartilhadas. Pressione Finalizar para iniciar o processo ou Cancelar para desistir. Importante: O compartilhamento das tabelas deve respeitar a hierarquia. Por exemplo: no permitido que uma tabela seja exclusiva nos campos Unidade de Negcio e Filial e compartilhada no campo Empresa. Aps efetuar a importao, os dados da Filial de origem estaro disponveis apenas para consulta.

TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0

TOTVS - Microsiga Protheus Gesto de Empresas

1.19 Autorizao de Empresas

Aps criar e importar as informaes para a Gesto de Empresas, necessrio solicitar o arquivo de liberao das novas empresas TOTVS. Acesse o Portal do Cliente http://suporte.totvs.com/, informe seu usurio e senha, depois acesse o link Auto Atendimento CST e siga os passos solicitados.

1.20 Utilizao

Complete a configurao da Gesto de Empresas e aplique o arquivo de liberao, disponibilizado pela TOTVS (Sigamat.emp) que deve ser copiado no diretrio SYSTEM do Ambiente da linha de Produtos Microsiga Protheus. Acesse a tela de login e selecione um dos novos Grupos de Empresa criados. Execute uma rotina de cadastro, por exemplo Clientes, e verifique a atualizao do campo Filial j respeitando o novo formato.

1.21 Tamanho padro do cdigo da Filial

Quando a Gesto de Empresas estiver habilitada o tamanho do campo M0_CODFIL (Filial) ser de doze caracteres. O Exemplo mostra ambas formas de utilizar o campo M0_CODFIL no cdigo fonte. Importante: A funo FWSizeFilial retorna o nmero de caracteres configurados para a Filial na Gesto de Empresas. Estude com ateno a lista de funes descritas no Glossrio.

1.22 Funes

Nome da funo

Descrio Retorna o tamanho do campo Filial.

FWSizeFilial

Parmetro: cGrpCompany Indica o grupo de empresas que dever ser verificado. Retorno: nFilSize Indica o tamanho do campo Filial. Retorna o cdigo da filial (M0_CODFIL).

FWCodFil

Parmetro: cGrpCompany Indica o grupo de empresas que dever ser verificado. Parmetro: cEmpUDFil Indica a empresa, unidade de negcio e filial. Retorno: cCodFil Indica o cdigo da filial posicionada.

TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0

TOTVS - Microsiga Protheus Gesto de Empresas

Retorna o modo de compartilhamento da tabela para o nvel informado. Parmetro: cAlias Indica o alias em que o modo de compartilhamento deve ser avaliado. Parmetro: nLevel Indica o nvel a ser avaliado (1=Empresa, 2=Unidade de Negcio e 3=Filial). Parmetro: cGrpCompany Indica o grupo de empresas que dever ser verificado. Retorno: cMode Indica o modo de compartilhamento da tabela. Retorna o grupo de empresas atual. FWGrpCompany Retorno: cGrpCompany Retorna o grupo de empresas atual. Retorna os grupos de empresa. FWAllGrpCompany Retorno: aAllGroup Retorna os grupos de empresa. Retorna a empresa atual. FWCompany Retorno: cCompany Retorna a empresa atual. Retorna as empresas do grupo informado. FWAllCompany Parmetro: cGrpCompany Indica o grupo de empresas que dever ser verificado. Retorno: aAllCompany Retorna as empresas do grupo atual. Retorna a unidade de negcio atual. Retorno: cUnitBusiness Retorna a unidade de negcio atual. Retorna as unidades de negcios para o grupo e empresa informados. FWAllUnitBusiness Parmetro: cCompany Indica a empresa que dever ser verificada. Parmetro: cGrpCompany Indica o grupo de empresas que dever ser verificado. Retorno: aAllUnitBusiness Retorna todas unidades de negcios do grupo atual. Retorna a filial atual. Parmetro: cAlias Se informado retorna a filial de acordo com o modo de compartilhamento. Retorno: cFilial Retorna a filial atual. Retorna as filiais para o grupo de empresas, empresa e unidade de negcio informada. Parmetro: cCompany Indica a empresa que dever ser verificada. Parmetro: cUnitBusiness Indica a unidade de negcio que dever ser verificada. Parmetro: cGrpCompany Indica o grupo de empresas que dever ser verificado. Retorno: aAllFilial Retorna todas filiais do grupo atual. Carrega as informaes do SIGAMAT.EMP. Retorno: aEmpresas Retorna as principais informaes das empresas do SIGAMAT. Observao: Utilize a posio SM0_RECNO para retornar as demais informaes. Retorna o leiaute utilizado pelo grupo de empresas. Parmetro: cGrpCompany Indica o grupo de empresas que dever ser verificado. Parmetro: nLevel Indica o nvel a ser avaliado (1=Empresa, 2=Unidade de Negcio e 3=Filial). Retorno: cLayout Retorna o leiaute do grupo de empresas.

FWModeAccess

FWUnitBusiness

FWFilial

FWAllFilial

FWLoadSM0

FWSM0Layout

10

TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0

TOTVS - Microsiga Protheus Gesto de Empresas

Retorna a string contendo a empresa, unidade de negcio e filial com o tratamento de compartilhamento. FWxFilial Parmetro: cAlias Alias da tabela a ser avaliada. Parmetro: cEmpUDFil Indica a empresa, unidade de negcio e filial (Ex: cFilAnt). Retorno: cFilial Retorna a string contendo a empresa, unidade de negcio e filial com o tratamento. Retorna o nome do grupo de empresas. Parmetro: cGrpCompany Indica o grupo de empresas que deve ser verificado. Retorno: cName Retorna o nome do grupo de empresas. Retorna o nome da filial. Parmetro: cGrpCompany Indica o grupo de empresas que deve ser verificado. Parmetro: cEmpUDFil Indica a empresa, unidade de negcio e filial (Ex: cFilAnt). Parmetro: nType Indica o tipo de retorno (1=Reduzido,2=Completo). Retorno: cName Retorna o nome completo ou reduzido da empresa. Retorna o nome da Unidade de Negocios. Parmetro: cGrpCompany Indica o grupo de empresas que deve ser verificado. Parmetro: cEmpUDFil Indica a empresa, unidade de negcio e filial (Ex: cFilAnt). Retorno: cName Retorna o nome da unidade de negcios. Retorna a Razo social da empresa/filial passada. Parmetro: cGrpCompany Indica o grupo de empresas que deve ser verificado. Parmetro: cEmpUDFil Indica a empresa, unidade de negcio e filial (Ex: cFilAnt). Retorno: cName Retorna a razo social. Retorna todas informaes referente a empresa, unidade de negcio e filial. Parmetro: cGrpCompany Indica o grupo de empresas que deve ser verificado. Parmetro: cEmpUDFil Indica a empresa, unidade de negcio e filial para tabelas exclusivas, no caso de no informado ser realizado o tratamento padro. Retorno: aRet Retorna um array com as informaes da filial atual (Utilize as strings disponibilizadas no FWCOMMAND.CH). Retorna o cdigo da empresa no caso de estar configurada no leaiute do grupo, seno, retorna o grupo de empresas. FWCodEmp Parmetro: cAlias Indica o Alias da tabela. Retorno: cEmp Cdigo da empresa no caso de estar configurada no leaiute do grupo, seno, retorna o grupo de empresas.

FWGrpName

FWFilialName

FWUnitName

FWFilRazSocial

FWArrFilAtu

1.23 Impresso
Aps a importao, a tela de configurao dos relatrios Personalizveis (TReport) apresenta o boto Gesto de Empresas. Esta opo permite filtrar o relatrio partir dos campos: Empresa. Unidade. Filial.

Basta marcar os filtros desejados, disponibilizados partir de um campo do tipo Seleo (checkbox), preencher os cdigos inicial e final para cada um dos filtros e pressionar Confirmar. TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0 11

TOTVS - Microsiga Protheus Gesto de Empresas

Importante: Sero apresentados apenas os filtros configurados no leiaute, como explicado no decorrer do curso. Desta forma, se o leiaute foi definido para EEFF (Empresa e Filial) no ser apresentado o filtro Unidade de Negcio.

1.24 Concluso

A Gesto de Empresas, presente na Linha de Produtos Microsiga Protheus verso TOTVS 2011, permite compartilhar as definies do Modelo de Dados entre as empresas configuradas no sistema, alm de introduzir o conceito de Unidade de Negcio. Neste Treinamento voc aprendeu como configurar a Gesto de Empresas.

12

TOTVS - Microsiga Protheus Gesto de Empresas Verso 1.0