Types de données primitifs pris en charge pour les formules des États électroniques
Cet article fournit des informations sur les types de données primitifs pris en charge dans les expressions des États électroniques (ER) expressions. Voici une liste des types de données primitifs :
Booléen
Le type de données primitif booléen contient une valeur qui est évaluée comme true ou false. Vous pouvez utiliser les mots-clés littéraux réservés True et False partout où l’on attend une expression booléenne. La valeur par défaut est false.
La représentation interne d’un booléen est un entier. La veleur entière 0 (zéro) est évaluée comme false, et toutes les autres valeurs entières sont évaluées comme true. Lorsque vous validez une expression configurée qui renvoie un booléen dans le Concepteur de formules ER, le volet des résultats du test présente 0 (zéro) lorsqu’une expression retourne false. Sinon, le volet des résultats du test présente 1.
Un booléen n’a pas de conversions implicites. Cependant, vous pouvez utiliser la fonction TEXT pour convertir explicitement un booléen en chaîne :
- La valeur false est convertie en chaîne de texte False.
- La valeur true est convertie en chaîne de texte True.
Note
Cette conversion ne dépend pas du contexte de langue et de culture fourni.
Les opérateurs de comparaison sont le seul type d’opérateur qui peut être utilisé avec le type de données booléen. Les opérateurs suivants peuvent être utilisés pour comparer deux valeurs booléennes : <> et =.
date ;
Le type de données primitif date contient le jour, le mois et l’année. Les dates peuvent être initiées à l’aide des fonctions suivantes :
Le type de données date peut contenir des dates comprises entre le 1er janvier 1900 et le 31 décembre 2154. La valeur par défaut est null, et la représentation interne est la date du 1er janvier 1900.
Une date n’a pas de conversions implicites. Cependant, vous pouvez utiliser les fonctions de conversion explicites suivantes :
La fonction ADDDAYS vous permet d’ajouter et de soustraire des jours aux dates. De cette façon, vous pouvez déplacer la date d’un nombre spécifique de jours dans le futur et le passé. La fonction DAYS vous permet de soustraire des dates les unes des autres et de calculer la différence en jours. Pour plus d’informations sur la transformation des valeurs date, voir Liste des fonctions ER dans la catégorie de date et d’heure.
Les opérateurs de comparaison sont le seul type d’opérateur qui peut être utilisé avec le type de données date. Les opérateurs suivants peuvent être utilisés pour comparer deux valeurs date : <>, <, <=, =, >, et >=.
Date et heure
Le type de données primitif dateheure combine le type date et une valeur qui représente le temps qui s’est écoulé depuis minuit. Le temps est exprimé en heures, minutes, secondes et fractions de seconde. Une valeur dateheure contient également des informations sur le fuseau horaire.
Le type de données dateheure peut contenir des dates entre le 1er janvier 1900 (1900-01-01T00:00:00.0000000+00:00 au format aller-retour) et le 31 décembre 2154 (2154/12/31T11:59:59.9999999+00:00 au format aller-retour). La plus petite unité de temps dans une valeur dateheure est un dix millionième de seconde.
Note
Quand le spécificateur hhest utilisé pour les heures, les valeurs de temps supérieures à 12:59:59:9999999 ne peuvent pas être interprétées comme des heures valides.
Quand le spécificateur HH est utilisé pour les heures, les valeurs de temps supérieures à 23:59:59:9999999 ne peuvent pas être interprétées comme des heures valides.
La valeur par défaut est null, et la représentation interne est la date du 1er janvier 1900 (1900-01-01T00:00:00.0000000+00:00 au format aller-retour).
Les valeurs dateheure peuvent être initiées à l’aide des fonctions suivantes :
Une dateheure n’a pas de conversions implicites. Cependant, vous pouvez utiliser les fonctions de conversion explicites suivantes :
Pour plus d’informations sur la transformation des valeurs dateheure, voir Liste des fonctions ER dans la catégorie de date et d’heure.
Les opérateurs de comparaison sont le seul type d’opérateur qui peut être utilisé avec le type de données dateheure. Les opérateurs suivants peuvent être utilisés pour comparer deux valeurs dateheure : <>, <, <=, =, >, et >=.
Énumération
Le type de données primitif énumération est une liste de littéraux. Vous pouvez utiliser des énumérations définies dans le code source de l’application. Vous pouvez également introduire vos propres énumérations dans le modèle de données ER et dans les composants de format ER.
Une énumération d’application peut être utilisé dans les expressions de tout mappage de modèle ER et de format ER.
L’illustration suivante montre comment ajouter l’énumération du modèle CustVendCorrectiveReasonCode au modèle de données ER modifiable.
Une énumération de modèle peut être utilisée dans les expressions de tout mappage de modèle ER et format ER qui ont été créés sous un modèle de données où l’énumération a été introduite.
L’illustration suivante montre comment ajouter l’énumération de format Liste des sous-catégories de taxe au preneur Natura au format ER modifiable.
Une énumération de format ne peut être utilisée que dans les expressions du format ER où l’énumération a été introduite.
Vous devez utiliser le type approprié de sources de données ER pour intégrer une énumération spécifique dans un composant ER configuré en tant que constante ou en tant que valeur que l’utilisateur qui exécute une solution ER a définie dans la boîte de dialogue au moment de l’exécution.
Les énumérations d’applications sont accessibles en utilisant les sources de données Dynamics 365 for Operations \ Énumération et Général \ Paramètres d’entrée utilisateur. L’illustration suivante montre comment ajouter au format ER modifiable les sources de données appenumNoYes et uipNoYes qui se réfèrent à l’énumération d’applications NoYes.
Les énumérations de modèles de données sont accessibles en utilisant les sources de données Modèle de données\Énumération et Modèle de données\Paramètres d’entrée utilisateur d’énumération. L’illustration suivante montre comment ajouter au format ER modifiable la source de données CustVendCorrectiveReasonCode qui se réfère à l’énumération de modèles de données CustVendCorrectiveReasonCode.
Les énumérations de formats sont accessibles en utilisant les sources de données Format\Énumération et Format\Paramètres d’entrée utilisateur d’énumération. L’illustration suivante montre comment ajouter au format ER modifiable la source de données NaturaReverseCharge qui se réfère à l’énumération de format Sous-catégories de taxe au preneur Natura.
Une énumération n’a pas de conversions implicites. Cependant, vous pouvez utiliser la fonction de conversion TEXT pour convertir une énumération en chaîne de texte. Cette conversion ne dépend pas de la langue. Pour savoir comment associer un valeur énumération avec les étiquettes spécifiques à la langue appropriées, voir les exemples d’utilisation des fonctions LISTOFFIELDS et GETENUMVALUEBYNAME.
Les opérateurs de comparaison sont le seul type d’opérateur qui peut être utilisé avec le type de données énumération. Les opérateurs suivants peuvent être utilisés pour comparer deux valeurs énumération : <> et =.
Guid
Le type de données primitif guid contient une valeur d’identificateur global unique (GUID). Un GUID est une valeur qui peut être utilisée sur tous les ordinateurs et réseaux, partout où un identifiant unique est requis. Il est peu probable que ce numéro existe en double. Un GUID valide répond à toutes les spécifications suivantes :
- Il doit comporter 32 digits hexadécimaux.
- De plus, il doit comporter quatre tirets intégrés aux emplacements suivants : 8-4-4-4-12.
- De plus, des accolades facultatives {} peuvent être ajoutées au début et à la fin de la chaîne. Par exemple, {2CDB0FE7-D7B3-4938-A0F0-FE28FB8FE212} et 2CDB0FE7-D7B3-4938-A0F0-FE28FB8FE212 sont des chaînes GUID valides.
- Par conséquent, il doit y avoir un total de 36 ou 38 caractères, selon que des accolades sont ajoutées.
- Les lettres utilisées comme digits hexadécimaux peuvent être des majuscules (A–F), des minuscules (a–f) ou les deux.
Vous pouvez utiliser les fonctions de conversion explicites suivantes :
Les opérateurs de comparaison sont le seul type d’opérateur qui peut être utilisé avec le type de données guid. Les opérateurs suivants peuvent être utilisés pour comparer deux valeurs guid : <> et =.
Entier
Le type de données primitif entier représente un nombre sans décimales. Les entiers sont utilisés comme variables de contrôle dans les instructions répétitives ou comme index dans les listes d’enregistrements.
Un littéral entier est l’entier tel qu’il est entré directement dans une expression ER (formule), comme 12345. Un entier a une taille de 32 bits. La valeur par défaut est 0, et la représentation interne est un nombre long. Un entier est automatiquement converti en réel.
De plus, vous pouvez utiliser les fonctions de conversion explicites suivantes :
La plage d’un entier est [-2 147 483 647 : 2 147 483 647]. Tous les entiers de cette plage peuvent être utilisés comme littéraux.
Tous les opérateurs de comparaison et mathématiques peuvent être utilisés avec le type de données entier.
Int64
Le type de données primitif int64 représente un nombre sans décimales. Les valeurs Int64 sont utilisées comme variables de contrôle dans les instructions répétitives ou comme index dans les identificateurs d’enregistrements.
Un int64 a une taille de 64 bits. La valeur par défaut est 0, et la représentation interne est un nombre long. Un int64 est automatiquement converti en réel.
De plus, vous pouvez utiliser les fonctions de conversion explicites suivantes :
La plage d’un int64 est [-9 223 372 036 854 775 807 : 9 223 372 036 854 775 807].
Tous les opérateurs de comparaison et mathématiques peuvent être utilisés avec le type de données int64.
Réel
Le type de données réel peut contenir des valeurs décimales en plus des entiers. Vous pouvez utiliser des littéraux décimaux partout où un réel est attendu. Un littéral décimal est le nombre décimal tel qu’il est entré directement dans le code, tel que 2.19.
Note
Dans les expressions ER, un point (.) est toujours utilisé comme séparateur décimal.
Les réels peuvent être utilisés dans toutes les expressions, et ils peuvent être utilisés à la fois avec des opérateurs de comparaison et des opérateurs arithmétiques. Un réel a une précision de 16 chiffres significatifs. La valeur par défaut d’un réel est 0.0, et la représentation interne est un nombre numérique codé en binaire (BCD). Le codage BCD permet des représentations exactes de valeurs multiples de 0,1. La plage d’une variable réelle est -(10)127 à (10)127. Tous les réels de cette plage peuvent être utilisés comme littéraux dans les expressions ER.
Un réel n’a pas de conversions implicites. Cependant, vous pouvez utiliser les fonctions suivantes pour convertir explicitement un réel en d’autres types de données et d’autres types de données en réel :
Tous les opérateurs de comparaison et mathématiques peuvent être utilisés avec le type de données réel.
Chaîne
Le type de données primitif chaîne représente une séquence de caractères utilisés comme textes, numéros de compte, adresses et numéros de téléphone.
Les littéraux chaîne sont des caractères placés entre guillemets droits (""). Les littéraux chaîne peuvent être utilisés partout où des valeurs chaîne sont attendues dans les expressions ER. Vous pouvez utiliser des chaînes dans des expressions logiques, telles que des comparaisons. Vous pouvez également concaténer des valeurs chaîne en utilisant l’opérateur & ou la fonction CONCATENATE.
Note
Si vous concaténez deux valeurs chaîne et que vous voulez que la chaîne résultante s’étende sur plusieurs lignes, utilisez le séparateur de saut de ligne entre les valeurs. Pour la sortie TEXT, ce séparateur peut être un caractère généré à l’aide de l’expression CHAR(10) ou CHAR(13). Pour le HTML, il peut s’agir de la balise <br>.
La valeur par défaut d’une chaîne est une chaîne de texte vide qui ne contient pas de caractère et la représentation interne est une liste de caractères.
Il n’y a pas de conversions automatiques pour les chaînes. Cependant, vous pouvez utiliser les fonctions de conversion explicites suivantes :
Pour en savoir plus sur la transformation des valeurs chaîne, voir Liste des fonctions ER de la catégorie texte.
Une chaîne peut contenir un nombre indéfini de caractères.
Tous les opérateurs de comparaison peuvent être utilisés avec le type de données chaîne.
Ressources supplémentaires
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour