SummaryCard Affiche un chiffre, grand, sous une étiquette — un pipeline ouvert, un compte de cas, un taux de victoire — et SummaryCards en dispose plusieurs en ligne qui s’enroulent sur un écran étroit. Une carte affiche une valeur que vous lui donnez, une colonne de l’enregistrement sur lequel elle se trouve, ou un chiffre que Dataverse calcule sur les enregistrements : un total, une moyenne, un minimum, un maximum ou un compte, formaté par le serveur dans la culture utilisateur. C’est pareil pour Blazor et React.
<SummaryCards>
<SummaryCard
label="Pipeline ouvert"
fetchXml={OPEN_DEALS}
columnName="estimatedvalue"
aggregate={QueryAggregate.Sum}
format="C0"
/>
...
</SummaryCards><SummaryCards>
<SummaryCard Label="Pipeline ouvert"
FetchXml="@OpenDeals"
ColumnName="estimatedvalue"
Aggregate="QueryAggregate.Sum"
Format="C0" />
...
</SummaryCards>Dans un contexte d’enregistrement, RelationshipName (relationshipName dans React) conserve les enregistrements à ceux liés à l’enregistrement, comme le fait a SubGrid . Avec un FetchXml ou ViewId également, ses filtres choisissent parmi eux ; sans compter, chaque enregistrement associé compte. Un compte n’a pas besoin de colonne : il compte les enregistrements. Le chiffre est calculé à nouveau lorsque le contexte de l’enregistrement se rafraîchit ou sauvegarde, et un enregistrement non encore enregistré n’en a pas. La démo Account 360 en a quatre en haut d’un compte.
<RecordContext table="account" id={accountId}>
<SummaryCard
label="Contacts"
relationshipName="contact_customer_accounts"
aggregate={QueryAggregate.Count}
/>
</RecordContext><RecordContext TableName="account" RecordId="@accountId">
<SummaryCard Label="Contacts"
RelationshipName="contact_customer_accounts"
Aggregate="QueryAggregate.Count" />
</RecordContext>Sans Aggregate (aggregate), ColumnName (columnName) affiche la valeur propre de l’enregistrement à la colonne, formatée comme l’indique sa forme. Value (value) montre une figure que la page calcule elle-même.
<SummaryCard label="Est. revenus" columnName="estimatedvalue" /><SummaryCard Label="Est. revenus" ColumnName="estimatedvalue" />Caption (caption) met une ligne sous la figure. Avec CaptionAggregate (captionAggregate), {0} il y a une seconde figure sur les mêmes enregistrements, calculée dans la même demande. Avec OfFetchXml ou OfViewId (ofFetchXml, ofViewId), la carte affiche sa valeur comme une part de la même figure sur ces enregistrements : un pourcentage, avec une barre en dessous sauf ShowProgressBar si (showProgressBar) est false.
<SummaryCard
label="Taux de victoire"
fetchXml={WON_DEALS}
ofFetchXml={CLOSED_DEALS}
aggregate={QueryAggregate.Count}
caption="{0} accords remportés"
captionAggregate={QueryAggregate.Count}
/><SummaryCard Label="Taux de victoire"
FetchXml="@WonDeals"
OfFetchXml="@ClosedDeals"
Aggregate="QueryAggregate.Count"
Caption="{0} accords remportés"
CaptionAggregate="QueryAggregate.Count" />OnClick (onClick) fait de la carte un bouton : un clic, Entrée ou Espace la relevant. Href (href) en fait un lien, qui s’ouvre dans un nouvel onglet comme n’importe quel autre ; dans Réacte, onNavigate elle la suiv via votre routeur par un simple clic.
Quatre chiffres sur chaque transaction dans les données de la démo : le pipeline ouvert et le nombre d’affaires qui le composent, la moyenne des transactions ouvertes, les revenus obtenus et la part des transactions conclues qui ont été remportées. Cliquez sur le pipeline pour lister ses transactions. L’argent est dans la monnaie de base de l’organisation.
Nom | Type | Par défaut | Description |
|---|---|---|---|
Aggregate | QueryAggregate? | La figure à déterminer sur les archives : un Models.QueryAggregate seul à lui-même, pas un combinaison. En déposition, la carte affiche SummaryCard.ColumnNamela valeur de de sur l’enregistrement en cascade. | |
Caption | string? | Une ligne sous la figure. Avec SummaryCard.CaptionAggregate, | |
CaptionAggregate | QueryAggregate? | Un second chiffre pour SummaryCard.Caption, a été calculé sur les mêmes records que le premier. La légende apparaît dès qu’elle arrive. | |
CaptionColumnName | string? | La colonne SummaryCard.CaptionAggregate est calculée par-dessus. Non placé, un compte compte compte le Les records et tout autre chiffre sont calculés à partir SummaryCard.ColumnNamede . | |
ChildContent | RenderFragment? | Tout ce qui est sous la figure. | |
ColumnName | string? | La colonne du chiffre est : celle SummaryCard.Aggregate qui est calculée — | |
FetchXml | string? | La requête dont la figure est calculée est enregistrée, à la place de SummaryCard.ViewId. Son Les filtres choisissent les enregistrements ; ses colonnes, le tri et la pagination n’ont pas d’importance. | |
Format | string? | Un format numérique .NET pour une figure calculée — | |
Href | string? | Cela fait de la carte un lien vers cette adresse. | |
Icon | Icon? | L’icône à côté de la figure. Aucune par défaut. | |
Label* | string | Le chiffre : « pipeline ouvert », « taux de victoire ». | |
OfFetchXml | string? | La requête des enregistrements de la part de la figure, à la place de SummaryCard.OfViewId. | |
OfViewId | Guid? | La vue Dataverse des enregistrements dont la figure est partagée. Une fois la carte posée, la carte affiche sa figure divisé par le même montant sur ces registres, conservé sur les mêmes documents liés. | |
Record | TableRecord? | Le record auquel appartient la carte, en cascade par le contexte du record environnant. | |
RelationshipName | string? | Conserve les enregistrements comme ceux liés au registre en cascade via cette relation, en tant qu’un SummaryCard.ViewId ou SummaryCard.FetchXml, chaque enregistrement associé compte. Jusqu’à ce que Le dossier est sauvegardé il n’y a pas de chiffre. | |
SelfReferencingRole | EntityRole? | De quel côté d’un auto-référentiel plusieurs-à-plusieurs SummaryCard.RelationshipName la cascade Enregistrement est en place. Nécessaire pour une telle relation, ignoré pour toute autre. | |
ShowProgressBar | bool | True | Affiche aussi un ratio en barre, sous le pourcentage. Par défaut à true. |
Value | string? | La figure, telle qu’elle est montrée. Set, elle est représentée à la place de toute autre. | |
ViewId | Guid? | La vue Dataverse dont les archives sont calculées sur la figure. |
AggregateModels.QueryAggregate seul à lui-même, pas un combinaison. En déposition, la carte affiche SummaryCard.ColumnNamela valeur de de sur l’enregistrement en cascade.CaptionSummaryCard.CaptionAggregate, CaptionAggregateSummaryCard.Caption, a été calculé sur les mêmes records que le premier. La légende apparaît dès qu’elle arrive.CaptionColumnNameSummaryCard.CaptionAggregate est calculée par-dessus. Non placé, un compte compte compte le Les records et tout autre chiffre sont calculés à partir SummaryCard.ColumnNamede .ChildContentColumnNameSummaryCard.Aggregate qui est calculée — FetchXmlSummaryCard.ViewId. Son Les filtres choisissent les enregistrements ; ses colonnes, le tri et la pagination n’ont pas d’importance.FormatHrefIconLabel*OfFetchXmlSummaryCard.OfViewId.OfViewIdRecordRelationshipNameSummaryCard.ViewId ou SummaryCard.FetchXml, chaque enregistrement associé compte. Jusqu’à ce que Le dossier est sauvegardé il n’y a pas de chiffre.SelfReferencingRoleSummaryCard.RelationshipName la cascade Enregistrement est en place. Nécessaire pour une telle relation, ignoré pour toute autre.ShowProgressBartrue.ValueViewIdNom | Type | Description |
|---|---|---|
OnClick | EventCallback<MouseEventArgs> | Ça fait de la carte un bouton, qui se lève lorsqu’on clique ou appuie sur Entrée ou Espace. |
OnClickNom | Type | Par défaut | Description |
|---|---|---|---|
ChildContent | RenderFragment? | Les cartes. | |
MinCardWidth | string | 220px | La carte la plus étroite est tirée, en longueur CSS : moins s’insèrent sur une rangée une fois qu’ils seraient Plus étroit. Par défaut, |
ChildContentMinCardWidth