Atusx 11 PDF

Atusx e Infraestrutura de dicionário de dados
Sérgio Alcântara – Inovação framework/ 07- 12

Atusx – Gerenciador do Dicionário de Dados
ÍNDICE
I) Apresentação
II) Principais funcionalidades
I) Apresentação
• Objetivo do treinamento
• Premissas do produto
• Principais dicionários
2
Apresentação
Objetivo do treinamento
• Prover aos colaboradores das áreas de sustentação e

inovação do produto Protheus o entendimento do
dicionário de dados e sua correspondência na
utilização da ferramenta ATUSX.
3
Apresentação
Introdução
 O produto Microsiga Protheus é composto por 3 camadas principais, a saber:

• Binários (linguagem e interpretador)
• Regras de negócio (funções, programas e classes – repositório)
• Dicionário de dados (metadados)
 Estas 3 camadas interagem para compor um produto completo (sistema). A camada de
binários é o ambiente de execução propriamente dito, a camada de regras de negócio é
camada na qual todos os programas e funcionalidades são compilados e a camada de
dicionário de dados (metadados) descreve o modelo de dados (tabelas,campos, índices),
consultas, menus, parâmetros, entre outros, de uma forma dinâmica, permitindo sua
configuração e customização.
 Definição de Metadados : Metadados, ou Metainformação, são dados sobre outros dados.
Um item de um metadado pode dizer do que se trata aquele dado, geralmente uma
informação inteligível por um computador. Os metadados facilitam o entendimento dos
relacionamentos e a utilidade das informações dos dados.
4
Apresentação
Introdução
• O dicionário de dados ativo do Protheus confere grande flexibilidade ao

produto, pois permite que muitas características do mesmo sejam
alteradas sem a necessidade de manipulação de código (programas). Além
disso, muitas dessas alterações podem ser realizadas “a quente”, sem ter
que paralisar o sistema. Além disso, permite grande facilidade de
customização.
• Desse modo, o dicionário age como uma extensão da camada de regras de
negócio, pois sua configuração pode modificar a operação do sistema, e
por outro lado, o próprio funcionamento do dicionário está vinculado a
regras definidas pela camada de negócios.
5
Apresentação
Introdução
• O Atusx é a ferramenta utilizada internamente para a construção e

manutenção do dicionário de dados. É nesta ferramenta que fica
armazenada a versão “oficial” do dicionário de dados. Qualquer alteração
a ser feita no dicionário de dados do produto padrão Protheus deve ser
feita no ATUSX.
• Quando uma nova versão do produto Protheus é liberada, o dicionário de

dados é extraído diretamente do ATUSX.
6
Apresentação
Introdução
• O cadastramento de dicionários no ATUSX guarda certas semelhanças com

a manipulação de dicionários no configurador, porém o objetivo das
ferramentas é diferente.
• O configurador é direcionado à manutenção de dicionários por parte do
administrador do Protheus, sendo utilizado também em personalizações e
customizações.
• O ATUSX é focado na construção do dicionário de dados do produto
Protheus. Entre suas premissas estão, entre outros:
 Controle individualizado de versões, projetos e pacotes.
 Separação por países (localização).
 Tradução para os demais idiomas.
 Aprovação dos registros pelo DBA e líderes.
7
Apresentação
Principais dicionários
 Os seguintes dicionários são cadastrados e mantidos no ATUSX:

• Índices (SIX)
• Perguntas (SX1)
• Tabelas (SX2)
• Campos (SX3)
• Tabelas genéricas (SX5)
• Parâmetros (SX6)
• Gatilhos (SX7)
• Relacionamentos (SX9)
• Pastas / agrupamentos (SXA)
• Consultas Padrão (SXB)
• Grupo de campos (SXG)
• Regras de dependência (XXA)
8
Apresentação
Outros itens
 Além dos dicionários propriamente ditos, são cadastrados / traduzidos os

seguintes itens:
• Arquivos “.CH” (textos de programas para serem traduzidos ).

• Menus do sistema.
• Help de campos e mensagens.
9
Atusx – Gerenciador do Dicionário de Dados
ÍNDICE
I) Apresentação
• Conceito de Projetos • Manutenção de grupo de campos

• Login no Projeto • Manutenção de tabelas genéricas
• Manutenção de tabela (SX2) • Manutenção de parâmetros
• Manutenção de tabela (SX3) • Manutenção de perguntas
• Manutenção de tabela (SX7) • Manutenção de consultas padrões
• Manutenção de tabela (XXA) • Manutenção de CHs (strings)
• Manutenção de tabela (SIX) • Manutenção de Helps
• Manutenção de tabela (SXA) • Manutenção de Menus
• Manutenção de tabela (SX9)
Principais funcionalidades
Conceito de Projetos
• O Atusx é uma ferramenta que suporta múltiplos projetos.
• Na realidade, existem 3 níveis possíveis de visualização : Versão, projeto e

pacote.
• Uma versão é o nível mais abrangente: na maioria dos casos, corresponde

a uma versão do Protheus. Para o usuário, os dados de diferentes versões
ficam totalmente isolados.
11
• O projeto é o nível intermediário. Um projeto está sempre vinculado a

uma versão. Um projeto pode ser um release (subdivisão de uma versão),
um desenvolvimento específico para um país ou para um cliente.
Dados lançados em um projeto não afetam projetos que possuem o mesmo nível
na estrutura, mas podem “herdar” dados de projetos de nível superior e
alterar dados de projetos de nível inferior.
12
• O pacote é o último nível da estrutura. Um pacote está sempre vinculado a

um projeto. Um pacote pode ser um desenvolvimento específico que
posteriormente será “incorporado” a um projeto.
Dados lançados em um pacote não afetam outros pacotes ou projetos, mas podem “herdar”
dados do projeto “pai”, que por sua vez pode herdar dados de outros projetos na
estrutura.
13
Login no projeto
• Antes de fazer qualquer

manipulação nos dados, o
usuário deve selecionar a
versão / projeto / pacote de
trabalho.
14
Login no projeto
• Após a primeira seleção, o projeto escolhido é utilizado

em todas as rotinas selecionadas.
• Para alterar o projeto de trabalho, deve-se utilizar a

