ManualdeExtensibilidad ERP810ES PDF

Manual de
Extensibilidad
ERP PRIMAVERA V8.10
Versin 1.0
marzo 2013
ndice
ndice................................................................................................................................. 2
Introduccin....................................................................................................................... 6
Extensibilidad ..................................................................................................................... 7
Motores de las Aplicaciones .............................................................................................7
Motores de la Plataforma .................................................................................................7
VBA Visual Basic for Applications ..................................................................................8
Campos y Tablas de Usuario.............................................................................................8
Pestaas y Formularios de Usuario ..................................................................................8
Funciones de Usuario .......................................................................................................8
Procesos de Usuario ........................................................................................................8
Mens de Usuario ............................................................................................................9
Navegador .......................................................................................................................9
Listas...............................................................................................................................9
Informes de Usuario ......................................................................................................10
Tecnologas de Integracin ............................................................................................10
Motores de los Mdulos .................................................................................................... 11
Tecnologa COM y Arquitectura Windows DNA ................................................................11
Arquitectura de los Motores ...........................................................................................12
Objetos de Negocio (BE) ................................................................................................13
Servicios de Negocio (BS) ..............................................................................................14
Servicios de Datos (DS) .................................................................................................16
Utilizacin de los Motores en Aplicaciones Externas .......................................................17
Integracin del Motor en el Proyecto ................................................................................. 17
Apertura del Motor ......................................................................................................... 18
Creacin del Cliente ....................................................................................................... 19
Motores de la Plataforma .................................................................................................. 21
Administrador PRIMAVERA ............................................................................................21
Referencias ................................................................................................................... 21
Apertura del Motor y Ejecucin del Servicio .................................................................. 22
Servicios de la Plataforma (StdPlatBS) ...........................................................................23
Referencias ................................................................................................................... 23
Ejecucin del Servicio ..................................................................................................... 23
Pg 2
VBA Visual Basic for Applications ................................................................................... 25

IDE ................................................................................................................................25
Proyecto VBA .................................................................................................................27
Macros ...........................................................................................................................27
Clases ............................................................................................................................28
Eventos .........................................................................................................................29
Mantenimientos de las Tablas Base ................................................................................... 29
Editores ........................................................................................................................ 30
Objetos ..........................................................................................................................31
Aplicacao ...................................................................................................................... 31
Plataforma PRIMAVERA ................................................................................................... 32
Campos y Tablas de Usuario ............................................................................................. 34
Campos de Usuario en las Aplicaciones ..........................................................................38
Campos de Usuario en Mantenimientos con Pestaas .......................................................... 38
Campos de Usuario en Mantenimientos sin Pestaas ........................................................... 38
Campos de Usuario en Documentos .................................................................................. 39
Tablas de Usuario ..........................................................................................................41
Pestaas y Formularios de Usuario ................................................................................... 42
Pestaas de Usuario ......................................................................................................42
Para crear una Pestaa de Usuario: .......................................................................................... 42
Formularios de Usuario ..................................................................................................48
Para crear un Formulario de Usuario: ................................................................................ 48
Funciones de Usuario........................................................................................................ 51
Ejemplos de Funciones de Usuario .................................................................................52
Mensaje de E-mail.......................................................................................................... 52
Definicin de Parmetros: .......................................................................................... 56
Definicin del Resultado: ........................................................................................... 58
Aplicacin Externa .......................................................................................................... 58
Macro VBA .................................................................................................................... 61
Consulta SQL ................................................................................................................ 63
Pg 3

Parmetros ....................................................................................................................66
Valor Fijo ...................................................................................................................... 66
Lista de Valores Fijos ...................................................................................................... 67
Lista definida a travs de una Consulta SQL ....................................................................... 68
Frmula ........................................................................................................................ 69
Funcin ........................................................................................................................ 70
Ejecucin .......................................................................................................................71
Mens de Usuario ............................................................................................................. 76
Para crear un Submen .................................................................................................. 77
Para crear un Comando .................................................................................................. 78
Procesos de Usuario ......................................................................................................... 81
Entorno de Configuracin ...............................................................................................82
Para definir las principales propiedades del Proceso............................................................. 84
Definicin de Pasos ........................................................................................................85
Definicin de Condiciones ..............................................................................................93
Definicin de Parmetros y Resultados ..........................................................................95
Entorno de Ejecucin .....................................................................................................96
Alertas de Usuario ............................................................................................................ 97
Definicin de la Alerta ....................................................................................................98
Entorno de Ejecucin ................................................................................................... 106
Resultados................................................................................................................... 107
Indicadores de Usuario ................................................................................................... 108
Definicin del Indicador ............................................................................................... 109
Navegador ...................................................................................................................... 116
Accesos directos .......................................................................................................... 119
Para crear un acceso directo a una aplicacin externa ....................................................... 119
Para crear un acceso directo a una pgina web................................................................. 120
Para crear un acceso directo a un men de la aplicacin .................................................... 122
Para crear un acceso directo a una Funcin de Usuario ...................................................... 122
Para crear un acceso directo a una Empresa .................................................................... 124
Listas ............................................................................................................................. 124
Categoras de Informacin ........................................................................................... 124
Pg 4
Creacin de Listas ........................................................................................................ 125

Ordenacin de Registros ............................................................................................... 133
Ordenacin de Columnas............................................................................................... 134
Alias .......................................................................................................................... 135
Expresiones (Valores Calculados) ................................................................................... 135
Condiciones ................................................................................................................ 137
Totales Agregados........................................................................................................ 142
Condiciones sin Totales Agregados ................................................................................. 143
Agrupacin ................................................................................................................. 144
Formatos Condicionales ................................................................................................ 144
Consulta de Listas .......................................................................................................... 147
Operaciones sobre una Lista ........................................................................................... 148
Bsquedas y Listas por Defecto ...................................................................................... 149
Categoras ...................................................................................................................... 149
Informes de Usuario ....................................................................................................... 150
Para duplicar un Informe............................................................................................... 150
Para modificar el diseo de un Informe ........................................................................... 151
Pg 5
Introduccin
La Extensibilidad de las aplicaciones es un concepto central en el ERP PRIMAVERA porque permite
completar la solucin estndar con funcionalidades adicionales e intervenir en las funcionalidades ms
importantes de cada aplicacin para responder a las necesidades especficas de cada negocio o cliente.
Este manual pretende documentar desde la perspectiva de los Partners PRIMAVERA las herramientas de
extensibilidad ms importantes del ERP PRIMAVERA, mostrando su arquitectura conceptual, ejemplos
prcticos de su aplicacin y las ventajas competitivas que ofrecen.
La informacin mostrada se refiere a la versin 8.10 de la Plataforma PRIMAVERA y a PRIMAVERA
EXECUTIVE versin 8.10.
Para consultar la versin ms actualizada de este manual, se sugiere su consulta online en PRIMAVERA
KnowledgeBase.
PKB
Manual de Extensibilidad
Pg 6
Extensibilidad
El concepto de Extensibilidad se refiere a la capacidad de modificar y extender las funcionalidades de los
diversos mdulos y aplicaciones del ERP PRIMAVERA, adaptndolos a las necesidades especficas de cada
cliente/negocio/implementacin particular.
Aunque PRIMAVERA es una empresa especializada en el desarrollo de soluciones de gestin estndar (que
tratan principalmente las reas administrativa y financiera de las empresas) no deja de ser necesario que sus
productos en particular las soluciones EXECUTIVE incluyan, y cada vez ms, tecnologas de
extensibilidad.
A lo largo del tiempo y con la evolucin de los productos PRIMAVERA se han ido desarrollando y explorando
diversas tecnologas que funcionan hoy como una herramienta muy poderos a disposicin de los servicios de
implementacin de PRIMAVERA y sus Partners. Estas tecnologas permiten, por ejemplo:
La reutilizacin de las funcionalidades del ERP a partir de aplicaciones externas;

La reutilizacin del cdigo y de las funcionalidades ms comunes que un programador necesita y que la
Plataforma PRIMAVERA ofrece;
La intervencin y la adaptacin del comportamiento de las principales funcionalidades del ERP;
La extensin de la base de datos o de las herramientas de exploracin de los datos del ERP;
La automatizacin de procesos de negocio especficos;
La integracin de soluciones y aplicaciones externas en el ERP;
La adaptacin del ERP a las necesidades de cada usuario.
Motores de las Aplicaciones

Todas las aplicaciones PRIMAVERA (a partir de la 2 Generacin) se desarrollan segn la arquitectura
Windows DNA y estndares internacionalmente reconocidos de desarrollo de componentes a travs de
capas, puestas a disposicin a travs de las DLL COM.
Esta arquitectura permite volver a usar todas las principales funcionalidades de las aplicaciones (las reglas
de negocio) a partir de cualquier otra aplicacin externa, como Microsoft Excel.
Motores de la Plataforma
La Plataforma PRIMAVERA est formada por un conjunto de componentes que ofrecen las funcionalidades
ms individuales (por ejemplo: impresin de informes o exportacin de registros) del ERP y las
funcionalidades comunes entre todos los mdulos (por ejemplo: la conexin a la base de datos o el sistema
de permisos).
Pg 7
Aunque estos componentes se han diseado en particular para su consumo por las aplicaciones
PRIMAVERA, muchas de sus funcionalidades tambin se pueden usar con aplicaciones externas a travs de
componentes (motores) que se pueden reutilizar, reduciendo el esfuerzo de desarrollo de la implementacin.
VBA Visual Basic for Applications

PRIMAVERA Business Software Solutions fue pionera en Portugal en la integracin de la tecnologa VBA
(Visual Basic for Applications) desde la versin 4.00 de la Lnea Profesional.
Esta tecnologa, internacionalmente reconocida, ofrece al programador la posibilidad de intervenir en el
comportamiento normal de la aplicacin, a travs de la implementacin de comportamiento (cdigo)
asociado a cada uno de sus eventos (ejemplos: antes de editar un cliente, despus de guardar una factura).
Campos y Tablas de Usuario

La estructura de la base de datos asociada a cada empresa registrada en el sistema PRIMAVERA puede
adaptarse creando nuevos campos en tablas del sistema (CDU Campos de Usuario) o creando nuevas
tablas (TDU Tablas de Usuario) para guardar datos adicionales.
Pestaas y Formularios de Usuario

Adems de la adaptacin del comportamiento (VBA) de las aplicaciones y de la estructura de datos (CDU y
TDU), el ERP PRIMAVERA ofrece tambin la posibilidad de intervenir en la interfaz de las aplicaciones a
travs de la creacin de nuevas pestaas en los formularios estndar (SDU Pestaas de Usuario), o de
formularios desarrollados desde el principio (FDU Formularios de Usuario) e integrados en las aplicaciones.
Funciones de Usuario
Una Funcin de Usuario (XDU) corresponde a la definicin de una accin de entre diversos tipos de
acciones disponibles (envo de mensajes, exportacin de informes, ejecucin de macros VBA, etc.) que
puede interactuar con el usuario (a travs de la solicitud de parmetros y de la presentacin de resultados) y
con el sistema (VBA, motores, etc.) para automatizar una determinada tarea.
Dadas sus caractersticas, las Funciones de Usuario son el componente central de las tecnologas de
extensibilidad de 2 Generacin (disponibles a partir de la versin 3 de la Lnea Empresarial) y sirven como
base a la implementacin de otras herramientas como los Procesos de Usuario y los Mens de Usuario.
Procesos de Usuario
Los Procesos de Usuario (PDU) permiten la definicin grfica de flujos de trabajo (secuencias de Funciones
de Usuario encadenadas entre s) que potencian la automatizacin de los procesos repetitivos (ejemplos:
Pg 8
pedidos automticos o clculos de primas) y su integracin en el ERP para implementar las necesidades
especficas de cada implementacin.
Mens de Usuario
Los Mens de Usuario permiten que los mens de las aplicaciones se completen para integrar nuevas
opciones que ejecutarn una determinada Funcin de Usuario (por ejemplo, abrir una aplicacin externa o
iniciar una determinada operacin en background).
Navegador
En esta versin el Navegador se ha reestructurado completamente. El Navegador es el punto de entrada de
todos los mdulos y ofrece al usuario un punto central para acceder a todas las funcionalidades de la
aplicacin (listas, opciones de men, documentos, accesos directos, etc.) configurado segn sus preferencias
y permisos.
Del punto de vista de la implementacin, el Navegador tambin es una gran herramienta de configuracin
porque permite:
Adaptar las funcionalidades ofrecidas por cada aplicacin a cada usuario;
Integrar herramientas y aplicaciones externas en el entorno de trabajo PRIMAVERA.
Listas
Uno de los componentes ms importantes en la implementacin de una solucin integrada de gestin est
relacionado con las herramientas de exploracin de los datos gestionados en el sistema y con su
adecuacin/adaptacin a las necesidades de cada usuario.
Desde la primera versin de las aplicaciones PRIMAVERA, las listas ofrecen el primer mtodo para acceder
a los datos principales (las listas de clientes, de documentos de venta, de cartera, etc.).
A partir de la versin 3 de la Lnea Empresarial, el ERP PRIMAVERA incluye un poderoso sistema de
configuracin asistida de listas a travs de categoras de informacin que relacionan todas las tablas en la
base de datos y permiten al usuario, entre otras operaciones:
Definir los campos de cada tabla que se deben mostrar en cada lista;
Establecer relaciones automticas entre las diversas tablas de cada categora (por ejemplo:
clientes y vendedores);
Definir filtros y condiciones para restringir los resultados y adaptarlos a las necesidades de cada
usuario;
Definir diversas opciones de configuracin y presentacin de las listas;
Pg 9
Crear listas dinmicas y parametrizadas que muestran datos diferentes segn las condiciones
seleccionadas por el usuario en la ejecucin.
Informes de Usuario
Las aplicaciones PRIMAVERA ofrecen todos los informes (impresiones) usando Crystal Reports.
Esta herramienta un estndar internacional a este nivel permite que los diversos informes de la aplicacin
se adapten (o se creen nuevos informes) segn las reglas de negocio de cada implementacin.
Tecnologas de Integracin
Los Partners PRIMAVERA tienen un papel indispensable en el negocio de PRIMAVERA. El reconocimiento
de este papel complementando las soluciones que ofrecen a los clientes finales, as como a travs de los
servicios de implementacin ha resultado en la puesta a disposicin, por parte de PRIMAVERA, de
tecnologas que facilitan la integracin de sus soluciones con las soluciones estndar.
En este momento estn disponibles las siguientes tecnologas de integracin:
La Tecnologa de Integracin PRIMAVERA (TIP): permite a los Partners Integradores el desarrollo

y la certificacin de soluciones que usan los motores de las aplicaciones PRIMAVERA y estn
integradas (segn las normas definidas) en la Plataforma EXECUTIVE (por ejemplo, el
Administrador);
La Tecnologa de Integracin Documental (TID): permite a los Partners Integradores
especializados en el desarrollo de soluciones de Gestin Documental, integrar las funcionalidades
de sus soluciones en las aplicaciones PRIMAVERA.
Pg 10
Motores de los Mdulos

Tecnologa COM y Arquitectura Windows DNA
Todas las aplicaciones PRIMAVERA se desarrollan basadas en la tecnologa COM y en la arquitectura
Windows DNA.
Este modelo de arquitectura con 3 niveles permite ofrecer el acceso a la capa intermedia a travs de
interfaces diferenciadas y de una forma que no permite destruir la lgica inherente al funcionamiento de las
aplicaciones.
Esta capa est formada por un conjunto de componentes (rutinas), que forman cerca del 70% del cdigo de
un producto, tambin conocida como Reglas del Negocio. Esta es una parte de la aplicacin cuyo cdigo
tiene grandes probabilidades de resistir a las constantes mutaciones de la tecnologa.
El acceso a la informacin a partir de la interfaz a travs del modelo de objetos de negocio garantiza el
cumplimiento de las reglas de negocio establecidas en el ERP PRIMAVERA, as como la independencia con
relacin al modelo de datos. Este es el elemento esencial de la Tecnologa de Integracin PRIMAVERA
(TIP).
Por otro lado, el uso de esta tecnologa permite que diferentes aplicaciones compartan diferentes objetos
dentro del ERP PRIMAVERA. Por ejemplo, el acceso a la ventana de Movimientos del mdulo de
Contabilidad directamente a partir del Editor de Ventas/Pedidos del mdulo de Ventas.
Pg 11
Esta posibilidad no existe solo entre los diversos mdulos del ERP, sino tambin en aplicaciones externas
que pueden usar los diferentes Motores de la Aplicacin. Por ejemplo el acceso a partir de Microsoft Excel o
de una aplicacin desarrollada por el usuario a la opcin de guardar movimientos en el mdulo de
Contabilidad o de facturas en el mdulo de Ventas.
Arquitectura de los Motores

Conceptualmente, la arquitectura del motor del ERP PRIMAVERA, estructurada en tres capas, asla el
acceso a los datos, fomentando su reutilizacin por aplicaciones externas sin colocar en causa la integridad
de los datos.
El motor de una aplicacin est formado por un conjunto de DLL COM que se pueden referenciar y usar a
partir de aplicaciones externas, bastando para ello que estn registradas en el sistema y que estn incluidas
en el proyecto correspondiente.
User
Interface
AplUS800.dll
Business
Services
ErpBS800.dll
IAplBS800.dll
AplBE800.dll
AplBS800.dll
Data
Services
ERPDS800.dll
IAplDS800.dll
AplBE800.dll
AplDS800.dll
Estructura de
datos
Pg 12
El diagrama anterior muestra la arquitectura y la organizacin del motor de uno o ms mdulos que estar
formado por las siguientes DLL:
AplBE800.dll
Objetos de negocio.
Representan las entidades gestionadas por el motor y por la aplicacin.
ErpBS800.dll
Permite el acceso a los Servicios de Negocio de cada Mdulo/rea.
IAplBS800.dll1
Implementan las interfaces para los Servicios de Negocio.
AplBS800.dll1
Servicios de Negocio.
Ponen a disposicin todas las reglas de negocio.
IAplDS800.dll1
Implementan las interfaces para los Servicios de Datos.
AplDS800.dll
Servicios de Datos.
Ponen a disposicin todos los servicios para cargar y guardar datos a partir de la
base de datos.
Objetos de Negocio (BE)

Todos los objetos de negocio (o entidades) gestionados por cada aplicacin estn disponibles a travs de
objetos simples con un conjunto de propiedades en la DLL AplBE800.dll.
La nomenclatura de los objetos es la siguiente:
<Apl>BE<Nombre>
Ejemplos:
GcpBEDocumentoVenda
GcpBEDocumentoCompra
RhpBEFuncionario
CblBEConta
(rea de Logstica & Tesorera)

(rea de Recursos Humanos)
(rea de Contabilidad)
Como ejemplo, en el caso de un Documento de Venta, el programador tendr acceso a un objeto tipo
GcpBEDocumentoVenda que est formado por un encabezado (con diversas propiedades) y un conjunto de
detalles (por ejemplo: las lneas del documento).
La sigla Apl deber sustituirse por la nomenclatura asociada a cada mdulo/rea. As, por
ejemplo, en el rea de Logstica & Tesorera ser IGcpBS800, GcpBE800
1
Pg 13
Cada objeto tendr un conjunto de propiedades que corresponden bsicamente a los campos utilizados en la
base de datos para almacenar la entidad:
Anulado
Arredondamento (Redondeo)
ArredondamentoIva (Redondeo IVA)
Cambio
CodigoPostal
CondPag
DataCarga (Fecha carga)
(...)
Servicios de Negocio (BS)

La DLL ErpBS800.dll es el punto de entrada en el motor del ERP. Esta DLL ofrece acceso a todos los
servicios del motor para cada mdulo (AplBS800.dll) que implementa todas las reglas de negocio.
Este ser el componente que se usar para acceder al motor de la aplicacin a partir de una aplicacin externa.
Al usar este componente para, por ejemplo, crear un nuevo cliente usando el motor del rea de Logstica &
Tesorera, podemos garantizar que la creacin de esta entidad respetar todas las reglas de negocio
exigidas por las aplicaciones PRIMAVERA (por ejemplo: validaciones).
Cada servicio del motor est disponible a travs de una clase a la que se puede acceder a travs de la clase
principal del motor (ErpBS). La nomenclatura de estos servicios es la siguiente:
I<Apl>BS<Nombre>
Ejemplos:
IGcpBSClientes
IRhpBSFuncionarios
ICblBSDiarios

(rea de Recursos Humanos)
(rea de Contabilidad)
En el caso del motor del rea de Logstica & Tesorera, el rbol de servicios es idntico al siguiente:
Pg 14
Cada una de las clases de servicios implementa un conjunto de mtodos tpicos que realizan las operaciones
ms importantes sobre cada tipo de entidad:
Actualiza
Introduce o actualiza una nueva entidad.
ActualizaValorAtributo
Actualiza el valor de un atributo de una entidad existente.
ActualizaValorAtributos
Actualiza el valor de diversos atributos de una entidad existente.
DaValorAtributo
Devuelve el valor de un atributo de una entidad existente.
DaValorAtributos
Devuelve el valor de diversos atributos de una entidad existente.
Edita
Devuelve una entidad existente.
Existe
Comprueba si determinada entidad existe.
Remove
Elimina una entidad del sistema.
ValidaActualizacao
Comprueba si se puede actualizar una entidad.
ValidaRemocao
Comprueba si se puede eliminar una entidad.
Como ejemplo, consideremos la firma de estos mtodos para los servicios de Clientes del rea de Logstica
& Tesorera:
Pg 15
Private Sub IGcpBSClientes_Actualiza(ByVal BECliente As GcpBECliente)

Private Sub IGcpBSClientes_ActualizaValorAtributo(ByVal strCliente As String, ByVal
strAtributo As String, ByVal varValor As Variant)
Private Sub IGcpBSClientes_ActualizaValorAtributos(ByVal strCliente As String, ByRef
Atributos As StdBECampos)
Private Function IGcpBSClientes_DaValorAtributo(ByVal strCliente As String, ByVal
strAtributo As String) As Variant
Private Function IGcpBSClientes_DaValorAtributos(ByVal strCliente As String, ParamArray
Atributos() As Variant) As StdBECampos
Private Function IGcpBSClientes_Edita(ByVal strCliente As String) As GcpBECliente
Private Function IGcpBSClientes_Existe(ByVal strCliente As String) As Boolean
Private Sub IGcpBSClientes_Remove(ByVal strCliente As String)
Private Function IGcpBSClientes_ValidaActualizacao(ByVal BECliente As GcpBECliente,
ByRef StrErro As String) As Boolean
Private Function IGcpBSClientes_ValidaRemocao(ByVal strCliente As String, ByRef StrErro
As String) As Boolean
Servicios de Datos (DS)

La DLL IAplDS800.dll ofrece los servicios de acceso a los datos (interaccin con la base de datos).
Los servicios de este componente tienen una correspondencia virtualmente directa con los mismos servicios
que los Servicios de Negocio (BS). En realidad, cada servicio del BS, siempre que tiene que acceder a la
base de datos lo hace a travs del servicio/mtodo correspondiente en el DS. Esta separacin permitira, por
ejemplo, modificar la fuente de datos adaptando solo la capa de datos (DS), sin efectuar ninguna
modificacin en la capa de las reglas de negocio (BS).
Atencin
Este componente del motor de una aplicacin nunca se debe referenciar a partir de aplicaciones externas. Sus servicios deben
ejecutarse siempre a travs de la capa de negocio (ErpBS).
Pg 16
Utilizacin de los Motores en Aplicaciones Externas

Despus de explicar la arquitectura interna del motor del ERP PRIMAVERA, solo falta demostrar sus
potencialidades a travs de un ejemplo de su utilizacin a partir de una aplicacin externa.
Consideremos el siguiente ejemplo:
El cliente tiene un sistema externo de CRM en el que registra los potenciales clientes de la empresa;
Se pretende utilizar el motor del rea de Logstica & Tesorera para registrar en el ERP PRIMAVERA
los clientes gestionados en un sistema externo de CRM, cuando estos realizan el primer pedido.
El ejemplo mostrado a continuacin se ha desarrollado en Visual Basic 6 por dos motivos:

1) Porque es la herramienta de desarrollo usada normalmente por PRIMAVERA;
2) Porque incluye funcionalidades que hacen la integracin de componentes COM muy sencilla.
Sin embargo cabe destacar que los componentes de los motores PRIMAVERA se pueden usar en otros entornos de programacin.
Todos los lenguajes de programacin ms recientes incluyen funcionalidades que permiten hacer referencia a componentes COM de
una forma ms o menos sencilla.
Integracin del Motor en el Proyecto

Para poder usar un componente COM en un proyecto VB6 solo hay que aadir las referencias adecuadas al
proyecto.
Como en el ejemplo se usa el motor del rea de Logstica & Tesorera, las referencias necesarias son las
siguientes:
PRIMAVERA StdBE 8.00

PRIMAVERA GcpBE 8.00
PRIMAVERA ErpBS 8.00
Pg 17
Apertura del Motor

Antes de poder realizar cualquier operacin a travs del motor hay que abrir la empresa de trabajo usando el
mtodo genrico AbreEmpresaTrabalho:
Private Sub cmdSincro_Click()
Dim objMotorErp As ErpBS
On Error GoTo Erro
'Apertura del 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
'Cierre del motor
objMotorErp.FechaEmpresaTrabalho
Exit Sub
Error:
MsgBox "Error al efectuar la sincronizacin." & vbCrLf & Err.Description,
vbExclamation
End Sub
El mtodo AbreEmpresaTrabalho necesita los siguientes parmetros:
Pg 18
TipoPlataforma
Versin de la Plataforma PRIMAVERA (EXECUTIVE o PROFESSIONAL).
CodEmp
Identificador de la empresa PRIMAVERA.
Utilizador
Identificador del usuario en el sistema PRIMAVERA.
Password
Contrasea del usuario.
Transaccao
Solo para uso de las aplicaciones PRIMAVERA (usar Nothing).
Instancia
Identificador de la instancia PRIMAVERA.
ModoPrimario
Siempre debe ser False.
Creacin del Cliente

Para guardar un nuevo cliente deber introducirse un objeto del tipo GcpBECliente y ejecutar el mtodo
Actualiza de IGcpBSClientes:
Private Sub cmdSincro_Click()
Dim objMotorErp
As ErpBS
Dim objCliente As GcpBECliente
Dim objClienteCRM
As Cliente
On Error GoTo Erro

'Apertura del motor
If Not (objMotorErp Is Nothing) Then objMotorErp.FechaEmpresaTrabalho
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
.CodigoPostal = objClienteCRM.CodigoPostal
.NumContribuinte = objClienteCRM.NumContribuinte
.ModoPag = objClienteCRM.ModoPag
.CondPag = objClienteCRM.CondPag
Pg 19
.Moeda = objClienteCRM.Moeda
End With
'Guardar
objMotorErp.Comercial.Clientes.Actualiza objCliente
Set objCliente = Nothing
'Cierre del motor
Exit Sub
Error:
If Not (objCliente Is Nothing) Then Set objCliente = Nothing
If Not (objMotorErp Is Nothing) Then
End If
MsgBox "Error al efectuar la sincronizacin." & vbCrLf & Err.Description,
vbExclamation
End Sub
PKB
Documentacin de Motores
Pg 20
Motores de la Plataforma
La Plataforma PRIMAVERA consiste en un conjunto de componentes, usados por todas las aplicaciones
PRIMAVERA, que ofrecen funcionalidades esenciales y comunes entre todas las aplicaciones, como por
ejemplo:
Impresin de informes;
Envo de mensajes de correo electrnico;
Formato de controles;
Gestin de transacciones;
Seguridad;
Gestin de las bases de datos;
()
Administrador PRIMAVERA
El Administrador PRIMAVERA la aplicacin de administracin general del sistema, de las empresas
registradas en el sistema y de seguridad es una parte integrante de la Plataforma PRIMAVERA.
Las funcionalidades del Administrador se muestran a travs de dos motores distintos y complementarios:
AdmEngine800.dll versin antigua del motor segn la primera generacin de la Tecnologa de

Integracin PRIMAVERA;
AdmBS800.dll nueva versin del motor del Administrador que acompaa la misma arquitectura
descrita para los motores del ERP.
Atencin
El motor AdmEngine, a pesar de ofrecer funcionalidades que an no estn disponibles en el nuevo motor, tiene su desarrollo
descontinuado. ste se sustituir completamente por lo que no se recomienda su utilizacin.
El uso del motor del Administrador es bsicamente idntico al descrito para el motor del ERP. Consideremos
el siguiente ejemplo:
Se pretende obtener una lista de las empresas registradas en el sistema PRIMAVERA.
Referencias
PRIMAVERA AdmBE 8.00

PRIMAVERA AdmBS 8.00
Pg 21
Apertura del Motor y Ejecucin del Servicio
Private Sub cmdUsers_Click()

Dim objMotorAdm
As AdmBS
Dim objListaEmpresas
As AdmBEEmpresas
Dim objEmpresa
As AdmBEEmpresa
On Error GoTo Erro

Set objMotorAdm = New AdmBS
objMotorAdm.AbrePRIEMPRE tpEmpresarial, m_strUtilizador, m_strPassword, Nothing,
m_strInstancia
Set objListaEmpresas = objMotorAdm.Empresas.ListaEmpresas
For Each objEmpresa In objListaEmpresas
'(...)
Next
Set objListaEmpresas = Nothing
objMotorAdm.FechaPRIEMPRE
Set objMotorAdm = Nothing
Exit Sub
Error:
If Not (objListaEmpresas Is Nothing) Then Set objListaEmpresas = Nothing
If Not (objMotorAdm Is Nothing) Then Set objMotorAdm = Nothing
MsgBox "Error al obtener la lista de usuarios." & vbCrLf & Err.Description,
vbExclamation
End Sub
Pg 22
Servicios de la Plataforma (StdPlatBS)

Los servicios comunes de la Plataforma PRIMAVERA estn disponibles a travs del componente
StdPlatBS800.dll.
Este componente tiene una estructura de servicios idntica a la siguiente:
Estos servicios estn disponibles a partir de las aplicaciones PRIMAVERA en el entorno de desarrollo VBA
(PlataformaPRIMAVERA) pero tambin se pueden usar a partir de una aplicacin externa. Uno de los
ejemplos ms comunes de esta aplicacin prctica es la impresin de informes.
Referencias

PRIMAVERA StdPlatBS 8.00
Ejecucin del Servicio

Private Sub cmdPrint_Click()
Dim objPlat
As StdPlatBS
Dim objConfApl
As StdBSConfApl
Dim strFormula
As String
Dim strSelFormula
As String
On Error GoTo Erro
Pg 23
Set objConfApl = New StdBSConfApl

objConfApl.AbvtApl = m_strApl
objConfApl.Instancia = m_strInstancia
objConfApl.Utilizador = m_strUtilizador
objConfApl.PwdUtilizador = m_strPassword
Set objPlat = New StdPlatBS
objPlat.AbrePlataformaEmpresaIntegrador m_strEmpresa, Nothing, objConfApl,
tpEmpresarial
Set objPlat.MDIForm = MDIForm1
objPlat.Mapas.Inicializar
strFormula = "NumberVar TipoDesc;NumberVar RegimeIva;NumberVar DecQde;NumberVar
DecPrecUnit;StringVar MotivoIsencao; TipoDesc:=" & 1 &
";RegimeIva:=3;DecQde:=1;DecPrecUnit:=" & 2 & ";MotivoIsencao:=' ';"
objPlat.Mapas.AddFormula "InicializaParametros", strFormula
strFormula = "StringVar Nome; StringVar Morada;StringVar Localidade; StringVar
CodPostal; StringVar Telefone; StringVar Fax; StringVar Contribuinte; StringVar
CapitalSocial; StringVar Conservatoria; StringVar Matricula;StringVar
MoedaCapitalSocial;"
strFormula = strFormula & "Nome:='HEIM'"
strFormula = strFormula & ";Localidade:='Tocadelos'"
strFormula = strFormula & ";CodPostal:='1000 Loures'"
strFormula = strFormula & ";Telefone:='219750801'"
strFormula = strFormula & ";Fax:='219750801'"
strFormula = strFormula & ";Contribuinte:='123456789'"
strFormula = strFormula & ";CapitalSocial:='123'"
strFormula = strFormula & ";Conservatoria:='321'"
strFormula = strFormula & ";Matricula:='213'"
strFormula = strFormula & ";MoedaCapitalSocial:='EUR'"
strFormula = strFormula & ";"
objPlat.Mapas.AddFormula "DadosEmpresa", strFormula
strSelFormula = "{CabecCompras.Filial}='000' And {CabecCompras.Serie}='2004' And
{CabecCompras.TipoDoc}='" & Text1.Text & "' And {CabecCompras.NumDoc}= " & Text2.Text
objPlat.Mapas.AddFormula "NumVia", "'Original'"
objPlat.Mapas.SelectionFormula = strSelFormula
objPlat.Mapas.ImprimeListagem "GCPCLS01", "TESTE", "W", 1, "S", strSelFormula,
soNenhuma, , True
objPlat.FechaPlataformaEmpresa
Set objPlat = Nothing
Pg 24
Set objConfApl = Nothing

Exit Sub
Error:
If Not (objPlat Is Nothing) Then Set objPlat = Nothing
If Not (objConfApl Is Nothing) Then Set objConfApl = Nothing
MsgBox "Error: " & Err.Number & " - " & Err.Description
End Sub
PKB
Documentacin de Motores
VBA Visual Basic for Applications

Microsoft Visual Basic for Applications (VBA) permite extender la solucin PRIMAVERA, creando
funcionalidades personalizadas, aplicaciones de productividad y soluciones que superan el mbito de los
mdulos del ERP.
Los implementadores de las soluciones PRIMAVERA, que conocen el entorno de programacin Visual Basic,
descubrirn en VBA un entorno familiar y confortable. Como se trata de una tecnologa ampliamente
divulgada como una herramienta de programacin, es lgico que las soluciones PRIMAVERA la ofrezcan
como tecnologa principal de extensibilidad que permite:
Acceder a los objetos mantenidos y usados en el contexto de cada una de las principales operaciones
mantenimiento de clientes, editores de ventas, etc.;
Asociar cdigo a determinados eventos desencadenados por las operaciones ms importantes de las
aplicaciones;
Crear pestaas de usuario para editar los campos de usuario asociados a cada entidad;
Crear formularios de usuario;
Integrar los desarrollos realizados en la solucin PRIMAVERA, a travs de las Funciones de Usuario
que se pueden asociar al Navegador o a los Mens de Usuario.
IDE
IDE (Integrated Development Environment) de VBA es una ventana que surge al usuario por separado de la
ventana principal de la aplicacin asociada.
Puede accederse a todas las herramientas de desarrollo de VBA a partir de este IDE, incluidos Project
Explorer, Object Browser, el editor de cdigo, la interfaz de diseo de formularios y el debugger.
Pg 25
Propiedades
Project Explorer
Interfaz de
diseo de
formularios
Object Browser
Editor de
cdigo VB
Pg 26
Proyecto VBA
Los proyectos VBA tienen dos papeles principales. Primero, incluyen los elementos del proyecto. Segundo,
almacenan todo el cdigo VBA.
Un proyecto VBA puede consistir en:
Mdulos de cdigo (Code Modules): incluyen declaraciones, procedimientos y funciones;
Clases (Class Modules): permiten una programacin orientada por objetos, agrupando
procedimientos, funciones y declaraciones en una clase;
Formularios (Forms): permiten crear poderosas interfaces;
Referencias (References): permiten la reutilizacin de cdigo a partir de otros proyectos.
El ERP PRIMAVERA v8.10 ofrece un nico proyecto VBA que incluye todas las clases de todos los mdulos
compatibles con VBA. Independientemente de los mdulos que estn disponibles en el ERP, existe solo un proyecto
que ofrece todas las funcionalidades.
Macros
Una macro corresponde a una subrutina VBA pblica sin cualquier parmetro. Normalmente deben definirse
en Class Modules y servirn como punto de entrada para una determinada funcionalidad disponible en el
proyecto.
IDE de VBA ofrece un dilogo propio que ayuda al usuario a trabajar con este tipo de cdigo VBA.
Pg 27
Este dilogo enumera todas las macros disponibles en un proyecto, permitiendo que el usuario las edite,
elimine o ejecute.
PKB
Cmo crear una Macro?
Clases
Todos los proyectos VBA asociados a las aplicaciones PRIMAVERA ofrecen de base un conjunto de clases
que permiten extender las principales funcionalidades de esta aplicacin.
Estas clases pueden reconocerse en el project explorer de VBA, en el primer nodo:
Todos los objetos

disponibles en un
nico proyecto
Por lo general, en cada rea estn disponibles tres tipos de clases:
Pg 28
Fichas (p. ej.: FichaArtigos): estn asociadas al mantenimiento de las principales tablas de la
aplicacin;
Editores (p. ej.: EditorVendas): estn asociadas a funcionalidades de edicin de documentos o clculos;
Otras (p. ej.: Empresa).
Eventos
Conceptualmente, un evento corresponde a una accin reconocida por uno de los objetos del proyecto por
ejemplo, pulsar una tecla o seleccionar un botn y para la que se puede producir cdigo como respuesta.
Un evento puede desencadenarse a travs del sistema, como resultado de una accin del usuario o a partir
de cdigo.
El proyecto VBA ofrece un conjunto de eventos de sistema asociados a cada una de las clases descritas
antes. Estos eventos sern el punto de partida para personalizar la solucin ofrecida por PRIMAVERA.
Los siguientes ejemplos muestran algunos usos posibles de los eventos de sistema para modificar el
comportamiento de la aplicacin:
Siempre que se edita un cliente en el mantenimiento correspondiente se desencadenar un evento.

Este evento puede, por ejemplo, usarse para escribir cdigo que modifique algunas de las propiedades
del cliente segn otros datos del sistema;
Cuando se identifica un artculo en las lneas de un documento de venta, el evento correspondiente
podr implementar reglas de negocio adicionales no implementadas en el rea de Logstica &
Tesorera.
Mantenimientos de las Tablas Base

Cada formulario de mantenimiento de las tablas base de las aplicaciones PRIMAVERA tiene una clase VBA
asociada. Estas clases ofrecen un conjunto de eventos estndar:
AntesDeAnular
Desencadenado inmediatamente antes de anular el registro activo.
AntesDeEditar
Desencadenado antes de editar un registro nuevo o un registro existente.
AntesDeGravar
Inmediatamente antes de guardar el registro activo.
DepoisDeAnular
Desencadenado inmediatamente despus de anular un registro.
DepoisDeEditar
Inmediatamente despus de editar un registro.
DepoisDeGravar
Inmediatamente despus de guardar un registro.
TeclaPressionada
Desencadenado siempre que se pulsa una tecla.
AntesDeCriar
Desencadenado cuando se abre un nuevo mantenimiento.
Pg 29
Los eventos AntesDe

permiten cancelar la
operacin
Editores
Los eventos disponibles en las operaciones de edicin de documentos o clculo dependen de cada caso en
particular.
Como ejemplo, la clase EditorVendas (asociada al formulario de edicin de documentos de venta del Mdulo
de Ventas) ofrece los siguientes eventos:
AntesDeAnular
Antes
Antesde
deiniciar
iniciarlaa anulacin
anulao do
deldocumento.
documento.
AntesDeDuplicar
Antes de duplicar un documento
AntesDeEditar
Antes de editar un documento.
AntesDeGravar
Antes de guardar el documento actual.
AntesDeImprimir
Antes de imprimir el documento actual.
AntesDeIntegrar
Antes de integrar/guardar en la Base de Datos despus de mostrar la

ventana de enlace a Contabilidad o Tesorera.
AntesDeProcessar
Antes de mostrar la ventana de enlace a Contabilidad o Tesorera.
ArmazemIdentificado
Momento en el que se identifica el almacn de un artculo.
ArtigoInexistente
Despus de seleccionar un artculo inexistente.
ArtigoIdentificado
Despus de seleccionar el artculo en una lnea del documento.
ClienteIdentificado
Despus de seleccionar el cliente asociado al documento.
DepoisDeAnular
Despus de anular un documento.
DepoisDeDuplicar
Despus de duplicar un documento.
Pg 30
DepoisDeEditar
Despus de editar un documento.
DepoisDeGravar
Despus de guardar un documento.
DepoisDeImprimir
Despus de imprimir un documento.
Objetos
En cada una de las clases de sistema, adems de los eventos correspondientes, el proyecto VBA tambin
ofrece objetos que permiten acceder y usar los datos asociados al formulario/funcionalidad correspondiente.
Puede accederse a estos objetos usando el identificador Me:
Aplicacao
El objeto Aplicacao ofrece un conjunto de propiedades relacionadas con la aplicacin asociada al proyecto
VBA:
MotorERP
Motor de la aplicacin.
DescricaoVersao
Descripcin de la versin de la aplicacin.
Empresa
Datos de la empresa activa.
Instancia
Instancia PRIMAVERA activa.
TipoPlataforma
Versin de la Plataforma PRIMAVERA.
Pg 31
Utilizador
Datos del usuario activo.
VBA
Modelo de objetos de VBA.
VersaoVBA
Versin de VBA.
Plataforma PRIMAVERA
Las principales funcionalidades de la Plataforma PRIMAVERA y de su motor (ver StdPlatBS) estn
disponibles a travs de este objeto. Se trata de un subconjunto de los mismos mtodos usados por las
aplicaciones para:
Usar campos de usuario;

Ejecutar formularios de usuario;
Formatear consultas SQL;
Etc.
Pg 32
PKB
Visual Basic for Applications (VBA)
Pg 33
Campos y Tablas de Usuario

El ERP PRIMAVERA permite crear campos adicionales en las tablas del sistema. Esta funcionalidad permite
mantener otros datos no compatibles con la solucin estndar de cualquier entidad (clientes,
proveedores, trabajadores, etc.), tablas auxiliares o tablas de documentos o movimientos.
El Administrador PRIMAVERA ofrece un asistente para facilitar la creacin de nuevos campos de usuario.
Pg 34
Inmediatamente despus de instalar el sistema PRIMAVERA, estarn disponibles campos de usuario en las principales
entidades (artculos, clientes, proveedores, etc.).
Pg 35
Pg 36
Atencin
El nombre fsico de los campos de usuario debe empezar por el prefijo CDU_ para que el sistema los reconozca correctamente.
Pg 37
Campos de Usuario en las Aplicaciones

La utilizacin de los campos de usuario creados se realiza dentro de las propias aplicaciones.
La forma cmo se efecte esta utilizacin depender de la complejidad de la tabla.
Campos de Usuario en Mantenimientos con Pestaas

En los mantenimientos ms complejos que incluyan pestaas (pginas de edicin de los diversos campos),
los campos de usuario podrn editarse directamente en el formulario a travs de una pestaa creada
automticamente para ello.
Campos de Usuario en Mantenimientos sin Pestaas

En las tablas ms sencillas (sin pestaas), la edicin de campos de usuario est disponible en un formulario
independiente, al que se accede a travs del botn Contexto de la base de herramientas.
Pg 38
Campos de Usuario en Documentos

Dada la especificidad de las ventanas de edicin de documentos o de movimientos, los campos de usuario
asociados (al encabezado o a las lneas) tambin estarn disponibles en un formulario independiente.
Pg 39
En cualquiera de los casos anteriores, la edicin de los campos de usuario puede modificarse segn las necesidades
del usuario, a travs de la creacin de Pestaas de Usuario y de la asociacin de cdigo VBA para implementar reglas
de negocio ms complejas.
Pg 40
Tablas de Usuario
Las tablas de usuario permiten, tal y como los Campos de Usuario, extender una base de datos PRIMAVERA
para que sea compatible con el mantenimiento de datos adicionales otras entidades no disponibles en la
solucin estndar.
Una Tabla de Usuario es un conjunto de Campos de Usuario no asociados a ninguna de las tablas del
sistema.
Para crear una nueva TDU debe utilizarse el mismo asistente disponible en el Administrador, indicando el
nombre de la tabla, los campos de usuario disponibles y las aplicaciones en la que estar disponible la nueva
tabla.
Atencin
El nombre fsico de los campos de usuario debe empezar por el prefijo TDU_ para que el sistema los reconozca correctamente.
Despus de crear una tabla de usuario en una base de datos PRIMAVERA, si sta obedece a las reglas
mencionadas, estar inmediatamente disponible en las aplicaciones correspondientes y podr accederse a
ella a travs de la opcin Tablas de Usuario en el men Herramientas.
Pg 41
PKB
Campos de Usuario
Tablas de Usuario
Pestaas y Formularios de Usuario

Pestaas de Usuario
Las Pestaas de Usuario (SDU) permiten modificar la interfaz estndar de edicin de campos de usuario y
asociar cdigo VBA al mantenimiento de los campos de usuario de cualquier entidad de las aplicaciones.
Despus de definir la primera pestaa de usuario en una tabla de la aplicacin, la pestaa estndar automtica de
edicin descrita antes desaparecer y dar lugar a las pestaas definidas por el usuario.
Para crear una Pestaa de Usuario:

1.
Seleccionar la opcin Pestaas de Usuario en el men Herramientas del ERP en el que se desea
crear la pestaa de usuario. Se abrir el entorno de desarrollo VBA que ayudar al usuario en la edicin
de la pestaa (en el caso de que la barra de herramientas PRIMAVERA no est visible, deber hacerse
visible):
Pg 42
2.
Seleccionar la entidad para la que se desea crear la pestaa. En el men de contexto, seleccionar
New (en este ejemplo se ha escogido la entidad Tablas - Clientes). Se crear un nuevo formulario
vaco:
Pg 43
3.
Configurar las propiedades de la pestaa:
Pg 44
4.
Disear la pestaa, adicionando los campos de usuario asociados a la entidad y otros controles:
El entorno VBA permite aadir cualquier control de terceros con licencia (fabricantes de controles para VBA). Existen
ndices de controles disponibles en la web. En estos sitios web podrn encontrarse controles para efectuar virtualmente
cualquier tipo de operacin en las pestaas de usuario.
5.
A continuacin, puede introducirse el cdigo especfico para implementar reglas de negocio

especficas:
Pg 45
La solucin PRIMAVERA ofrece el entorno VBA configurado para ser compatible con las entidades lgicas PRIMAVERA
(campos de usuario, pestaas de usuario, etc.).
Del mismo modo, en cada pestaa estn disponibles diversos eventos que le permiten programar el funcionamiento de
la pestaa de una forma simplificada.
6.
Guardar el proyecto VBA y volver al ERP PRIMAVERA.
Pg 46
Pg 47
Formularios de Usuario
Los Formularios de Usuario (FDU) corresponden a formularios (o forms) desarrollados en el mbito del
proyecto VBA asociado a cada aplicacin.
A diferencia de las Pestaas de Usuario, no estn asociados a ninguna de las tablas del sistema, por lo que
se pueden usar para implementar otras funcionalidades, como por ejemplo:
Edicin de tablas de usuario;

Edicin de tablas almacenadas en bases de datos externas al sistema PRIMAVERA;
Implementacin de reglas de negocio especficas sin conexin a la base de datos.
En trminos prcticos un FDU corresponde directamente a un User Form de VBA. Sin embargo, este
concepto permite la extensin de la solucin PRIMAVERA de una forma ms integrada, ya que permite
asociar cada FDU a una funcin de usuario y as mostrar el formulario al usuario:
En los mens de la aplicacin (a travs del concepto de Mens de Usuario);

A partir del Navegador (creando accesos directos a los mens de la aplicacin);
A partir del proyecto VBA, usando los objetos disponibles a travs de la Plataforma PRIMAVERA.
Para crear un Formulario de Usuario:

1.
Seleccionar la opcin Formularios de Usuario del men Herramientas del ERP. Se abrir el entorno
de desarrollo VBA para ayudar al usuario a editar el formulario;
2.
Activar la barra de herramientas Formularios. En el men de contexto, seleccionar Nuevo

Formulario. Se crear un nuevo formulario vaco:
Pg 48
3.
Configurar las propiedades del formulario;
4.
Disear el formulario aadiendo los controles necesarios:
Pg 49
5.
A continuacin, puede introducirse el cdigo especfico para implementar reglas de negocio

especficas:
Pg 50
6.
Guardar el proyecto VBA y volver a la aplicacin PRIMAVERA.
A partir de este momento, el nuevo formulario est disponible para asociarlo a una Funcin de Usuario.
PKB
Pestaas de Usuario
Formularios de Usuario
Una Funcin de Usuario (XDU) corresponde a una determinada accin ejecutada por el sistema
PRIMAVERA que implementa una determinada regla de negocio.
Este nuevo concepto central en las aplicaciones a partir de la versin 6.0 permite extender la solucin
PRIMAVERA para garantizar todas las reglas de negocio especficas de cada empresa. Por ejemplo:
Envo de mensajes de correo electrnico o SMS personalizados para cada empresa;

Ejecucin de procedimientos almacenados o consultas en la base de datos de la empresa;
Ejecucin de formularios de usuario o macros VBA;
Exportacin y envo por correo electrnico de informes de usuario;
Ejecutar otras utilidades externas o documentos.
La Plataforma PRIMAVERA ofrece los siguientes tipos de Funciones de Usuario:

E-mail
Para el envo de mensajes de correo electrnico.
SMS
Para el envo de mensajes SMS.
Aplicacin Externa
Para la ejecucin de aplicaciones o documentos externos.
Macro VBA
Para la ejecucin de macros definidas en el proyecto VBA de la

empresa.
Formulario de Usuario
Para la ejecucin de Formularios de Usuario.
Informe de Usuario
Procedimiento
almacenado
Para la exportacin y envo por correo electrnico de informes de

usuario.
Para la ejecucin de procedimientos almacenados existentes en la base
de datos de la empresa.
Pg 51
Funcin definida por el

usuario
Para la ejecucin de funciones definidas por el usuario existentes en la

base de datos de la empresa (disponible solo en SQL Server 2000 o
superior).
Consulta SQL
Para la ejecucin de consultas SQL ad-hoc.
Dependiendo del tipo, cada Funcin de Usuario permite definir:
Parmetros de entrada: que permiten hacerla dinmica y adaptable a diversas

situaciones idnticas;
Resultados: en forma de valores discretos (numricos o alfanumricos), listas de valores
o listas de registros.
Los siguientes tpicos analizan la creacin de cada uno de los tipos de funciones de usuario disponibles, la
definicin de parmetros y de sus resultados, as como su ejecucin en las aplicaciones PRIMAVERA.
El concepto de Funcin de Usuario sirve como base a la implementacin de Mens y Procesos de Usuario.
Ejemplos de Funciones de Usuario

Mensaje de E-mail
Para crear una Funcin de usuario para enviar mensajes de correo electrnico, deben seguirse los siguientes
pasos:
1.
Seleccionar la opcin Funciones de Usuario del men Herramientas del ERP;
2.
La siguiente ventana muestra todas las funciones de usuario disponibles en el sistema. Seleccionar
Nueva...:
Pg 52
3.
En la siguiente ventana puede definir las propiedades de la funcin de usuario. En la primera pgina
introducir el nombre de la funcin, seleccionar el tipo E-mail e introducir una descripcin ms
detallada:
Pg 53
Campo
Nombre
Tipo de Funcin
Activa
4.
Descripcin
Nombre de la Funcin
Tipo de Funcin
Si est activa, la funcin puede ejecutarse
En la pestaa Definicin debe configurarse el mensaje:
Pg 54
Campo
Para
Asunto
Mensaje
Adjuntos
5.
Descripcin
Destinos del mensaje
Asunto del mensaje
Contenido del mensaje
Posibilidad de adjuntar archivos
Seleccionar Confirmar.
Con este ejemplo se obtendra una Funcin de Usuario que permitira el envo de un mensaje electrnico al
destino director.financeiro@clientepreferido.pt. Esta funcin podra ejecutarse en el ERP PRIMAVERA a
partir de la ventana de funciones de usuario, de un men de usuario o de un acceso directo en el Navegador.
Pg 55
Sin embargo, una XDU de este tipo no sera de gran utilidad porque solo permitira enviar un correo
electrnico a uno o varios destinos fijos.
La Plataforma PRIMAVERA permite que este concepto se extienda a travs de la definicin de parmetros.
De este modo, una misma funcin de usuario podr usarse para enviar avisos de vencimiento a cualquier
cliente.
Definicin de Parmetros:
En las funciones de usuario de tipo E-mail, el usuario debe establecer los parmetros, en cualquiera de los
campos de la definicin, usando una sintaxis particular (@@NombreDelParametro@@).
Volviendo al ejemplo anterior, suponiendo que se pretenda que la funcin de usuario permitiera:
Enviar avisos de vencimiento a cualquier cliente;

