Como utilizar os controlos SDK do ERP PRIMAVERA?

O SDK trata-se de uma biblioteca de padrões e componentes de negócio para o ambiente PRIMAVERA. Este permite aos parceiros e às equipas de desenvolvimento externas criar add-ons para o ERP de uma forma mais rápida e simples.

A utilização do SDK apresenta várias vantagens, entre as quais se destaca:

• Aceleração dos processos de desenvolvimento;
• Uniformização de processos, interfaces e experiência de utilização do ERP.

Utilizar o SDK

Passo 1 - Referenciação

Para que seja possível utilizar o SDK, é necessário adicionar à toolbox os componentes que se encontram na assembly PRISDK100.dll disponível na pasta “PRIMAVERASG100APL”.

Passo 2 - Inicialização do contexto do SDK

Após a referenciação da assembly PRISDK100.dll, basta selecionar o controlo desejado na toolbox e proceder à inicialização do contexto de utilização.

Este contexto não é mais do que uma verificação do ambiente onde os controlos estão a ser executados, uma vez que estes apenas devem ser utilizados no contexto do ERP. Ou seja, trata-se do momento onde se inicializa a plataforma e o motor.

Esta inicialização deve ser executada, preferencialmente, no carregamento do formulário (evento load do form).

Nota: O contexto do SDK necessita de ser inicializado apenas uma vez.

//Variavél global que contem o contexto e que deverá ser passada para os controlos.
private clsSDKContexto sdkContexto;

//Funcção que inicializa o contexto SDK.
private void InicializaSDKContexto()
{
   if(sdkContexto == null)
   {
      sdkContexto = new clsSDKContexto();

      //Inicializaçao do contexto SDK a partir do objeto BSO e respetivo módulo.
      sdkContexto.Inicializa(BSO, "ERP");

      //Inicialização da plataforma no contexto e verificação de assinatura digital.
      PSO.InicializaPlataforma(sdkContext);
   }
}

Passo 3 - Inicialização dos controlos

Depois de adicionados os formulários, todos os controlos têm de ser inicializados com o contexto previamente criado.

Para tal, é necessário chamar o método Inicializa() de cada controlo, como exemplificado a seguir.

Como no passo anterior, esta inicialização deve também ser executada, preferencialmente, no carregamento do formulário (evento load do form).

//É passado por parâmetro a variavél global que contém o contexto SDK criada no passo 2 deste documento.
Controlo.Inicializa(sdkContexto);