rotina de menu “inicializa ambiente”.
15
Manutenção de tabela
• Utilizar a opção de • Através da opção “Dicionários de Dados”
poderão ser editados os dados da tabela e
menu : Atualizações
de dicionários vinculados: arquivos (SX2),
-> Cadastros -> campos (SX3), índices (SIX), gatilhos (SX7),
Dicionários. relacionamentos (SX9),
pastas/agrupamentos (SXA) e regras de
dependência (XXA).
Lembrete: para cadastrar uma tabela, no mínimo é

preciso possuir dados do SX2, SX3 e SIX.
16
Manutenção de tabela – SX2

• O dados principais da
tabela, referentes ao
dicionário SX2, ficam na
parte superior da janela.
Exemplo : prefixo da
tabela.
• Alguns dados do SX2
podem ser diferentes para
cada país. Essa informação
fica armazenada em um
“grid” localizado abaixo da
edição dos dados principais
da tabela. Se o dado serve
para todos os países, deve-
se selecionar no campo
“sigla/país” o país ALL.
17
• O SX2 é o dicionário de tabelas do sistema Protheus. Todas as tabelas de dados

do Protheus (cadastro de clientes, cadastro de produtos, saldos em estoque,
pedidos de venda etc...) estão descritas no SX2.
• No SX2 são armazenados os dados principais da tabela, como prefixo (Ex: SA1),
nome físico e chave única.
18

• Os dados principais do SX2 localizam-se na parte superior da janela de edição.
• Definição dos campos:

Campo Descrição
Tabela Nome da tabela (Alias) – Exemplo: A00. Este nome é reservado por GDP e cada uma controla o próprio sequenciamento.
Path Esta opção serve apenas para quando o ambiente não for TOP.
1=SIGAADV -> As tabelas serão criadas na pasta SYSTEM ambiente.
2=DADOSADV -> As tabelas serão criadas em uma pasta definida pelo usuário na criação do ambiente, dentro do rootpath.
Arquivo Ao preencher o campo tabela, este campo é automaticamente preenchido.
19

• Definição dos campos (continuação):
Modo Compartilhado: As filiais compartilham os dados desta tabela.

Exclusivo: As filiais apenas tem acesso aos dados cadastrados pela própria filial.
Modo Unidade Compartilhado: As unidades de negócios compartilham os dados desta tabela.
Exclusivo: As unidades de negócio apenas tem acesso aos dados cadastrados pelas próprias unidades de negócio.
Modo Empresa Compartilhado: As empresas compartilham os dados desta tabela.
Exclusivo: As empresas apenas tem acesso aos dados cadastrados pelas próprias empresas.
Pyme Se a tabela irá pertencer a Versão Série 3 do Protheus (ERP Reduzido): Sim ou Não.
Chave única Combinação de campos que não irão se repetir no banco de dados (primary key de banco de dados).
Display Indique quais campos serão mostrados em um Browse para melhor visualização do registro. Estes campos serão mostrados
em um cabeçalho, separado dos registros.
Ex. A1_COD+A1_LOJA+A1_NOME
20

• Os dados distribuídos (por países) localizam-se no “grid” na parte inferior.

Campo Descrição
Sigla/País Através deste campo é possível definir para qual país as informações serão válidas, ou caso seja selecionado o país “ALL” as
informações serão válidas para todos os países.
Nome Port. Nome em Português da Tabela.

Rotina Função disparada sempre que a tabela for aberta. Obs. Não é permitido incluir novas funções, apenas visual.
Template Fora de uso.
Objeto Indique o fonte responsável pela manutenção(caso a mesma seja em MVC) e verificação de acesso de usuário da rotina.
ID Usado para controle interno.
21

• A lista de campos da tabela
encontra-se no canto inferior
esquerdo. Os dados de campos
são referentes ao dicionário SX3.
• Os dados principais de cada
campo, como por exemplo o tipo,
encontram-se à direita da lista.
• Assim como acontece no
dicionário SX2, alguns dados do
campo, como o tamanho, podem
ser específicos por país. Essa
distribuição encontra-se no grid
abaixo dos dados principais do
campo. Se o dado serve para
todos os países, deve-se
selecionar o país ALL.
22
• No SX3 são armazenados as características básicas dos campos, como

por exemplo nome, tipo de dado, tamanho e decimais, que permitem ao
Protheus construir a tabela automaticamente no banco de dados, sem
necessidade de intervenção por parte do Administrador.
• Além disso, são registradas informações que norteiam o comportamento

do campo no sistema, como por exemplo: título, descrição, regras de
validação, inicialização e gatilhos, entre outros.
• Os campos informados no SX3 estão sempre relacionados a uma tabela

descrita no SX2. Não pode existir tabela no SX2 sem campos no SX3, e
vice-versa.
23

• Os dados principais do
SX3 localizam-se na
parte superior do
painel de edição de
campos.
• Definição dos campos (dados principais):

Campo Descrição
Campo Nome do campo digitado no grid.
Tipo Indica o tipo de informação que o campo armazenará. (Caracter, Numérico, Lógico, Data ou Memo).
Grp. Campos Indica a qual grupo de campos o campo pertence, para maiores informações consulte o tópico Grupo de Campo.
ID ZYG Controle interno.
Pyme Se o campo irá pertencer a Versão Série 3 do Protheus (ERP Reduzido): Sim ou Não.
Index Server Indica se o campo servirá de base para a busca da ferramenta Protheus Search.
24

• Definição dos campos (continuação) .
Exporta POS Indica se o campo será exportado pela ferramenta de PDV.
Template Selecione, caso necessite, um template que o campo utilizará.
Dsc.Template Descrição do template selecionado.
25

• Os dados distribuídos (por
países) localizam-se no
“grid” na parte inferior.
• Definição dos campos (dados distribuídos):

Campo Descrição
Sigla/País Através deste campo é possível definir para qual país as informações serão válidas, ou caso seja selecionado o país “ALL” as
Ordem Indica a ordem de apresentação do campo, caso seja necessário incluir um campo entre outros, é necessário mudar
manualmente todos.
Tamanho Indica o tamanho do campo.
Decimal Caso o tipo do campo seja numérico indica a quantidade de casas decimais que o campo irá aceitar.
26

