V10 RecursosReferencia
RecursosReferencia
Referencia
Años | Lista de Artículos

Características de las entidades y servicios

Última modificación el 03/05/2024

En ERP PRIMAVERA, las entidades y los servicios tienen un conjunto de características transversales que implementan comportamientos uniformes, influyendo en la forma en que las entidades son tratadas o los servicios responden.

A continuación, se describen las principales características de las entidades y servicios.

Identificador único

Todas las entidades que soportan transacciones (Documentos de Compra, Ventas, Contabilidad, etc.) en el sistema tienen un identificador único generado automáticamente por la plataforma. Se trata de un GUID (Global Unique Identifier). Este identificador debe ser utilizado en los servicios API que permiten selección del registro por su ID.

Ejemplo de cómo generar un ID con la plataforma:

PSO.FuncoesGlobais.CriaGuid(false);

Ejemplo de edición de un registro por ID.

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

En modo edición

El atributo EmModoEdicao está presente en todas las entidades del sistema y es utilizado por la plataforma para saber cuándo actualizar o crear un registro en la base de datos. Cuando se utiliza el método Edita o EditaID, este atributo se establece automáticamente a true.

Campos de usuario

El atributo CamposUtil (StdBECampos) permite acceder a la colección de campos de usuario de la entidad. Estos campos representan características adicionales de la entidad y se utilizan para almacenar datos adicionales específicos de una implementación.

VndBELinhaDocumentoVenda linha = new VndBELinhaDocumentoVenda();
double qtd = Convert.ToDouble(item.SubItems[/av_ext);

// 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";

Servicios estándar

Todas las clases proporcionan un conjunto de servicios estándar que permiten realizar una serie de operaciones sobre las entidades.

AtributoDescripción
ActualizaInserta o actualiza una nueva entidad
ActualizaValorAtributo Actualiza el valor de un atributo de una entidad existente.
UpdateAttributeValueActualiza el valor de varios atributos de una entidad existente
DaValorAtributoDevuelve el valor de un atributo de una entidad existente sin bloquear el registro
DaValorAtributosDevuelve el valor de varios atributos de una entidad existente sin bloquear el registro
DaValorAtributoLockDevuelve el valor de un atributo de una entidad existente pero bloquea el registro
DaValorAtributosLockDevuelve el valor de varios atributos de una entidad existente pero bloquea el registro
EditaDevuelve una entidad existente
ExisteComprueba si una entidad dada existe
RemoveElimina una entidad del sistema (si procede)
ValidaActualizacaoComprueba si se puede actualizar una entidad
Bookmark or share this article
Esta página foi útil?
Obrigado pelo seu voto.

login para deixar a sua opinião.

Obrigado pelo seu feedback. Iremos analisá-lo para continuarmos a melhorar!
Artículos Relacionados
Concepto de integración Concepto de extensibilidad ¿Cómo registrar proyectos de extensibilidad? Buenas prácticas de organización de proyectos de integración ¿Cómo depurar (debug) proyectos de extensibilidad con Visual Studio?