Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Microsoft Dataverse a plusieurs types de données qui peuvent être configurés avec différents formats. Vous pouvez spécifier le format de la colonne à l’aide de l’Explorateur de solutions ou des opérations d’API. Les sections suivantes fournissent plus d’informations sur les formats de type de données, notamment :
Formats pris en charge par type de données
La colonne de format spécifie l’interface utilisateur sur l’affichage du contenu. Certains formats disponibles dans l’interface utilisateur sont Téléphone, Courrier électronique ou Durée. Les formats appliqués ne valident pas le contexte, les domaines ou d’autres valeurs. Ils indiquent à l’interface utilisateur quel contrôle utiliser pour ce type.
Formats
Le tableau suivant fournit des informations sur les formats disponibles pour chaque type de données :
| Type de données | Nom du format | Description | Disponible pour le créateur d’applications ? | Remarques |
|---|---|---|---|---|
| Texto | Texto | Colonne de texte de base qui contient des caractères de texte. | Oui | Valeur de format par défaut pour la colonne de texte. |
| Zone de texte | Colonne de texte qui contient des caractères de texte et autorise également les sauts de ligne. | Oui | ||
| Messagerie électronique | Le texte fournit un lien pour ouvrir l’application de messagerie de l’utilisateur. | Oui | ||
| URL | Le texte fournit un lien hypertexte pour ouvrir la page spécifiée.
https:// est ajouté au début de tout texte qui ne commence pas par un protocole valide |
Oui | ||
| Symbole de l’action | Pour la plupart des langues, le texte est activé en tant que lien pour ouvrir le site web MSN Money afin d'afficher des détails sur le prix de l'action représenté par le symbole boursier. | Oui | ||
| Téléphone | Les colonnes sont cliquables pour initier des appels. | Oui | ||
| JSON | Stocke du texte à l’aide de la mise en forme JSON | Oui (API uniquement) | Uniquement dans les magasins non-SQL comme Audit. | |
| Texte enrichi | Autorise la mise en forme de texte enrichi, y compris le balisage HTML. | Oui (API uniquement) | ||
| Numéro de version | Stocke le numéro de version des lignes. | Non | Utilisation du système uniquement. | |
| Texte multiligne (mémo) | Texto | Colonne de texte de base qui contient des caractères de texte. | Oui | |
| Zone de texte | La colonne de texte contient des caractères de texte et autorise les sauts de ligne. | Oui | ||
| Messagerie électronique | Réservé exclusivement à un usage interne. | Non | ||
| JSON | Stocke du texte à l’aide de la mise en forme JSON | Oui (API uniquement) | Uniquement dans les magasins non-SQL tels que Log. | |
| RichText | Permet la mise en forme de texte enrichi, y compris le balisage HTML. | Y (API uniquement) | ||
| InternalExtentData | Réservé exclusivement à un usage interne. | Non | Utilisation du système uniquement | |
| Aucun/chaîne vide | Cette option affiche simplement un nombre. | Oui | Valeur de format par défaut pour la colonne numérique entière. | |
| Nombre entier | Durée | Cette option de format affiche une liste d’options de durée. Les données stockées dans la base de données sont toujours exprimées en nombre de minutes. Le champ ressemble à une liste déroulante et fournit des options suggérées comme 1 minute, 15 minutes, 30 minutes jusqu’à 3 jours. Toutefois, ils peuvent également choisir ces options ou entrer un nombre de minutes, qui se transforme en période. Par exemple, tapez 60 et cela correspond à une heure. Ou ils peuvent entrer « 1 heure » ou « 2 jours » et il se résout à afficher cette heure. La durée doit être entrée au format suivant : « x minutes », « x heures » ou « x jours ». Les heures et les jours peuvent également être entrés à l’aide de décimales, par exemple « x.x heures » ou « x.x jours ». REMARQUE : Les valeurs doivent être expressibles en minutes, les valeurs de sous-minute sont arrondies à la minute la plus proche. |
Oui | Le système lit cette valeur en secondes. |
| Timezone | Cette option affiche une liste de sélection de fuseaux horaires à l’aide de codes de fuseau horaire. Chacune de ces zones est enregistrée comme nombre. Par exemple, pour le fuseau horaire (GMT-08:00) Pacifique (É.-U. et Canada), le TimeZoneCode est 4. Les applications pilotées par modèle affichent ces codes sous forme de noms de fuseaux horaires, tandis que les applications basées sur Canvas affichent le nombre stocké. | Oui | ||
| Language | Cette option affiche une liste des langues mises en service pour votre organisation. Les valeurs sont stockées sous la forme d’un nombre à l’aide de codes LCID. Les codes de langue sont des ID de paramètres régionaux à quatre ou cinq chiffres. Les valeurs d’ID de paramètres régionaux valides sont disponibles sur la page Tableau des ID de paramètres régionaux (LCID). Les applications pilotées par modèle affichent les langues comme nom de langue, les applications Canvas s’affichent comme nombre stocké. | Oui | ||
| Paramètres régionaux | Valeur qui correspond à des paramètres régionaux spécifiques à l’aide de valeurs standard ISO. | Oui (API uniquement) | Non affiché dans l’interface utilisateur power Apps Maker. | |
| Date et heure | Date uniquement | Date uniquement. Inclut une heure de 00:00:00 si Utilisateur local ou Indépendant du fuseau horaire est sélectionné. | Oui | |
| Date et heure | Format de date et d’heure. | Oui | Valeur de format par défaut pour la colonne DateTime. |
Conversion de format
Vous pouvez remplacer le format de type de données par l’un des formats compatibles pris en charge par ce type de données. La modification du format conserve vos définitions de tableau précédentes (maxsize) si elles existent dans le nouveau format cible. Si une charge utile entrante n’inclut pas de format, Dataverse suppose que le format ne doit pas être modifié. Vous pouvez convertir le format par un appel d’API avec la charge utile souhaitée dans la FormatName colonne. La modification de la valeur dans la Format colonne est recommandée, car toutes les sélections nouvellement ajoutées Format sont ignorées.
Note
À ce stade, les conversions de format sont effectuées uniquement en effectuant des opérations d’API. La modification des formats ne modifie pas les données présentes dans la colonne. En raison de cela, vous remarquerez peut-être certains problèmes de mise en forme inattendus qui doivent être résolus après la conversion.
Comme mentionné dans le tableau précédent, il existe certaines restrictions pour les conversions de format :
- JSON ne peut être utilisé que si une table fait partie du stockage non-SQL (autrement dit, Journal).
- Vous ne pouvez pas convertir de colonnes avec les formats de type
emailbody,internalextentdataen d’autres formats. Toute tentative de conversion de ces colonnes est ignorée et aucun message d’erreur n’est fourni. - Vous ne pouvez pas convertir une colonne en formats de
emailbody,internalextentdataen d’autres formats. En cas de tentative, une erreur se produit. - La date ne peut pas être convertie en DateTime, mais Date avec le comportement de Utilisateur local ou Indépendant du fuseau horaire peut être changé en DateTime.
Si vous modifiez le type de données dans un format incompatible, l’erreur suivante s’affiche :
Le format <<formatname>> n’est pas valide pour la colonne de type <<datatype>><<columnname>> de la table <<tablename>>. Par exemple, le format datetime n’est pas valide pour la colonne de type texte.
Pour modifier le format d’un type de données, vous devez ajouter les détails du nouveau format dans un appel PUT de l’API OData :
PUT [Organization URI]/api/data/v9.0/EntityDefinitions(<<entity name>>)/Attributes(<<attribute name>>)
To set or change the format of a data type, you need to add the new format details into an OData API **POST** for a new column or **PUT** call to update an existing column:
> [!NOTE]
> For more samples on how to use the API, see https://github.com/microsoft/PowerApps-Samples
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
{
"AttributeType": \<\<Data type you are setting the format for\>\>,
"AttributeTypeName": {
"Value": *\<\<Datatype Type\>\>*
},
"Description": {
"@odata.type": "Microsoft.Dynamics.CRM.Label",
"LocalizedLabels": [
{
"@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
"Label": *\<\<text label to use for the format\>\>*
"LanguageCode": 1033
}
]
},
"DisplayName": {
"@odata.type": "Microsoft.Dynamics.CRM.Label",
"LocalizedLabels": [
{
"@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
"Label": *\<\<text label to use for the format\>\>*
"LanguageCode": 1033
}
]
},
"RequiredLevel": {
"Value": "None",
"CanBeChanged": true,
"ManagedPropertyLogicalName": "canmodifyrequirementlevelsettings"
},
"SchemaName": *\<\<Your chosen schema name\>\>*
"@odata.type": "Microsoft.Dynamics.CRM.StringAttributeMetadata",
"FormatName": {
"Value": *\<\<Formatname value\>\>*
},
"MaxLength": 100
}