Acerca de las listas

Una lista es una configuración basada en datos que usa para agregar una página web que representará una lista de registros sin necesidad de que un programador muestre la cuadrícula en el portal. Al usar listas, puede exponer registros para mostrar en portales.

La cuadrícula admite la ordenación y se paginará si el número de registros es mayor que el tamaño de página especificado. Si la página web para la vista de detalles se ha especificado, cada registro contendrá un vínculo a la página y el identificador del registro se anexará a la cadena de consulta junto al nombre de parámetro de la cadena de consulta de Id. La lista también admite varias vistas. Si se ha especificado más de una vista, se representará una lista desplegable para permitir que el usuario cambie en las distintas vistas.

Los datos también se pueden filtrar por el usuario del portal actual, la cuenta del cliente principal del usuario del portal actual y el sitio web del portal actual. Si existe un valor para las condiciones de filtro Atributo de usuario del portal y Atributo de cuenta, el portal representará una lista desplegable para permitir que el usuario vea sus propios datos (Mis) o los datos de su cuenta de cliente principal.

Agregar una lista al portal

La lista contiene relaciones con páginas web y distintas propiedades para controlar la inicialización de la lista de registros dentro del portal. La relación con la página web permite la recuperación dinámica de la definición de lista para un determinado nodo de página en el sitio web. Para ver las vistas de Tabla existentes o para crear nuevas vistas de Tabla, vaya a Portales > Listas.

Las páginas web asociadas a la lista se pueden ver al seleccionar el vínculo Páginas web mostrado en los vínculos de navegación Relacionados en el menú de la izquierda. Al crear su lista, el primer paso es elegir la tabla para la que desea representar una lista en el portal. Después elegirá una o varias vistas de aplicación basada en modelo para representar.

Al crear o editar una página web, puede especificar una lista en el campo de búsqueda proporcionado en el formulario de la página web. La plantilla de página será normalmente la plantilla de "página", pero puede suele ser una de las otras plantillas diseñadas para contenido, ya que las plantillas maestras contienen la lógica necesaria para determinar si se debe representar una lista.

Atributos y relaciones de listas

Agregar JavaScript personalizado

La pestaña Opciones del formulario contiene un área de texto en la que puede introducir JavaScript personalizado. Si la página incluye biblioteca de jQuery, puede usarla aquí también. El bloque de script se agregará en la parte inferior de la página web justo delante de la etiqueta de formulario de cierre de la página.

La lista obtiene sus datos de forma asincrónica y, cuando está competa, desencadena un evento loaded que su JavaScript personalizado pueda escuchar y hacer algo con los elementos de la cuadrícula. El siguiente código es un ejemplo trivial:

$(document).ready(function (){
$(".entitylist.entity-grid").on("loaded", function () {
$(this).children(".view-grid").find("tr").each(function (){
// do something with each row
$(this).css("background-color", "yellow");
});
});
}); 

Busque un campo de atributo particular y obtenga su valor para modificar posiblemente la representación del valor. El siguiente código obtiene cada celda de la tabla que contenga el valor del atributo accountnumber. Reemplace accountnumber con un atributo adecuado para la tabla y vista.

$(document).ready(function (){
   $(".entitylist.entity-grid").on("loaded", function () {
      $(this).children(".view-grid").find("td[data-attribute='accountnumber']").each(function (i, e){
         var value = $(this).data(value);
         // now that you have the value you can do something to the value
      });
   });
});

Configuración de lista

Puede fácilmente habilitar y configurar acciones (crear, editar, eliminar, etc.) para registros en una lista. También es posible reemplazar etiquetas predeterminadas, tamaños y otro atributos para que la lista se muestre exactamente de la manera que desea.

Estos valores se encuentran en la sección Configuración del formulario de lista. De forma predeterminada, sólo aparece Configuración básica. Seleccione Configuración avanzada para ver configuración adicional.

Atributos

Configuración general de acciones

En general, las acciones de la tabla tienen valores que se pueden configurar. En todos los casos, este para ofrecerle más opciones en relación con la personalización, y los campos no son necesarios. Al agregar la acción simplemente podrá realizarse la acción en el portal, siempre que los permisos de la tabla hayan concedido el privilegio adecuado.

Generalmente, puede configurar el cuadro de diálogo correspondiente para cada acción, que aparecerá solo si se selecciona Confirmación necesaria.

Configuración avanzada del cuadro de diálogo General

Configuración de la Acción Crear

Habilitar una Acción Crear representa un botón sobre la lista de entidades, cuando se selecciona, abre un cuadro de diálogo con un formulario básico que permite al usuario crear un nuevo registro, siempre que los permisos de tabla hayan concedido el privilegio "Crear".

Configuración avanzada del cuadro de diálogo Crear formulario

Configuración de la Acción Descargar

Habilitar una Acción Descargar representa un botón encima de la lista que, cuando se selecciona, descarga los datos de la lista en un archivo Excel (.xlsx).

Configuración de la Acción Detalles

Habilitar una Acción Detalles permite al usuario ver un formulario básico de solo lectura de una fila seleccionada en la lista.

Configuración avanzada del cuadro de diálogo Detalles

Configuración de la Acción Editar

Habilitar una Acción Editar permite al usuario ver un formulario básico editable que está enlazado a datos al registro de la fila seleccionada de la lista siempre que los permisos de tabla hayan concedido el privilegio de 'Escritura'.

Configuración avanzada del cuadro de diálogo Editar formulario

Configuración de la Acción Eliminar

Habilitar Acción Eliminar permite al usuario eliminar permanentemente el registro de la fila seleccionada de la lista, siempre que permisos de tabla haya concedido el privilegio 'Eliminar'.

Configuración avanzada del cuadro de diálogo Eliminar

Configuración de la Acción de flujo de trabajo

Habilitar una Acción de flujo de trabajo permite al usuario ejecutar un flujo de trabajo a petición para el registro de la fila seleccionada de la lista. Puede agregar cualquier número de acciones de flujo de trabajo a la lista.

Asegurar listas

Para realizar una lista de entidades, debe configurar los permisos de tabla para la tabla para la que se muestran registros y también seleccionar la casilla Habilitar permisos de tabla. Si no lo hace, verá la siguiente advertencia:

"Los permisos de tabla deben estar habilitados para este registro; de lo contrario, cualquier usuario de Internet puede ver los datos".

El acto de proteger una lista asegurará que para cualquier usuario que tenga acceso a la página solo se muestran los registros para los que se ha concedido permiso. Esto se consigue mediante un filtro adicional que se agrega a las vistas de la aplicación basada en modelo que emergen a través de la lista. Este filtro filtrará solo los registros que son accesibles al usuario, mediante el permiso Leer.

Además, las acciones se definan para la lista respetarán los permisos correspondientes para dicha acción, registro a registro. Es decir, si tiene el permiso Editar para un registro, la acción Editar se habilitará para ese registro. Lo mismo se aplica a Eliminar, Crear, etc. Tenga en cuenta que si no hay ningún registro disponible, un mensaje que indica esto aparecerá cuando la lista se cargue.

Sin embargo, un buen diseño de la página web requiere que, si el usuario no tiene un rol con permisos para la tabla (es decir, nunca habrá una situación en la que no vea ningún registro), no debe obtener acceso a la página en absoluto. Idealmente, la página debe protegerse con permisos de acceso de página web.

Si ha asegurado una lista seleccionando Habilitar permisos de tabla y desea mostrar las acciones de nivel de registros que son aplicables al usuario que inició sesión, debe establecer el valor de configuración del sitio EntityList/ShowRecordLevelActions en true. Por ejemplo, hay dos usuarios: Preston y Teddy. Preston tiene acceso total a nivel de contacto en la tabla de casos, mientras que Teddy tiene acceso de lectura global. Si se crea una lista para mostrar todos los registros de casos, Preston vería todas las acciones (Ver, Editar y Eliminar) en los registros relacionados con su contacto. En otros registros, solo vería la acción Ver. Por otro lado, Teddy solo vería la acción Ver en todos los registros.

