CL.STRUCTURES 2.5.0

Acerca de CL.STRUCTURES

Contiene todas aquellas estructuras que se han considerado estandar en todos los procesos que pueden presentar las aplicaciones.

¿Qué resuelve?

Cada vez que tenemos que lidiar con la creación de esctructuras de datos, como clases, interfaces, exisite un conjunto de estos que son muy similiar en cuanto comportamiento y al no existir un estandar los desarrolladores declaran clases como por ejemplo user o User y con las propiedades Nombre o nombre, incluso en inglés Name o name. La idea con este nuget es poder agrupar todas estas estructuras para que en la mayoría de proyectos tengamos esta consistencia al momento de implementar nuevas funcionalidades.

Resumen de versión

Cambios (Changes)

• Nueva estructuras agregadas para el manejo de procesamiento por lotes.
• Nueva estructuras agregadas para el manejo de respuestas de SL sin necesidad de mapeo a un objeto.

Clases

Response<T>

• T Data: Va a contener la información que deseamos retornar.
• System.String Message: Variable opcional para indicar algún evento que queramos comunicar.
• Reponse(): Contructor base de la base
• Reponse(System.Exception): Contructor que nos permite de manera automática mapear una excepción y retornarla al ui.

Usada generalmente para contener tanto la información como el detalle de un error que queramos indicar.

Ejemplo:

// Este método retorna un objeto de tipo Context<T>, pero se accede a la propiedad response al final
var user = Execute<User, AppContext, System.Int16>("spGetUserById", 5).Response;

Context<T>

• CL.STRUCTURES.CLASSES.Response<T> Response: Objeto genérico que contiene la información a retornar.
• System.Net.HttpStatusCode Code: Estatus de la petición tras haber sido ejecutada.

Esta clase representa el estado final de una transacción que hayamos intentado hacer en nuestro backend, la cual debe ser evaluda según el código http.

Ejemplo:

// Este método retorna un objeto de tipo context
var user = Execute<User, AppContext, System.Int16>("spGetUserById", 5);

BatchRequest

• Cl.Structures.Classes.ServiceLayer.BatchRequest BatchRequest: Objeto que almacenara la transacción a realizar en un lote.

Esta clase representa la transaccion que vamos ajecutar en el lote creado en SL.

Ejemplo:

var request = new BatchRequest(){ Id = 1, Verb = GET, ChangeSet = 1, Url = "Items('B001'')",Content=""

UnmappedResponse

• Cl.Structures.Classes.ServiceLayer.UnmappedResponse unmappedResponse: Objeto que almacena la respuesta de SL en formato String

Ejemplo:

CLContext<UnmappedResponse> oClContext = await oSLRequestObject.SendAsync<UnmappedResponse>();

Interfaces

ICLMaster

Usada para definir límites en funciones, por ejemplo en contraints

Ejemplo:

// Usada en una función para indicar que solo podemos usar objetos que implementes esta interfaz
where V : CL.STRUCTURES.INTERFACES.ICLMaster

ICLInclude

Usada para indicar que se deben incluir los elementos según en el contexto en el que se use.

Ejemplo:

// Incluyendo la propiedad "Id" en la la lista.
var users = Execute<User, AppContext, CL.STRUCTURES.INTERFACES.ICLInclude>("spGetUsers", user, new System.String[] { "Id" });

ICLExclude

Usada para indicar que se deben excluir los elementos según en el contexto en el que se use.

Ejemplo:

// Excluyendo la propiedad "Id" en la lista.
// var users= Execute<User, AppContext, CL.STRUCTURES.INTERFACES.ICLExclude>("spGetUsers", user, new System.String[] { "Id" });

Enums

EmailDomains

Nos permite conocer los dominios que podría procesar una aplicación

Ejemplo:

// Uso del enum
var valor = CL.STRUCTURES.Enums.EmailDomains.Gmail;

DaysOfWeek

Contiene los días de la semana, el primer día es el Domingo.

Ejemplo:

// Uso del enum
var valor = CL.STRUCTURES.Enums.DaysOfWeek.Su;

UdfType

Nos informa sobre el tipo de datos que permiten los UDFs.

Ejemplo:

// Uso del enum
var valor = CL.STRUCTURES.Enums.UdfType.Numeric;

ObjectStatus

Indica el estado en el que se encuentra un objeto.

Ejemplo:

// Uso del enum
var valor = CL.STRUCTURES.Enums.ObjectStatus.Stashed;

ObjectTypes

Representa todos los objetos que sap puede manejar a nivel del sdk.

Ejemplo:

// Uso del enum
var valor = CL.STRUCTURES.Enums.ObjectTypes.Items;

Clavis Consultores ©