Adaptar el contenido del mensaje a cada caso;
Su ejecucin independientemente de la empresa de trabajo.
Para alcanzar estos objetivos, la definicin anterior podra modificarse de la siguiente forma:
Pg 56
Parmetros que definen

el destino del mensaje.
Parmetro que se
adaptar al nombre de
la empresa de trabajo
Extracto del cliente
A medida que el usuario define los parmetros usando la sintaxis esperada, la aplicacin efectuar su
reconocimiento y estos se mostrarn en la pgina Parmetros/Resultado:
Pg 57
Parmetros definidos
por el usuario
Valores asociados
En este punto pueden definirse todas las caractersticas de cada uno de los parmetros de la Funcin de Usuario (tipo
de datos, valor por defecto, lista de valores, etc.). Para ms informacin, consultar la seccin Parmetros.
Definicin del Resultado:
Las funciones del tipo E-mail no permiten definir resultados de su ejecucin.
Aplicacin Externa
Para crear una Funcin de Usuario que permita la ejecucin de aplicaciones o documentos externos a la
solucin PRIMAVERA deben seguirse los siguientes pasos:
1.
2.
Nueva...;
3.
introducir el nombre de la funcin, seleccionar el tipo Aplicacin Externa e introducir una descripcin
ms detallada:
Pg 58
4.
En la pgina Definicin debe indicarse la ubicacin de la aplicacin externa:
Pg 59
Campo
Comando
Parmetros
Dir. Inicial
Ejecutar (Ventana)
5.
Descripcin
Ubicacin de la Aplicacin
Parmetros
Directorio Inicial
Estado inicial de la ventana
El usuario puede personalizar la ejecucin de aplicaciones externas.

El ejemplo anterior podra configurarse para permitir la apertura dinmica de hojas de clculo:
Pg 60
La ejecucin de aplicaciones externas permite definir la gestin que se desea realizar del resultado
Definicin del resultado de

ejecucin de la Funcin de
Usuario
Puede indicar dos tipos de resultado:
Ninguno: el motor de ejecucin no gestionar el resultado de la ejecucin;

Entero: la aplicacin ejecutada producir un exit code que el motor gestionar al final de
la ejecucin.
Macro VBA
Para crear una Funcin de Usuario para ejecutar macros definidas en el proyecto VBA deben seguirse los
siguientes pasos:
1.
2.
Nueva...;
3.
introducir el nombre de la funcin, seleccionar el tipo Macro VBA e introducir una descripcin ms
detallada:
Pg 61
4.
En la pgina Definicin seleccionar la macro a ejecutar:
Proyecto VBA
Lista de macros
disponibles en el proyecto
VBA actual
Pg 62
5.
Atencin
La definicin de las macros debe efectuarse previamente en el proyecto VBA de la aplicacin o en proyecto compartido (entre todas
las aplicaciones).
En la lista de macros se incluirn todas las macros (procedimientos sin parmetros o resultados), los procedimientos pblicos (con o
sin parmetros) y las funciones pblicas (con o sin parmetros) definidos en el proyecto VBA de la aplicacin o en el proyecto comn
de la empresa activa.
La macro seleccionada definir los parmetros de la funcin:
Esta Macro tiene en su cdigo VBA como parmetro de entrada la variable Usuario de tipo String.
El resultado de la funcin de usuario tambin se determinar a travs de la definicin de la macro. El valor

que esta Macro devuelve es un Booleano.
Consulta SQL
Para crear una Funcin de Usuario para ejecutar consultas SQL deben seguirse los siguientes pasos:
1.
Pg 63
2.
Nueva...;
3.
introducir el nombre de la funcin, seleccionar el tipo Query SQL e introducir una descripcin ms
detallada:
4.
En la pgina Definicin seleccionar la consulta SQL a ejecutar:
Comprobar la sintaxis de
la instruccin SQL
Instruccin SQL a ejecutar
Pg 64
5.
Los parmetros de la Funcin de Usuario pueden definirse segn la sintaxis descrita anteriormente:
Pg 65
El resultado de la Funcin de Usuario debe definirlo el usuario.

La forma como el motor de ejecucin interpreta el recordset resultante de la consulta SQL depende del tipo
de resultado seleccionado por el usuario:
Ninguno: la consulta SQL no devuelve ningn resultado;

Texto, Entero, Numrico, Fecha, Booleano: la consulta devuelve un recordset con solo un
registro y una sola columna, que se debe interpretar segn el tipo de datos seleccionado;
Lista de registros: la consulta devuelve un recordset con diversos registros y diversas
columnas.
Parmetros
Cada parmetro de una funcin de usuario tiene asociada la siguiente informacin:
Nombre: define un identificador nico para cada funcin;

Tipo de Datos: define el intervalo de posibles valores;
Tamao: define (para los tipos de datos en los que importa) el tamao mximo del valor;
Obligatorio: define si el parmetro es necesario para ejecutar la funcin;
Valor: define el valor discreto asociado a cada parmetro en el momento de ejecutar la
funcin.
Los siguientes tipos de datos son compatibles:
Texto (p. ej.: F0001);

Entero (p. ej.: 120);
Numrico (p. ej.: 120,58);
Fecha (p. ej.: 12-12-1973);
Booleano (p. ej.: Verdadero).
Normalmente, para que una funcin de usuario se pueda ejecutar correctamente, el valor correspondiente a
cada uno de los parmetros obligatorios deber definirse en el momento de ejecucin. Sin embargo, el
mdulo de configuracin de Funciones de Usuario permite definir el valor por defecto, los posibles valores o
efectuar el clculo del valor como resultado de expresiones.
Valor Fijo
En este caso, se asignar al parmetro seleccionado un valor discreto que el usuario puede o no modificar
despus en el momento de ejecucin de la funcin.
Pg 66
Seleccionando esta opcin, el

usuario podr modificar el
valor en el momento de la
ejecucin
Lista de Valores Fijos

Tambin se puede definir una lista de posibles valores fijos para el parmetro seleccionado. En este caso,
inmediatamente antes de que se ejecute la funcin, el usuario podr seleccionar el valor de la lista.
Lista de valores fijos
Valor por defecto
Posibles valores
Permitir o no que el
usuario introduzca un valor
que no est en la lista
Pg 67
Lista definida a travs de una Consulta SQL

Tambin se puede definir la lista de posibles valores a partir de una consulta ejecutada en la base de datos
inmediatamente antes de ejecutar la funcin de usuario:
Tabla
Campos a incluir en la
consulta SQL
La consulta SQL tambin se puede editar manualmente:
Consulta SQL usada para

rellenar la lista de posibles
valores
Pg 68
Finalmente, hay que indicar el campo de la consulta que se debe usar para determinar el valor del parmetro
y otras opciones:
Permitir o no que el
usuario introduzca un valor
que no est en la lista
Campo a usar para

determinar el valor del
parmetro
Valor por defecto
Frmula
En este caso el valor del parmetro lo determinar el resultado de la ejecucin de una frmula.
Lista de todas las

funciones de usuario cuyo
resultado sea compatible
con el tipo de datos del
parmetro
Pg 69
El valor resultante de la expresin se determinar inmediatamente antes de que se ejecute la funcin. La

expresin puede incluir:
Operadores (p. ej.: +);

Campos dependientes del contexto (p. ej.: %%UTILADMIN%%);
Funciones (p. ej.: IIF).
La Plataforma ofrece los siguientes tipos de campos:

Empresa
Valores dependientes de la empresa activa (Cdigo, Nombre, etc.).
Aplicacin
Valores dependientes de la aplicacin activa (Abreviatura, Nombre, etc.).
Usuario
Valores dependientes del usuario activo (Usuario, Nombre, etc.).
Perfil
Valores dependientes de los perfiles del usuario (Perfil y Descripcin).
Base de Datos
Valores dependientes de la base de datos activa (Nombre y Servidor).
Tambin son compatibles los siguientes tipos de funciones:

Conversin
Funciones de conversin de datos (p. ej.: Asc).
Fecha/Tiempo
Funciones sobre fechas o tiempo (p. ej.: DateSerial).
Genricas
Funciones genricas (p. ej.: IIF).
Matemticas
Funciones matemticas (p. ej.: Power).
Texto
Funciones de texto (p. ej.: UCase).
Atencin
La expresin/frmula asociada al valor del parmetro deber respetar la sintaxis VBScript.

Los campos de contexto se identifican con la sintaxis @@NombreDelCampo@@.
Funcin
En este caso el valor del parmetro lo determinar el resultado de la ejecucin de otra funcin de usuario.
Las funciones de usuario que tengan parmetros definidos de este modo, desencadenarn la ejecucin de
todas las funciones del usuario dependientes, inmediatamente antes de su propia ejecucin.
Pg 70
Ejecucin
Una funcin de usuario puede ejecutarse (botn "Ejecutar"):
A partir del formulario de configuracin de funciones:
Como resultado de un men de usuario;

A partir del Navegador;
Como consecuencia de la ejecucin de un proceso de usuario.
Exceptuando el ltimo caso mencionado, la ejecucin de la funcin de usuario se realizar inmediatamente,

interactuando con el usuario para:
Solicitarle los valores de todos los parmetros (no definidos completamente en la

configuracin);
Mostrarle los resultados (si aplicable).
Ejemplo
Para ejemplificar este comportamiento consideremos la definicin de una funcin de usuario con las
siguientes caractersticas:
Pg 71
1.
Se pretende obtener una lista con los clientes que tengan un volumen de ventas superior a un
determinado valor en un determinado mes;
2.
Para este efecto, se ha definido un procedimiento almacenado TopClientes en la base de datos con
dos parmetros: el mes del que se desea obtener la lista de clientes y el valor mnimo de ventas a
considerar;
3.
Tambin se pretende que el resultado se muestre al usuario.
La definicin de la funcin de usuario sera la siguiente:
Pg 72
Pg 73
Inmediatamente antes de la ejecucin de la funcin, se le pediran al usuario todos los parmetros, en un

formulario idntico al siguiente:
Valor fijo
Lista de Valores
El resultado de la funcin en este caso, una lista de registros, se mostrar al usuario:
Registros resultantes de la
ejecucin de la funcin
Operaciones disponibles en
la lista de registros
Pg 74
El envo de mensajes SMS se efecta asncronamente. Es decir, siempre que se ejecuta una funcin de usuario de tipo
SMS, el mensaje correspondiente se colocar en una cola de espera para enviar. El envo se realizar a travs de la
aplicacin Gestin de Procesos PRIMAVERA segn el calendario de ejecucin definido.
PKB
Pg 75
Mens de Usuario
Esta herramienta permite extender los mens de cualquier aplicacin PRIMAVERA, aadiendo nuevos
comandos asociados a funciones de usuario que ejecutan determinadas acciones cuando el usuario los
selecciona.
El usuario puede crear un nuevo submen y ste aparece inmediatamente en el rea de Mens de Usuario
del ERP. Puede configurar otros submens y comandos.
Ningn men de usuario
Pg 76
Cada uno de los comandos los elementos de men que ejecutan algo cuando estn seleccionados se
asociarn a una funcin del usuario (responsable por la ejecucin).
Para crear un Submen

1.
Seleccionar Mens de Usuario en el men Herramientas del ERP. Se abrir el formulario de

configuracin de los mens de usuario:
2.
Seleccionar el submen en el que se desea crear el nuevo submen y seleccionar Submen;
3.
En la siguiente ventana introducir el ttulo del submen y la tooltip asociada:
Pg 77
4.
Seleccionar Confirmar para volver al formulario inicial.
Puede modificarse el ttulo del men Otros, seleccionando el nodo correspondiente en la ventana anterior y
seleccionando Propiedades.
Despus de definir los mens de usuario hay que acceder al Administrador para definir los permisos de acceso. Hasta
aqu, solo tendrn acceso a los nuevos mens los administradores de sistema.
Puede reorganizarse el orden de los elementos de cada submen utilizando las flechas disponibles en la ventana.
Para crear un Comando

1.
Seleccionar el submen en el que se desea crear el nuevo comando y seleccionar Comando;
Pg 78
2.
En la ventana siguiente introducir el ttulo del comando, la "tooltip" asociada y la funcin del usuario a
ejecutar:
Esta lista muestra todas

las funciones de usuario
disponibles en el sistema.
Botones para crear una

nueva funcin o editar una
funcin seleccionada
La funcin de usuario puede recibir parmetros y producir un resultado.

Cuando el usuario selecciona un determinado comando, se le solicitan todos los parmetros necesarios antes de la
ejecucin. Despus de ejecutar la funcin ser mostrado el resultado correspondiente (si existe).
3.
Seleccionar Confirmar para volver al formulario inicial.
Pg 79
El botn Propiedades permite editar el elemento seleccionado, el botn Anular permite eliminar el
elemento seleccionado.
Men de usuario con el

comando creado
PKB
Mens de Usuario
Pg 80
Procesos de Usuario
Los Procesos de Usuario (PDU) complementan las Funciones de Usuario, permitiendo la ejecucin
programada de secuencias de acciones (funciones) en un servidor, sin intervencin del usuario.
Usando este mecanismo, el usuario tiene a su disposicin una herramienta de automatizacin de tareas
repetitivas, capaz de implementar reglas de negocio especficas.
Para ilustrar este concepto, consideremos los siguientes ejemplos de tareas programables como Procesos de
Usuario:
Pedidos automticos: control de todos los artculos en ruptura de stock y consecuente

creacin de pedidos automticos;
Notificaciones por Email: envo de mensajes de notificacin siempre que determinada
condicin/evento ocurra (p. ej.: creacin de un nuevo cliente, venta de un determinado
producto, inicio de sesin de determinado usuario);
Publicacin de informes de ventas: envo peridico de informes de gestin para la fuerza
de ventas.
Adems de complementar el concepto de Funcin de Usuario, un Proceso de Usuario extiende la solucin

PRIMAVERA porque proporciona una herramienta de implementacin alternativa a VBA. Aunque este ltimo
se pueda usar para implementar procesos de negocio bastante complejos, los Procesos de Usuario facilitan
casi siempre esta tarea:
Porque el entorno de configuracin no exige conocimientos de programacin es ms

accesible a usuarios con menos experiencia;
Porque ofrecen un entorno de ejecucin programada en un servidor autnomo y
escalable (con los recursos adecuados);
Porque se ejecutan sin que sea necesaria la intervencin del usuario;
Porque incluyen mecanismos bsicos de workflow.
Conceptualmente un Proceso de Usuario consiste en:
Uno o ms pasos (en los que cada uno corresponde a una Funcin de Usuario)
ejecutados de forma secuencial;
Cero o ms condiciones que permiten adaptar la ejecucin del proceso a travs del
resultado de cada uno de los pasos;
La definicin de los parmetros de entrada y de los resultados de cada uno de los pasos
(encadenados entre s);
Un calendario que define el momento de ejecucin;
Un conjunto de otras propiedades (notificaciones, gestin de errores, descripciones, etc.)
que permiten configurar su comportamiento.
Pg 81
Atencin
El uso de funciones de usuario en procesos de usuario est sujeto a las siguientes limitaciones:
(1) Macro VBA solo se pueden usar funciones de este tipo si stas apuntan a macros definidas en el proyecto del ERP;
(2) Informes de usuario solo se pueden usar funciones de este tipo si estn configuradas para enviar el informe por email o
exportar a un directorio en el disco.
Entorno de Configuracin
El entorno de configuracin de los Procesos de Usuario est disponible en el men Herramientas.
Seleccionando esta opcin en el men principal, el usuario podr acceder a la ventana de definicin de los
Procesos de Usuario. Este formulario permite crear nuevos procesos, as como ejecutar, modificar, duplicar o
eliminar los existentes.
Para crear un nuevo proceso bastar con seleccionar la opcin Nuevo.... De esta forma, surge el entorno de
configuracin asistida.
Pg 82
Barra de Herramientas
Toolbox de Funciones de
Usuario
rea de diseo
Estado de la ejecucin
Este entorno es muy visual y sus principales caractersticas son:
Barra de herramientas: incluye un conjunto de opciones para guardar, configurar y

ejecutar el proceso de usuario;
Toolbox: incluye los elementos necesarios para crear nuevos pasos o condiciones al
proceso;
rea de diseo: rea visual que permite configurar los pasos y el flujo de ejecucin del
proceso;
Estado de ejecucin: registro de ejecuciones del proceso;
Inicio del Proceso: estado inicial del proceso (permite acceder a sus propiedades);
Fin del Proceso: estado final del proceso (marca el final de la ejecucin).
El principal componente del entorno es el rea de diseo, en la que se efectuarn todas las configuraciones
del proceso. Pueden crearse nuevos pasos o condiciones arrastrando el elemento correspondiente hasta el
rea en blanco. Puede modificarse cada uno de los elementos usando la opcin Propiedades, en el men
de contexto. Y puede modificarse el flujo de ejecucin enlazando cada paso y condicin.
Pg 83
Para definir las principales propiedades del Proceso

1.
Seleccionar el elemento Inicio del Proceso;
2.
En el men de contexto, seleccionar Propiedades.
Podr accederse al formulario de propiedades del Proceso de Usuario:
Nombre y descripcin del

proceso
Opcin para permitir la

ejecucin programada del
proceso
Notificaciones automticas
durante la ejecucin
Definicin del calendario de

ejecucin
Pg 84
Definicin de Pasos
Despus de definir las principales propiedades del proceso, el siguiente paso debe ser la definicin de los
pasos que lo forman. Para ilustrar este procedimiento consideraremos de nuevo el ejemplo de pedidos
automticos. Las condiciones son las siguientes:
Existen en la base de datos dos procedimientos almacenados (RupturaStockA1 y

EncomendasAuto);
El primer procedimiento no exige ningn parmetro y devuelve un valor numrico que
corresponde al nmero de unidades necesarias para reponer el stock del artculo A1;
El segundo procedimiento acepta dos parmetros el cdigo de artculo y el nmero de
unidades a pedir y realiza un pedido al proveedor de ese artculo.
Para crear un proceso de usuario que automatice este procedimiento deberan seguirse los siguientes pasos:
1.
Seleccionar la opcin Procesos de Usuario en el men Herramientas del ERP;
2.
Seleccionar Nuevo;
3.
Seleccionar el nodo Inicio del Proceso y seleccionar Propiedades en el men de contexto;
4.
Definir las principales propiedades del proceso:
Pg 85
5.
Activar la pgina Planificacin, activar Ejecutar Peridicamente y seleccionar Editar:
6.
Definir el calendario del proceso y seleccionar Aceptar;
7.
De nuevo en la ventana de propiedades, seleccionar Aceptar;
8.
En la "toolbox", seleccionar el elemento Procedimiento almacenado y arrastrarlo al rea de diseo (se

crear un nuevo paso y la ventana de propiedades de este paso se abrir automticamente);
9.
Introducir el nombre y la descripcin del nuevo paso:
Este comando permite

crear una nueva funcin de
usuario
Pg 86
10.
Seleccionar la opcin de creacin de una nueva funcin de usuario;
11.
Definir las propiedades de la funcin de usuario y confirmar:
Pg 87
12.
En las propiedades del paso, seleccionar la funcin que se acaba de crear:
13.
La pgina Configuracin indica los parmetros y el resultado del paso (a partir de la definicin de la
Funcin de Usuario). Seleccionar Aceptar (se crear un nuevo nodo en el rea de diseo del proceso
correspondiente al nuevo paso):
Pg 88
14.
Crear un nuevo paso correspondiente a la ejecucin del segundo procedimiento almacenado:
Pg 89
Pg 90
15.
Deben definirse los parmetros del segundo paso de la siguiente forma:
Pg 91
Pg 92
16.
A continuacin, definir el flujo de ejecucin enlazando los varios nodos entre s:
Flechas de flujo de
ejecucin
17.
Guardar el Proceso de Usuario.
Definicin de Condiciones
Una herramienta fundamental para que los Procesos de Usuario se adapten mejor a cada situacin est
relacionada con la definicin de condiciones que modifican el flujo de ejecucin a travs de determinados
criterios.
Imaginar el siguiente ejemplo:
Se pretende implementar un proceso de anlisis de ventas capaz de efectuar el clculo
de primas (en el caso de que las ventas superen el valor del presupuesto) o enviar
notificaciones (en el caso contrario);
Existe un paso implementado como un procedimiento almacenado que compara el

valor de las ventas con el valor presupuestado. Devuelve 0 si est por debajo del
presupuesto o 1 en el caso contrario;
Este proceso ejecutar el segundo paso dependiendo del primero (el anlisis de ventas).
La definicin del Proceso sera idntica a la siguiente:
Pg 93
Este ejemplo ilustra el uso de una condicin para adaptar el mismo proceso a dos situaciones distintas.
La definicin de la condicin sera la siguiente:
Pg 94
Definicin del paso anterior

a la condicin
Condicin a aplicar al
resultado del paso anterior
Acciones dependientes del

resultado de la condicin
Definicin de Parmetros y Resultados

La definicin de los parmetros y resultados de cada uno de los pasos de un proceso es idntico al que se
debe efectuar en las Funciones de Usuario.
Defecto
El valor del parmetro depender de la definicin en la Funcin de Usuario

asociada al paso.
Frmula
El valor se calcular con base a una frmula.
Funcin
El valor se determinar a travs del resultado de una determinada funcin

de usuario.
Resultado del paso

anterior
El valor se determina a travs del resultado del paso anterior.
Valor fijo
El usuario debe definir el valor que ser fijo en todas las ejecuciones del
proceso.
El resultado del paso se determina siempre a travs de la definicin de la funcin de usuario asociada.
Los tipos de valores asociados a los parmetros dependern del tipo de datos del parmetro y de los dems pasos
definidos. Por ejemplo, en el caso de que no exista ningn paso que devuelva un valor de tipo Entero, no se podr
definir, para un parmetro de este tipo, un valor Resultado del paso anterior.
Pg 95
Entorno de Ejecucin
Los Procesos de Usuario se ejecutan normalmente a travs de la aplicacin Gestin de Procesos
PRIMAVERA en una mquina configurada como servidor.
Su ejecucin se realizar, segn el calendario definido, cuando el servidor est disponible (por ejemplo,
cuando haya terminado la ejecucin de otro proceso o el envo de mensajes SMS).
A efectos de las pruebas, puede ejecutarse un proceso de usuario a partir del entorno de configuracin
(descrito en los puntos anteriores).
Por ltimo, un proceso puede ejecutarse de forma explcita, a peticin de un usuario, a partir de un acceso
directo configurado en el Navegador. En este caso, su calendario se ignorar y el proceso se ejecutar
inmediatamente.
PKB
Procesos de Usuario
Pg 96
Alertas de Usuario
Las Alertas de Usuario son la nueva forma de definir alertas, mucho ms parametrizable, permitiendo al
usuario controlar de forma ms detallada un conjunto de informacin crtica que necesita avisos peridicos.
La periodicidad de las alertas tambin se puede definir en su configuracin, adaptndose as a las
necesidades de cada perfil de usuario.
Para ilustrar esta funcionalidad, considerar algunos ejemplos de informacin adaptable a una Alerta de
Usuario:
Certificaciones no facturadas;
Aperturas de Propuestas, de Concursos, en los prximos 5 das;
Documentos de cartera vencidos para pagar;
Pedidos pendientes sin recibir;
Antigedades vencidas de los trabajadores;
Reclculo con stock negativo;
Revisin de precios no facturados en Obras.
Para cada una de estas opciones puede crearse una Alerta de Usuario.
El entorno de configuracin y visualizacin de las Alertas de Usuario est disponible en el men
Herramientas.
Seleccionando esta opcin, el usuario podr acceder a la ventana de presentacin de las Alertas de Usuario.
Pg 97
Este formulario permite crear nuevas alertas, as como ejecutar, modificar, duplicar o eliminar las existentes.
Para crear un nuevo proceso bastar con seleccionar la opcin Nuevo. De esta forma, surge un asistente
que permitir crear una nueva Alerta.
Definicin de la Alerta
Para explicar mejor los varios pasos necesarios para crear una Alerta de Usuario usaremos un ejemplo.
Ejemplo
Creacin de una alerta que permita a los usuarios obtener informacin peridica sobre los cumpleaos de los
trabajadores de la empresa.
Pg 98
En este caso se selecciona la opcin Filtrar para definir la categora de la lista correcta. La lista deseada se
obtiene a travs de un procedimiento almacenado previamente creado en el Ejercicio. Todos los
procedimientos almacenados existentes se muestran en la categora <Consultas SQL>.
Seleccionar la lista correspondiente: Alertas Cumpleaos.
Pg 99
Opcionalmente, puede optarse por seguir la configuracin por defecto, pasando directamente a la definicin
de los usuarios con acceso a la alerta. En este ejemplo, se desactiva la opcin para poder efectuar una
configuracin ms detallada.
Pg 100
Se define cmo se desean mostrar los resultados. Se muestran los resultados de la ltima ejecucin de la
alerta o se selecciona la opcin con aviso cuando Tiene resultados/Sin resultados.
Se indica si los resultados deben enviarse como notificacin y si se deben publicar. En ambas opciones debe
definirse el comportamiento.
Pg 101
Indicar si la alerta es una:

- Alerta de uso Privado: solo el usuario actual tiene acceso;
- Alerta de uso Pblico: indicar qu perfiles y usuarios correspondientes tienen acceso a la alerta.
Todos los usuarios

existentes
Todos los perfiles definidos