Si la configuración EntityList / ShowRecordLevelActions del sitio está establecida en falso y la tabla tiene múltiples permisos, todas las acciones de nivel de registro son visibles. Pero, cuando un usuario intenta realizar una acción para la cual no está autorizado, se muestra un error.

Agregar una página de detalles de vista

Al establecer la búsqueda de Página web para vista de detalles en una página web, los detalles de un registro enumerado en la cuadrícula pueden verse como de solo lectura o editados, en función de la configuración del formulario o de la página asociada.

Esta página puede ser una plantilla de página completamente personalizada, quizás creada con Liquid. El escenario más común es probablemente tener la página de detalles como una página web que contiene un formulario básico o un formulario avanzado.

Lo importante es conocer que cada registro enumerado en la cuadrícula tendrá un hipervínculo a la página de detalles, y el vínculo contendrá un parámetro Cadena de consulta con nombre con el identificador del registro. El nombre de parámetro Cadena de consulta depende del Nombre de parámetro de cadena de consulta de id. especificado en la lista. La tarea final a tener en cuenta es que la página web de detalles de destino también debe conocer el nombre de este parámetro de Cadena de consulta para obtener el identificador del registro que debe consultar y cargar sus datos.

Uso de un formulario básico para mostrar detalles

Para crear un formulario básico consulte las instrucciones que se encuentran en la página Formulario básico.

A continuación se describen los valores importantes que debe conocer para asegurarse de que el registro de la lista de entidades se carga en el formulario básico.

El Nombre del parámetro de cadena de consulta de id. de registro en el Formulario de básico debe coincidir con Nombre de parámetro de cadena de consulta de id. en la lista.

El Modo puede ser Editar o Solo lectura según sus necesidades.

Uso de un formulario avanzado para mostrar detalles

A continuación se describen los valores importantes que debe conocer para asegurarse de que el registro de la lista de entidades se carga en el formulario avanzado.

El Nombre del parámetro de cadena de consulta de clave principal en Paso de formulario avanzado debe coincidir con Nombre de parámetro de cadena de consulta de id. en la lista.

El Modo puede ser Editar o Solo lectura según sus necesidades.

Uso de una página de detalles para la función Crear

Puede usar una página personalizada, un formulario básico o un formulario avanzado en el mismo modo para la función Crear. Esto es una alternativa a definir una acción Crear en el formulario. No puede definir una acción Crear y una página personalizada para Crear: definir una acción personalizada tiene prioridad.

Si asigna una página web a la búsqueda Crear en la lista, y no especifica una acción Crear mediante la Configuración, se representará un botón Crear en la lista; este botón vinculará al usuario a la página personalizada que se ha designado para Crear.

Configuración de filtro de lista

Agregar la capacidad de filtrar registros de una lista es fácil: habilite simplemente la opción de filtrado y luego seleccione uno o más tipos de filtro para mostrar a los usuarios. Es posible filtrar por un atributo que coincida con algo de texto proporcionado por el usuario, o seleccionar de una serie de opciones. Incluso puede diseñar prácticamente cualquier tipo de filtro que pueda imaginarse mediante Búsqueda avanzada.

Habilitar el filtro de lista

En la sección Filtro de metadatos, seleccione la casilla Habilitado. Esto agregará el área Filtro a la lista cuando se muestran. Hasta que haya definido por lo menos un tipo de filtro, aparecerá el cuadro vacío.

Puede definir cómo el área Filtro en la lista se representará con la opción Orientación. El valor predeterminado, Horizontal, representa el área Filtro por encima de la lista. Orientación vertical representa el área Filtro como un cuadro a la izquierda de la lista.

