Como criar funções do utilizador?

Este documento descreve os passos necessários para criação da sua primeira função do utilizador com Visual Studio. As funções do utilizador (tipo macro), como o próprio nome indica, são pedações de código desenvolvidos com o objetivo de executar uma operação especifica.

Pré-Requisitos

• PRIMAVERA ERP.
• Visual Studio & NET Framework 4.7.

Passo  1- Criar o projeto

1. Depois de abrir o Visual Studio, selecionar File > New > Project.

2. Na janela apresentada, na árvore à esquerda, escolher a linguagem C#.

3. Selecionar o tipo de projeto Class Library (.NET Framework).

4. Atribuir um nome ao projeto "Primavera.UserFunction " e carregar em OK.

Passo 2 - Referências

1. Depois de criado o projeto é necessário adicionar uma referência à plataforma de extensibilidade assim como aos módulos que irá trabalhar:

• Primavera.Extensibility.CustomCode.dll
• Primavera.Extensibility.Integration.dll
• Primavera.Extensibility.BusinessEntities.dll
• ErpBS100.dll
• StdPlatBS100.dll

Passo 3 - Criar a função

1. Renomear a classe de Classe1.cs para PrimeiraFuncao.cs

2. Adicionar  os namespaces no início da classe, com recurso à diretiva using, conforme a imagem abaixo.

3. A seguir ao nome da classe adicionar CustomCode. Este passo indica que a nossa classe passa a herdar da classe base da API CustomCode todos os métodos, propriedades e atributos como, por exemplo o PSO (acesso à plataforma) e o BSO (acesso aos módulos).

4. Criar um método público com o nome Funcao1. Dentro do método criado adicionar o código conforme apresentado na figura seguinte. Todos os métodos que estiverem declarados com a palavra public serão expostos no ERP, o que significa que podemos colocar numa classe, tantas funções quantas necessárias.

5. Compile a sua solução em BUILD > Build Solution.

6. Registar a assembly conforme descrito em "Como registar projetos de extensibilidade?"

7. Registar a função do utilizador conforme descrito em "Como registar uma função utilizador do tipo macro?"