Marcas de entidade do Dataverse

Observação

Desde o dia 12 de outubro de 2022, os portais do Power Apps passaram a ser Power Pages. Mais Informações: O Microsoft Power Pages já está disponível para todos (blog)
Em breve, migraremos e mesclaremos a documentação dos portais do Power Apps com a documentação do Power Pages.

As marcas de entidade do Microsoft Dataverse são usadas para carregar e exibir dados do Dataverse, ou use os demais serviços de estrutura do portal do Power Apps. Essas extensões são marcas Dataverse específicas ao idioma líquido.

gráfico

Adiciona um gráfico Power Apps a uma página da Web. A marca do gráfico pode ser adicionada ao campo Copiar em uma página da Web ou ao campo Origem em um Modelo da Web. Para obter as etapas para adicionar um gráfico Power Apps em uma página da Web, consulte Adicionar um gráfico em uma página da Web no portal.

{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}

Parâmetros

Existem dois parâmetros a serem fornecidos com a marca do gráfico: id do gráfico e viewid.

id do gráfico

ID de Visualização do gráfico. Você pode obter isso ao exportar o gráfico.

viewid

ID da tabela quando estiver aberta no editor de exibição.

powerbi

Adiciona os painéis e relatórios do Power BI dentro das páginas. A marca do gráfico pode ser adicionada ao campo Copiar em uma página da Web ou ao campo Origem em um Modelo da Web. Para obter as etapas de adição de um relatório ou painel do Power BI a uma página da Web no portal, consulte Adicionar um relatório ou painel do Power BI a uma página da Web no portal.

Observação

Para que a marca funcione, é necessário habilitar a integração do Power BI no centro de administração de portais no Power Apps. Se a integração do Power BI não estiver habilitada, o painel ou relatório não será exibido.

Parâmetros

A marca powerbi aceita os seguintes parâmetros:

caminho

Caminho do relatório ou painel do Power BI. Se o relatório ou painel do Power BI estiver seguro, você deverá fornecer o tipo de autenticação.

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

authentication_type

Tipo de autenticação necessário para o relatório ou painel do Power BI. Os valores válidos desse parâmetro são:

  • Anonymous: permite que você insira relatórios do Power BI para publicação na Web. O tipo de autenticação anônima padrão é Anônimo. Ao usar o tipo de autenticação como Anônimo, você deve obter a URL do relatório do Power BI conforme descrito em: Publicar na Web do Power BI

  • AAD: permite compartilhar relatórios ou painéis seguros do Power BI com os usuários autenticados do Azure Active Directory no Power BI.

  • powerbiembedded: permite que você compartilhe relatórios ou painéis protegidos do Power BI com usuários externos que não tenham licença do Power BI nem a configuração de autenticação do Azure Active Directory. Para obter informações sobre a configuração do serviço Power BI Embedded, consulte Habilitar o serviço Power BI Embedded.

Ao adicionar o relatório ou painel protegido do Power BI, verifique se ele foi compartilhado com os serviços do portal do Azure Active Directory ou do Power BI Embedded.

Observação

Os valores do parâmetro authentication_type não fazem diferenciação entre maiúsculas e minúsculas.

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

Você também pode filtrar o relatório em um ou vários valores. A sintaxe para filtrar o relatório é:

URL?filter=Table/Field eq 'value'

Por exemplo, suponha que deseja filtrar o relatório para ver dados de um contado chamado Bert Hair. Você deve acrescentar a URL com os seguintes dados:

?filter=Executives/Executive eq 'Bert Hair'

O código completo será:

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq 'Bert Hair'" %}

Mais informações sobre filtrar o relatório: Filtrar um relatório usando os parâmetros de cadeia de consulta na URL

Observação

Relatório anônimo não oferece suporte a filtragem.

Você também pode criar um caminho dinâmico usando a variável líquida capture como abaixo:

{% capture pbi_path %}https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq '{{user.id}}'{% endcapture %}
{% powerbi authentication_type:"AAD" path:pbi_path %}

Mais informações sobre variável líquida Marcas de variável

tileid

Exibe o bloco específico do painel. Você deve fornecer a ID do bloco.

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/dashboards/00000000-0000-0000-0000-000000000001" tileid:"00000000-0000-0000-0000-000000000002" %}

funções

Funções atribuídas ao relatório do Power BI. Esse parâmetro funciona somente quando o parâmetro authentication_type é definido como powerbiembedded.

Se você tiver definido funções no Power BI e as atribuiu a relatórios, será preciso especificar as funções apropriadas na marca Líquida powerbi. As funções permitem filtrar os dados a serem exibidos em um relatório. Você pode especificar várias funções separadas por uma vírgula. Para obter mais informações sobre como definir funções no Power BI, consulte RLS (Segurança em nível de linha) com o Power BI.

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:"Region_East,Region_West" %}

Se você tiver atribuído uma função a um relatório do Power BI e não especificou o parâmetro roles na marca Líquida ou não especificou uma função no parâmetro, um erro será exibido.

Dica

Se quiser usar as funções Web definidas no seu portal como as funções do Power BI, você poderá definir uma variável e atribuir funções Web a ela. É possível usar a variável definida na marca Líquida.

Digamos que você definiu duas funções Web como Region_East e Region_West no portal. É possível adicioná-las usando o código: {% assign webroles = user.roles | join: ", " %}

No snippet de código acima, webroles é uma variável e as funções Web Region_East e Region_West serão armazenadas nela.

Use a variável webroles como se segue na marca Líquida:

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:webroles%}

editável

Renderiza um objeto CMS dos portais do Power Apps como editáveis no portal, para usuários com permissão de edição de conteúdo para esse objeto. Objetos editáveis incluem página, trechos de código, e weblinks.

{% editable page 'adx_copy' type: 'html', title: 'Page Copy', escape: false, liquid: true %}

{% editable snippets Header type: 'html' %}

<!--

An editable web link set required a specific DOM structure, with

certain classes on the containing element, as demonstrated here.

-->

{% assign primary_nav = weblinks[Primary Navigation] %}

{% if primary_nav %}

<div {% if primary_nav.editable %}class=xrm-entity xrm-editable-adx_weblinkset{% endif %}>

<ul>

<!-- Render weblinks... -->

</ul>

{% editable primary_nav %}

</div>

{% endif %}

Parâmetros

O primeiro parâmetro fornecido para edição é o objeto editável, como um conjunto de links da Web, trechos ou a página atual. O segundo parâmetros opcional é especificar um nome ou uma chave de atributos nesse objeto que deve ser renderizado e editado. Esse valor ser o nome de uma tabela, um atributo ou um nome de trecho, por exemplo.

Depois desses parâmetros iniciais, a marca oferece suporte a vários parâmetros nomeados opcionais.

classe

Especifica um valor de atributo de classe do elemento raiz renderizado nesta marca.

padrão

Um valor padrão na ocorrência a ser renderizado em que o item editável não tem nenhum valor.

escape

Um valor booliano que indica se um valor renderizado por essa marca será codificado por HTML. Esse valor é falso por padrão.

líquido

Um valor booliano que indica se algum código líquido de modelo localizado no valor de texto renderizado nesta marca será processado. Esse valor é verdadeiro por padrão.

marca

O nome das marcas de HTML do contêiner que serão renderizadas nesta marca. Essa marca renderizará elementos div por padrão. É recomendável que você escolha entre div ou span como um valor para esse parâmetro.

título

Especifique um rótulo para o item editável na interface do conteúdo de edição. Caso não seja fornecido um rótulo, ele será gerado automaticamente.

tipo

Um valor da cadeia de caracteres que indica o tipo da interface de edição pode ser editável para valores do texto. Os valores válidos para esse parâmetro são html ou texto. O padrão é html.

entitylist

Carregar uma determinada lista de tabelas, como nome ou a identificação. As propriedades da lista podem ser acessadas usando um objeto entitylist que ficará disponível no bloco de marca. Para renderizar os registros do resultado real da lista, use a marca entityview no bloco.