• Definição dos campos (continuação) :
Titulo Port. Título do campo em Português.
Desc. Port. Descrição do campo em Português.
Picture Máscara dada ao campo. Caso seja um campo numérico ao preencher as informações de Tamanho e Decimal, a Picture será sugerida. Caso deseje pode também utilizar o botão
para que uma Picture adequada seja dada.
Valid Função a ser chamada para validação do campo, o retorno da função deverá ser um booleano (True ou False).
Usado Campo de uso interno preenchido através do botão Obrigat .
Inic. Padrao Indica qual será o inicializador padrão do campo, possui o mesmo conceito do DEFAULT utilizado em banco de dados.
Reserv Campo de uso interno preenchido através do botão Obrigat .
Check Não usado.
Propri Indica o proprietário do campo:

S = Microsiga
T = Template
U = Customizaçao do usuário
Browse Indica se o campo deverá ser mostrado em um Browse ou não, mesmo que o campo esteja marcado como Não usado.
Visual Indica se o campo será apenas para visualização ou para alteração também (Alterar/Visualizar).
Contexto Indica se é um campo Real ou Virtual.
VldUser Campo para informar a validação do usuário. Esse campo pode vir preenchido na instalação padrão do produto, porém é permitido que o cliente o customize.
Cbox Port. Neste campo são indicados os possíveis valores caso o campo seja uma Combo Box. O padrão para o preenchimento é: (número relativo a opção)=(Descrição da opção). Exemplo.:
1=Local;2=Server
Pode se também indicar uma função colocando # seguido do nome da função, porém deve se tomar cuidado para que o retorno da mesma esteja seguindo o padrão de
preenchimento. Exemplo: #MyFunction()
27

PictVar Informe uma função para determinar qual Picture será utilizada no campo em tempo de execução. Exemplo de uso, no cadastro de Cliente, quando alteramos o tipo de pessoa
(entre juridica e física), a picture do campo A1_CGC, é alterado para validar CPF ou CNPJ.
When Informe uma função que determinará se o campo poderá ser alterado ou não, esta função será executada a cada mudança de foco no sistema.
IniBrw Informe o inicializador padrão para este campo, quando for exibido em um Browse.
Cond. SQL Fora de uso.
Check SQL Fora de uso.
C.Padrao SXB Consulta padrão para o campo localizada no SXB, para maiores detalhes consulte o tópico Consultas Padrão.
C.Padrao SX5 Consulta padrão para o campo localizada no SX5.
Pasta SXA Se desejar, informe a pasta em que o campo irá aparecer. É necessário que a pasta já esteja cadastrada. Para maiores informações consulte o tópico Pastas.
Cor Ortograf Indica se o campo está sujeito ao corretor ortográfico. Esse recurso depende da ativação do corretor ortográfico no Protheus.
Descr. Help Descrição do Help, apenas visual.
Selecao Tela Este campo é utilizado quando se deseja omitir um campo ao utilizar uma Enchoice ou a classe MSMGET, ao chamá-las pode se passar um ID no parâmetro “cTela” que verificará se o
campo possui este ID cadastrado.
Pode se informar um ou mais Ids, caso seja mais que um separá-los com o caractere “|”(pipe). Ex.: 2|5
Cons. Help Indica qual o HELP para este campo, para maiores informações consultar o tópico Help.
ID ID do HELP selecionado.
Agrupamento Informe um agrupamento que deseja colocar o campo, apenas para rotina escritas na tecnologia MVC, podemos criar um Agrupador dentro de cada folder. Para maiores
informações consulte o tópico Agrupamentos.
28

Item Ativo Usado para controle interno.
Título Esp. Título do Campo em Espanhol.
Desc. Esp. Descrição do Campo em Espanhol.
Cbox Esp. Campo contendo a tradução do campo Cbox Port. para o Espanhol.
Título Ing. Título do Campo em Inglês.
Desc. Ingles Descrição do Campo em Inglês.
Cbox Ingles Campo contendo a tradução do campo Cbox Port. para o Inglês.
Título Ptg. Título do Campo em Português de Portugal.
Desc. Ptg Descrição do Campo em Português de Portugal.
Cbox Ptg Campo contendo a tradução do campo Cbox Port. para o Português de Portugal.
29

• Clicando-se na sub-pasta “gatilhos”,
é efetuada a manutenção dos
gatilhos, dicionário SX7.
• No Protheus, os gatilhos são
disparados por um campo e
efetuam uma ação alterando o
conteúdo de outro campo.
• A edição dos dados da pasta
encontra-se no grid. Neste
dicionário existe distribuição por
países. Se o dado serve a todos os
países, deve-se selecionar o país
ALL.
• Os gatilhos são criados por campo,
portanto o campo disparador do
gatilho será o que estiver
selecionado do lado esquerdo da
tela. Após selecionar o campo,
basta preencher as informações.
30
• Os gatilhos permitem que, ao alterar o conteúdo de um campo (domínio),

seja disparada uma ação para modificar o conteúdo de outro campo
(contradomínio).
• Os campos informados no SX7 estão sempre relacionados a um campo

descrito no SX3. Não pode existir domínio ou contradomínio no SX7 sem
correspondência no SX3.
• Os gatilhos operam apenas nas funções e classes de objetos

disponibilizados por framework. Dessa forma, rodam na camada framework
Protheus e não no banco de dados.
31

• Os dados do SX7
localizam-se no painel de
edição de gatilhos.

Campo Descrição
Sigla / País Através deste campo é possível definir para qual país as informações serão válidas, ou caso seja selecionado o país “ALL”
as informações serão válidas para todos os países.
Cnt. Domínio Informe o campo que será o contra domínio(destino) do gatilho. Obs. Apenas campos já cadastrados podem ser
selecionados, portanto se estiver criando campos e já desejar adicionar gatilhos, terá que primeiro cadastrar o campo e
depois adicionar o gatilho.
Cpo Ct. Dom Nome do campo selecionado, apenas visual.
32

• Definição dos campos (continuação) :
Sequência Informe a ordem em que este gatilho será disparado. Exemplo: Pode se ter 3 gatilhos para o mesmo campo, e cada um
com sua ordem de disparo. Obs. Utilizar sempre 3 digitos -> 001,002,003,...
Regra Informe a regra para o preenchimento do campo contra domínio.
Tipo Indica o tipo de Gatilho, valores aceitos para ele P = Primário ; E = Estrangeiro ; X = Posicionamento.
Seek Indica se a tabela será posicionada ou não.
Id SIX Indica o índice para busca de valores em outras tabelas.
Ordem Mostra o índice selecionado no campo ID SIX, apenas visual.
Chave Indica expressão a ser pesquisada em uma tabela para busca do valor para o gatilho. Deverá obedecer o índice definido no
campo ID SIX.
Proprietário Indica se é do Microsiga Protheus ou um Template específico.
Condição Indique neste campo, caso necessite, uma função para determinar se o gatilho deve ser executado ou não. O retorno da
função deverá ser booleano.
33
Manutenção de tabela – XXA

• Clicando-se na sub-pasta “regras
de dependência”, é efetuada a
manutenção das regras de
dependência, dicionário XXA.
• No Protheus, as regras de
dependência permitem
estabelecer vínculos entre
campos no momento da
digitação, impedindo que um
campo seja inserido antes de
outro, por exemplo.
encontra-se no grid. Neste
dicionário existe distribuição por
países. Se o dado serve para
todos os países, deve-se
selecionar o país ALL.
34
Manutenção de tabela – XXA

• Os dados do XXA
edição de regras de
dependência.

Campo Descrição
Sigla / País Através deste campo é possível definir para qual país as informações serão válidas, ou caso seja selecionado o país “ALL” as
Sequência Informe a ordem em que esta regra será disparada. Exemplo: Pode se ter 3 regras para o mesmo campo, e cada uma com
sua ordem de disparo. Obs. Utilizar sempre 3 digitos -> 001,002,003,...
C. domínio Informe qual campo que será associado a regra do campo atual.
Descriçao Informe a descrição da regra criada.
Tipo / regra Informe o tipo de regra:

1 – Pré-Validação: O campo contra domínio só terá a sua edição habilitada quando o campo domínio estiver preenchido.
2 – Pós-Validação: Sempre que o campo domínio for preenchido, é executada a validação do campo contra domínio
3 – Pré ePós-Validação: Executa as duas validações.
ID Controle interno.
35
Manutenção de tabela – SIX

• Ao clicar na aba “índices”, são
apresentados os dados referentes
ao dicionário SIX.
• A lista de índices da tabela
encontra-se no canto inferior
esquerdo.
• Os dados principais de cada índice,
como por exemplo a chave,
encontram-se à direita da lista.
• Assim como acontece no dicionário
SX3, alguns dados do índice, como
a exibição, podem ser específicos
por país. Essa distribuição
encontra-se no grid abaixo dos
dados principais do campo. Se o
dado serve para todos os países,
deve-se selecionar o país ALL.
36
• As chaves de índice são criadas para permitir a pesquisa dos dados da

tabela. São usadas em buscas estilo ISAM no Protheus (via dbSeek ),
consultas no banco de dados via queries e pesquisas nos grids do
Protheus pelo usuário.
• Os campos que compõe a chave de índice devem estar presentes nas

tabelas e no dicionário SX3. Não pode existir chave de índice
referenciando a um campo ausente no SX3.
• No ADVPL, as chaves de índices devem ser formadas por apenas um

tipo de dado (caractere ou data, por exemplo). Se for necessário criar
uma chave combinando campos de tipos diferentes, deve-se colocar
funções para converter para um tipo único (normalmente caractere).
Dessa forma, ao combinar um campo caractere e um campo data, deve-
se converter o campo data para caractere usando a função DTOS().
37

• Os dados principais
do índice localizam-
se na parte superior
do painel de edição
de índices.
• Para incluir um novo índice, clique no botão

incluir e será aberta uma tela para inclusão da
chave de índice. A chave é preenchida da seguinte
maneira:
(nome_do_campo)+(nome_do_campo)+...
• A chave já vem com o campo Filial para facilitar o
cadastro, para adicionar outros campos basta
clicar no botão de Ações Relacionadas e
selecionar a opção Campos.
38

• Definição dos campos (principal) :
Campo Descrição
Proprietario Indica se é do Microsiga Protheus ou um Template específico.
NickName Nome dado ao Índice. Pode ser utilizado em rotinas para a seleção do índice, dispensando o uso da seleção numérica.
F3 Caso a chave possua campos de chave estrangeira, pode se colocar uma consulta padrão para buscar o valor do campo
quando utilizada a busca separada no browse. Para preencher elimina-se o campo Filial e a partir deste campo é colocado o
código da(s) consulta(s) padrão, caso não exista ou o campo seja da própria tabela, coloca-se ‘XXX’.
Exemplo: Chave -> AB1_FILIAL+AB1_STATUS+AB1_CODCLI+AB1_LOJA
O campo CODCLI é chave estrangeira da tabela SA1, portanto o F3 ficará:
F3 -> XXX+SA1
39

• Os dados distribuídos
(por países) localizam-
se no “grid” na parte
inferior.
No grid é possível editar informações específicas do índice que podem ser distribuídas por país dependendo da
necessidade, ou caso não haja necessidade basta colocar para o país “ALL”.
Campo Descrição
View AxPesq Indica se o índice será mostrado no Browse do sistema.
40
Manutenção de tabela – SXA

• Ao clicar na aba “Pastas”, são
apresentados os dados referentes ao
dicionário SXA.
encontra-se no grid. Neste dicionário
não existe distribuição por países.
• Após o cadastro, a pasta pode ser
vinculada ao campo através do GRID
de edição do campo por país (tabela
SX3).
41
• O recurso de pasta tem a função de agrupar campos com características

semelhantes em pastas no momento do cadastramento do dado,
facilitando a visualização.
• Esse recurso opera apenas em janelas de edição estilo formulário, ou

seja, não funciona em “grid”.
• Caso hajam pastas definidas para uma tabela, os campos que não
possuem pasta definida serão automaticamente alocados na pasta
“outros”.
42

• Os dados do SXA
edição de pastas.

Campo Descrição
Ordem Informe a ordem em que a pasta será exibida.
DescPor Informe a descrição que será apresentada no pasta.
ProPri Não usado.
43
Manutenção de tabela – SXA / Agrupamentos

