Características das entidades e serviços

No ERP PRIMAVERA as entidades e serviços têm um conjunto de características transversais que implementam comportamentos uniformes, influenciando a forma como as entidades são tratadas ou os serviços respondem.

De seguida, descrevem-se as principais características das entidades e serviços.

Identificador único

Todas as entidades que suportam transações (Documentos de Compras, Vendas, Contabilidade, etc.) do sistema têm um identificador único que é gerado automaticamente pela plataforma. Trata-se de um GUID (Global Unique Identifier). Este identificador deve ser utilizado nos serviços da API que suportam a seleção do registo pelo seu ID.

Exemplo de como gerar um ID com a plataforma:

PSO.FuncoesGlobais.CriaGuid(false);

Exemplo de edição de um registo pelo ID.

BSO.Vendas.DocumentosVenda.EditaID("C73C6FD7-61E4-4DCA-B441-32C3DD94A336");

Em modo edição

O atributo EmModoEdicao está presente em todas as entidades do sistema e é utilizado pela plataforma para saber quando proceder à atualização ou criação de um registo na base dados. Quando usado o método Edita ou EditaID este atributo é colocado automaticamente a true.

Campos do utilizador

O atributo CamposUtil (StdBECampos) permite acesso à coleção dos campos de utilizador da entidade. Estes campos representam características extra da entidade e são usados para armazenar dados adicionais específicos de uma implementação.

VndBELinhaDocumentoVenda linha = new VndBELinhaDocumentoVenda();
double qtd = Convert.ToDouble(item.SubItems[1].Text);

// Adicionar uma linha ao documento de venda.
PSO.Vendas.Documentos.AdicionaLinha(invoice, item.SubItems[0].Text, ref qtd);

// Obter a primeira linha do documento.
linha = invoice.Linhas.GetEdita(1);

// Atribuir ao CDU "LinVar1" da primeira linha da fatura o valor.
linha.CamposUtil["CDU_LinVar1"].Valor = "100";

Serviços standard

Todas as classes disponibilizam um conjunto de serviços standard que permite realizar um conjunto de operações sobre as entidades.