Introducción
Cuando se invocan los servicios OData, específicamente aquellos que traen información de los Servicios de datos, es posible elegir cuáles atributos se retornan.
Esta configuración es totalmente opcional y aplica para:
1. Invocaciones sobre Mis Cosas.
2. Invocaciones sobre Búsquedas.
3. Invocaciones sobre datos de los procesos (casos).
4. Servicios de los métodos Query OData usados en conectores de Power BI y Tableau.
Por defecto, los atributos que se retornan son aquellos que se han configurado en la plantilla que muestra la información de una entidad por defecto.
Se puede sobrescribir esta definición, al configurar para cada entidad la información que estará disponible para las invocaciones OData.
Cambiar la definición de la plantilla
Para cambiar la información que es retornada, cree una plantilla de tipo Contenido (Content) para dicha entidad, o modifique la que ya pueda existir (es decir, si dicha entidad ya tiene una configurada).
Configurar los atributos expuestos
Para llevar acabo una configuración explícita que sobrescriba la definición de la plantilla, ubique la entidad que tiene la información que quiere incluir o excluir explícitamente.
Diríjase a la Vista de Experto y en el módulo de Entidades, haga clic derecho sobre la entidad elegida.
Seleccione la opción Atributos expuestos por OData:
En la ventana emergente, haga clic sobre Personalizar para cambiar la definición de los atributos que se retornarán para que no todos sean considerados.
Desmarque los atributos en el panel de la izquierda para que no sean retornados por los servicios OData:
Note que el panel de la derecha mostrará automáticamente la Datos Seleccionados y los atributos elegidos.
De manera similar podrá marcar otros atributos que desee incluir.
Haga clic sobre Ok cuando haya terminado.
Referencias enlazadas (para entidades y colecciones)
Cuando un ítem del modelo de datos muestra otros ítems a su interior (subitems), significa que dicho ítem principal es un atributo relacionado que apunta a otra entidad.
Considere que los atributos de tipo colección no se muestran por este editor con sus subitems sino que se muestran como si fuesen de algún tipo de dato simple.
Las colecciones se muestran con el siguiente ícono representándolas: 
.
Por lo tanto y si usted marca la casilla de un ítem sin expandirse, entonces todos sus subitems quedarán sin marcarse y únicamente el ítem actual quedará seleccionado (como una referencia enlazada):
Lo cuál podrá confirmar cuando expanda el ítem (observando que los subitems quedan sin marcarse):
Al realizar lo anterior, está implícitamente definiendo que desea incluir información de una entidad relacionada como un enlace a la misma; de manera que pueda navegar al interior del detalle a través de siguientes invocaciones de OData.
Este concepto se presenta como Navegaciones.
Algo totalmente diferente sucede si marca el ítem cuando este se encuentre expandido, donde notará que sus subitems se tornan elegibles para ser marcados e incluidos (se marcan de manera automáticamente por defecto):
Cuando se incluye algún subitem explícitamente como se muestra en la imagen anterior, entonces usted no utilizará el concepto de navegaciones y tal detalle de la entidad referenciada se obtendrá desde la misma invocación del servicio OData (no se necesitarán invocaciones adicionales).
Las colecciones por ejemplo, usan siempre el tratamiento de navegaciones, dado que siempre se retornan como entidades enlazadas (no permiten escoger subitems).
La siguiente imagen muestra como se enseña Medicalequipment, que es de tipo colección:
Para mayor detalle sobre cómo tratar este concepto de navegaciones, y las invocaciones a entidades enlazadas, consulte Navegando hacia información enlazada.
Ejemplo
El siguiente ejemplo muestra como esta configuración se puede aplicar en la búsqueda de las características del Asistente de Personas.
Una búsqueda llamada Solicitudes de búsqueda está configurada para basarse en la entidad SimplePurchaseRequest larga como se muestra a continuación:
Por lo tanto, para reducir y especificar exactamente cuáles partes de información de negocio se retornan cuando se busca información sobre la entidad SimplePurchaseRequest, se puede hacer uso de la opción Atributos expuestos por OData.
En este caso, los atributos han sido personalizados para la búsqueda anterior, como se muestra en Studio:
Cuando se invoca la búsqueda Solicitudes de búsqueda, note que los atributos a ser retornados coinciden con el grupo personalizado anteriormente:
Last Updated 1/30/2023 4:32:09 PM