Filtro de Usuário por Rotina Parambox

Boletim Técnico: Filtro de Usuário por Rotina (Parambox)

Ocorrência

Nova Rotina

Resumo

Está disponível o 12º Tipo de parâmetro para a função PARAMBOX, que permite criar, alterar, excluir, salvar e utilizar filtros configurados pelo usuário nas rotinas em que a função é chamada.

ID do Chamado

SCQOQ4

Aplicabilidade

Filtro de Usuário por Rotina (Parambox)

Produtos

Microsiga 10

Módulos

SIGAPMS

Portais

todos

Países

todos

Sistema Operacional

todos

Bancos de Dados

todos

Nome + Fonte

PMSXFUN, PMSXFUNB

Número da FNC

000000133692010

Ajustes no Compatibilizador

Sim

Integridade Referencial

Não

Aplicação de Patch

Não

Compatibilizador 1

- U_UPDPMS

Procedimentos para Implementação

Importante:

Antes de executar o compatibilizador ”U_UPDPMS” é imprescindível:

a) Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório “\PROTHEUS_DATA\DATA”) e dos dicionários de dados "SXs" (diretório “\PROTHEUS_DATA\ SYSTEM”).

b) Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.

c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.

d) Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.

e) O compatibilizador deve ser executado com a Integridade Referencial desativada*.

ATENÇÃO: O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

* A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir:

i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).

ii. Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a verificação e aplicar normalmente o compatibilizador, conforme instruções.

iii. Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída, ou;

iv. Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework para informações quanto a um arquivo que contém essa informação).

v. Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).

vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.

vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a ativação.

Contate o Help Desk Framework EM CASO DE DÚVIDAS!

1. Em Microsiga Protheus TOTVS Smart Client, digite “U_UPDPMS” no campo Programa Inicial.

Importante:

Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a (17/06/2010).

2. Clique em OK para continuar.

3. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.

4. Clique em Sim para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.

É apresentada uma mensagem explicativa na tela.

5. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização, são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.

6. Clique em Gravar para salvar o histórico (log) apresentado.

7. Clique em OK para encerrar o processamento.

Descrição de Ajustes

1. Criação no arquivo SX3 – Campos:

· Tabela AN7 - “Filtro de Usuário por Rotina”:

Campo	AN7_FILIAL
Tipo	Caracter
Tamanho	2
Decimal	0
Título	Filial
Descrição	Filial do Sistema
Nível	1
Usado	Não
Obrigatório	Não
*Browse*	Não
*Help*	Informe a filial do sistema.

Campo	AN7_USER
Tipo	Caracter
Tamanho	6
Decimal	0
Título	Usuário
Descrição	Código do Usuário
Nível	1
Usado	Sim
Obrigatório	Sim
*Browse*	Sim
*Help*	Código do usuário do sistema que o filtro pertence.
*Modo Edicao*	Inclui

Campo	AN7_FUNCAO
Tipo	Caracter
Tamanho	10
Decimal	0
Título	Rotina
Descrição	Nome da Rotina
Nível	1
Usado	Sim
Obrigatório	Sim
*Browse*	Sim
*Help*	Nome da rotina que chamou a função parambox.
*Modo Edição*	INCLUI

Campo	AN7_ALIAS
Tipo	Caracter
Tamanho	3
Decimal	0
Título	Alias
Descrição	Alias do Filtro
Nível	1
Usado	Sim
Obrigatório	Sim
*Browse*	Sim
*Help*	Alias do filtro a ser utilizado na lista de opções de caixa de combinação do Tipo de parâmetro Filtro de usuário da função parambox.
*Modo Edicao*	INCLUI

Campo	AN7_FILTR
Tipo	Caracter
Tamanho	15
Decimal	0
Formato
Título	Nome
Descrição	Nome do Filtro
Nível	1
Usado	Sim
Obrigatório	Sim
*Browse*	Sim
*Help*	Nome do filtro a ser utilizado na lista de opções de caixa de combinação do Tipo de parâmetro Filtro de usuário da função parambox.
*Modo Edição*	Inclui

Campo	AN7_EXPR
Tipo	Caracter
Tamanho	254
Decimal	0
Título	Expressão
Descrição	Expressão de Filtro
Nível	1
Usado	Sim
Obrigatório	Sim
*Browse*	Sim
*Help*	Expressão de filtro configurado pelo usuário.
*Modo Edição*	Inclui

2. Criação de tabela no arquivo SX2– Tabelas:

Chave	Nome	Modo	PYME
AN7	Filtro de usuário por Rotina	E	N

3. Criação de Índices no arquivo SIX – Índices:

Índice	AN7
Ordem	1
Chave	AN7_FILIAL+AN7_USER+AN7_FUNCAO+AN7_ALIAS+AN7_FILTR
Descrição	Usuario + Rotina + Alias + Filtro
Proprietário	S

Procedimentos para Utilização

1. Crie uma função de usuário utilizando a ParamBox com o objeto tipo de parâmetro 12 (filtro de usuário por rotina).

2. Adicione a rotina criada no menu.

3. Acesse a rotina criada no menu

4. O sistema apresenta o objeto tipo de parâmetro 12 (filtro de usuário por rotina) na parambox.

Informações Técnicas

Tabelas Utilizadas

AN7 – Filtro de Usuário por Rotina

Home

Linha Microsiga Protheus

Páginas filhas