Configurer une colonne de choix sur les portails

Les créateurs peuvent concevoir des formulaires de base et des formulaires à plusieurs étapes inclure colonnes de choix défini dans Microsoft Dataverse. Cette fonctionnalité permet aux utilisateurs du portail de sélectionner plusieurs options lors de la soumission de données et d’afficher des vues avec des colonnes de choix via listes.

Formulaires de base et formulaires à plusieurs étapes

Vous pouvez concevoir un formulaire basique ou un formulaire à plusieurs étapes accéder au site web à l’aide d’un formulaire Dataverse ayant la colonne de choix pour prendre en charge la sélection de plusieurs options. Les utilisateurs du site web peuvent insérer, modifier ou effacer la sélection.

Écran affichant une liste d’activités de plein air créées. L’utilisateur développe la zone Sélectionner ou rechercher des options et sélectionne certaines activités depuis la liste qui s’affiche. Les activités sélectionnées s’affichent en haut de la fenêtre. L’utilisateur saisit les lettres C a m dans la zone, puis sélectionne l’option Camping lorsqu’elle s’affiche. En haut de la fenêtre de la liste des activités, l’utilisateur sélectionne le bouton Fermer à côté d’une des options pour la désélectionner.

Liste

Vous pouvez définir une colonne de choix dans une vue Dataverse pour afficher les multiples options disponibles pour l’enregistrement dans une liste. La colonne des choix prend en charge la recherche rapide en tapant un mot-clé pour filtrer la liste.

Note

Trier une colonne liste par choix n’est pas prise en charge.

Liquid

Les développeurs peuvent concevoir le site Web en utilisant Liquid pour récupérer les enregistrements d’une table Dataverse. Les colonnes de choix peuvent être récupérées lors de l’interrogation des données à l’aide de fetchXML et de la vue d’entité.

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

Des exemples de choix pour les valeurs sample_outdooractivities sont affichées dans la table suivante.

Valeur	Étiquette
1	Natation
2	Randonnée
3	Alpinisme
4	Pêche
5	Chasse
6	Exécution en cours
7	Canotage
8	Ski
9	Camping

Des exemples de valeurs de table de contact sont présentés dans le tableau suivant.

Colonne « nom complet »	Colonne « Sample_outdooractivities »
Quinn Yarborough	1,9
Avery Orton	2
Yuri Maple	4
Ravi Mundy	2,3,8,9

Récupérer les options sélectionnées à l’aide de 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 %}

Récupérer les options sélectionnées à l’aide d’une vue d’entité

{% 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

Les développeurs peuvent utiliser des colonnes de choix avec les opérations de lecture, de création et de mise à jour de l’API web.

Lu

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

Réponse –

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

Créer/modifier

Méthode – PUT / PATCH

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

Body –

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