• Ao clicar na aba “Agrupamentos”, são
apresentados os dados referentes ao
dicionário SXA, relativos aos
agrupamentos.
• O dicionário SXA armazena
informações tanto de pastas quanto
de agrupamentos.
encontra-se no grid. Neste dicionário
não existe distribuição por países.
• Após o cadastro, o agrupamento
pode ser vinculado ao campo através
do GRID de edição do campo por país
(tabela SX3), no campo
“agrupamento”.
44

• O recurso de agrupamento tem a função de organizar os campos exibidos em um
formulário ou pasta.
• O objetivo do agrupamento é semelhante ao das pastas, ou seja, agrupar campos

com características semelhantes. O estilo de exibição que é diferente, pois os
itens aparecem agrupados em uma mesma área.
• Agrupamentos e pastas podem ser usados em conjunto.
• Se dois campos são colocados em um mesmo agrupamento e em duas pastas

diferentes, por exemplo, o agrupamento será criado automaticamente nas duas
pastas.
• Esse recurso opera apenas em janelas de edição estilo formulário, ou seja, não
funciona em “grid”.
• O recurso de agrupamento funciona apenas se for usado o modelo de

desenvolvimento MVC.
45

• Os dados do “SXA /
Agrupamentos”
edição de
agrupamentos.

Campo Descrição
Ordem Informe a ordem em que o agrupamento será exibido.
Agrupamento Informe o código do agrupamento, este código deve ser iniciado com um número.
DescPor Descrição que aparecerá como título do agrupamento.
ProPri Não usado.
Tipo 1=Separador
2=Painel
46

• Ao clicar na aba
“Relacionamentos”, são
apresentados os dados
referentes ao dicionário
SX9.
• O relacionamento vincula
campos da tabela que está
sendo editada com
campos de outras tabelas
do sistema.
• A edição dos dados da
pasta encontra-se no grid.
Neste dicionário existe
distribuição por países,
pois os campos também
podem ser distribuídos.
47

Campo Descrição
Sigla / País Através deste campo é possível definir para qual país as informações serão válidas, ou caso seja selecionado o país
“ALL” as informações serão válidas para todos os países.
Domínio Indique qual tabela se relaciona com a atual.
Alias Dom. Alias da tabela de domínio. Apenas visual.
Exp.Domínio e Exp.CDomínio Expressões que definirão as regras de relacionamento.
Exemplo tabela SA1, em relacionamento com a tabela SX5:
Exp.Domínio -> X5_TABELA+X5_CHAVE
Exp.CDomínio -> '12'+A1_EST
Tp.Lig.Dom. e Tp.Lig.CDom. Definem o tipo de ligação:
1 para 1: Relacionamento de 1 registro da tabela Domínio para 1 registro da tabela de Contra Domínio.
1 para N: Relacionamento de 1 registro da tabela Domínio para N registros da tabela de Contra Domínio.
N para 1: Relacionamento de N registros da tabela Domínio para 1 registro da tabela de Contra Domínio.
N para N: Relacionamento de N registros da tabela Domínio para N registros da tabela de Contra Domínio.
Usar Filial Indica se irá considerar a filial para fazer o relacionamento.

S=Sim
N=Não
Condicao SQL Caso necessário indique uma condição SQL para filtrar os dados que serão relacionados da tabela de contra
domínio.
Habilitar Indica se o relacionamento está habilitado ou não.
48

Vinc. Filial Indica se existe vínculo do modo de compartilhamento de filiais entre as tabelas. A princípio se marcada faz com
que a tabela atual tenha que respeitar o modo da tabela Domínio, caso a tabela Domínio seja Compartilhada a
Contra-Domínio pode ser Exclusiva ou Compartilhada. Caso a tabela Domínio seja Exclusiva a Contra-Domínio
deverá ser Exclusiva. ATENÇÃO: Esta opção percorre toda a estrutura de domínios e contra-domínios.
Chave Forte Caso a opção Vinc. Filial esteja ativada, esta opção pode forçar um vínculo mais forte, onde a tabela Contra-
Domínio deverá ter seu modo de compartilhamento igual a tabela Domínio. ATENÇÃO: Esta opção percorre toda a
estrutura de domínios e contra-domínios.
ID Controle Interno.
49
Manutenção de tabela – confirmação do cadastro
• Para inserir uma tabela é

obrigatório existir ao menos
dois campos (filial e outro),
com dados gerais e por país,
e uma chave de índice.
• Após a alteração dos dados

e confirmação no botão OK,
o sistema exibe uma janela
com as alterações
efetuadas. Deve-se verificar
os dados e preencher um
histórico para cada
dicionário manipulado.
50
Manutenção do grupo de campos -SXG

• O grupo de campo permite que
campos que possuam tamanho igual
sejam agrupados para que caso um
campo seja alterado, todos os
campo vinculados sejam
modificados. Exemplos : código do
produto, código da filial
• Utilizar a opção de menu :
Atualizações -> Cadastros ->
Dicionários
• Através da opção “Grupo de
campos” poderá ser editado o
dicionário SXG
51

• Na parte superior encontramos
os dados básicos do grupo :
código e descrição
• No grid abaixo, são informados
o tamanho mínimo, máximo e
atual do grupo de campos.
Estes dados são separados por
países
• O vínculo de um campo ao
grupo deve ser efetuado pela
rotina de edição de tabela, nos
dados principais do campo
52

• Definição dos campos do cabeçalho:
Campo Descrição
Grupo ID do grupo de campos.
Owner Owner escolhido para inclusão do Grupo de Campos.
• Definição dos campos dos itens (por país):
Campo Descrição
Sigla / País Através deste campo é possível definir para qual país as informações serão válidas, ou caso seja selecionado o país “ALL” as
Descrição Nome do grupo de campos.
SizeMax Tamanho máximo que os campos pertencentes a este grupo podem ter, em alterações.
SizeMin Tamanho mínimo que os campos pertencentes a este grupo podem ter, em alterações.
Picture Picture que os campos pertencentes a este grupo terão.
Size Tamanho que os campos pertencentes a este grupo terão na geração de dicionário.
ID Número de controle interno.
53
Manutenção de tabelas genéricas – SX5

