Attributs calculés et attributs de report

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Les attributs calculés et de rapport sont essentiels, car ils dispensent l'utilisateur de devoir exécuter manuellement des calculs ; l'utilisateur peut ainsi se concentrer sur son travail. Désormais, les administrateurs systèmes peuvent facilement définir un champ pour contenir la valeur de la plupart des calculs courants sans avoir à collaborer avec un développeur. Les développeurs peuvent aussi mettre à profit les fonctionnalités de la plateforme pour effectuer ces calculs plutôt qu'au sein de leur propre code.

Vidéo : Champs cumulatifs et calculés dans Microsoft Dynamics CRM 2015

Contenu de la rubrique

Éléments communs et fonctionnalités

Attributs calculés

Attributs de report

Énumération SourceTypeMasks

Éléments communs et fonctionnalités

Les attributs calculés et de report partagent certains éléments communs et fonctionnalités, par exemple :

• Ils sont en lecture seule.

• Ils ne sont pas spécifiques à l'utilisateur. Comme le calcul est effectué avec un compte d'utilisateur système, les valeurs peuvent être basées sur les enregistrements pour lesquels l'utilisateur ne possède pas autrement les privilèges d'affichage, comme les attributs dont la sécurité est activée au niveau du champ.

Tous les attributs qui héritent de AttributeMetadata ont une propriété SourceType pouvant contenir les valeurs affichées dans le tableau suivant.

Les attributs calculés et de report sont basés sur les types d'attributs existants qui héritent de AttributeMetadata. Les types d'attributs suivants ont de nouvelles propriétés :

• BooleanAttributeMetadata

• DateTimeAttributeMetadata

• DecimalAttributeMetadata

• IntegerAttributeMetadata

• MoneyAttributeMetadata

• PicklistAttributeMetadata

• StringAttributeMetadata

Chacun de ces types d'attributs a les propriétés suivantes pour prendre en charge les calculs et les reports.

Attributs calculés

Les attributs calculés en temps réel quand ils sont récupérés. Les attributs calculés peuvent être composée en utilisant différents types de données. Par exemple, un attribut Integer calculé peut référencer les valeurs des attributs Decimal ou Currency.Pour plus d'informations :TechNet : Définir des champs calculés.

Les valeurs d'attributs calculés sont disponibles dans le pipeline du plug-in de récupération. La post-image de la mise à jour ou de la création d'un enregistrements d'entité contient la valeur d'attribut calculé de l'étape 40.Pour plus d'informations :Pipeline d’exécution des événements

Limitations

Vous ne pouvez pas utiliser les valeurs des attributs calculés qui font référence à une entité associée, à un autre attribut calculé ou à une valeur logique de la même entité pour trier les données renvoyées par une requête. Bien que votre requête puisse spécifier que les résultats doivent être classés à l'aide d'un attribut calculé, le sens du tri est ignoré et ne lève aucune erreur. Si l'attribut calculé référence seulement les valeurs simples du même enregistrement, le tri fonctionne normalement. Vous pouvez déterminer les sources utilisées dans un champ calculé à l'aide de la propriété d'SourceTypeMask des métadonnées d'attribut.Pour plus d'informations :Attributs logiques

Seuls les attributs d'une entité parente immédiate peuvent être utilisés dans un attribut calculé.

Les requêtes, graphiques et visualisations enregistrés peuvent comporter un maximum de 10 champs calculés uniques.

Les attributs calculés peuvent faire référence à d'autres attributs calculés dans leur formule, mais ils ne peuvent pas faire référence à eux-mêmes.

Les attributs calculés ne disposent pas de valeurs lorsqu'un utilisateur avec Microsoft Dynamics 365 pour Outlook est en mode hors connexion.

Les propriétés de métadonnées MaxValue et MinValue ne peuvent pas être définies sur les attributs calculés.

Attributs de report

Comme les attributs de report demeurent dans la base de données, ils peuvent être utilisés pour filtrer ou trier comme les attributs réguliers. Tout type de processus ou de plug-in utilise la valeur calculée de l'attribut la plus récente. Les valeurs d'attribut de report sont calculées de façon asynchrone par les tâches système planifiées. Les administrateurs définissent à quel moment une tâche est exécuté ou suspendue. Par défaut, chaque attribut est mis à jour toutes les heures.Pour plus d'informations :TechNet : Définition de champs cumulatifs.