en el sistema.
Opcionalmente, definir si la alerta es independiente del usuario que la ejecuta. Definir si se puede o no
ejecutar manualmente y a partir de cunto tiempo deja de estar actualizada. Tambin se puede programar la
ejecucin de la alerta.
Pg 102
Puede programarse la
ejecucin de la alerta de
forma automtica a travs
de Windows Scheduler.
Indicar el nombre, la descripcin, la prioridad y la categora correspondiente de la Alerta de Usuario.
Activar la alerta creada o aadirla al Monitor de Negocio.
Pg 103
La nueva alerta aparece asociada a la categora correspondiente.
Pg 104
Indica que la alerta est

accesible solo para el
usuario actual (ningn
otro usuario puede
acceder a la alerta).
Aade la alerta al Monitor

de Negocio.
Indica que la alerta est
en el monitor de negocios.
Pg 105
Entorno de Ejecucin
A pesar de tratarse de una alerta con ejecucin programada, puede procederse de inmediato a la ejecucin
(procesamiento) de su informacin asociada, con el envo inmediato de un email a los destinatarios
correspondientes.
Para ello, basta con usar la opcin Ejecutar de la barra de herramientas o del men de contexto.
Como se ha mencionado antes, durante la creacin de la Alerta, o ms tarde editando una alerta creada,
puede programarse la ejecucin correspondiente.
Pg 106
Resultados
La prxima vez que alguno de los usuarios destinatarios de la Alerta entre en el ERP, se le mostrar el
Monitor de Negocio que incluir, entre otra informacin, un lugar especfico para visualizar sus alertas.
Puede accederse al Monitor de Negocio a travs de la opcin Monitor de Negocio del men Usuario del
ERP.
PKB
Alertas de Usuario
Pg 107
Indicadores de Usuario
Los Indicadores de Usuario son una funcionalidad que permite que cada usuario observe, de forma rpida y
fcil, un conjunto de informacin pertinente.
El entorno de configuracin y visualizacin de los Indicadores de Usuario est disponible en el men
Herramientas.
Seleccionando esta opcin, el usuario podr acceder a la ventana de presentacin de los Indicadores de
Usuario existentes.
Para ilustrar esta funcionalidad, considerar algunos ejemplos de informacin que se puede visualizar como
un Indicador de Usuario en dos reas distintas del ERP:
rea de Recursos Humanos
Antigedad;
Formacin;
Nmero Efectivo por Sexo;
Porcentajes de Absentismo;
Dimisiones
rea de Ventas
Pg 108
Crecimiento de las ventas (%);

Ventas - 5 mejores clientes (mes actual);
Ventas - 10 mejores artculos (mes actual);
Rentabilidad mensual (ao actual y anterior).
Para cada una de estas opciones puede crearse un Indicador de Usuario.

Este formulario de configuracin de los Indicadores de Usuario permite crear nuevos indicadores, as como
ejecutar, modificar, duplicar o eliminar los existentes.
Para crear un nuevo indicador basta con seleccionar la opcin Nuevo. De esta forma, surge un asistente
que permitir al usuario configurar un nuevo indicador.
Definicin del Indicador

Para explicar mejor los varios pasos necesarios para crear un Indicador de Usuario usaremos un ejemplo.
Ejemplo
Creacin de un indicador que permita que los usuarios obtengan informacin sobre los Artculos que se
encuentran entre los 10 mejores del mes actual. Probablemente este indicador mostrar informacin
diferente a lo largo del mes ya que el anlisis se efectuar siempre que se ejecute el indicador
correspondiente. Al seleccionar la ejecucin diaria, se obtiene una imagen diaria actualizada sobre la
informacin deseada.
Seleccionar el origen de los datos del indicador:
Lista de registros: por defecto muestra las listas da la categora "Categora de Artculos";
Comandos SQL: permite la introduccin de una consulta SQL.
En este caso se trata de informacin obtenida a travs de un comando SQL.
Pg 109
Pg 110
Opcionalmente, usar la opcin por defecto en el caso de que se deseen usar las opciones ms comunes en
la definicin de un indicador sencillo. En este caso no se usar la configuracin por defecto. As, se desactiva
la opcin.
Indicar las acciones que el sistema efectuar automticamente despus de ejecutar el indicador:
Enviar notificaciones de los resultados usando: permite el envo de los resultados a

travs de SMS/Correo electrnico a los usuarios que tengan la alerta en el Monitor de
Negocio;
Publicar resultados para: permite publicar los resultados en un archivo o un sitio FTP.
Las dos opciones deben configurarse correctamente accediendo e introduciendo los datos de las "Opciones".
Pg 111
Indicar el mbito del indicador:
Indicador de uso privado: solo tendr acceso al indicador el usuario actual;

Indicador de uso pblico: se definen los perfiles/usuarios con acceso al indicador.
Pg 112
Programar la ejecucin del indicador para que ocurra todos los das a las 00:00 horas. De esta forma, el
grfico resultado del indicador obtiene sus datos sobre la informacin de ventas realizadas el da anterior.
Indicar los datos generales del indicador: nombre, descripcin, presentacin de los resultados (Grfico o Lista
de Registros) y categora.
Pg 113
Por ltimo, deber seleccionarse el tipo de grfico que servir de apoyo a la presentacin de los resultados
grficos del Indicador.
Pg 114
El Indicador estar disponible en la lista de Indicadores de Usuario, en la que eventualmente se podr

ejecutar. El Indicador tambin se puede incluir en el control del servicio Monitor de Negocios.
PKB
Alertas de Usuario
Pg 115
Navegador
El Navegador ofrece al usuario la posibilidad de configurar el entorno de trabajo en cada uno de los Mdulos,
adaptndolo a sus necesidades. Usando esta funcionalidad, el usuario podr:
Configurar sus propias vistas sobre los datos ms importantes del ERP;
Consultar y editar registros (de tablas base o documentos);
Aadir accesos directos para aplicaciones o documentos externos.
En la perspectiva del administrador de sistema, responsable por la configuracin de la solucin PRIMAVERA,

el Navegador suministra las herramientas necesarias para adaptarla a cada perfil de usuarios:
Garantizando que cada usuario tiene acceso a toda la informacin relevante para su
trabajo, en el formato correcto;
Permitiendo la implementacin de reglas de seguridad adicionales;
Ofreciendo todas las herramientas de extensibilidad de forma completamente integrada
con la aplicacin.
Como herramienta de productividad, el Navegador es, normalmente, un configurador de accesos directos y

listas. Est integrado en cada una de las aplicaciones, como muestra la siguiente imagen:
Pg 116
Mostrar/Ocultar el
Navegador
Botn de contexto.
Acceso directo para todos

los Mdulos del ERP (ver
siguiente imagen)
Pg 117
Mdulos del ERP con

navegacin en rbol
PKB
Navegador
Pg 118
Accesos directos
El usuario podr crear los siguientes tipos de accesos directos:
Listas;
Aplicaciones externas;
Documentos;
Pginas web;
Mens de la aplicacin;
Funciones de Usuario;
Procesos de Usuario;
Empresas.
Todos los accesos directos pueden organizarse y agruparse en carpetas, con una estructura idntica a la
disponible en Windows para organizar los archivos.
Para crear un acceso directo a una aplicacin externa

1.
En el men de contexto del Navegador, seleccionar Nuevo/Aplicacin Externa;
2.
En la siguiente ventana, seleccionar la aplicacin externa y definir las dems propiedades del acceso
directo:
Pg 119
3.
El acceso directo queda disponible en los mens Mis favoritos
Para crear un acceso directo a una pgina web
Pg 120
1.
En el men de contexto del Navegador, seleccionar Nuevo/Pgina web;
2.
En la siguiente ventana, introducir la direccin de la pgina o seleccionar una de las pginas

disponibles en los favoritos del Internet Explorer:
Pg 121
Para crear un acceso directo a un men de la aplicacin

1.
En el men de contexto del Navegador, seleccionar Nuevo/Men;
2.
En la siguiente ventana, seleccionar los mens de la aplicacin para los que se desean crear accesos
directos en el Navegador (pueden crearse diversos accesos directos simultneamente)
Para crear un acceso directo a una Funcin de Usuario

1.
En el men de contexto del Navegador, seleccionar Nuevo/Funcin de Usuario;
2.
En la siguiente ventana, seleccionar la funcin que se desea asociar al acceso directo:
Pg 122
Lista de todas las

funciones de usuario
disponibles.
Para crear un acceso directo a un Proceso de Usuario:

1.
En el men de contexto del Navegador, seleccionar Nuevo/Proceso de Usuario;
2.
En la siguiente ventana, seleccionar el proceso que se desea asociar al acceso directo:
Lista de todos los procesos

de usuario disponibles
Pg 123
Para crear un acceso directo a una Empresa

1.
En el men de contexto del Navegador, seleccionar Nuevo/Empresa;
Lista de las empresas

registradas para la
aplicacin activa.
2.
En la siguiente ventana, seleccionar la empresa que se desea asociar al acceso directo:
La creacin de accesos directos para empresas ofrece un mecanismo para abrir rpidamente una determinada
empresa. Esta herramienta es muy til en instalaciones con muchas empresas, como por ejemplo en las gestoras
contables.
PKB
Navegador
Listas
Categoras de Informacin
La creacin de listas permite:
Pg 124
El acceso a todos los datos de una determinada entidad, adems del concepto de tablas;
La configuracin de filtros, condiciones y ordenaciones sobre los datos de cada entidad;
Otras funcionalidades de manipulacin de datos, como por ejemplo exportaciones.
As, todos los datos de cada Mdulo/rea estn organizados en Categoras que agrupan todas las tablas
relevantes para obtener la informacin importante sobre una determinada entidad.
En la prctica, esto significa que la categora de Clientes ofrece todos los datos sobre los clientes. Adems
de la tabla asociada, incluir datos de vendedores, ventas, contactos, monedas, etc.
As, el Navegador se transforma en la principal fuente de datos del usuario y en una herramienta
imprescindible para configurar la solucin y adaptarla a cada situacin.
Las categoras disponibles dependen de cada una de las aplicaciones. Como ejemplo, se muestran ms
abajo algunas de las categoras del rea de Logstica & Tesorera:
ALGUNAS
CATEGORAS
DE
LOGSTICA &
TESORERA
Almacenes;
Bancos;
Cuentas Bancarias;
Documentos de Compra;
Documentos de Stocks;
Documentos de Venta;
Modos de Expedicin;
Movimientos Bancarios;
Movimientos de Compras;
Movimientos Compras (transf. lneas);
Movimientos de Cartera Lneas;
Movimientos de Tesorera Lneas;
Movimientos de Ventas;
Movimientos Ventas (transf. lneas);
Socios;
Tablas Artculos;
Tablas Clientes;
Tablas Contactos;
Tablas Otros Terceros;
Vendedores;
Zonas.
Creacin de Listas
Para crear una nueva lista, deben seguirse los siguientes pasos:
1.
En el men de contexto del Navegador, seleccionar Nuevo Acceso directo/Lista;
Pg 125
2.
Seleccionar la categora en la que se desea crear una nueva lista y seleccionar Nueva...:
3.
En el primer paso del asistente de creacin de listas, seleccionar Siguiente:
4.
Seleccionar, a partir de cada tabla, las columnas de la lista que forman la categora de informacin:
Todas las tablas
disponibles en la categora
seleccionada.
Todos los campos

disponibles en la tabla
seleccionada.
Opciones adicionales que

permiten definir
ordenaciones, alias y
expresiones.
Pg 126
5.
En el paso siguiente pueden definirse expresiones condicionales para filtrar los datos de la lista a travs
de determinados criterios:
Filtros sobre los datos de

la lista.
6.
A continuacin, pueden definirse totalizadores en las columnas numricas seleccionadas previamente:
Pg 127
7.
Despus pueden definirse agrupaciones lgicas sobre los registros:
8.
En el paso siguiente pueden definirse formatos condicionales a aplicar a los registros de la lista:
Pg 128
9.
Indicar si se desea o no, previsualizar el resultado:
Pg 129
En este paso tambin puede definir las siguientes opciones avanzadas de la lista:
Pg 130
Nmero mximo de
registros
Eliminar registros
duplicados
Modo de apertura de
la lista
10.
Permite limitar el nmero mximo de registros mostrados en el resultado

de la lista. Esta opcin puede ser til en listas con muchos registros y en
las, en principio, sea posible prever que el registro buscado est entre los
primeros.
Permitir eliminar todos los registros repetidos en la lista, mostrando solo
uno.
Define si la paginacin de los registros se efecta en memoria en el cliente
o en el servidor. La primera opcin ofrece el mximo rendimiento para
listas con pocos registros o listas en las que sea normal recorrer todos los
registros. La segunda opcin se recomienda para listas con muchos
registros y siempre que sea posible prever el uso inmediato de registros
existentes en las primeras pginas (reduciendo la comunicacin y los datos
transferidos del servidor).
Seleccionando la opcin de vista previa se mostrar el resultado en el paso siguiente:
Resultado de la aplicacin
del formato condicional.
11.
Finalmente, debe indicarse el nombre de la nueva lista y la disponibilidad correspondiente para los
dems usuarios:
Pg 131
Al finalizar el asistente, la nueva lista estar disponible para aadir al Navegador:
Pg 132
Al confirmar, la lista se aade al men Mis favoritos.
Ordenacin de Registros
Puede definir hasta cinco criterios de ordenacin de los registros de la lista.
Ordenacin de los
registros
Para definir los criterios de ordenacin debe indicar cada uno de los campos de ordenacin y el orden
correspondiente:
Pg 133
Cada una de estas listas

