SummaryCard mostra um número, grande, sob um rótulo — um pipeline aberto, uma contagem de casos, uma taxa de vitória — e SummaryCards apresenta vários em linha que se enrolam em uma tela estreita. Um cartão mostra um valor que você atribui, uma coluna do registro em que ele está, ou um valor que o Dataverse calcula sobre registros: total, média, mínimo, máximo ou contagem, formatado pelo servidor na cultura do usuário. O mesmo vale para Blazor e React.
<SummaryCards>
<SummaryCard
label="Pipeline aberto"
fetchXml={OPEN_DEALS}
columnName="estimatedvalue"
aggregate={QueryAggregate.Sum}
format="C0"
/>
...
</SummaryCards><SummaryCards>
<SummaryCard Label="Pipeline aberto"
FetchXml="@OpenDeals"
ColumnName="estimatedvalue"
Aggregate="QueryAggregate.Sum"
Format="C0" />
...
</SummaryCards>Dentro de um contexto de registro, RelationshipName (relationshipName no React ) mantém os registros com aqueles relacionados ao registro, assim como o SubGrid faz. Com um FetchXml ou ViewId também, seus filtros escolhem entre eles; sem, todo registro relacionado conta. Uma contagem não precisa de coluna: ela conta os registros. A figura é calculada novamente quando o contexto do registro atualiza ou salva, e um registro ainda não salvo não tem nenhum. A demo do Account 360 tem quatro no topo da conta.
<RecordContext table="account" id={accountId}>
<SummaryCard
label="Contatos"
relationshipName="contact_customer_accounts"
aggregate={QueryAggregate.Count}
/>
</RecordContext><RecordContext TableName="account" RecordId="@accountId">
<SummaryCard Label="Contatos"
RelationshipName="contact_customer_accounts"
Aggregate="QueryAggregate.Count" />
</RecordContext>Sem um Aggregate (aggregate), ColumnName (columnName) mostra o valor próprio da coluna do registro, formatado conforme sua forma indica. Value (value) mostra um valor que a página calcula sozinha.
<SummaryCard label="Receita estimada" columnName="estimatedvalue" /><SummaryCard Label="Receita estimada" ColumnName="estimatedvalue" />Caption (caption) coloca uma linha abaixo da figura. Com CaptionAggregate (captionAggregate), {0} em ela há um segundo valor sobre os mesmos registros, calculado no mesmo pedido. Com OfFetchXml ou OfViewId (ofFetchXml, ofViewId), o cartão mostra seu valor como uma parte do mesmo valor sobre esses registros: uma porcentagem, com uma barra abaixo, a menos que ShowProgressBar (showProgressBar) seja false.
<SummaryCard
label="Taxa de vitória"
fetchXml={WON_DEALS}
ofFetchXml={CLOSED_DEALS}
aggregate={QueryAggregate.Count}
caption="{0} acordos conquistados"
captionAggregate={QueryAggregate.Count}
/><SummaryCard Label="Taxa de vitória"
FetchXml="@WonDeals"
OfFetchXml="@ClosedDeals"
Aggregate="QueryAggregate.Count"
Caption="{0} acordos conquistados"
CaptionAggregate="QueryAggregate.Count" />OnClick (onClick) transforma a carta em um botão: um clique, Enter ou Espaço a eleva. Href (href) faz dela um link, que abre em uma nova aba como qualquer outra; no React, onNavigate ela segue pelo roteador com um clique simples.
Quatro dígitos em cada negócio nos dados da demonstração: o pipeline aberto e quantos negócios o compõem, a média de negócios abertos, a receita obtida e a participação de negócios fechados que foram conquistados. Clique no pipeline para listar seus negócios. O dinheiro está na moeda base da organização.
Nome | Tipo | Padrão | Descrição |
|---|---|---|---|
Aggregate | QueryAggregate? | A figura a ser calculada sobre os registros: um Models.QueryAggregate por si só, não um combinação. Sem ajuste, a carta mostra SummaryCard.ColumnNameo valor de ' no registro em cascata. | |
Caption | string? | Uma linha sob a figura. Com SummaryCard.CaptionAggregate, | |
CaptionAggregate | QueryAggregate? | Um segundo valor para SummaryCard.Caption, foi calculado sobre os mesmos registros do primeiro. A legenda aparece assim que chega. | |
CaptionColumnName | string? | A coluna SummaryCard.CaptionAggregate é calculada por cima. Sem colocação, uma contagem conta o Registros e qualquer outro valor são calculados por cima SummaryCard.ColumnName. | |
ChildContent | RenderFragment? | Qualquer coisa abaixo da figura. | |
ColumnName | string? | A coluna do número é: aquele SummaryCard.Aggregate que é calculado — | |
FetchXml | string? | A consulta cujo registro é calculado o número, no lugar de SummaryCard.ViewId. É Filtros escolhem os registros; suas colunas, ordenação e paginação não importam. | |
Format | string? | Um formato numérico .NET para uma figura trabalhada — | |
Href | string? | Faz do cartão um link para esse endereço. | |
Icon | Icon? | O ícone ao lado da figura. Nenhum por padrão. | |
Label* | string | Qual é o número: 'Pipeline aberto', 'Taxa de vitória'. | |
OfFetchXml | string? | A consulta dos registros em que a figura é uma parte, no lugar de SummaryCard.OfViewId. | |
OfViewId | Guid? | A visão do Dataverse dos registros dos quais a figura é compartilhada. Set, a carta mostra sua figura dividido pelo mesmo valor sobre esses registros, mantido nos mesmos registros relacionados. | |
Record | TableRecord? | O registro ao qual o cartão pertence, em cascata pelo contexto do registro ao redor. | |
RelationshipName | string? | Mantém os registros com aqueles relacionados ao registro em cascata por meio dessa relação, como um SummaryCard.ViewId ou SummaryCard.FetchXml, todo registro relacionado conta. Até o registro é salvo, não há número. | |
SelfReferencingRole | EntityRole? | De que lado de um auto-referencial muitos-para-muitos SummaryCard.RelationshipName , a cascata Registro está ligado. Exigido para tal relacionamento, ignorado por qualquer outro. | |
ShowProgressBar | bool | True | Mostra uma razão como barra também, abaixo da porcentagem. Padrão para true. |
Value | string? | A figura, como é mostrada. Set, ela é mostrada no lugar de qualquer outra. | |
ViewId | Guid? | A visão do Dataverse cujos registros são calculados no número. |
AggregateModels.QueryAggregate por si só, não um combinação. Sem ajuste, a carta mostra SummaryCard.ColumnNameo valor de ' no registro em cascata.CaptionSummaryCard.CaptionAggregate, CaptionAggregateSummaryCard.Caption, foi calculado sobre os mesmos registros do primeiro. A legenda aparece assim que chega.CaptionColumnNameSummaryCard.CaptionAggregate é calculada por cima. Sem colocação, uma contagem conta o Registros e qualquer outro valor são calculados por cima SummaryCard.ColumnName.ChildContentColumnNameSummaryCard.Aggregate que é calculado — FetchXmlSummaryCard.ViewId. É Filtros escolhem os registros; suas colunas, ordenação e paginação não importam.FormatHrefIconLabel*OfFetchXmlSummaryCard.OfViewId.OfViewIdRecordRelationshipNameSummaryCard.ViewId ou SummaryCard.FetchXml, todo registro relacionado conta. Até o registro é salvo, não há número.SelfReferencingRoleSummaryCard.RelationshipName , a cascata Registro está ligado. Exigido para tal relacionamento, ignorado por qualquer outro.ShowProgressBartrue.ValueViewIdNome | Tipo | Descrição |
|---|---|---|
OnClick | EventCallback<MouseEventArgs> | Faz da carta um botão, levantada quando é clicada ou pressionada com Enter ou Espaço. |
OnClickNome | Tipo | Padrão | Descrição |
|---|---|---|---|
ChildContent | RenderFragment? | As cartas. | |
MinCardWidth | string | 220px | O mais estreito que uma carta é tirada, como um comprimento CSS: menos cabem em uma fileira quando seriam Mais estreito. Padrão é |
ChildContentMinCardWidth