Configurar uma coluna de opções em portais

Os criadores podem criar formulários básicos e formulários de várias etapas para incluir colunas de opções definidas no Microsoft Dataverse. Este recurso permite que os usuários do portal selecionem várias opções ao enviar dados e mostrem exibições com colunas de opções por meio de listas.

Formulários básicos e formulários de várias etapas

Você pode criar uma etapa de formulário básico ou de formulário multietapas no site usando um formulário do Dataverse que tenha uma coluna de opções para oferecer suporte à seleção de várias opções. Os usuários do site podem inserir, modificar ou limpar a seleção.

Tela mostrando uma lista de atividades ao ar livre sendo criada. O usuário expande a caixa Selecionar ou pesquisar opções e seleciona algumas atividades na lista exibida. As atividades selecionadas aparecem na parte superior da janela. O usuário digita as letras A c a na caixa e, em seguida, seleciona a opção Acampamento quando ela aparece. Na parte superior da janela, na lista de atividades, o usuário seleciona o botão Fechar ao lado de uma das opções para anular a seleção.

Lista

Você pode definir uma coluna de opções em uma exibição do Dataverse para exibir as várias opções disponíveis para o registro em uma lista. A coluna de opções dá suporte à pesquisa rápida digitando uma palavra-chave para filtrar a lista.

Observação

Não há suporte para classificar uma lista pela coluna de opções.

Liquid

Os desenvolvedores podem criar o site usando Liquid para recuperar os registros de uma tabela do Dataverse. As colunas de opções podem ser recuperadas enquanto os dados são consultados usando fetchXML ou uma exibição de entidade.

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

Exemplos de opções para valores de sample_outdooractivities são mostrados na tabela a seguir.

Valor	Rótulo
1	Natação
2	Caminhada
3	Montanhismo
4	Pesca
5	Caça
6	Corrida
7	Navegação
8	Esqui
9	Acampamento

Exemplos de valores da tabela de contato são mostrados na tabela a seguir.

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

Recuperar as opções selecionadas 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 as opções selecionadas usando uma exibição de entidade

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

Os desenvolvedores podem usar colunas de opções com as operações de leitura, criação e atualização da API Web.

Ler

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

Resposta –

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

Criar/Editar

Método – PATCH / PUT

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

Corpo –

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

Problemas conhecidos

O controle Escolhas não estará disponível em metadados de formulário básico e de várias etapas para aplicação de lógica de modificação de comportamento extra nem para substituição da funcionalidade de campos de formulário.