• As tabelas genéricas são utilizadas
para armazenar tabelas de pequeno
número de itens e que sofrem pouca
alteração (estáticas). Ex: tabela de
estados (UF).
• Utilizar a opção de menu :

Atualizações -> Cadastros ->
Dicionários.
• Através da opção “tabelas genéricas”

poderá ser editado o dicionário SX5.
54

• Ao editar, é apresentada a janela abaixo.
• Na parte superior encontramos os dados básicos da tabela : código e descrição.
• No grid abaixo, são informadas a chave e descrição. Estes dados são separados por
países.
55

Campo Descrição
Tabela Código da tabela que deseja criar.
Owner Indica o Owner em que está tabela está sendo criada.
Descrição Informe a descrição da tabela que será criada.
Campo Descrição
Sigla/País País a qual o registro pertence.
Chave Chave identificadora deste registro na tabela.
Descrição Descrição do registro.
ID ID do registro.
56
Manutenção de parâmetros – SX6

• O dicionário SX6 armazena os parâmetros
do sistema.
• Utilizar a opção de menu : Atualizações ->

Cadastros -> Dicionários.
• Através da opção “parâmetros” poderá

ser editado o dicionário SX6.
57

• Ao editar, é apresentada a janela abaixo.
• Na parte superior encontramos os dados básicos do parâmetro: variável, tipo e se é
utilizado no PYME
• No grid abaixo, é informada a descrição, distribuída em até 3 campos, e o conteúdo.
Estes dados são separados por países.
58

Campo Descrição
Var Nome do parâmetro.
Tipo Tipo de dado que o parâmetro irá conter.
Pyme Se o parâmetro também será incluído na Versão Série 3 do Protheus (ERP Reduzido): Sim ou Não.

Campo Descrição
Sigla / País Através deste campo é possível definir para qual país as informações serão válidas.
DscPor/DscPor1/DscPor2 Nestes campos é informada a descrição do parâmetro. Estes campos são utilizados como uma informação
contínua.
ContPor Conteúdo do parâmetro.
ContSpa Conteúdo do parâmetro para o Espanhol, a regra geral é que seja o mesmo do Português.
ContEng Conteúdo do parâmetro para o Inglês, a regra geral é que seja o mesmo do Português.
Propri Indica se é do Microsiga Protheus ou um Template específico.
Valid Expressão para validação do parâmetro.
Init Fora de uso.
Cons. Help ID do Help para controle interno.
ContPtg Conteúdo do parâmetro para o Português de Portugal, a regra geral é que seja o mesmo do Português.
ID ID referente ao registro.
59
Manutenção de perguntas – SX1

• O dicionário SX1 armazena as
perguntas do sistema
• Utilizar a opção de menu : Atualizações

-> Cadastros -> Dicionários
• Através da opção “perguntas” poderá

ser editado o dicionário SX1
60

• Ao editar, é apresentada a janela ao
lado
• Na parte superior encontramos o
grupo (código) da pergunta
• No grid abaixo, são informados os
detalhes da pergunta, como por
exemplo : pergunta, tipo de
dado,tamanho, regras de
preenchimento, variável, entre
outros. Esses dados podem ser
separados por países.
61

Campo Descrição
Grupo: Nome do grupo de perguntas.
Owner Owner escolhido para inclusão da Pergunta.
Campo Descrição
Ordem Ordem do item a ser apresentado na chamada da pergunta.
PerPor Pergunta em Português.
Tipo Tipo do dado da resposta da pergunta.
Tamanho Tamanho do campo de resposta.
Decimal Número de casas decimais caso o tipo seja numérico.
Presel Informe qual item do Combo aparecerá selecionado ao abrir a tela. Digite um valor numérico.
GSC Tipo do campo que será apresentado.
G = Get;
C = Combo;
S = Say;
R = Range;
K = Check.
Valid Função para validação do campo.
62

• Definição dos campos dos itens (continuação):
Var01 Variável em que será armazenado o conteúdo do campo. Como padrão o nome deverá ser “MV_PAR” + ordem do campo com dois dígitos. Ex.: MV_PAR01. *ATENÇÃO:
Quando houver distribuição de país, olhar o tópico Variáveis da Pergunta.
DefPor1 Valor para a Combo Box que ficará na posição 1.
Cnto1 Conteúdo que será carregado como default pela primeira vez, exceto para campos tipo Range, para estes campos deverá ser preenchido com o campo que será utilizado no
range.
Cnto2 Apenas para campo tipo Range, indique o conteúdo que será carregado como default pela primeira vez.
Cons. SXG Consulta para selecionar grupo de campo.
Pyme Se o item da pergunta também será incluído na Versão Série 3 do Protheus (ERP Reduzido): Sim ou Não.
Cons. SXB Pode se informar uma consulta padrão para o campo.
Descr. SXB Usado para controle interno.
Cons. SX5 Pode se informar uma consulta padrão de tabelas genéricas para o campo.
Descr. SX5 Usado para controle interno.
Cod Help Caso não deseje que o help aberto para o campo seja o padrão, indique o help que deseja apresentar. Help padrão de pergunta: “.”+<grupo da pergunta>+<seq>+“.” .
Exemplo: o help “.FIN80112.” é o help da pergunta 12 do grupo FIN801.
Picture Picture para ser aplicada ao campo.
Descr. SXG Usado para controle interno.
ID Usado para controle interno.
63
Manutenção de consultas padrões -SXB

• O dicionário SXB armazena as consultas
padrões do sistema. As consultas padrões
permitem o rápido preenchimento de
informações ou campos através da
visualização de dados de outra tabela.

Cadastros -> Dicionários
• Através da opção “consultas padrão”

poderá ser editado o dicionário SXB
64

• Ao editar, é
apresentado um
assistente para auxiliar
o preenchimento da
consulta
• Ao navegar pelas
páginas do assistente,
são informados o
código da consulta,
descrição, a tabela de
origem dos dados, os
campos exibidos, as
chaves de pesquisa,
filtros, campo de
retorno entre outros.
65

• Na tela principal será escolhido o tipo de consulta: Padrão, Específica, Usuários ou
Grupo de Usuários, e as informações genéricas da Consulta:

Campo Descrição
Tabela 6 - Informações Genéricas (SXB)
Consulta: Informe neste campo o nome da consulta.
Descrição Informe uma breve descrição sobre a consulta.
Consulta Indica se a consulta será utilizada em Portal Web,

Web para isso é apresentada uma tela de configuração a
mais para configurações específicas para o Portal.
Pode-se limitar através de configurações a
quantidade de registros que a consulta retorna, para
melhorar o desempenho no Portal. ATENÇÃO:
Apenas Portal do módulo GE (Gestão Educacional)
66

• Se o tipo de Consulta selecionado foi • Definição dos campos:
“Padrão”, o assistente deverá apresentar Campo Descrição
a janela abaixo (caso não seja, clique no Tabela: Indica em qual tabela a consulta irá se basear, pode se apertar a tecla F3 ou clicar no
ícone da Lupa para trazer as tabelas existentes.
botão “<< Voltar” na parte inferior da Função/programa

vinculado
Este recurso indica qual o programa do Protheus é a referência para verificação dos
direitos de inclusão e alteração. Ex.: Se for especificado que o programa vinculado a
tela e verifique a escolha): tabela SA1(Clientes) é o MATA030 o usuário deverá possuir direito de inclusão de
registros neste programa para conseguir efetuar a inclusão através da consulta.
Filtro: Filtro para os dados que serão mostrados na Consulta.
Expressão para Determina através da expressão o limite superior dos dados em que poderá navegar no
posicionamento inicial browse.
(TopFun):
Expressão para Determina através da expressão o limite inferior dos dados em que poderá navegar no
posicionamento final browse.
(BotFun):
Expressão para Determina através da expressão onde estará posicionado o browse quando a tela da
posicionar tabela: Consulta for aberta.
Habilitar botão de Indica se será exibido o botão de inclusão de registros.
inclusão
Função específica: Caso especificada o Protheus irá utilizar está função para inclusão de um novo registro,
senão utilizará a rotina padrão.
Função específica para Caso especificada o Protheus irá utilizar está função para visualização do registro, senão
visualização: utilizará a rotina padrão. Para preencher este campo, a função específica de inclusão
deve estar preenchida.
Habilitar botão de Indica se será exibido o botão de alteração de registros.
alteração
Função para consulta Pode se informar uma função para especificar a consulta já feita, se informada uma
analítica (F5): função será apresentado um botão na tela da Consulta para chamada da função. A
criação da tela dessa consulta é de responsabilidade do desenvolvedor da função.
Função para novo Caso deseje incluir um botão adicional pode se definir neste campo a função que ele
botão: executará seguido do caracter ; e a descrição do botão. Exemplo: MyFunction();Consulta
67

• Na próxima janela, são selecionadas • Definição dos campos:
ordens de busca e os campos que serão
Campos Descrição
apresentados em cada ordem.
Ordem Indica a ordem do Índice
da tabela que estará
disponível no Browse.
Índices
Descrição Descrição do Índice
adicionado.
Título Indica o título da coluna

que será apresentada no
Browse da Consulta.
Expressão Campo que será

apresentado nesta
Colunas coluna. Na edição deste
campo pode se apertar
F3 ou clicar no ícone da
lupa para buscar os
campos da tabela.
68

• Na última janela é informado o retorno da • Definição dos campos:
consulta.
Campo Descrição
• No mínimo um retorno deve ser cadastrado,
porém podem ser cadastrados mais que um. O Retorno Informe neste campo a expressão de retorno. Na edição
primeiro retorno irá para o campo que deste campo pode se apertar F3 ou clicar no ícone da lupa
disparou a Consulta, e os outros retornos irão para buscar os campos da tabela.
para os próximos campos de acordo com a

ordem informada.
69
Manutenção de consultas (específica) -SXB

“Específica”, o assistente deverá
Campo Descrição
apresentar a janela abaixo (caso não seja,
clique no botão “<< Voltar” na parte Tabela: Indica em qual tabela a consulta irá se basear, pode se
apertar a tecla F3 ou clicar no ícone da Lupa para trazer
inferior da tela e verifique a escolha): as tabelas existentes.
Expressão: Função efetuará a construção da janela de consulta,
quando o usuário utilizar este Consulta.
Retorno Informe neste campo a expressão que será executada e
retornará o valor desejado.
70
Manutenção de consultas (específica) -SXB
• Em uma consulta específica a construção da tela fica por responsabilidade

da função que é criada pelo desenvolvedor, no caso ao acionar a consulta
será apenas chamada a função do desenvolvedor.
• Ao término do preenchimento do(s) retorno(s), clicar no botão Avançar na
parte inferior da tela, para prosseguir com o assistente.
71
Manutenção de consultas (usuários) -SXB

“usuários”, o assistente deverá
apresentar a janela abaixo (caso não seja, Campo Descrição
clique no botão “<< Voltar” na parte ID: Código referente ao Usuário.
inferior da tela e verifique a escolha): Nome: Nome usado para o login do usuário no sistema.
Nome Nome completo do usuário cadastrado no sistema.

descer. Completo
E-mail E-mail do usuário cadastrado no sistema.
72
Manutenção de consultas (usuários) -SXB
• Ao término do preenchimento do(s) retorno(s), clicar no botão

Avançar na parte inferior da tela, para prosseguir com o
assistente.
73
Manutenção de consultas (grupo de usuários) -SXB

“grupo de usuários”, o assistente deverá
apresentar a janela abaixo (caso não seja, Campo Descrição
clique no botão “<< Voltar” na parte ID: Código referente ao Grupo de Usuários.
inferior da tela e verifique a escolha): Nome: Nome do Grupo de Usuários cadastrado no sistema.
74
Manutenção de consultas (grupo de usuários) -SXB
• Ao término do preenchimento do(s) retorno(s), clicar no botão

Avançar na parte inferior da tela, para prosseguir com o
assistente.
75
Manutenção de arquivos .CH

• Os arquivos .CH armazenam todos os
textos de programas (fontes) do Protheus.
Esse recurso permite que o sistema tenha
3 idiomas na mesma instalação e possa
ser efetuada a tradução no ATUSX

Cadastros -> Dicionários
• Os arquivos .CH não são dicionários de

dados, pois são utilizados na compilação
dos programas.
76

• Ao editar, é apresentada a janela ao lado
• Na parte superior encontramos o nome
do arquivo (programa) e a descrição
• No grid abaixo, são informados os
detalhes, como por exemplo : chave e
texto em português
77

Campo Descrição
Arquivo Informe neste campo o nome do arquivo que será gerado.
Descrição Escreva uma breve descrição sobre o CH, esta informação é muito importante para a equipe de tradução.
Path Diretório onde será gerado o CH quando este for exportado. Ex.: \VER11\
Obs. Caso seja um CH da lib(programas controlados exclusivamente pela equipe de framework), colocar um diretório
colocando a palavra “lib”. Ex.: \include-lib\
• Definição dos campos dos itens:
Campo Descrição
Sigla / País Informe neste campo a localização da String,
Chave Indica qual a String que está se editando.
Texto Por. Informe o texto em Português que será representado pela chave. O texto informado deve estar entre aspas duplas.
Texto Esp. Apresenta o texto em Espanhol, depois de traduzido.
Texto Eng. Apresenta o texto em Inglês, depois de traduzido.
Texto Ptg. Apresenta o texto em Português de Portugal, depois de traduzido.
78
Manutenção de Helps
• A rotina de manutenção de helps permite a digitação de textos de
ajuda que podem ser associados a campos, perguntas ou serem
disparados manualmente pelos programas
• Utilizar a opção de menu : Atualizações -> Help -> Editor de Help
79
Manutenção de Helps
• Ao editar um Help, é apresentada a
janela ao lado
• Deve ser digitado o texto de ajuda ou
alerta, e opcionalmente uma solução
• Os textos em outros idiomas são
preenchidos exclusivamente pela área
de traduções
80
Manutenção de Menus
• A rotina de manutenção de Menus permite a construção dos
menus dos módulos do Protheus, e a criação dos arquivos de
extensão .XNU que são utilizados pelo sistema
• Utilizar a opção de menu : Atualizações -> Cadastros -> Menus
81
• Ao editar um menu, é apresentada a janela abaixo.
• Todos os menus são estruturados contendo 4 pastas principais : Cadastro,Consulta,
Relatório e Miscelânea
• Em cada pasta são cadastrados os itens de menu que pode ser tópicos, itens e
separadores
82
• Tópicos funcionam como títulos de uma seção

• Separadores são linha divisórias entre itens
• Itens são as rotinas / funcionalidades propriamente ditas
83
• Ao editar um item, deve ser
informada sua ordem de seqüência,
a descrição, o programa e os países
a qual o item se aplica
• Ao clicar no campo país é aberta
uma janela para seleção dos países.
Esta seleção é diferente da seleção
de países dos dicionários, onde cada
país obrigatoriamente deve ser
representado por uma linha
separada
84
Novo Padrão de Apresentações TOTVS
QUESTÕES
Palestrante
psergio@totvs.com.br

Atusx 11 PDF

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Atusx 11 PDF

Enviado por

Direitos autorais:

Formatos disponíveis

Atusx e Infraestrutura de dicionário de dados

Sérgio Alcântara – Inovação framework/ 07- 12

• Prover aos colaboradores das áreas de sustentação e

 O produto Microsiga Protheus é composto por 3 camadas principais, a saber:

• O dicionário de dados ativo do Protheus confere grande flexibilidade ao

• O Atusx é a ferramenta utilizada internamente para a construção e

• Quando uma nova versão do produto Protheus é liberada, o dicionário de

• O cadastramento de dicionários no ATUSX guarda certas semelhanças com

 Os seguintes dicionários são cadastrados e mantidos no ATUSX:

 Além dos dicionários propriamente ditos, são cadastrados / traduzidos os

• Arquivos “.CH” (textos de programas para serem traduzidos ).

II) Principais funcionalidades

• Conceito de Projetos • Manutenção de grupo de campos

• O Atusx é uma ferramenta que suporta múltiplos projetos.

• Na realidade, existem 3 níveis possíveis de visualização : Versão, projeto e

• Uma versão é o nível mais abrangente: na maioria dos casos, corresponde

• O projeto é o nível intermediário. Um projeto está sempre vinculado a

• O pacote é o último nível da estrutura. Um pacote está sempre vinculado a

• Antes de fazer qualquer

• Após a primeira seleção, o projeto escolhido é utilizado

• Para alterar o projeto de trabalho, deve-se utilizar a

Lembrete: para cadastrar uma tabela, no mínimo é

Manutenção de tabela – SX2

Manutenção de tabela – SX2

• O SX2 é o dicionário de tabelas do sistema Protheus. Todas as tabelas de dados

Manutenção de tabela – SX2

• Definição dos campos:

Arquivo Ao preencher o campo tabela, este campo é automaticamente preenchido.

Manutenção de tabela – SX2

Modo Compartilhado: As filiais compartilham os dados desta tabela.

Manutenção de tabela – SX2

• Definição dos campos:

Nome Port. Nome em Português da Tabela.

Manutenção de tabela – SX3

Manutenção de tabela – SX3

• No SX3 são armazenados as características básicas dos campos, como

• Além disso, são registradas informações que norteiam o comportamento

• Os campos informados no SX3 estão sempre relacionados a uma tabela

Manutenção de tabela – SX3

• Definição dos campos (dados principais):

Manutenção de tabela – SX3

Template Selecione, caso necessite, um template que o campo utilizará.

Dsc.Template Descrição do template selecionado.

Manutenção de tabela – SX3

• Definição dos campos (dados distribuídos):

Tamanho Indica o tamanho do campo.

Manutenção de tabela – SX3

Desc. Port. Descrição do campo em Português.

Usado Campo de uso interno preenchido através do botão Obrigat .

Reserv Campo de uso interno preenchido através do botão Obrigat .

Check Não usado.

Propri Indica o proprietário do campo:

Contexto Indica se é um campo Real ou Virtual.

Manutenção de tabela – SX3

Cond. SQL Fora de uso.

Check SQL Fora de uso.

Template Fora de uso.

C.Padrao SX5 Consulta padrão para o campo localizada no SX5.

Descr. Help Descrição do Help, apenas visual.

Manutenção de tabela – SX3

Título Esp. Título do Campo em Espanhol.

Desc. Esp. Descrição do Campo em Espanhol.