muestra todos los campos
visibles en la lista.
Ordenacin de Columnas
El orden de las columnas en la lista puede definirse en el formulario de creacin de la lista:
Usar las flechas para

definir el orden de las
columnas en la lista.
Pg 134
Alias
En determinadas situaciones, por ejemplo en listas resultantes de la agregacin de varias tablas, puede ser
necesario cambiar el nombre de algunas columnas:
Usar esta opcin para

modificar el alias del
campo seleccionado.
Expresiones (Valores Calculados)

Tambin se pueden definir columnas en la lista como resultado de expresiones calculadas (a partir de otras
columnas de la lista).
Para aadir una nueva expresin debe seleccionarse el botn correspondiente en el asistente de creacin de
listas:
Pg 135
Estas opciones permiten

definir valores calculados.
Se mostrar un formulario que permite definir la expresin calculada:
Columnas disponibles en la
lista.
Operadores.
Expresin.
Nombre de la expresin.
Alias.
Pg 136
Condiciones
Una expresin condicional permite definir una condicin que filtrar los resultados de la lista a travs de un
determinado criterio.
Esta es la funcionalidad ms importante de las listas porque permite que el usuario pueda definir listas
configuradas segn sus necesidades de informacin y esto facilita:
El enfoque en los datos ms relevantes;

La obtencin de toda la informacin importante sobre cada entidad;
El formato de vistas diferentes de estos datos;
El desempeo general de la aplicacin, ya que al filtrar los datos se reduce la cantidad de
informacin a la que se accede a cada momento, acelerando su procesamiento.
El mdulo de configuracin de las listas permite definir tantas condiciones cuantas sean necesarias y es
compatible con la combinacin de expresiones usando los operadores lgicos Y/O.
Para crear una nueva expresin condicional:
1.
En la lista de expresiones condicionales, seleccionar Nueva...:
2.
Seleccionar la columna en la que se desea aplicar la condicin:
Seleccionar la tabla entre

las que forman la
categora.
Seleccionar la columna en
la que se desea aplicar la
condicin.
Operador condicional (los

operadores disponibles
dependen del tipo de datos
de la columna
seleccionada).
Tipo de condicin. Puede

definirse un valor fijo,
relacionar la columna con
otra o definir una condicin
parametrizable.
Pg 137
3.
Definir la condicin y seleccionar Aceptar:
Las diversas condiciones definidas pueden combinarse en subexpresiones a las que se aplicarn los
operadores lgicos Y/O.
Para crear una subexpresin en la lista de expresiones condicionales, seleccionar Subexpresin y el tipo de
subexpresin a crear:
Definir todas las condiciones que se desean combinar en la subexpresin:
Para crear una expresin parametrizable:

Algo que hace que este mdulo sea especialmente funcional es la posibilidad de parametrizar cada una de
las condiciones definiendo una lista de posibles valores para la condicin:
Pg 138
Usar esta opcin para

definir la lista de posibles
valores de la columna.
Existen dos opciones:
Puede crearse una lista de valores fijos:
Pg 139
O crear una lista de valores resultante de la ejecucin de una consulta en la base de

datos:
Pg 140
Esta configuracin dar lugar a una lista parametrizada. Siempre que el usuario inicie su edicin, se le
solicitarn todos los valores parametrizados. Esto permite, por ejemplo, definir listas genricas que se
adaptan a las necesidades del usuario a todo momento.
Pg 141
Totales Agregados
Pueden definirse totalizadores en cualquiera de los campos numricos definidos en la lista. Estn disponibles
las siguientes operaciones:
Contador;
Suma;
Media;
Mnimo;
Mximo;
Desviacin estndar;
Contador de los valores.
Pg 142
Condiciones sin Totales Agregados

Pueden definirse condiciones sin totales agregados:
La forma de parametrizar la obtencin de resultados es idntica a las opciones explicadas anteriormente en

la seccin Condiciones.
Pg 143
Agrupacin
Esta funcionalidad est limitada a un nmero mximo de cuatro agrupaciones.
El resultado de la agrupacin ser idntico al siguiente:
Formatos Condicionales
Los formatos condicionales permiten destacar en la lista los registros que obedecen a una determinada
condicin.
Para crear un nuevo formato condicional:
Pg 144
1.
En la lista de formatos condicionales, seleccionar Nueva...:
2.
Seleccionar la columna en la que se desea aplicar el formato;
3.
Definir la condicin;
4.
Seleccionar los colores de las letras y del fondo que se aplicar a los registros que obedezcan al
criterio:
Pg 145
Pueden combinarse varios formatos condicionales en la misma lista.

Cada uno de los formatos condicionales se aplicar de forma secuencial a cada uno de los registros de la lista, segn el
orden definido en el asistente de configuracin.
Pg 146
Consulta de Listas
Se puede acceder y pueden consultarse todas las listas configuradas por el usuario desde:
El Navegador, a partir de accesos directos;

Mantenimientos asociados (en la barra de herramientas):
Bsquedas (F4) efectuadas a partir de diversos formularios de la aplicacin:
Pg 147
Operaciones sobre una Lista

Ms que una herramienta de consulta de datos, las listas ofrecen al usuario un conjunto de funcionalidades
que permiten usar los datos para obtener informacin adicional, efectuar su publicacin y usarla como
soporte de las ms variadas funciones de gestin. Las operaciones sobre las listas y sus datos estn
disponibles en la barra de herramientas y en el men de contexto:
Listas de la Categora;
Edicin de Registros;
Filtros Rpidos;
Bsquedas Rpidas;
Bsquedas;
Drill Down;
Ordenacin de Registros;
Impresin de la Lista;
Impresin de Informes;
Exportacin de Registros;
Envo de Mensajes por email;
Creacin de Accesos directos para Registros;
Servicio de Localizacin.
Pg 148
Bsquedas y Listas por Defecto

Todas las bsquedas de registros, en cualquiera de los formularios de la aplicacin, se efectuarn en las
listas definidas para la categora correspondiente.
Por ejemplo, en el editor de ventas del mdulo de Ventas, la bsqueda del cliente (usando la tecla F4) se
efectuar en una de las listas definidas en la categora de clientes. En el caso de que no exista ninguna lista
definida por el usuario, se usar la lista de sistema. En caso contrario, se usar la que se haya definido como
lista por defecto para el usuario activo.
La lista por defecto para cada categora puede definirse de dos formas:
En el Administrador PRIMAVERA, por el administrador de sistema, para cada empresa y

para los varios usuarios registrados en el sistema;
En las preferencias de sistema (disponibles en la aplicacin) por cada usuario, desde que
tenga permisos para ello.
La primera opcin ser especialmente til para el usuario responsable por la configuracin inicial del sistema.
La segunda opcin deber usarse en el caso de los usuarios con permisos ms avanzados o con
necesidades adicionales de flexibilidad para usar la aplicacin.
PKB
Listas
Categoras
Pueden condicionarse resultados a travs de la aplicacin de condiciones durante el proceso de creacin de
listas o en la edicin de sus propiedades. Una expresin condicional consiste en la definicin de una
restriccin que filtra los resultados de las listas a travs de un criterio. Esta es una de las funcionalidades ms
importante de las listas, ya que permite que el usuario defina listas configuradas exactamente segn la
informacin del usuario.
Sin embargo, pueden existir situaciones/decisiones en las que este procedimiento se aplica
transversalmente, es decir, a la propia informacin de la categora. Este escenario consiste
fundamentalmente en una o ms expresiones condicionales transversales a todas las listas asociadas a una
categora. Resumiendo, las listas siempre tienen una expresin condicional indicada en la categora.
PKB
Cmo aplicar condiciones a las categoras?
Pg 149
Informes de Usuario
Los productos PRIMAVERA permiten que el usuario configure cualquier informe o listado a su gusto. Las
posibilidades ofrecidas por la herramienta de creacin de informes, Crystal Reports, del productor
mundialmente conocido Business Objects del cual PRIMAVERA Business Software Solutions es el
representante portugus exclusivo son inmensas.
Todos los informes o listados creados a partir del software PRIMAVERA usan Crystal Reports. Los
programas ofrecen en cada opcin una configuracin, que se ha tipificado como <SIST>, es decir, la
configuracin del sistema, la configuracin segn PRIMAVERA Business Software Solutions. El usuario no
debe modificar este informe. En el caso de que desee realizar alguna modificacin, debe duplicarlo y
asignarle un nuevo nombre. As se garantiza que en caso de accidente o de un uso incorrecto, el usuario no
daar los informes de base incluidos en los programas.
Para duplicar un Informe

1.
En la ventana de Mantenimiento de Informes, seleccionar el informe que se desea duplicar;
2.
Seleccionar la opcin Duplicar y confirmar esta accin;
Pg 150
3.
Asignar un nuevo nombre al informe y confirmar. Al salir de la opcin, el nuevo informe surge en la
ventana de Mantenimiento de Informes.
Para modificar el diseo de un Informe

1.
Seleccionar el Informe cuya configuracin se desea modificar;
2.
Seleccionar la opcin Propiedades. Acceder a la siguiente ventana:
3.
Acceder a Crystal Reports a travs de la opcin Editar. En el caso de que este programa no est
instalado en su sistema, la aplicacin muestra un mensaje de aviso;
4.
Despus de realizar las modificaciones en el informe, stas deben guardarse en Crystal Reports antes
de salir del programa. A partir de este momento, el usuario puede utilizar su informe siempre que lo
desee.
El uso de Crystal Reports se explica en el manual que acompaa al producto, en formato digital o a travs de la ayuda
de este programa. Crystal Reports es un producto desarrollado en ingls y su grado de dificultad de uso va desde muy
fcil hasta lo ms difcil, dependiendo de lo que el usuario pretende.
PKB
Informes de Usuario
Pg 151
Pg 152

ManualdeExtensibilidad ERP810ES PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

ManualdeExtensibilidad ERP810ES PDF

Uploaded by

Copyright:

Available Formats

Manual de

VBA Visual Basic for Applications ................................................................................... 25

Definicin de Parmetros: .......................................................................................... 65

Creacin de Listas ........................................................................................................ 125

La reutilizacin de las funcionalidades del ERP a partir de aplicaciones externas;

Motores de las Aplicaciones

VBA Visual Basic for Applications

Campos y Tablas de Usuario

Pestaas y Formularios de Usuario

Adaptar las funcionalidades ofrecidas por cada aplicacin a cada usuario;

Integrar herramientas y aplicaciones externas en el entorno de trabajo PRIMAVERA.

La Tecnologa de Integracin PRIMAVERA (TIP): permite a los Partners Integradores el desarrollo

Motores de los Mdulos

Arquitectura de los Motores

Permite el acceso a los Servicios de Negocio de cada Mdulo/rea.

Implementan las interfaces para los Servicios de Negocio.

Implementan las interfaces para los Servicios de Datos.

Objetos de Negocio (BE)

(rea de Logstica & Tesorera)

Servicios de Negocio (BS)

(rea de Logstica & Tesorera)

Introduce o actualiza una nueva entidad.

Actualiza el valor de un atributo de una entidad existente.

Actualiza el valor de diversos atributos de una entidad existente.

Devuelve el valor de un atributo de una entidad existente.

Devuelve el valor de diversos atributos de una entidad existente.

Devuelve una entidad existente.

Comprueba si determinada entidad existe.

Elimina una entidad del sistema.

Comprueba si se puede actualizar una entidad.

Comprueba si se puede eliminar una entidad.

Private Sub IGcpBSClientes_Actualiza(ByVal BECliente As GcpBECliente)

Servicios de Datos (DS)

Utilizacin de los Motores en Aplicaciones Externas

El ejemplo mostrado a continuacin se ha desarrollado en Visual Basic 6 por dos motivos:

Integracin del Motor en el Proyecto

PRIMAVERA StdBE 8.00

Apertura del Motor

El mtodo AbreEmpresaTrabalho necesita los siguientes parmetros:

Versin de la Plataforma PRIMAVERA (EXECUTIVE o PROFESSIONAL).

Identificador de la empresa PRIMAVERA.

Identificador del usuario en el sistema PRIMAVERA.

Contrasea del usuario.

Solo para uso de las aplicaciones PRIMAVERA (usar Nothing).

Identificador de la instancia PRIMAVERA.

Siempre debe ser False.

Creacin del Cliente

On Error GoTo Erro

AdmEngine800.dll versin antigua del motor segn la primera generacin de la Tecnologa de

Se pretende obtener una lista de las empresas registradas en el sistema PRIMAVERA.

PRIMAVERA AdmBE 8.00

Apertura del Motor y Ejecucin del Servicio

Private Sub cmdUsers_Click()

On Error GoTo Erro

Servicios de la Plataforma (StdPlatBS)

PRIMAVERA StdBE 8.00

Ejecucin del Servicio

On Error GoTo Erro

Set objConfApl = New StdBSConfApl

Set objConfApl = Nothing

VBA Visual Basic for Applications

Crear formularios de usuario;

Mdulos de cdigo (Code Modules): incluyen declaraciones, procedimientos y funciones;