Escolar Documentos
Profissional Documentos
Cultura Documentos
Extensibilidade
ERP PRIMAVERA V9.00
Versão 1.1
dezembro 2014
Índice
Índice................................................................................................................................. 2
Introdução ......................................................................................................................... 6
Extensibilidade ................................................................................................................... 7
Funções do Utilizador.......................................................................................................8
Navegador .......................................................................................................................9
Listas...............................................................................................................................9
Ribbon ...........................................................................................................................10
Painéis ..........................................................................................................................10
Atualiza um Painel.......................................................................................................... 11
Pg 2
Criação do Cliente .......................................................................................................... 22
Referências ................................................................................................................... 24
Referências ................................................................................................................... 26
IDE ................................................................................................................................29
Macros ...........................................................................................................................31
Classes ..........................................................................................................................32
Eventos .........................................................................................................................33
Editores ........................................................................................................................ 34
Objetos ..........................................................................................................................35
Aplicacao ...................................................................................................................... 35
PlataformaPRIMAVERA .................................................................................................... 36
Pg 3
Definição de Parâmetros: ........................................................................................... 57
Parâmetros ....................................................................................................................66
Fórmula ........................................................................................................................ 69
Função ......................................................................................................................... 70
Execução .......................................................................................................................71
Resultados................................................................................................................... 104
Pg 4
Navegador ...................................................................................................................... 113
Pg 5
Introdução
A Extensibilidade das aplicações é um conceito central no ERP PRIMAVERA na medida em que permite
complementar a solução standard com funcionalidades adicionais e intervir nas funcionalidades nucleares de
cada aplicação para responder às necessidades específicas de cada negócio ou cliente em particular.
Este manual tem como propósito documentar – na perspetiva dos Parceiros PRIMAVERA – as ferramentas
de extensibilidade mais importantes do ERP PRIMAVERA, apresentando a sua arquitetura conceptual,
exemplos práticos da sua aplicação e as vantagens competitivas que poderão proporcionar.
De modo a consultar a versão mais atualizada deste manual, sugere-se a sua consulta online na PRIMAVERA
KnowledgeBase.
PKB
Manual de Extensibilidade
Pg 6
Extensibilidade
O conceito de Extensibilidade refere-se à faculdade de alterar e estender as funcionalidades dos vários
módulos e aplicações do ERP PRIMAVERA, adaptando-os às necessidades específicas de cada
cliente/negócio/implementação particular.
Ao longo do tempo e da evolução dos produtos PRIMAVERA são várias as tecnologias que têm vindo a ser
desenvolvidas e exploradas e são hoje uma ferramenta muito poderosa ao dispor dos serviços de
implementação da PRIMAVERA e dos seus parceiros. Essas tecnologias permitem, por exemplo:
Esta arquitetura permite a reutilização de todas as funcionalidades principais das aplicações (as regras de
negócio) a partir de qualquer outra aplicação externa como o Microsoft Excel.
Motores da Plataforma
A Plataforma PRIMAVERA é composta por um conjunto de componentes que disponibilizam as
funcionalidades mais atómicas (exemplo: impressão de mapas ou a exportação de registos) do ERP e as
funcionalidades comuns entre todos os módulos (exemplo: a ligação à base de dados ou o sistema de
permissões).
Embora estes componentes tenham sido especialmente concebidos para serem consumidos por aplicações
PRIMAVERA, muitas das suas funcionalidades são também expostas para qualquer aplicação externa
através de componentes (motores) que podem ser reutilizados, reduzindo o esforço de desenvolvimento na
implementação.
Pg 7
VBA – Visual Basic for Applications
A PRIMAVERA Business Software Solutions é pioneira na integração da tecnologia VBA (Visual Basic for
Applications) em Portugal desde a versão 4.00 da Linha Profissional.
Funções do Utilizador
Uma Função do Utilizador (XDU) corresponde à definição de uma ação – entre os vários tipos de ações
disponíveis (envio de mensagens, exportação de mapas, execução de macros VBA, etc.) – que pode
interagir com o utilizador (através da solicitação de parâmetros e da apresentação de resultados) e com o
sistema (VBA, motores, etc.) para automatizar uma determinada tarefa.
Dadas as suas características, as Funções do Utilizador são o componente central das tecnologias de
extensibilidade de 2ª Geração (disponibilizadas a partir da versão 3 da Linha Empresarial) e servem de base
à implementação de várias outras ferramentas como os Processos do Utilizador e os Menus do Utilizador.
Processos do Utilizador
Os Processos do Utilizador (PDU) permitem a definição gráfica de fluxos de trabalho (sequências de Funções
do Utilizador encadeadas entre si) que potenciam a automatização de processos repetitivos (exemplos:
encomendas automáticas ou processamentos de prémios) e a sua integração no ERP para implementar
necessidades específicas de cada implementação.
Pg 8
Menus do Utilizador
Os Menus do Utilizador permitem que os menus das aplicações sejam complementados para integrarem
novas opções que executarão uma determinada Função do Utilizador (que, por exemplo, abre uma aplicação
externa ou inicia uma determinada operação em background).
Navegador
O Navegador é o “ponto de entrada” de todos os módulos e proporciona ao utilizador um ponto central para
aceder a todas as funcionalidades da aplicação (listas, opções de menu, documentos, atalhos, etc.)
configurado de acordo com as suas preferências e permissões.
Listas
Um dos componentes mais importantes na implementação de uma solução integrada de gestão está
relacionado com as ferramentas de exploração dos dados geridos no sistema e com a sua
adequação/adaptação às necessidades de cada utilizador.
Desde a primeira versão das aplicações PRIMAVERA que as listas fornecem o primeiro método para aceder
aos dados principais (as listas de clientes, de documentos de venda, de contas correntes, etc.).
A partir da versão 3 da Linha Empresarial, o ERP PRIMAVERA inclui um poderoso sistema de configuração
assistida de listas através de categorias de informação que relacionam todas as tabelas na base de dados e
permitem ao utilizador, entre outras operações:
• Definir os campos de cada tabela que devem ser apresentados para cada lista;
• Estabelecer relações automáticas entre as várias tabelas de cada categoria (exemplo: clientes e
vendedores);
• Definir filtros e condições para restringir os resultados e adaptá-los às necessidades de cada
utilizador;
• Definir várias opções de configuração e apresentação das listas;
• Criar listas dinâmicas e parametrizadas que apresentam dados diferentes mediante as condições
selecionadas pelo utilizador no momento da sua execução.
Mapas do Utilizador
As aplicações PRIMAVERA disponibilizam todos os mapas (impressões) usando o Crystal Reports.
Pg 9
Esta ferramenta – claramente um standard internacional a este nível – permite que os vários mapas da
aplicação sejam adaptados (ou sejam criados novos mapas) de acordo com as regras de negócio de cada
implementação.
Ribbon
Os menus do ERP passam a estar disponíveis numa Ribbon. Com esta tecnologia as funcionalidades estão
acessíveis de forma mais fácil e rápida.
As operações estão disponíveis divididas em grupos que por sua vez são organizados por tabuladores.
Tabulador
Operação
Foi adicionada uma lista de empresas recentes que simplifica a troca entre as empresas mais usadas.
Grupo
É possível a personalização da Ribbon por forma adicionar tabuladores, grupos e botões com ações
definidas em VBA e que podem fazer qualquer operação pretendida pelo utilizador. Para consultar exemplos
poderá aceder ao SDK.
Painéis
A versão 9 do ERP PRIMAVERA disponibiliza uma nova forma de extensibilidade, nomeadamente através de
painéis. Este tipo de controlo revela-se especialmente útil no apoio à tomada de decisão através da
apresentação de conteúdos relacionados com o contexto no qual o utilizador está a trabalhar.
Pg 10
Posicionamento: Vertical; Horizontal.
Estado: Flutuante; Ancorado; Fixo; Oculto automaticamente.
Sobreposição de painéis.
O estado dos painéis é conservado entre execuções do ERP conforme o utilizador.
Possibilidade de carregar controlos do utilizador.
Abrir um Painel
Dim objPainel As StdBSDockingPane
Fechar um Painel
PlataformaPRIMAVERA.MDI.DockingManager.FechaPainel objPainel.Nome
Atualiza um Painel
PlataformaPRIMAVERA.MDI.DockingManager.ActualizaPainel objPainel.Nome, objUserCtrl
Ajusta um Painel
PlataformaPRIMAVERA.MDI.DockingManager.AjustaPainel objPainel.Nome, 200, 200
Destinam-se a fornecer informação relevante para o contexto ativo, como por exemplo, o resumo das vendas
de um determinado cliente ao introduzi-lo num editor do ERP.
Pg 11
É possível ativar/desativar a abertura automática de painéis de informação relacionada através da opção do
menu: PAINÉIS | Contexto | Info. Relacionada. O fecho manual do painel desativa esta opção.
É possível criar um painel de informação relacionada na invocação de qualquer F4 no ERP. É ainda possível
substituir ou adicionar controlos criados pelo cliente aos painéis de informação relacionada do sistema.
Pg 12
Para informações detalhadas sobre extensibilidade em Painéis de Informação Relacionada, por favor
consultar a seguinte ligação no PRIMAVERA KnowledgeBase: Como criar novos Painéis de Informação
Relacionada?
Tecnologias de Integração
Os Parceiros PRIMAVERA desempenham um papel indispensável no negócio da PRIMAVERA. O
reconhecimento desse papel – na complementaridade de soluções que oferecem aos clientes finais bem
como nos serviços de implementação – teve como resultado a disponibilização, por parte da PRIMAVERA,
de tecnologias que facilitam a integração das suas soluções com as soluções standard.
Pg 13
Motores dos Módulos
Tecnologia COM e Arquitetura Windows DNA
Todas as aplicações PRIMAVERA são desenvolvidas com base na tecnologia COM e na arquitetura
Windows DNA.
Este modelo de arquitetura em 3 níveis, permite disponibilizar o acesso à camada intermédia através de
interfaces diferenciados e de uma forma que não permite subverter a lógica inerente ao funcionamento das
aplicações.
Esta camada é constituída por um conjunto de componentes (rotinas), que perfazem cerca de 70% do código
de um produto, também conhecida por “Regras do Negócio”. Esta é uma parte da aplicação, cujo código tem
seguras probabilidades de perdurar às constantes mutações da tecnologia.
O acesso à informação a partir do interface através do modelo de objetos de negócio garante o cumprimento
das regras de negócio estabelecidas no ERP PRIMAVERA bem como a independência face ao modelo de
dados. Este facto constitui o elemento primordial da Tecnologia de Integração PRIMAVERA (TIP).
Por outro lado, a utilização desta tecnologia permite que diferentes objetos sejam partilhados por diferentes
aplicações dentro do ERP PRIMAVERA. Por exemplo, o acesso à janela de Movimentos do módulo de
Contabilidade diretamente a partir do Editor de Vendas/Encomendas do módulo de Vendas.
Pg 14
Esta possibilidade existe não apenas entre os vários módulos do ERP, mas também em aplicações externas
que podem usar os diferentes Motores de Aplicação. Por exemplo o acesso a partir do Microsoft Excel ou de
uma aplicação desenvolvida pelo utilizador à gravação de movimentos no módulo de Contabilidade ou de
faturas no módulo de Vendas.
O motor de uma aplicação é composto por um conjunto de DLLs COM que podem ser referenciadas e
utilizadas a partir de aplicações externas, bastando para tal que estejam registadas no sistema e que sejam
incluídas no respetivo projeto.
User AplUS900.dll
Interface
AplBS900.dll
AplDS900.dll
Estrutura de
dados
Pg 15
O diagrama anterior apresenta a arquitetura e organização do motor de um ou mais módulos que será
composto pelos seguintes ficheiros:
Objetos de negócio.
AplBE900.dll 1
Representam as entidades geridas pelo motor e pela aplicação.
ErpBS900.dll Permite o acesso aos Serviços de Negócio de cada Módulo/Área.
<Apl>BE<Nome>
Exemplos:
A título de exemplo, no caso de um Documento de Venda, o programador terá acesso a um objeto tipo
GcpBEDocumentoVenda que é composto por um cabeçalho (com várias propriedades) e um conjunto de
detalhes (por exemplo: as linhas do documento).
1
A sigla Apl deverá ser substituída pela nomenclatura associada a cada módulo/área. Assim,
por exemplo, para a área de Logística & Tesouraria deverá ser IGcpBS900, GcpBE900,...
Pg 16
Cada objeto terá um conjunto de propriedades que correspondem basicamente aos campos utilizados na
base de dados para armazenar a entidade:
• Anulado
• Arredondamento
• ArredondamentoIva
• Cambio
• CodigoPostal
• CondPag
• DataCarga
• (...)
Este será o componente a utilizar para aceder ao motor da aplicação a partir de uma aplicação externa.
Utilizando este componente para, por exemplo, criar um novo cliente usando o motor da área de Logística &
Tesouraria, podemos garantir que a criação dessa entidade observará todas as regras de negócio exigidas
pelas aplicações PRIMAVERA (exemplo: validações).
Cada serviço do motor é disponibilizado através de uma classe que pode ser acedida através da classe
principal do motor (ErpBS). A nomenclatura desses serviços é a seguinte:
I<Apl>BS<Nome>
Exemplos:
No caso do motor da área de Logística & Tesouraria a árvore de serviços é semelhante à seguinte:
Pg 17
Cada uma das classes de serviços implementa um conjunto de métodos típicos que realizam as operações
mais importantes sobre cada tipo de entidade:
A título de exemplo, consideremos a assinatura destes métodos para os serviços de Clientes da área de
Logística & Tesouraria:
Pg 18
Private Sub IGcpBSClientes_Actualiza(ByVal BECliente As GcpBECliente)
Os serviços deste componente têm uma correspondência virtualmente direta com os mesmos serviços dos
Serviços de Negócio (BS). Na realidade, cada serviço do BS, sempre que necessita de aceder à base de
dados, fá-lo através do serviço/método correspondente no DS. Esta separação permitiria, por exemplo,
modificar a fonte de dados adaptando apenas a camada de dados (DS) e não efetuando qualquer alteração
na camada de regras de negócio (BS).
Atenção
Este componente do motor de uma aplicação nunca deve ser referenciado a partir de aplicações externas. Os seus serviços devem
ser sempre executados através da camada de negócio (ErpBS)
Pg 19
Utilização dos Motores em Aplicações Externas
Apresentada que está a arquitetura interna do motor do ERP PRIMAVERA, resta demonstrar as suas
potencialidades através de um exemplo da sua utilização a partir de uma aplicação externa.
• O cliente em causa possui um sistema externo de CRM onde são registados os potenciais clientes da
empresa;
• Pretende-se utilizar o motor da área de Logística & Tesouraria para registar no ERP PRIMAVERA os
clientes geridos num sistema externo de CRM, quando estes efetuam uma primeira encomenda.
O exemplo apresentado de seguida foi desenvolvido em Visual Basic 6 por duas razões:
2) Porque inclui funcionalidades que tornam a integração de componentes COM muito simples.
Note-se, no entanto, que os componentes dos motores PRIMAVERA podem ser utilizados em outros ambientes de programação.
Todas as linguagens de programação mais recentes incluem funcionalidades que permitem referenciar componentes COM de uma
forma mais ou menos simples.
Como vamos fazer uso do motor da área de Logística & Tesouraria as referências necessárias são as
seguintes:
Pg 20
Abertura do Motor
Antes de ser possível realizar qualquer operação através do motor é necessário abrir a empresa de trabalho
usando o método genérico “AbreEmpresaTrabalho”:
'Abertura do motor
If Not (objMotorrp Is Nothing) Then objMotorErp.FechaEmpresaTrabalho
Set objMotorErp = Nothing
Set objMotorErp = New ErpBS
objMotorErp.AbreEmpresaTrabalho tpEmpresarial, m_strEmpresa, m_strUtilizador,
m_strPassword, Nothing, m_strInstancia, False
'Fecho do motor
objMotorErp.FechaEmpresaTrabalho
Set objMotorErp = Nothing
Exit Sub
Erro:
Set objMotorErp = Nothing
MsgBox "Erro ao efetuar a sincronização." & vbCrLf & Err.Description, vbExclamation
Pg 21
TipoPlataforma Versão da Plataforma PRIMAVERA (EXECUTIVE ou PROFESSIONAL).
Criação do Cliente
No caso da gravação de um novo cliente será necessário preencher um objeto do tipo GcpBECliente e
executar o método Actualiza de IGcpBSClientes:
'Abertura do motor
If Not (objMotorErp Is Nothing) Then objMotorErp.FechaEmpresaTrabalho
Set objMotorErp = Nothing
Set objMotorErp = New ErpBS
objMotorErp.AbreEmpresaTrabalho tpEmpresarial, m_strEmpresa, m_strUtilizador,
m_strPassword, Nothing, m_strInstancia, False
'Cliente
CarregaCliente objClienteCRM
Set objCliente = New GcpBECliente
With objCliente
.Cliente = objClienteCRM.Codigo
.Nome = objClienteCRM.Nome
.Morada = objClienteCRM.Morada
.Localidade = objClienteCRM.Localidade
Pg 22
.CodigoPostal = objClienteCRM.CodigoPostal
.NumContribuinte = objClienteCRM.NumContribuinte
.ModoPag = objClienteCRM.ModoPag
.CondPag = objClienteCRM.CondPag
.Moeda = objClienteCRM.Moeda
End With
'Gravação
objMotorErp.Comercial.Clientes.Actualiza objCliente
Set objCliente = Nothing
'Fecho do motor
objMotorErp.FechaEmpresaTrabalho
Set objMotorErp = Nothing
Exit Sub
Erro:
If Not (objCliente Is Nothing) Then Set objCliente = Nothing
If Not (objMotorErp Is Nothing) Then
objMotorErp.FechaEmpresaTrabalho
Set objMotorErp = Nothing
End If
MsgBox "Erro ao efetuar a sincronização." & vbCrLf & Err.Description, vbExclamation
End Sub
PKB
Documentação de Motores
Pg 23
Motores da Plataforma
A Plataforma PRIMAVERA consiste de um conjunto de componentes, utilizados por todas as aplicações
PRIMAVERA, que disponibilizam funcionalidades nucleares e comuns entre todas as aplicações, como por
exemplo:
• Impressão de mapas;
• Envio de mensagens de E-mail;
• Formatação de controlos;
• Tratamento de transações;
• Segurança;
• Gestão de bases de dados;
• (…)
Administrador PRIMAVERA
O Administrador PRIMAVERA – a aplicação de administração geral do sistema, das empresas registadas no
sistema e de segurança – é parte integrante da Plataforma PRIMAVERA.
Atenção
O motor AdmEngine, apesar de fornecer funcionalidades que ainda não estão disponíveis no novo motor, tem o seu desenvolvimento
descontinuado. Será completamente substituído a prazo, pelo que a sua utilização não é recomendada
Referências
• PRIMAVERA AdmBE 9.00
• PRIMAVERA AdmBS 9.00
• PRIMAVERA StdBE 9.00
Pg 24
Private Sub cmdUsers_Click()
Dim objMotorAdm As AdmBS
Dim objListaEmpresas As AdmBEEmpresas
Dim objEmpresa As AdmBEEmpresa
Erro:
If Not (objListaEmpresas Is Nothing) Then Set objListaEmpresas = Nothing
If Not (objMotorAdm Is Nothing) Then Set objMotorAdm = Nothing
MsgBox "Erro ao obter a lista de utilizadores." & vbCrLf & Err.Description,
vbExclamation
End Sub
Pg 25
Estes serviços estão disponíveis a partir das aplicações PRIMAVERA – no ambiente de desenvolvimento
VBA (PlataformaPRIMAVERA) – mas também podem ser utilizados a partir de uma aplicação externa. Um
dos exemplos mais comuns dessa aplicação prática é a impressão de mapas.
Referências
• PRIMAVERA StdBE 9.00
• PRIMAVERA StdPlatBS 9.00
Execução do Serviço
Private m_objPlat As StdPlatBS
Pg 26
Exit Sub
Erro:
Set m_objPlat = Nothing
Set m_objConfApl = Nothing
End Sub
End Sub
Exit Sub
Erro:
MsgBox "Erro: " & Err.Number & " - " & Err.Description
End Sub
Pg 27
Autenticação Windows nos motores
É possível inicializar o motor da plataforma através de autenticação Windows. Para isso é necessário, em
termos de código, no objecto "ConfApl" que é passado à plataforma, omitir as propriedades "Utilizador" (linha
“objConfApl.Utilizador”) e "PwdUtilizador” (linha “objConfApl.PwdUtilizador) do exemplo de código da secção
anterior.
1. o sistema permita autenticação mista, ou seja, que a "Autenticação PRIMAVERA e Windows" esteja
ativada nos Parâmetros da Instalação, no Administrador;
2. cada utilizador Windows esteja mapeado com o respetivo utilizador PRIMAVERA (na ficha do
utilizador, no Administrador).
O exemplo seguinte ilustra o código necessário para efetuar a abertura da plataforma, com autenticação
Windows:
objConfApl.AbvtApl = "ERP"
objConfApl.Instancia = "DEFAULT"
objConfApl.LicVersaoMinima = "9.00"
eTipo = tpEmpresarial
objPlat.AbrePlataformaEmpresa txtEmpresa.Text, objTrans, objConfApl, eTipo, vbNullString
PKB
Documentação de Motores
Pg 28
VBA – Visual Basic for Applications
O Microsoft Visual Basic for Applications (VBA) permite estender a solução PRIMAVERA criando
funcionalidades customizadas, aplicações de produtividade e soluções que extravasam o âmbito dos
módulos do ERP.
• Aceder aos próprios objetos mantidos e manipulados no contexto de cada uma das principais
operações – manutenção de clientes, editores de vendas, etc.;
• Associar código a determinados eventos despoletados pelas operações mais importantes das
aplicações;
• Criar separadores do utilizador para edição dos campos do utilizador associados a cada entidade;
• Criar formulários do utilizador;
• Integrar os desenvolvimentos realizados na solução PRIMAVERA, via Funções do Utilizador que
podem ser associadas ao Navegador ou a Menus do Utilizador.
IDE
O IDE (Integrated Development Environment) do VBA é uma janela que aparece ao utilizador separadamente
da janela principal da aplicação associada.
Todas as ferramentas de desenvolvimento do VBA podem ser acedidas a partir deste IDE, incluindo o
“Project Explorer”, o “Object Browser”, o editor de código, a interface de desenho de formulários e o
debugger.
Pg 29
Propriedades Project Explorer Interface de Object Browser Editor de
desenho de código VB
formulários
Pg 30
Projeto VBA
Os projetos VBA desempenham dois papéis fundamentais. Primeiro, contêm os itens do projeto. Segundo,
armazenam todo o código VBA.
O ERP PRIMAVERA v9.00 disponibiliza um único projeto VBA que agrega todas as classes de todos os módulos que
suportam VBA. Independentemente dos Módulos que estiverem disponíveis no ERP, existe apenas um projeto que
disponibiliza todas as funcionalidades
Macros
Uma macro corresponde a uma sub rotina VBA pública sem qualquer parâmetro. Tipicamente devem ser
definidos em “Class Modules” e servirão de ponto de entrada para uma determinada funcionalidade
disponibilizada pelo projeto.
O IDE do VBA disponibiliza um diálogo próprio para assistir o utilizador na manipulação deste tipo de código
VBA.
Pg 31
Este diálogo enumera todas as macros disponíveis num projeto, permitindo que o utilizador as edite, remova
ou execute.
PKB
Como criar uma Macro?
Classes
Todos os projetos VBA associados às aplicações PRIMAVERA disponibilizam de raiz um conjunto de classes
que permitem estender as principais funcionalidades dessa aplicação.
Estas classes podem ser reconhecidas no “project explorer” do VBA sob o primeiro nó:
Todos os objetos
disponibilizados num
único projeto
Pg 32
Genericamente, em cada área são disponibilizados três tipos de classes:
• Fichas (ex.: FichaArtigos): estão associadas às manutenções das tabelas principais da aplicação;
• Editores (ex.: EditorVendas): estão associadas a funcionalidades de edição de documentos e/ou
processamentos;
• Outras (ex.: Empresa).
Eventos
Conceptualmente, um evento corresponde a uma ação reconhecida por um dos objetos do projeto – por
exemplo, pressionar uma tecla ou selecionar um botão – e para a qual é possível produzir código como
resposta. Um evento pode ser despoletado pelo sistema, em resultado de uma ação do utilizador ou a partir
de código.
O projeto VBA disponibiliza um conjunto de eventos de sistema associados a cada uma das classes descritas
anteriormente. Serão estes eventos o ponto de partida para a customização da solução disponibilizada pela
PRIMAVERA.
Os seguintes exemplos ilustram utilizações potenciais dos eventos de sistema para alterar o comportamento
da aplicação:
• Sempre que um cliente é editado na respetiva manutenção será disparado um evento. Esse evento
pode, por exemplo, ser utilizado para escrever código que altere algumas das propriedades do cliente
em função de outros dados no sistema;
• Quando um artigo é identificado nas linhas de um documento de venda, o respetivo evento poderá
implementar regras de negócio adicionais não implementadas na área de Logística & Tesouraria.
Pg 33
AntesDeCriar Despoletado quando se abre uma nova manutenção.
Os eventos AntesDe
permitem cancelar a
operação
Editores
Os eventos disponibilizados nas operações de edição de documentos ou processamento dependem de cada
caso em particular.
AntesDeAnular Antes
Antesde
deiniciar
iniciaraaanulação
anulaçãodo
dodocumento.
documento.
Pg 34
DepoisDeEditar Depois de editar um documento.
Objetos
Em cada uma das classes de sistema, para além dos respetivos eventos, o projeto VBA disponibiliza também
objetos que permitem aceder e manipular os dados associados ao respetivo formulário/funcionalidade.
Aplicacao
O objeto Aplicacao disponibiliza um conjunto de propriedades relacionadas com a aplicação associada ao
projeto VBA:
Pg 35
Utilizador Dados do utilizador ativo.
PlataformaPRIMAVERA
As principais funcionalidades da Plataforma PRIMAVERA e do seu motor (ver StdPlatBS) são
disponibilizadas por este objeto. Trata-se de um subconjunto dos mesmos métodos utilizados pelas
aplicações para:
PKB
Visual Basic for Applications (VBA)
Pg 36
Campos e Tabelas do Utilizador
O ERP PRIMAVERA permite a criação de campos adicionais nas tabelas do sistema. Esta funcionalidade
permite manter outros dados – não suportados pela solução standard – acerca de qualquer uma das
entidades (clientes, fornecedores, funcionários, etc.), tabelas auxiliares ou tabelas de documentos ou
movimentos.
Pg 37
Imediatamente após a instalação do sistema PRIMAVERA, ficarão disponíveis campos do utilizador nas entidades
principais (artigos, clientes, fornecedores, etc.)
Pg 38
Pg 39
Atenção
O nome físico dos campos do utilizador deve começar pelo prefixo “CDU_” para serem corretamente reconhecidos pelo sistema.
Pg 40
Campos do Utilizador nas Aplicações
O manuseamento dos campos do utilizador criados é feito dentro das próprias aplicações.
A forma como esse manuseamento será feito depende da complexidade da tabela em causa.
Pg 41
Campos do Utilizador em Documentos
Dada a especificidade das janelas de edição de documentos ou movimentos, os campos do utilizador
associados (ao cabeçalho ou às linhas) estará também disponível em formulário autónomo.
Pg 42
Em qualquer um dos casos anteriores, a edição dos campos do utilizador pode ser modificada, de acordo com as
necessidades do utilizador, através da criação de Separadores do Utilizador e da associação de código VBA para
implementar regras de negócio mais complexas
Pg 43
Tabelas do Utilizador
As tabelas do utilizador permitem, à semelhança dos Campos do Utilizador, estender uma base de dados
PRIMAVERA para suportar a manutenção de dados adicionais – outras entidades – não disponibilizadas pela
solução standard.
Uma Tabela do Utilizador é um conjunto de Campos do Utilizador não associados a nenhuma das tabelas do
sistema.
Para criar uma nova TDU deve utilizar-se o mesmo assistente disponível no Administrador, indicando o nome
da tabela, os campos do utilizador disponibilizados e as aplicações em que a nova tabela estará disponível.
Atenção
O nome físico dos campos do utilizador deve começar pelo prefixo “TDU_” para serem corretamente reconhecidos pelo sistema.
Depois de criar uma tabela de utilizador numa base de dados PRIMAVERA, desde que esta obedeça às
regras mencionadas, ela passará imediatamente a estar disponível nas respetivas aplicações e pode ser
acedida através da opção “Tabelas do Utilizador” no menu “Ferramentas”.
PKB
Campos do Utilizador
Tabelas do Utilizador
Pg 44
Separadores e Formulários do Utilizador
Separadores do Utilizador
Os Separadores do Utilizador (SDU) permitem modificar a interface standard de edição de campos do
utilizador e associar código VBA à manutenção dos campos do utilizador de qualquer entidade das
aplicações.
Depois de definir o primeiro separador do utilizador para uma tabela da aplicação, o separador standard automático de
edição, descrito previamente, desaparecerá para dar lugar ao(s) separador(es) definidos pelo utilizador
Pg 45
2. Selecione a entidade para a qual pretende criar o separador. No menu de contexto, selecione “New”
(neste exemplo escolhemos a entidade “Tabelas - Clientes”). Será criado um novo formulário vazio:
Pg 46
Pg 47
3. Configure as propriedades do separador:
Pg 48
O ambiente VBA permite-lhe adicionar qualquer controlo licenciado de terceiras partes (fabricantes de controlos para
VBA). Existem índices de controlos disponíveis na Web. Nesses Web sites poderá encontrar controlos para efetuar
virtualmente qualquer tipo de operação nos seus separadores do utilizador.
5. Pode, de seguida, introduzir código específico para implementar regras de negócio específicas:
A solução PRIMAVERA disponibiliza o ambiente VBA configurado para suportar as entidades lógicas PRIMAVERA
(campos do utilizador, separadores do utilizador, etc.).
Da mesma forma, em cada separador, são disponibilizados vários eventos que lhe permitem programar o
funcionamento do separador de uma forma simplificada.
Pg 49
Formulários do Utilizador
Os Formulários do Utilizador (FDU) correspondem a formulários (ou forms) desenvolvidos no âmbito do
projeto VBA associado a cada aplicação.
Ao contrário dos Separadores do Utilizador não estão associados a nenhuma das tabelas do sistema, pelo
que podem ser utilizados para implementar outras funcionalidades, como por exemplo:
Na prática um FDU corresponde diretamente a um “User Form” do VBA. No entanto, este conceito permite a
extensão da solução PRIMAVERA de uma forma mais integrada, na medida em que será possível associar
cada FDU a uma função do utilizador e, desta forma, apresentar o formulário ao utilizador:
Pg 50
Para criar um Formulário do Utilizador:
1. Selecione a opção “Formulários do Utilizador” do menu “Ferramentas” do ERP. Será aberto o ambiente
de desenvolvimento VBA para o assistir na edição do formulário;
2. Ative a barra de ferramentas “Formulários”. No menu de contexto, selecione “Novo Formulário”. Será
criado um novo formulário vazio:
Pg 51
5. Pode, de seguida, introduzir código específico para implementar regras de negócio específicas:
Pg 52
6. Grave o projeto VBA e retorne à aplicação PRIMAVERA.
A partir deste momento o novo formulário ficará disponível para ser associado a um Função do Utilizador.
PKB
Separadores do Utilizador
Formulários do Utilizador
Funções do Utilizador
Uma Função do Utilizador (XDU) corresponde a uma determinada ação – executada pelo sistema
PRIMAVERA – que implementa uma determinada regra de negócio.
Este novo conceito – central nas aplicações a partir da versão 6.0 – permite estender a solução PRIMAVERA
para garantir todas as regras de negócio específicas a cada empresa. Por exemplo:
Mapa do Utilizador Para exportação e/ou envio por email de mapas do utilizador.
Para execução de stored procedures existentes na base de dados da
Stored Procedure
empresa.
Para execução de user defined functions existentes na base de dados da
User Defined Function
empresa (apenas disponível em SQL Server 2000 ou superior).
Query SQL Para execução de queries SQL ad-hoc.
Pg 53
Dependendo do seu tipo, cada Função do Utilizador permite a definição de:
Os tópicos seguintes analisam a criação de cada um dos tipos de funções do utilizador disponíveis, a
definição de parâmetros e dos seus resultados, bem como a sua execução nas aplicações PRIMAVERA.
Mensagem de E-mail
Para criar uma Função do Utilizador para envio de mensagens de E-mail, siga os seguintes passos:
Pg 54
3. Na janela seguinte pode definir as propriedades da função do utilizador. Na primeira página introduza o
nome da função, selecione o tipo “E-mail” e introduza uma descrição mais detalhada:
Pg 55
Campo Descrição
Nome Nome da Função
Tipo de Função Tipo de Função
Activa Se estivar ativa, a função pode ser executada
Campo Descrição
Para Destino(s) da mensagem
Assunto Assunto da mensagem
Mensagem Conteúdo da mensagem
Anexos Possibilidade de anexar ficheiros
5. Selecionar “Confirmar”.
Pg 56
Deste exemplo resultaria uma Função do Utilizador que permitiria o envio de uma mensagem por E-mail para
o destino “diretor.financeiro@clientepreferido.pt”. Essa função poderia então ser executada no ERP
PRIMAVERA a partir da janela de funções do utilizador, de um menu do utilizador ou de um atalho no
Navegador.
No entanto, uma XDU deste tipo não teria uma grande utilidade prática porque apenas permitiria o envio de
um E-mail para um determinado destino fixo (ou vários fixos).
A Plataforma PRIMAVERA permite, na verdade, que este conceito seja estendido através da definição de
parâmetros. Desta forma, uma mesma função do utilizador poderá ser utilizada para enviar o envio de avisos
de vencimento para qualquer cliente.
Definição de Parâmetros:
Nas funções do utilizador do tipo E-mail, os parâmetros devem ser declarados pelo utilizador, em qualquer
um dos campos da definição, usando uma sintaxe particular (@@NomeDoParametro@@).
Voltando ao exemplo anterior, suponhamos que se pretendia que a função do utilizador permitisse:
Para atingir tais objetivos, a definição anterior poderia ser alterada da seguinte forma:
Pg 57
Parâmetros que define o
destino da mensagem.
À medida que o utilizador for definindo os parâmetros usando a sintaxe esperada, a aplicação efetuará o seu
Parâmetro que se
adaptará ao nome da
reconhecimento e estes serão apresentados na página “Parâmetros/Resultado”: empresa de trabalho
Extrato do cliente
Pg 58
Parâmetros definidos
pelo utilizador
Valores associados
Neste ponto pode definir todas as características de cada um dos parâmetros da Função do Utilizador (tipo de dados,
valor por defeito, lista de valores, etc.). Para mais informação consulte a secção referente a “Parâmetros”.
Definição do Resultado:
Pg 59
Aplicação Externa
Para criar uma Função do Utilizador que permita a execução de aplicações ou documentos externos à
solução PRIMAVERA, siga os seguintes passos:
Pg 60
Campo Descrição
Comando Localização da Aplicação
Parâmetros Parâmetros
Dir. Inicial Diretoria Inicial
Executar (Janela) Estado inicial da janela
5. Selecione “Confirmar”.
Definição de Parâmetros:
O exemplo anterior poderia ser configurado para permitir a abertura dinâmica de folhas de cálculo:
Definição do Resultado:
Definição do resultado de
execução da Função do
Utilizador
Pg 61
Pode especificar dois tipos de resultado:
Macro VBA
Para criar uma Função do Utilizador para execução de macros definidas no projeto VBA siga os seguintes
passos:
Pg 62
Projeto VBA
Lista de macros
disponíveis no projeto
VBA atual
5. Selecione “Confirmar”.
Atenção
A definição das macros deve ser efetuada previamente no projeto VBA da aplicação ou no projeto partilhado (entre todas aplicações).
Na lista de macros constarão todas as macros (procedimentos sem parâmetros ou resultados), procedimentos públicos (com ou sem
parâmetros) e funções públicas (com ou sem parâmetros) definidos no projeto VBA da aplicação ou no projeto comum para a
empresa ativa.
Definição de Parâmetros:
Pg 63
Esta Macro tem no seu código VBA como parâmetro de entrada a variável Utilizador do tipo String.
Definição do Resultado:
O resultado da função do utilizador será determinado também pela definição da macro. O valor retornado por
esta Macro é um Booleano.
Query SQL
Para criar uma Função do Utilizador para execução de queries SQL siga os seguintes passos:
Pg 64
Verificar a sintaxe da
instrução SQL
5. Selecione “Confirmar”.
Definição de Parâmetros:
Os parâmetros da Função do Utilizador podem ser definidos de acordo com a sintaxe descrita anteriormente:
Pg 65
Definição do Resultado:
A forma como o recordset resultante da query SQL será interpretado pelo motor de execução depende do
tipo de resultado selecionado pelo utilizador:
Parâmetros
A cada parâmetro de uma função do utilizador está associada a seguinte informação:
Genericamente, para que uma função do utilizador possa ser corretamente executada, será necessário que o
valor correspondente a cada um dos parâmetros obrigatórios seja definido no momento de execução. No
entanto, o módulo de configuração de Funções do Utilizador permite definir o valor por defeito, os valores
possíveis ou efetuar o cálculo do valor como resultado de expressões.
Valor Fixo
Neste caso, será atribuído ao parâmetro selecionado um valor discreto que pode, ou não, ser depois
modificado pelo utilizador no momento de execução da função.
Pg 66
Selecionando esta opção, o
utilizador poderá modificar o
valor no momento de
execução
Valores possíveis
Pg 67
Lista Definida Através de uma Query SQL
Também pode definir a lista de valores possíveis a partir de uma query executada sobre a base de dados
imediatamente antes de executar a função do utilizador:
Tabela
Finalmente, é necessário indicar o campo da query que deve ser utilizado para determinar o valor do
parâmetro e outras opções:
Pg 68
Permitir, ou não, que o
utilizador introduza um
valor não constante na
lista
Fórmula
Neste caso o valor do parâmetro será determinado pelo resultado da execução de uma fórmula.
O valor resultante da expressão será determinado imediatamente antes da função ser executada. A
expressão pode incluir:
Pg 69
Empresa Valores dependentes da empresa ativa (Código, Nome, etc.).
Atenção
A expressão/fórmula associada ao valor do parâmetro deverá observar a sintaxe VBScript.
Função
Neste caso, o valor do parâmetro será determinado pelo resultado da execução de uma outra função do
utilizador.
As funções do utilizador que tenham parâmetros definidos desta forma despoletarão a execução de todas as
funções do utilizador dependentes imediatamente antes da sua própria execução.
Pg 70
Execução
Uma função do utilizador pode ser executada (botão “Executar”):
Excetuando no último caso referido, a execução da função do utilizador será efetuada imediatamente,
interagindo com o utilizador para:
Exemplo
Para exemplificar este comportamento consideremos a definição de uma função do utilizador com as
seguintes características:
1. Pretende-se obter uma lista com os clientes que tenham um volume de vendas superior a um
determinado valor para um determinado mês;
2. Para o efeito foi definido um Stored Procedure – TopClientes – na base de dados com dois parâmetros:
o mês para o qual se pretende obter a lista de clientes e o valor mínimo de vendas a considerar;
3. Pretende-se ainda que o resultado seja apresentado ao utilizador.
A definição da função do utilizador seria a seguinte:
Pg 71
Pg 72
Imediatamente antes da execução da função, todos os parâmetros seriam então solicitados ao utilizador num
formulário semelhante ao seguinte:
Valor fixo
Lista de Valores
Pg 73
O resultado da função – neste caso, uma lista de registos, será então apresentado ao utilizador:
Registos resultantes da
execução da função
Operações disponíveis
sobre a lista de registos
O envio de mensagens SMS é efetuado assincronamente. Ou seja, sempre que uma função do utilizador do tipo “SMS”
for executada, a respetiva mensagem será colocada numa fila de espera para envio. O envio propriamente dito será
efetuado pela aplicação “Gestão de Processos PRIMAVERA” de acordo com o calendário de execução aí definido.
PKB
Funções do Utilizador
Pg 74
Menus do Utilizador
Esta ferramenta permite a extensão dos menus de qualquer uma das aplicações PRIMAVERA, adicionando
novos comandos associados a funções do utilizador que executam determinadas ações quando selecionados
pelo utilizador.
O utilizador pode criar um novo submenu e este passa a aparecer de imediato na área de Menus do
Utilizador do ERP. Pode configurar outros submenus e comandos.
Nenhum menu de
utilizador
Pg 75
Cada um dos comandos – os items de menu que executam algo quando selecionados – será associado a
uma função do utilizador (responsável pela execução).
2. Selecione o sub menu sob o qual pretende criar o novo sub menu e selecione “Submenu”;
3. Na janela seguinte introduza o título do sub menu e a “tooltip” associada:
Pg 76
4. Selecione “Confirmar” para regressar ao formulário inicial.
Pode mudar o título do menu “Outros”, selecionando o nó correspondente na janela anterior e escolhendo
“Propriedades”.
Depois de definidos os menus do utilizador, é necessário aceder ao Administrador para definir as permissões de
acesso. Até lá, apenas os administradores de sistema terão acessos aos novos menus.
Para reorganizar a ordem dos itens de cada sub menu utilizando as setas disponíveis na janela.
O botão “Propriedades” permite editar o elemento selecionado, o botão “Anular” permite remover o elemento
selecionado.
Pg 78
Menu do utilizador com o
comando criado
PKB
Menus do Utilizador
Pg 79
Processos do Utilizador
Os Processos do Utilizador (PDU) complementam as Funções do Utilizador, permitindo a execução
calendarizada de sequências de ações (funções) num servidor, sem intervenção do utilizador.
Usando este mecanismo, o utilizador tem ao seu dispor uma ferramenta de automatização de tarefas
repetitivas, capaz de implementar regras de negócio específicas.
Para ilustrar este conceito, consideremos os seguintes exemplos de tarefas programáveis na forma de
Processos do Utilizador:
Pg 80
Atenção
A utilização de funções do utilizador em processos do utilizador está sujeita às seguintes limitações:
(1) Macro VBA – só podem ser utilizadas funções deste tipo desde que apontem para macros definidas no projeto do ERP;
(2) Mapas do Utilizador – só podem ser utilizadas funções deste tipo desde que estejam configuradas para enviar o mapa por E-mail
e/ou o exportar para uma diretoria em disco.
Ambiente de Configuração
O ambiente de configuração de Processos do Utilizador está disponível no menu “Ferramentas”.
Selecionando esta opção no menu principal, o utilizador terá acesso a janela de definição de Processos do
Utilizador. A partir deste formulário será possível criar novos processos, executar, modificar, duplicar ou
eliminar aqueles já existentes.
Para criar um novo processo bastará selecionar a opção “Novo...”. Surge então o ambiente de configuração
assistida.
Pg 81
Barra de Ferramentas
“Toolbox” de Funções do
Utilizador
Área de desenho
Estado da execução
Pg 82
Para definir as propriedades principais do Processo
1. Selecione o elemento “Início do Processo”;
2. No menu de contexto, selecione “Propriedades”.
Nome e descrição do
processo
Notificações automáticas
durante a execução
Definição do calendário de
execução
Pg 83
Definição de Passos
Depois de definidas as propriedades principais do processo, o passo seguinte deve ser a definição dos
passos que o compõem. Para ilustrar este procedimento consideremos novamente o exemplo de
encomendas automáticas. Os pressupostos são os seguintes:
Para criar um processo do utilizador que automatize este procedimento, seria necessário seguir os seguintes
passos:
Pg 84
6. Defina o calendário do processo e escolha “Confirmar”;
7. Novamente na janela de propriedades, escolha “Confirmar”;
8. Na toolbox, selecione o elemento “Stored Procedure” e arraste-o para a área de desenho (será criado
um novo passo e a janela de propriedades desse passo será automaticamente aberta);
9. Introduza o nome e a descrição do novo passo:
Pg 85
Pg 86
12. Novamente nas propriedades do passo selecione a função acabada de criar:
13. A página “Configuração” indica os parâmetros e o resultado do passo (a partir da definição da Função
do Utilizador). Escolha “Confirmar” (será criado um novo nó na área de desenho do processo
correspondente ao novo passo):
Pg 87
14. Crie um novo passo correspondente à execução do segundo stored procedure:
Pg 88
Pg 89
15. Deve definir os parâmetros do segundo passo da seguinte forma:
Pg 90
16. De seguida defina o fluxo de execução, ligando os vários nós entre si:
Setas de fluxo de
execução
Definição de Condições
Uma ferramenta essencial para tornar os Processos do Utilizador mais adaptáveis a cada situação está
relacionada com a definição de condições que alteram o fluxo de execução mediante determinados critérios.
Pg 91
Este exemplo ilustra a utilização de uma condição para adaptar o mesmo processo a duas situações
distintas.
Pg 92
Definição do passo anterior
à condição
Condição a aplicar ao
resultado do passo
anterior
Ações dependentes do
resultado da condição
Os tipos de valores associados aos parâmetros dependerão do tipo de dados do parâmetro e dos restantes passos já
definidos. Por exemplo, se não existir nenhum passo que devolva um valor do tipo “Inteiro”, não será possível definir,
para um parâmetro desse tipo, um valor “Resultado do passo anterior”.
Pg 93
Ambiente de Execução
Os Processos do Utilizador são normalmente executados pela aplicação Gestão de Processos PRIMAVERA
numa máquina configurada como servidor.
A sua execução será realizada segundo o calendário definido, logo que o servidor esteja disponível (tenha,
por exemplo, terminado a execução de outro processo ou o envio de mensagens SMS).
Para efeitos de testes, é possível executar um processo do utilizador a partir do ambiente de configuração
(descrito nos pontos anteriores).
Finalmente, um processo pode ser explicitamente executado, a pedido de um utilizador, a partir de um atalho
configurado no Navegador. Neste caso, o seu calendário será ignorado e o processo imediatamente
executado.
PKB
Processos do Utilizador
Pg 94
Alertas do Utilizador
Os Alertas do Utilizador são a nova forma de definir alertas, muito mais parametrizável, permitindo ao
utilizador um controlo mais pormenorizado sobre um conjunto de informação crítica sobre a qual é
indispensável obter avisos periódicos.
A periodicidade dos alertas é também ela definível aquando da sua configuração adaptando-se assim às
necessidades de cada perfil de utilizador.
Para ilustrar esta funcionalidade, consideremos alguns exemplos de informação adaptável a um Alerta do
Utilizador:
Para cada uma da informação indicada acima é possível criar um Alerta de Utilizador.
Selecionando esta opção, o utilizador terá acesso à janela de apresentação dos Alertas do Utilizador.
Pg 95
A partir deste formulário será possível criar novos alertas, executar, modificar, duplicar ou eliminar aqueles já
existentes.
Para criar um novo processo bastará selecionar a opção “Novo”. Surge então um assistente que o ajudará a
criar um novo Alerta.
Definição do Alerta
Para explicar melhor os vários passos necessários efetuar na criação de um Alerta do Utilizador vamos usar
um exemplo.
Exemplo
Vamos efetuar a criação de um alerta que permita aos utilizadores obter informação periódica sobre os
aniversários dos funcionários da empresa.
Pg 96
Neste caso, seleciona-se a opção “Filtrar” para definir a categoria da lista correta. A lista que se pretende é
obtida por um Stored Procedure previamente criado no Exercício. Todos os Stored Procedure’s existentes
são apresentados na categoria <Queries SQL>.
Pg 97
Seleciona-se a lista correspondente: “Alertas Aniversários”.
Opcionalmente, pode-se optar por seguir com a configuração por defeito passando-se diretamente para a
definição dos utilizadores com acesso ao alerta. Neste exemplo, inativa-se a opção para se poder efetuar
uma configuração mais detalhada.
Pg 98
Define-se como se pretende apresentar os resultados. Apresenta-se os resultados da última execução do
alerta ou marca-se alerta com aviso quando Tem resultados/Sem resultados.
Indica-se se os resultados devem enviados como notificação e se devem ser publicados. Para ambas as
opções deve ser definido o seu comportamento.
Pg 99
Indicar se o alerta é um:
Todos os utilizadores
existentes
Opcionalmente, definir se o alerta é independente do utilizador que o executa. Definir se pode ou não ser
executado manualmente e a partir de quanto tempo é que o alerta se torna desatualizado. É possível, ainda,
calendarizar a execução do alerta.
É possível calendarizar a
execução do alerta de
forma automática a
efetuar pelo Windows
Scheduler.
Pg 100
Indicar o nome, descrição, prioridade e a respetiva categoria do Alerta do Utilizador.
Pg 101
O novo alerta aparece associado à categoria correspondente.
Ambiente de Execução
Apesar de ser um alerta com execução calendarizada é possível de imediato proceder à execução
(processamento) da sua informação associada, com o imediato envio por E-mail para os respetivos
destinatários.
Pg 102
Para tal basta utilizar a opção “Executar” da barra de ferramentas ou do menu de contexto.
Podemos tal como foi referido anteriormente, durante a criação do Alerta, ou mais tarde editando um alerta
criado, efetuar a calendarização da respetiva execução.
Pg 103
Resultados
Da próxima vez que qualquer um dos utilizadores destinatários do Alerta entrar no ERP ser-lhe-á
apresentado o Monitor de Negócio que conterá, entre outra informação, um local específico para a
visualização dos seus alertas.
O Monitor de Negócio está acessível pela opção “Monitor de Negócio” do menu “Utilizador” do ERP.
PKB
Alertas do Utilizador
Pg 104
Indicadores do Utilizador
Os Indicadores do Utilizador são uma funcionalidade que permite a cada utilizador observar, de forma rápida
e facilmente percetível, um conjunto de informação pertinente.
Selecionando esta opção, o utilizador terá acesso à janela de apresentação dos Indicadores do Utilizador
existentes.
Para ilustrar esta funcionalidade, consideremos alguns exemplos de informação passível de ser visualizada
sob a forma de um Indicador do Utilizador para duas áreas distintas do ERP:
• Antiguidade;
• Habilitações;
• Número Efetivo por Sexo;
• Taxas de Absentismo;
• Demissões…
Pg 105
Área de Vendas
Para cada uma da informação indicada acima é possível criar um Indicador do Utilizador.
A partir do formulário de configuração dos Indicadores do Utilizador é possível criar novos indicadores,
executar, modificar, duplicar ou eliminar aqueles já existentes.
Para criar um novo indicador basta selecionar a opção “Novo”. Surge então um assistente que ajudará o
utilizador a configurar um novo indicador.
Definição do Indicador
Para explicar melhor os vários passos necessários efetuar na criação de um Indicador do Utilizador vamos
usar um exemplo.
Exemplo
Vamos efetuar a criação de um indicador que permita aos utilizadores obter informação sobre os Artigos que
se encontram no Top 10, para o mês atual. Obviamente este indicador provavelmente apresentará
informação diferente ao longo do mês pois a análise será efetuada sempre que o respetivo indicador for
executado. Se optarmos por uma execução diária, obteremos uma imagem diária atualizada em relação à
informação pretendida.
Pg 106
Opcionalmente, avançar com a opção por defeito se pretender utilizar as opções mais comuns na definição
de um indicador simples. Aqui não se pretende avançar com a configuração por defeito. Assim, desativa-se a
opção.
Pg 107
Indicar as ações a efetuar automaticamente, pelo sistema, após executar o indicador:
• Enviar notificações dos resultados usando: permite o envio dos resultados, via SMS/E-
mail, para os utilizadores que tenham o indicador no Monitor de Negócio;
• Publicar resultados para: permite publicar os resultados num ficheiro ou num site FTP.
Ambas as opções devem ser devidamente configuradas acedendo e preenchendo os dados das "Opções".
Pg 108
Indicar o âmbito do indicador:
Calendarizar a execução do indicador para ocorrer todos os dias às 00:00 horas. Desta forma, o gráfico
resultado do indicador obtém os seus dados sobre a informação de vendas realizadas no dia anterior.
Pg 109
Indicar os dados gerais do indicador: nome, descrição, apresentação dos resultados (Gráfico ou Lista de
Registos) e categoria.
Pg 110
Por fim deverá ser escolhido o tipo de gráfico que servirá de apoio à apresentação dos resultados gráficos do
Indicador.
Pg 111
O Indicador ficará disponível na lista de Indicadores do Utilizador, onde eventualmente poderá ser objeto de
execução. Consequentemente, poderá incluir o Indicador para monitorização no serviço Monitor de Negócios.
PKB
Alertas do Utilizador
Pg 112
Navegador
O Navegador oferece ao utilizador a possibilidade de configurar o ambiente de trabalho em cada um dos
Módulos, adaptando-o às suas necessidades. Usando esta funcionalidade, o utilizador poderá:
• Garantindo que cada utilizador tem acesso a toda a informação relevante para o seu
trabalho, no formato correto;
• Permitindo a implementação de regras de segurança adicionais;
• Disponibilizando todas as ferramentas de extensibilidade de uma forma totalmente
integrada com a aplicação.
Pg 113
Mostrar/Ocultar o
Navegador
Botão de contexto.
Pg 114
Módulos do ERP com
navegação em árvore
PKB
Navegador
Pg 115
Atalhos
O utilizador poderá criar os seguintes tipos de atalhos:
• Listas;
• Aplicações externas;
• Documentos;
• Páginas Web;
• Menus da aplicação;
• Funções do Utilizador;
• Processos do Utilizador;
• Empresas.
Todos os atalhos podem ser organizados e agrupados em pastas, numa estrutura semelhante à disponível
no Windows para organizar os ficheiros.
Pg 116
2. Na janela seguinte, selecione a aplicação externa e defina as restantes propriedades do atalho:
Pg 117
Para criar um atalho para uma página Web
1. No menu de contexto do Navegador, selecione Novo/Página Web;
2. Na janela seguinte, introduza o endereço da página ou selecione uma das páginas disponíveis nos
favoritos do Internet Explorer:
Pg 118
Para criar um atalho para um menu da aplicação
1. No menu de contexto do Navegador, selecione Novo/Menu;
2. Na janela seguinte, selecione os menus da aplicação para os quais pretende criar atalhos no
Navegador (podem ser criados vários atalhos em simultâneo):
Pg 119
Para criar um atalho para um Processo do Utilizador
1. No menu de contexto do Navegador, selecione Novo/Processo do Utilizador;
2. Na janela seguinte, selecione o processo a associar ao atalho:
Lista de todos os
processos do utilizador
disponíveis
Pg 120
A criação de atalhos para empresas fornece um mecanismo para abrir rapidamente uma empresa em particular. Esta
ferramenta será particularmente útil em instalações com muitas empresas como, por exemplo, gabinetes de
contabilidade
PKB
Navegador
Listas
Categorias de Informação
A criação de listas permite:
Assim, todos os dados de cada Módulo/Área estão organizados em Categorias que agrupam todas as
tabelas relevantes para obter a informação relevante sobre determinada entidade.
Na prática, isto quer dizer que a categoria de Clientes disponibiliza todos os dados relacionados com clientes.
Para além da tabela associada, incluirá dados de vendedores, vendas, contactos, moedas, etc.
O Navegador torna-se assim na principal fonte de dados para o utilizador e numa ferramenta imprescindível
para configurar a solução e adaptá-la a cada situação em particular.
As categorias disponíveis dependerão de cada uma das aplicações. A título de exemplo, apresenta-se abaixo
algumas das categorias da área de Logística & Tesouraria:
ALGUMAS
• Armazéns;
DAS • Bancos;
CATEGORIAS • Contas Bancárias;
DA
LOGÍSTICA &
• Documentos de Compra;
TESOURARIA • Documentos de Stocks;
• Documentos de Venda;
• Modos de Expedição;
• Movimentos Bancários;
• Movimentos de Compras;
• Movimentos Compras (transf. linhas);
Pg 121
• Movimentos de Contas Correntes – Linhas;
• Movimentos de Tesouraria – Linhas;
• Movimentos de Vendas;
• Movimentos Vendas (transf. linhas);
• Sócios;
• Tabelas – Artigos;
• Tabelas – Clientes;
• Tabelas – Contactos;
• Tabelas – Outros Terceiros;
• Vendedores;
• Zonas.
Criação de Listas
Para criar uma nova lista, siga os seguintes passos:
Categorias de informação
da aplicação ativa.
Pg 122
4. Selecionar as colunas da lista a partir de cada tabela que compõem a categoria de informação:
Todas as tabelas
disponíveis na categoria
selecionada.
Todos os campos
disponíveis na tabela
selecionada.
5. No passo seguinte pode definir expressões condicionais para filtrar os dados da lista mediante
determinados critérios:
Pg 123
Filtros sobre os dados da
lista.
Pg 124
7. De seguida pode definir agrupamentos lógicos sobre os registos:
8. No passo seguinte pode definir formatações condicionais a aplicar aos registos da lista:
Pg 125
9. Indique se pretende, ou não, pré-visualizar o resultado:
Pg 126
Neste passo pode ainda definir as seguintes opções avançadas da lista:
Pg 127
Resultado da aplicação da
formatação condicional.
11. Finalmente, deve indicar o nome da nova lista e a respetiva disponibilidade para os restantes
utilizadores:
Pg 128
Depois de concluído o assistente, a nova lista ficará disponível para ser adicionada no Navegador:
Ordenação de Registos
Pode definir até cinco critérios de ordenação dos registos da lista.
Pg 129
Para definir os critérios de ordenação deve indicar cada um dos campos de ordenação e a respetiva ordem:
Ordenação de Colunas
A ordem das colunas na lista pode ser definida no formulário de criação da lista:
Pg 130
Aliases
Em determinadas situações, nomeadamente, em listas resultantes da agregação de várias tabelas, pode ser
necessário renomear algumas das colunas:
Para adicionar uma nova expressão deve selecionar o botão respetivo no assistente de criação de listas:
Estas opções
permitem-lhe definir
valores calculados.
Pg 131
Ser-lhe-á apresentado um formulário que permite a definição da expressão calculada:
Colunas disponíveis na
lista.
Operadores.
Expressão.
Nome da expressão.
Alias.
Condições
Uma expressão condicional permite a definição de uma condição que filtrará os resultados da lista mediante
um determinado critério.
Esta é a funcionalidade mais importante das listas porque permite ao utilizador definir listas configuradas à
exata medida das suas necessidades de informação, facilitando:
O módulo de configuração de listas permite-lhe definir tantas condições, quantas necessárias, suportando a
combinação de expressões usando os operadores lógicos E e OU.
Pg 132
1. Na lista de expressões condicionais, selecione “Nova...”:
Pg 133
3. Defina a condição e escolha “Confirmar”:
As várias condições definidas podem ser combinadas em sub-expressões às quais serão aplicados os
operadores lógicos E ou OU.
Para criar uma sub-expressão, na lista de expressões condicionais, selecione “Sub-Expressão” e escolha o
tipo de sub-expressão a criar:
Pg 134
Para criar uma expressão parametrizável:
Algo que torna este módulo particularmente funcional é a possibilidade de parametrizar cada uma das
condições definindo uma lista de valores possíveis para a condição:
Pg 135
• Ou criar uma lista de valores resultante da execução de uma query na base de dados:
Pg 136
Esta configuração resultará numa lista parametrizada. Sempre que o utilizador iniciar a sua edição, todos os
valores parametrizados ser-lhe-ão solicitados. O que permite, por exemplo, definir listas genéricas que se
adaptam às necessidades do utilizador em cada momento.
Totais Agregados
Pode definir totalizadores sobre qualquer um dos campos numéricos definidos na lista. Estão disponíveis as
seguintes operações:
• Contador;
• Soma;
• Média;
• Mínimo;
• Máximo;
• Desvio Padrão;
• Contador dos Valores.
Pg 137
Condições sem Totais Agregados
Podem ser definidas condições sem ter totais agregados:
Pg 138
Agrupamento
Esta funcionalidade está limitada a um número máximo de quatro agrupamentos.
Pg 139
Formatações Condicionais
As formatações condicionais permitem salientar na lista aqueles registos que obedeçam a determinada
condição.
Pg 140
Pode combinar várias formatações condicionais na mesma lista.
Cada uma das formatações condicionais será aplicada sequencialmente a cada um dos registos da lista pela ordem
definida no assistente de configuração.
Pg 141
Consulta de Listas
Todas as listas configuradas pelo utilizador podem ser acedidas/consultadas a partir:
F4
Pg 142
Operações sobre uma Lista
Mais do que uma ferramenta de consulta de dados, as listas disponibilizam ao utilizador um conjunto de
funcionalidades que permitem manipular os dados de modo a obter informação adicional, efetuar a sua
publicação e utilizá-la como suporte às mais variadas funções de gestão. As operações sobre as listas e os
seus dados estão disponíveis na barra de ferramentas e no menu de contexto:
• Listas da Categoria;
• Edição de Registos;
• Filtros Rápidos;
• Pesquisas Rápidas;
• Pesquisas;
• Drilldown;
• Ordenação de Registos;
• Impressão da Lista;
• Impressão de Mapas;
• Exportação de Registos;
• Envio de Mensagens por E-mail;
• Criação de Atalhos para Registos;
• Serviço de Localização…
Pg 143
Pesquisas e Listas por Defeito
Todas as pesquisas de registos, em qualquer um dos formulários da aplicação, serão efetuadas sobre as
listas definidas para a categoria respetiva.
Por exemplo, no editor de vendas do módulo de Vendas a pesquisa do cliente (usando o F4) será efetuada
sobre uma das listas definidas na categoria de clientes. Se não existir nenhuma lista definida pelo utilizador,
será usada a lista de sistema. Caso contrário será usada aquela que tiver sido definida como lista por defeito
para o utilizador ativo.
A lista por defeito para cada categoria pode ser definida de duas formas:
A primeira opção será especialmente útil na perspetiva do utilizador responsável pela configuração inicial do
sistema.
A segunda opção deverá ser usada pelos utilizadores com permissões mais avançadas e/ou com
necessidades adicionais de flexibilidade na utilização da aplicação.
PKB
Listas
Pg 144
Categorias
É possível condicionar resultados através da aplicação de condições durante o processo de criação de listas
ou na edição das suas propriedades. Uma expressão condicional consiste na definição de uma restrição que
filtra os resultados das listas através de um critério. Esta é uma das funcionalidades sobre as listas mais
importante, pois permite ao utilizador definir listas configuradas exatamente de acordo com a informação do
utilizador.
Porém, podem existir situações/decisões quando este procedimento é aplicado transversalmente, isto é, para
a própria informação da categoria. Este cenário consiste essencialmente numa ou mais expressões
condicionais transversais a todas as listas associadas a uma categoria. Resumindo, as listas têm sempre
uma expressão condicional especificada na categoria.
PKB
Como aplicar condições às categorias?
Pg 145
Mapas do Utilizador
Os produtos PRIMAVERA permitem que o utilizador configure qualquer mapa ou listagem a seu gosto. As
possibilidades oferecidas pela ferramenta de geração de reports, Crystal Reports, do conhecido produtor
mundial Business Objects – do qual a PRIMAVERA Business Software Solutions é o representante português
exclusivo – são imensas.
Todos os mapas ou listagens gerados a partir do software PRIMAVERA utilizam o Crystal Reports. Os
programas oferecem em cada opção uma configuração, a qual se tipificou como sendo <SIST>, isto é, a
configuração do sistema, a configuração segundo a PRIMAVERA Business Software Solutions. Esse report
não deve ser alterado pelo utilizador que, para o efeito, deverá duplicá-lo dando-lhe um outro nome e sobre
essa duplicação proceder às alterações que entender. Assim garante-se que por acidente, ou por utilização
incorreta, o utilizador não danificará os mapas de base que lhe foram entregues com os programas.
Pg 146
Para alterar o desenho de um Mapa
1. Selecione o Mapa cuja configuração pretende alterar;
2. Escolha a opção Propriedades. Acede à seguinte janela:
3. Aceda ao Crystal Reports através da opção “Editar”. Caso esse programa não esteja instalado no seu
sistema a aplicação avisa-o desse facto;
4. Depois de proceder às alterações do mapa, grave as mesmas no Crystal Reports e saia desse
programa. A partir desse momento, pode passar a utilizar o seu mapa sempre que quiser.
O manuseamento do Crystal Reports é explicado no manual que acompanha o produto, em formato digital ou através
da ajuda desse programa. O Crystal Reports é um produto desenvolvido em inglês e o nível de dificuldade da sua
utilização varia do simples à utilização avançada, dependendo das pretensões dos utilizadores.
PKB
Mapas de Utilizador
Pg 147
PRIMAVERA Business Software Solutions, S.A. © 1993 – 2014 || All rights reserved
Pg 148