Configurar una columna de opciones en portales

Los creadores pueden diseñar formularios básicos y formularios de varios pasos para incluir columnas de opciones definidas en Microsoft Dataverse. Esta función permite a los usuarios del portal seleccionar múltiples opciones mientras envían datos y mostrar vistas con columnas de opciones a través de listas.

Formularios básicos y de varios pasos

Puede diseñar un paso de formulario básico o formulario de varios pasos en el sitio web utilizando un formulario de Dataverse que tiene la columna de opciones para admitir la selección de múltiples opciones. Los usuarios del sitio web pueden insertar, modificar o borrar la selección.

Pantalla que muestra una lista de actividades al aire libre que se están creando. El usuario expande el cuadro de opciones Seleccionar o buscar y selecciona algunas actividades de la lista que aparece. Las actividades seleccionadas aparecen en la parte superior de la ventana. El usuario introduce las letras C a m en el cuadro y luego selecciona la opción Camping cuando aparece. En la parte superior de la ventana en la lista de actividades, el usuario selecciona el botón Cerrar junto a una de las opciones para dejar de seleccionarla.

Lista

Puede definir una columna de opciones en una vista de Dataverse para mostrar las múltiples opciones disponibles para el registro en una lista. La columna de opciones admite la búsqueda rápida escribiendo una palabra clave para filtrar la lista.

Nota

No se admite clasificar una lista por la columna de opciones.

Liquid

Los desarrolladores pueden diseñar el sitio web utilizando Liquid para recuperar los registros de una tabla de Dataverse. Las columnas de opciones se pueden recuperar mientras se consultan los datos mediante fetchXML o una vista de entidad.

{% for choice in record.ChoicesColumn %}
    {{ choice.Label }}
    {{ choice.Value }}
{% endfor %} 

Ejemplos de opciones para los valores sample_outdooractivities se muestran en la siguiente tabla.

Valor	Etiqueta
1	Natación
2	Senderismo
3	Montañismo
4	Pesca
5	Caza
6	Carrera
7	Remo
8	Esquí
9	Acampada

En la siguiente tabla se muestran ejemplos de valores de la tabla de contactos.

Columna 'fullname'	Columna "Sample_outdooractivities"
Quinn Yarborough	1,9
Avery Orton	2
Yuri Maple	4
Ravi Mundy	2,3,8,9

Recuperar las opciones seleccionadas usando fetchXML

{% fetchxml contacts %}
    <fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">
        <entity name="contact">
            <attribute name="firstname" >
            <attribute name="lastname" >
            <attribute name="sample_outdooractivities" >
        </entity>
    </fetch>
{% endfetchxml %}
{% for item in contacts.results.entities %}
{
    "First Name":"{{ item.firstname }}",
    "Last Name":"{{ item.lastname }}",
    "Outdoor Activities": [
        {% for choice in item.sample_outdooractivities %}
            {{choice.Label}},
        {% endfor %}
    ]
}
{% endfor %}

Recuperar opciones seleccionadas usando una vista de entidad

{% entitylist id:page.adx_entitylist.id %}
{% for e in entityview.records -%}
    {
    "First Name":"{{ e.firstname }}",
    "Last Name":"{{ e.lastname }}",
    "Outdoor Activities": [
    {% for choice in e. sample_outdooractivities %}
        {{choice.Label}},
    {% endfor %}
    ]
    }
{% endfor -%}

API web

Los desarrolladores pueden usar columnas de operaciones de lectura, creación y actualización de la API web.

Leer

GET \[Portal URI]\_api/contacts?$select=fullname,sample\_outdooractivities &$top=1

Respuesta:

{
"value": [
    {
    "@odata.etag": "W/\\"1066412\\"",
    "fullname":" Quinn Yarborough ",
    "sample\_outdooractivities ":"1,9",
    "sample\_outdooractivities @OData.Community.Display.V1.FormattedValue":"Swimming, Camping"
    }
    ]
}

Crear y editar

Método: PATCH / PUT

\[Portal URI]\_api/contacts (guid)

Cuerpo:

{
"sample\_outdooractivities": "1,4,8",
}

Problemas conocidos

El control Choices no estará disponible en metadatos de formulario básicos y de varios pasos para aplicar lógica de modificación de comportamiento adicional o anular la funcionalidad de los campos de formulario.