Se a lista for carregada com êxito, o conteúdo do pacote estará renderizado. Se a lista não for encontrada, o conteúdo do bloco não será renderizado.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Por padrão, o objeto de lista de entidades receberá o nome variável de entitylist. Opcionalmente, variável de um nome diferente pode ser fornecido.

{% entitylist my_list = name:My List %}

Loaded list {{ my_list.adx_name }}.

{% endentitylist %}

Parâmetros

Forneça somente um da ID, nome ou chave para selecionar a Lista a ser carregada.

id

Carrega uma lista por ID de GUID. id deve ser uma cadeia de caracteres que pode ser analisada como GUID.

{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Geralmente, as cadeias de caracteres literais GUID não serão usadas. Em vez disso, a identificação será especificada usando uma propriedade GUID de outra variável.

{% entitylist id:page.adx_entitylist.id %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

nome

Carrega uma lista por nome.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

chave

Carrega uma lista por ID ou nome. Se o valor de chave fornecido puder ser analisado como um GUID, a lista será carregada por ID. Caso contrário, será carregado por nome.

<!-- key_variable can hold an ID or name -->

{% entitylist key:key_variable %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

código de_idioma

Um código de idioma do inteiro do Power Apps para selecionar os rótulos encontrados na lista a serem carregados. Caso não seja fornecido código de_idioma, o idioma padrão de conexão de Power Apps do portal do aplicativo será usado.

{% entitylist name:"My List", language_code:1033 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

entityview

Carregar uma determinada exibição de Power Apps, como nome ou a identificação. As propriedades de exibição ߝ de metadados da coluna, registros de resultado paginado, etc. podem ser acessados usando um objeto entityview que estará disponível dentro do bloco de marca.

Se a exibição é carregada com êxito, o conteúdo do pacote estará renderizado. Se a exibição não for encontrada, o conteúdo do bloco não será renderizado.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Por padrão, o objeto de exibição de entidade receberá o nome variável de entityview. Opcionalmente, variável de um nome diferente pode ser fornecido.

{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ my_view.total_records }} total records.

{% endentityview %}

Se a entityview é aninhada a um bloco de entitylist, ela herda a configuração padrão (tamanho da página de resultados, opções de filtragem, etc.) da lista. Se os parâmetros de exibição de identificação ou nome não forem fornecidos à entityview, ela carregará a exibição padrão da entitylist anexa.

{% entitylist id:page.adx_entitylist.id %}

{% entityview %}

Loaded default view of the list associated with the current page, with {{ entityview.total_records }} total records.

{% endentityview %}

{% endentitylist %}

Parâmetros

Fornecer uma id ou um nome_lógico com denominação para selecionar a exibição do Power Apps a ser carregada. Se nenhum será fornecido, e a marca de exibição da entidade está aninhada em uma marca de lista da entidade, a exibição padrão de lista de entidade incluída será carregada.

id

id deve ser uma cadeia de caracteres que pode ser analisada como GUID.

{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded entity view {{ entityview.name }}.

{% endentityview %}

Geralmente, as cadeias de caracteres literais GUID não serão usadas. Em vez disso, a identificação será especificada usando uma propriedade GUID de outra variável.

{% entityview id:request.params.view %}

Loaded entity view {{ entityview.name }} using view query string request parameter.

{% endentityview %}

nome_lógico

O nome lógico da entidade do Power Apps da exibição a ser carregada. Deve ser usado em combinação com o nome.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

nome

O nome do Power Apps da visualização a ser carregada. Deve ser usado em combinação com o nome_lógico.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

filtro

Especifica filtrar a exibição de resultados por usuário ou conta. Deve ter um valor da cadeia de caracteres de usuário ou conta.

{% entityview id:request.params.view, filter:'user' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Um caso de uso comum é definir esse parâmetro com base em uma solicitação.

{% entityview id:request.params.view, filter:request.params.filter %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

metafiltro

Especifica a expressão de filtragem dos metadados de lista de resultados para filtrar por exibição. Esse parâmetro é válido apenas quando a entityview é utilizada em combinação com a entitylist. Na maioria dos casos, esse parâmetro é definido com base em uma solicitação.

{% entitylist id:page.adx_entitylist.id %}

{% entityview id:request.params.view, metafilter:request.params.mf %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

{% endentitylist %}

ordem

Especifica uma expressão para o tipo da exibição. Uma expressão do tipo pode conter um ou vários nomes lógicos de atributos de entidade, acompanhados por uma ordem de classificação ASC ou DESC.

{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Um caso de uso comum é definir esse parâmetro com base em uma solicitação.

{% entityview id:request.params.view, order:request.params.order %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

página

Especifica a página do resultado a ser carregado. Se esse parâmetro não for especificado, a primeira página de resultados será carregada.

Esse parâmetro deve ser passado em um valor inteiro, ou em uma cadeia de caracteres que pode ser analisada e apresentada como um inteiro. Se um valor for fornecido para esse parâmetro, mas o valor for nulo ou se não puder ser analisado com um inteiro, a primeira página de resultados será carregada.

{% entityview id:request.params.view, page:2 %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Um caso de uso comum é definir esse parâmetro com base em uma solicitação.

{% entityview id:request.params.view, page:request.params.page %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

tamanho da_página

Especifica o número de resultados para carregar de resultados da página atual. Se nenhum valor for fornecido para esse parâmetro, e a entityview for usada em um bloco de entitylist, o tamanho da página da lista será usado. Se não estiver em um bloco de entitylist, um valor padrão 10 será usado.

Esse parâmetro deve ser passado em um valor inteiro, ou em uma cadeia de caracteres que pode ser analisada e apresentada como um inteiro. Se um valor for fornecido para esse parâmetro, mas o valor for nulo ou não puder ser analisado como um inteiro, o tamanho da página padrão será usado.

{% entityview id:request.params.view, page_size:20 %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Um caso de uso comum é definir esse parâmetro com base em uma solicitação.

{% entityview id:request.params.view, page_size:request.params.pagesize %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

pesquisar

Especifica uma expressão de pesquisa que filtra por resultados da exibição. Expressões simples das pesquisas de palavras-chave filtram os atributos à procura da palavra-chave. As * curingas também podem ser incluídas na expressão.

{% entityview id:request.params.view, search:'John\*' %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

Um caso de uso comum é definir esse parâmetro com base em uma solicitação, para que o filtro de pesquisa possa ser definido com base nas informações do usuário.

{% entityview id:request.params.view, search:request.params.search %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

código de_idioma

Um código de idioma do inteiro do Power Apps para selecionar os rótulos encontrados de exibição de entidade (rótulos de cabeçalho de coluna, etc.) a ser carregado. Caso não seja fornecido código de_idioma, o idioma padrão de conexão de Power Apps do portal do aplicativo será usado.

Se a entityview é usada em um bloco da entitylist, a entityview herda a configuração do código de idioma da entitylist.

{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}

Loaded entity view {{ entityview.name }}.

{% endentitylist %}

searchindex

Executar uma consulta para o índice do portal de pesquisa. Os resultados correspondentes podem ser acessados usando um searchindex que ficará disponível no bloco de marca.

{% searchindex query: 'support', page: params.page, page_size: 10 %}

{% if searchindex.results.size > 0 %}

<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>

<ul>

{% for result in searchindex.results %}

<li>

<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>

<p>{{ result.fragment }}</p>

</li>

{% endfor %}

</ul>

{% else %}

<p>Your query returned no results.</p>

{% endif %}

{% endsearchindex %}

<style>

    .highlight {background-color: #FFFCAC;}

</style>

Por padrão, o objeto de índice de pesquisa receberá o nome variável de searchindex. Opcionalmente, variável de um nome diferente pode ser fornecido.

{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}

{% if liquid_search.results.size > 0 %}

...

{% endif %}

{% endsearchindex %}

Parâmetros

A marca searchindex aceita os seguintes parâmetros.

consulta

A consulta usada para combinar resultados. Esse parâmetro deve aceitar a parte especificado pelo usuário do índice de consulta (se for o caso.)

{% searchindex query: 'support' %}

...

{% endsearchindex %}

Um caso de uso comum é definir esse parâmetro com base em uma solicitação.

{% searchindex query: request.params.query %}

...

{% endsearchindex %}

Esse parâmetro oferece suporte à sintaxe do Analisador de Consulta Lucene.

filtro

Uma consulta adicional usada para combinar resultados. Esse parâmetro deve conter um filtro desenvolvedor especificado para resultados, se desejar.

{% searchindex query: request.params.query, filter: '+statecode:0' %}

...

{% endsearchindex %}

Esse parâmetro oferece suporte à sintaxe do Analisador de Consulta Lucene.

Observação

A diferença entre filtro e consulta é que enquanto ambos aceitam a sintaxe do analisador de consulta Lucene, a consulta tende a ser mais complacente sobre como essa sintaxe é analisada ߝ pois a maior parte dos usuários finais não tem conhecimento da sintaxe. Assim, na ocorrência de análise, conforme a falha dessa sintaxe, toda a consulta será enviada e escapada como texto de consulta. o filtro, por outro lado, será estritamente analisado e retornará um erro se houver ocorrência de sintaxe inválida.

nomes_lógicos

Nomes lógicos de entidade do Power Apps para os quais resultados combinatórias serão restritos, como uma cadeia de caracteres delimitada por vírgula. Se não fornecido, todas as entidades combinatórias serão devolvidas.

{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}

...
>
{% endsearchindex %}

página

A página de resultados de pesquisa a ser retornada. Se não, desde a primeira página (1) é retornada.

{% searchindex query: request.params.query, page: 2 %}

...

{% endsearchindex %}

Um caso de uso comum é definir esse parâmetro com base em uma solicitação.

{% searchindex query: request.params.query, page: request.params.page %}

...

{% endsearchindex %}

tamanho da_página

O tamanho da página de resultados a ser retornado. Se não fornecido, um tamanho padrão de 10 será usado.

{% searchindex query: request.params.query, page_size: 20 %}

...

{% endsearchindex %}

entityform

Renderiza totalmente formulários básicos configurados pelo Power Apps, por nome ou ID.

Observação

A marca do entityform fica disponível somente para uso no conteúdo renderizado em um modelo de página com base em modelo da web. Ao tentar usar um modelo reescrito de marca na página, ele não renderizará nada. Você só pode renderizar uma marca de entityform ou formulário da Web por página. marcas de entityform ou formulário da Web não serão renderizadas depois da primeira.

{% entityform name: 'My Basic Form' %}

Parâmetros

nome

O nome do formulário básico que deseja carregar.

{% entityform name:My Basic Form %}

formulário da Web

Renderiza totalmente um formulário de várias etapas configurado pelo Power Apps, por nome ou ID. A marca do formulário da Web fica disponível para uso somente no conteúdo renderizado em um modelo de página baseado em um modelo da Web. Ao tentar usar um modelo reescrito de marca na página, ele não renderizará nada. Você só pode renderizar uma marca de entityform ou formulário da Web por página. marcas de entityform ou formulário da Web não serão renderizadas depois da primeira.

{% webform name: 'My Multistep Form' %}

Parâmetros

nome

O nome do Formulário de Várias Etapas que você deseja carregar.

{% webform name:My Multistep Form %}

codecomponent

Permite inserir componentes de código por meio de uma marca Liquid. Por exemplo, adicionar um controle personalizado de exibição de mapa a uma página da Web.

Importante

  • Esse é um recurso de visualização.
  • Os recursos de visualização não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e fornecer comentários.

Parâmetros

nome

A Id ou o nome do componente de código.

propriedade

Os valores das propriedades que o componente de código espera precisam ser passados como um par de chave/valor separado por ":" (sinal de dois pontos), no qual a chave é o nome da propriedade e o valor é o valor da cadeia de caracteres JSON.

{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}

Observação

As propriedades necessárias podem ser diferentes dependendo do componente escolhido.

Consulte Usar a marca de modelo do Liquid para componentes.

Confira também

Marcas de fluxo de controle
Marcas de iteração
Marcas de variável
Marcas de modelo

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).