Tipos de filtro

Filtro de texto

El Filtro de texto agrega un cuadro de texto al área Filtro de listas que está ligado a un atributo de tipo de tabla de la lista. Cuando un usuario aplica el filtro, la lista muestra solo aquellos registros cuyo atributo seleccionado contenga el valor.

Para agregar un filtro de texto, seleccione + Filtro de texto.

El filtro de texto usa los siguientes atributos:

Conjunto de filtros de atributo

El Conjunto de filtros de atributo agrega una serie de opciones por las que filtrar la lista, ligadas a un solo atributo de tipo de la tabla seleccionada de la lista. Cuando un usuario aplica el filtro, la lista muestra solo aquellos registros que coinciden exactamente con al menos una de las opciones seleccionadas.

El Conjunto de filtros de atributo usa los siguientes atributos:

Opciones Conjunto de filtros de atributo

Un Conjunto de filtros de atributo puede tener normalmente cualquier número de opciones, con las excepciones de lista desplegable y atributos booleanos. Un Conjunto de filtros de atributo booleano puede tener solo una o dos opciones—una opción True y una opción False. Un Conjunto de filtros de atributo de lista desplegable puede tener una opción para cada valor posible en la lista desplegable.

Las opciones tienen los siguientes atributos:

Conjunto de búsquedas

El Conjunto de búsquedas agrega una serie de opciones por las que filtrar la lista, ligadas a una tabla relacionada con el tipo de la tabla seleccionada de la lista. Cuando un usuario aplica el filtro, la lista muestra solo aquellos registros que coinciden exactamente con al menos uno de los registros seleccionados.

El Conjunto de búsquedas usa los siguientes atributos:

Opciones de conjunto de búsqueda

Un conjunto de la búsqueda tiene normalmente varias opciones, con el único límite en el número de registros relacionados de tipo relacionado seleccionado.

Las opciones tienen los siguientes atributos:

Conjunto de filtros de intervalo

El Conjunto de filtros de intervalo agrega una serie de opciones, cada una con una o dos condiciones, al área Filtro. Cuando un usuario aplica el filtro, la lista muestra solo aquellos registros que coinciden exactamente con todas las condiciones en al menos una de las opciones seleccionadas.

El conjunto de filtros de intervalo usa los siguientes atributos:

Opciones del Conjunto de filtros de intervalo

Un Conjunto de filtros de intervalo puede tener varias opciones. Cada opción generará una condición de filtro con una o dos subcondiciones, que deben cumplirse para que la condición sea True.

Las opciones tienen los siguientes atributos:

Conjunto de listas desplegables dinámicas

El Conjunto de listas desplegables dinámicas agrega una serie de opciones por las que filtrar que representan todos los valores de un campo de lista desplegable específico. Esto es diferente de seleccionar una lista desplegable en el Conjunto de filtros de atributo. En el Conjunto de filtros de atributo debe especificar un conjunto de opciones que estarán disponibles para el usuario para filtrar; en el Conjunto de lisas desplegables dinámicas solo debe especificar el campo de lista desplegable y el conjunto completo de opciones se proporcionará automáticamente. Si necesita mayor control, se recomienda usar el Conjunto de filtros de atributo.

El Conjunto de listas desplegables dinámicas usa las siguientes opciones:

Conjunto de búsquedas dinámicas

El Conjunto de búsqueda dinámica agrega una serie de opciones dinámica por las que filtrar la lista, ligadas a una tabla relacionada con el tipo de la tabla seleccionada de la lista. Cuando un usuario aplica el filtro, la lista muestra solo aquellos registros que coinciden exactamente con al menos uno de los registros seleccionados.

Esto es diferente de un Conjunto de búsquedas. En el Conjunto de búsqueda, debe especificar manualmente las tablas relacionadas por las que filtrar. En el Conjunto de búsquedas dinámicas, debe especificar solo la relación por la que se va a filtrar, y una lista de opciones se generará en función de la vista especificada de tablas relacionadas.

El Conjunto de búsquedas dinámicas usa las siguientes opciones:

Filtro FetchXML

El filtro de intervalo puede crear un filtro de cuadro de texto básico como el filtro de texto, o un conjunto de opciones como otros tipos de filtro. Permite crear manualmente prácticamente cualquier tipo de filtro para la lista mediante FetchXML.

El filtro FetchXML solo usa un atributo:

Vista de mapa de listas

Con las listas es posible habilitar y configurar una vista de mapa de los datos, con tecnología de mapas de Bing con la funcionalidad de búsqueda para buscar ubicaciones cerca de una dirección. Al rellenar los registros con valores de coordenadas de latitud y longitud y especificar las opciones de configuración necesarias enumeradas en esta sección, los registros se pueden representar como marcadores en un mapa. Cualquier registro que no tenga un valor de latitud o longitud quedará excluido de la búsqueda. La carga inicial de la página mostrará todos los registros en el valor inicial del campo Valores de distancia (en millas o kilómetros, según las unidades de distancia especificadas) de las coordenadas de Latitud del centro predeterminada y Longitud del centro predeterminada. La vista especificada se omite cuando se usa la vista de mapa, y una consulta de distancia se aplica al conjunto de datos para devolver resultados de mapa.

Vista de calendario de lista

Use la Vista de calendario de lista para representar una lista como calendario, con cada registro individual configurado para actuar como un solo evento.

Para mostrar los registros mediante un calendario, esos registros deben incluir como mínimo un campo de fecha. Para que los eventos tengan horas de inicio y finalización exactos, los campos correspondientes deben existir, etc. Si se supone que estos campos estén configurados, una vista de calendario de lista aparecerá en el portal.

Fuentes de OData de la lista

Si está habilitada, una tabla se puede publicar a una fuente de OData. El protocolo OData es un protocolo a nivel de aplicación para interactuar con datos a través de servicios web RESTful. Los datos de esta fuente se pueden ver en un explorador web, consumir por una aplicación web del lado del cliente, o importar a Excel.

Filtro de vista mejorado para listas

Puede usar permisos de la tabla si desea proteger los registros, pero si desea proporcionar simplemente un filtro como parte del conjunto de opciones de filtro que corresponde al usuario del portal actual, puede usar la función de lista. Esta característica admite el filtro de usuario actual, de la cuenta primaria del usuario, o una página web en cualquier profundidad. Simplemente cree el filtro de la vista para que coincida con cualquier registro de contacto único, y el código reemplazará la configuración con el valor real en tiempo de ejecución — sin necesidad de asignar valores a los campos de la sección Condiciones de filtro.

• El control encontrará todos los elementos de condición donde uitype= "contact" y establecerá el valor en el valor real del identificador de contacto del usuario del portal actual.
• El control encontrará todos los elementos de condición donde uitype= "account" y establecerá el valor en el valor real del identificador de la cuenta principal del usuario del portal actual.
• El control encontrará todos los elementos de condición donde uitype= "adx_website" y establecerá el valor en el valor real del identificador del sitio web actual.

Ejemplo de criterios de filtro de vista

La siguiente imagen muestra un contacto arbitrario asignado a una condición de filtro, este contacto resulta ser un contacto "falso" pendiente de confirmación, pero esto podría ser cualquier registro de contacto. La identificación de este registro será reemplazada por el valor real del identificador del usuario que ve la página. Si el usuario no ha iniciado sesión, no se devolverán registros. Esto proporciona una mayor flexibilidad para filtrar los datos en función del usuario y el sitio web contextualmente.

Consultar también

• Microsoft Learn: Mostrar múltiples registros de Dataverse utilizando listas
• Configurar un portal
• Redireccionar a una nueva dirección URL en un portal