Lorsqu'un attribut de report est créé ou mis à jour, une tâche Champs cumulatifs calculés en masse est planifiée pour s'exécuter en 12 heures. Le délai de 12 heures est conçu pour exécuter cette opération sollicitant de nombreuses ressources pendant une période qui affecte le moins les utilisateurs. Une fois la tâche terminée, sa prochaine exécution est planifiée 10 années plus tard. Si un problème survient lors du calcul, il sera déclaré avec la tâche système. Recherchez la tâche système dans Paramètres > Tâches système pour rechercher les éventuelles erreurs avec les champs de report.

La tâche Calculer en masse les champs cumulatifs se produit immédiatement quand une solution contenant un attribut de report est importée. Cela suppose que vous installiez une solution pendant une période qui n'impactera pas défavorablement les utilisateurs.

Chaque attribut de report d'une entité contient aussi deux attributs de prise en charge pour l'attribut de report :

• <attribut SchemaName>:_Date :Datetime – dernière date de calcul du report.

• <attribut SchemaName>:_State : Integer – état du calcul du report.Pour plus d'informations :Valeurs de l'état du report

Valeurs de l'état du report

L'état d'un de calcul de champ cumulatif est disponible dans l'attribut <attribut SchemaName correspondant et dans la propriété _State et CalculateRollupFieldResponse.FieldState. Les valeurs qui indiquent l'état sont répertoriées dans le tableau suivant.

Extraire immédiatement une valeur calculée de champ de report

Les attributs de report prennent en charge un message CalculateRollupField que les développeurs peuvent utiliser pour calculer une valeur d'attribut de report à la demande. La demande et la réponse, ainsi que des membres, sont illustrées dans le tableau suivant.

Ce message est une opération synchrone uniquement pour l'attribut identifié dans la requête. Si la valeur de cet enregistrement est incluse comme composante d'autres champs cumulatifs, les valeurs de ces champs ne prendront pas en compte l'éventuelle modification de valeur provoquée par cette méthode avant que ne se produisent les travaux asynchrones régulièrement planifiés exécutant ces calculs.

Limitations

Les attributs de report ne peuvent pas être utilisés comme événement de workflow ou condition d'attente. Ces attributs ne déclenchent pas l'événement pour déclencher des workflows.

Les attributs ModifiedBy et ModifiedOn de l'entité ne sont pas mis à jour lorsque l'attribut de report est mis à jour.

Un maximum de 100 attributs de report peut être défini dans une organisation. Chaque entité ne peut pas avoir plus de 10 attributs de report.

Une formule d'attribut de report ne peut pas faire référence à un autre attribut de report.

Une formule d'attribut de report ne peut pas faire référence à des attributs calculés complexes. Seuls les attributs calculés qui référencent des attributs simples du même enregistrement peuvent être utilisés avec les reports.

Une formule d'attribut de report ne peut pas contenir des enregistrements de relations plusieurs-à-plusieurs (N:N). Elle peut uniquement contenir des enregistrements de relations un-à-plusieurs (1:N).

Les formules d'attribut de report ne peuvent pas utiliser les relations un-à-plusieurs (1:N) avec l'entité ActivityPointer ou ActivityParty.

Énumération SourceTypeMasks

La propriété SourceTypeMask des attributs qui prennent en charge les champs calculés et les champs de report contient une valeur de masque de bits. Pour extraire les informations pertinentes de la valeur, il est utile d'avoir une énumération lors de l'exécution d'opérations au niveau du bit. Utilisez l'énumération SourceTypeMasks suivante lors de la comparaison de la valeur de propriété SourceTypeMask.

 public enum SourceTypeMasks
{
    /// <summary>
    /// Undefined: 0 - The default value for simple and rollup attributes.
    /// </summary>
    Undefined = 0,
    /// <summary>
    /// Simple: 1 - The calculated attribute refers to an attribute in the same record.
    /// </summary>
    Simple = 1,
    /// <summary>
    /// Related: 2 - The calculated attribute refers to an attribute in a related record.
    /// </summary>
    Related = 2,
    /// <summary>
    /// Logical: 4 - The calculated attribute refers to a logical attribute.
    /// </summary>
    Logical = 4,
    /// <summary>
    /// Calculated: 8 - The calculated attribute refers to another calculated attribute.
    /// </summary>
    Calculated = 8,
    /// <summary>
    /// Rollup: 16 - The calculated attribute refers a rollup attribute. 
    /// </summary>
    Rollup = 16,
    /// <summary>
    /// Invalid: 32 - The calculated or rollup attribute is invalid.
    /// Typically this would be where a field refers to an attribute that no longer exists. 
    /// </summary>
    Invalid = 32
}

Voir aussi

Vidéo : Champs cumulatifs et calculés dans Microsoft Dynamics CRM 2015
Présentation des attributs d'entité dans Microsoft Dynamics 365
TechNet : définition de champs calculés.
TechNet : Définition de champs cumulatifs

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright