Aide:Type de données
 | This is an information page. It is not one of Wikidata's policies or guidelines, but rather intends to describe some aspect(s) of Wikidata's norms, customs, technicalities, or practices. It may reflect varying levels of consensus and vetting. |
Les types de donnée définissent l'interface d'édition des déclarations, et quelles valeurs ils sont autorisé à prendre. Différents types de déclarations vont impliquer l'utilisation de différents types de propriété, et chaque propriété utilise un type de donnée prédéfini lors de sa création. Une propriété ne changera pas de type de données après sa création. Le type d'une propriété influe sur son utilisation et doit donc être choisi avec soin AVANT sa création.
La coordination du travail sur les propriétés se fait à partir de la proposition de propriété.
| Data type | Number of properties |
|---|---|
| External identifier | 9 157 |
| Item | 1 670 |
| Quantity | 661 |
| String | 335 |
| URL | 109 |
| Commons media file | 83 |
| Point in time | 67 |
| Monolingual text | 62 |
| Property | 21 |
| Geographic coordinates | 10 |
| Tabular data | 6 |
| Geographic shape | 3 |
| Data type | Number of properties |
|---|---|
| Mathematical expression | 36 |
| Sense | 19 |
| Lexeme | 15 |
| Form | 10 |
| Musical Notation | 6 |
Propriétés classées par type
Pour une liste des propriétés en fonction du type de donnée, voir :
- Special:ListProperties
- Liste de toutes les propriétés
- Violations de contraintes : toutes les propriétés
- Catégorie des propriétés par type de donnée
Types de données à lier aux entités
Wikidata a 6 types d'entité (Item, Property, Lexeme, Sense et Form). Pour chacun des types d'entité, il y existe un type de données portant le même nom qui peut être utilisé pour lier des entités de ce type.
- Item
- Lien à un élément. (list of properties)
- Property
- Lien vers une propriété. (list of properties)
- EntitySchema
- Link to an entity schema. (list of properties)
The following data types are primarily meant for statements on Lexemes, which make up the lexicographical data of Wikidata.
- Lexeme
- Link to a lexeme. (list of properties)
- Form
- For statements on lexemes that reference forms on other lexemes in order to indicate their relation. (list of properties)
- Sense
- For statements on lexemes that reference senses on other lexemes. (list of properties)
String-based data types
String
- type: string (String)
- list of properties: Catégorie:Propriété de type de donnée string -- Special:ListProperties/string
Chaîne de caractères (chiffes et autres symboles) qui ne nécessite pas d'être traduite dans d'autres langues ou formats de nombres. Une chaîne n'est pas utilisée pour faire des calculs.
- Examples:
- B123
- 90928390-XLE
- u29238
Longueur maximum 1 500 caractères sur Wikidata, comme défini avec wmgWikibaseStringLimits dans InitialiseSettings.php.
Monolingual text
- type: monolingualtext (Monolingual text)
- list of properties: Catégorie:Propriétés de type de donnée monalingualtext -- Special:ListProperties/monolingualtext
Une chaîne de caractères qui n'est pas traduite dans les autres langues. Ce type de chaîne est défini une fois puis réutilisé dans toutes les langues. L'utilisation typique est celle d'un nom d'entité localisé géographiquement, écrit en langue locale, un identifiant de type donné, une formule chimique ou un nom scientifique latin. Voir Help:Monolingual text languages pour les informations concernant les codes de langue disponibles pour les valeurs des textes monolingues et sur la manière de demander la prise en charge de codes de langues supplémentaires. (Notez que le texte monolingue implique l'existence d'un unique système d'écriture, qui peut rendre la phrase problématique quelques fois.)
Longueur maximum 1 500 caractères sur Wikidata, comme défini avec wmgWikibaseStringLimits dans InitialiseSettings.php.
External identifier
- type: external-id (External identifier)
- list of properties: Catégorie:Propriété de type de donnée external-id -- Special:ListProperties/external-id
Chaîne de caractères qui représente un identifiant utilisé dans un système externe. S'affichera comme un lien externe si un formatter URL (P1630) est défini. Voir : Identifiants externes.
Longueur maximum 1 500 caractères sur Wikidata, comme défini avec wmgWikibaseStringLimits dans InitialiseSettings.php.
URL
- type: url (URL)
- list of properties: Catégorie:Propriété de type de donnée url -- Special:ListProperties/url
URL généralisée qui identifie une sorte de ressource externe, peut-être un lien vers un site externe quelconque ou un identifiant utilisé pour une recherche dans une sorte de ressource spécialisée.
Longueur maximum 1 500 caractères sur Wikidata, comme défini avec wmgWikibaseStringLimits dans InitialiseSettings.php.
Data types to reference files on Commons
Commons media
- type: commonsMedia (Commons media file)
- list of properties: Catégorie:Propriétés de type de donnée commonsMedia -- Special:ListProperties/commonsMedia
Références à des fichiers de Wikimedia Commons. Lors de l'entrée par l'intermédiaire de l'interface utilisateur, l'utilisateur se voit proposer les fichiers de l'espace de nommage « File » (Fichier) de Commons qui correspondent aux caractère entrés. Ces fichiers peuvent être utilisés à la fois pour illustrer les concepts dans Wikidata, ou comme valeur actuelle de propriété dans les inclusions de Wikipedia.
- Examples:
- Wikidata-logo.svg
Geographic shape
- type: geo-shape (Geographic shape)
- list of properties: Catégorie:Propriété de type de donnée geo-shape -- Special:ListProperties/geo-shape
Référence au fichier de données cartographiques sur Wikimedia Commons. Lors de l'entrée dans le champ de texte, l'espace de noms « Data » sur Wikimedia Commons sera recherché pour les entrées correspondantes.
Tabular data
- type: tabular-data (Tabular data)
- list of properties: Catégorie:Propriété de type de donnée tabular-data-datatype -- Special:ListProperties/tabular-data
Référence à un fichier de données de tableur de Wikimedia Commons. Lors de la saisie du champs texte, l'espace de noms « Data » sera recherché sur Commons pour voir si des entrées correspondent.
Data types for specific notations
Mathematical expression
- type: math (Mathematical expression)
- list of properties: Catégorie:Propriété de type de donnée math-datatype -- Special:ListProperties/math
Chaîne de caractères formatée qui affiche une formule.
Exemple :
\sqrt{1-e^2}donne :
Voir fr:Aide:Formules TeX pour les formats applicables.
Limite actuelle : le texte saisi ne peut pas être récupéré par le Service des requêtes.
Musical Notation
- type: musical-notation (Musical Notation)
- list of properties: Catégorie:Propriétés avec le type de donnée notation musicale -- Special:ListProperties/musical-notation
Image générée au format .png affichant une partition musicale. Les valeurs pour ce type de donnée sont des chaînes de caractères qui décrivent la musique en suivant la syntaxe LilyPond.
Exemple:
- la chaîne pour la valeur
\relative c' { c d e f | g2 g | a4 a a a | g1 |}, génère
Autres types de donnée
Quantity
- type: quantity (Quantity)
- list of properties: Catégorie:Propriété de type de donnée quantity -- Special:ListProperties/quantity
Une valeur de Quantité représente un nombre décimal ainsi que des informations sur l'intervalle d'incertitude de ce nombre et son unité de mesure. Ces attributs sont :
- amount : la quantité de la valeur principale
- lowerBound : la limite inférieure de la quantité (par défaut 1 - optionel)
- upperBound : la limite supérieure de la quantité (par défaut 1 - optionel)
- unit : l'unité de mesure de l'élément (vide pour les valeurs sans unités)
En interne, les quantités et les limites inférieure et supérieure sont des chaînes de caractères; les nombres positifs sont rangés avec le signe plus, bien que cela ne soit pas affiché. La représentation d'une quantité peut dépasser 127 caractères; néanmoins la valeur maximale d'une quantité est de 10^126-1.
La conversion d'unités est implémentée sur la base de conversion to SI unit (P2370). La plupart des unités avec cette propriété sont normalisées dans l'exportation RDF pour le service de requête (octobre 2019).
La table de normalisation est lisible en tant que fichier JSON dans le dépôt WMF Mediawiki.
- Examples:
- 762 (sans unité)
- 2500 km (les limites supérieures et inférieures ne sont pas définies, avec les unités)
- 1,03 ± 0,02 g (entrer en tant que valeur nominale +/- tolérance, ce qui représente les limites supérieures et inférieures, avec les unités). La tolérance n'apparaît pas dans certains cas sur Wikipedia mais seule la valeur nominale, par exemple dans les listes Wikidata produites par le robot listeria .
Time
- type: time (Point in time)
- list of properties: Catégorie:Propriété de type de donnée time -- Special:ListProperties/time
Ce type de donnée stocke une date dans le calendrier grégorien ou julien. Voir la structure détaillée.
- Examples:
- 2012
- 1780-05 (= mai 1780)
- 1833-11-01 (= 1er novembre 1833)
Voir Help:Dates pour plus d'informations.
Globe coordinate
- type: globe-coordinate (Geographic coordinates)
- list of properties: Catégorie:Propriétés de type de donnée globe-coordinate -- Special:ListProperties/globe-coordinate
Position géographique entrée sous la forme d'une paire latitude/longitude (en gms ou en degrés décimaux) pour un « globe » donné (n'importe quel corps stellaire). Par défaut ce corps est la « Terre » (globe: http://www.wikidata.org/entity/Q2). Un paramètre « precision » indique la résolution de la source de la coordonnée. Le système de coordonnées est supposé être « WGS84 » World Geodetic System 1984 (Q11902211), ce qui peut ne pas convenir pour des corps différents de la Terre, mais ceci n'est pas configurable.
Actuellement, l’interface de Wikidata ne montre pas tous les paramètres de ce type de donnée. La valeur est visualisée uniquement en tant que coordonnée, plus une carte si le globe est Earth (Q2). La précision peut être modifiée en mode édition. Le globe n'est pas visible ni modifiable dans la vue de l'élément. La configuration complète est toutefois visible dans l'affichage du diff de l'historique (exemple).
Lors de l'utilisation de l'interface utilisateur web, la valeur enregistrée sera un multiple exact de la précision choisie.
Il est possible de modifier les données dans leur intégralité via l'API. L'outil CLI est un moyen d'accéder à l'API. Dans cet exemple, Olympus Mons (Q520) reçoit une coordonnée sur Mars (Q111) en utilisant le paramètre globe (utilisé dans coordinate location (P625)) :
wd ac Q520 P625 '{ "latitude": 18.4, "longitude": 226, "precision": 0.016666666666667, "globe": "http://www.wikidata.org/entity/Q111" }'
Le script globe.js ajoute une interface utilisateur pour définir le paramètre globe de coordinate location (P625).
Des robots tels que LocatorBot peuvent détecter lorsque le paramètre globe de coordinate location (P625) n'est pas défini conformément à located on astronomical body (P376). Ajouter located on astronomical body (P376) et attendre qu'un robot mette à jour le globe avec les coordonnées est une solution de contournement acceptée.
Technical details
In the Wikibase JSON format each value is represented by "datatype": <datatype>, "datavalue": {"type": <type>, "value": ...}, where the representation of the value depends on the type.
In the RDF format data types are represented by the RDF name in the following table prefixed with http://wikiba.se/ontology# (or the wikibase: prefix in case of the RDF dumps). Note that this prefix is also available in the Wikidata query service, so for example ?prop wikibase:propertyType wikibase:String will return all properties of data type String.
| Name | JSON datatype | RDF name | JSON type | Implemented by | Links |
|---|---|---|---|---|---|
| Élément | wikibase-item | WikibaseItem | wikibase-entityid | built-in | list, query |
| Propriété | wikibase-property | WikibaseProperty | wikibase-entityid | built-in | list, query |
| Lexème | wikibase-lexeme | WikibaseLexeme | wikibase-entityid | WikibaseLexeme (Q28925815) | list, query |
| Sens défini | wikibase-sense | WikibaseSense | wikibase-entityid | WikibaseLexeme (Q28925815) | list, query |
| Forme lexicographique | wikibase-form | WikibaseForm | wikibase-entityid | WikibaseLexeme (Q28925815) | list, query |
| Schéma d’entité | entity-schema | EntitySchema | wikibase-entityid | Wikidata Entity Schema (Q73505550) | list, query |
| Texte monolingue | monolingualtext | Monolingualtext | monolingualtext | built-in | list, query |
| Chaîne | string | String | string | built-in | list, query |
| Identifiant externe | external-id | ExternalId | string | built-in | list, query |
| URL | url | Url | string | built-in | list, query |
| Fichier média de Commons | commonsMedia | CommonsMedia | string | built-in | list, query |
| Forme géographique | geo-shape | GeoShape | string | built-in | list, query |
| Données tabulaires | tabular-data | TabularData | string | built-in | list, query |
| Expression mathématique | math | Math | string | Math (Q21677559) | list, query |
| Notation musicale | musical-notation | MusicalNotation | string | Score (Q21678392) | list, query |
| Quantité | quantity | Quantity | quantity | built-in | list, query |
| Point dans le temps | time | Time | time | built-in | list, query |
| Coordonnées géographiques | globe-coordinate | Globecoordinate | globecoordinate | built-in | list, query |
Limitations
- Point in time doesn't support time of day. phab:T57755
- Quantity doesn't support infinity (Q205), e.g. you cannot state prime number (Q49008)quantity (P1114)infinitely many.
Types de données en attente
Aucun des types suivants sont sûr d'être disponibles à l'avenir. Les types de donnée existants peuvent résoudre la demande pendant ce temps.
À faire
Durée
Temps dans le format HH:MM:SS
À planifier
Propriété calculée
Propriété calculée par Wikibase et ajoutée directement aux éléments. N'est pas dans le plan de développement.
Utilisations possibles : nombre de déclarations d'un élément.
Coordonnées célestes
Un format de coordonnées pour spécifier la position des objets célestes. N'est pas dans le plan de développement.
Palliatif actuel : voir Wikidata:Property proposal/Astronomical coordinates
Type de donnée entier
Un type de donnée de quantité pour les nombres entiers positifs. Ceci a été implémenté partiellement en enlevant la précision et en créant integer constraint (Q52848401).
Élément avec une seule chaîne de caractères
Un type de donnée qui permet la description dans n'importe quelle langue, mais un seul libellé. N'est pas dans le plan de développement.
Alternatives actuelles : les lexèmes
Alternative en cours d'évaluation : étiquette multilingue en remplacement des étiquettes répétées
Texte multilingue
Une chaîne de caractères qui peut être traduite dans d'autres langues. Il pourrait être utilisé pour un nom d'entité, ou une forme non-locale qui est traduit en plusieurs langues et systèmes d'écriture.(Notez que le texte multilingue implique aussi beaucoup de travail manuel lors de la traduction.). Véritable objectif à déterminer.
Multiline text
A string that may contain newlines.
Propriété externe
Propriétés situées dans les bases externes, identifiées par une déclaration spéciale sur les entités existantes. Ce n'est pas un type de donnée spécifique.
Série de valeurs
Une manière simplifiée pour stocker des séries de valeurs à différents moments. N'est pas dans le plan de développement.
Échecs
Affiche les chaînes en notation FEN comme dans position in Forsyth-Edwards Notation (P6648) directement comme les échiquiers.
Hiero
Chaînes à afficher avec WikiHiero. Les chaînes en syntaxe WikiHiero sont incluses dans <hiero></hiero> pour être affichées. Exemples sur Talk:Q68101340 et Property_talk:P7383.
Faire une requête sur Phabricator.
Combiner l'identification numérique avec 'lisible par un humain'
Type de donnée pour ajouter un ID numérique et un titre de page, par exemple à une page MediaWiki. Le qualifieur MediaWiki page ID (P9675) est ajouté quelques fois à la valeur de la propriété avec les titres de pages. Quelques propriétés utilisent directement la valeur numérique.
Déclaration Wikibase
Type de donnée pour référencer une déclaration Wikidata particulière.
Expressions régulières
Type de donnée pour stocker des expressions régulières (regex). Actuellement elles sont rangées en tant que chaînes ou texte monolangue, comme format as a regular expression (P1793), format as language specific regular expression (P8770).
Intervalles d'adresses IP
Types de données pour ranger des intervalles d'adresses et simplifier leur recherche.
Types de données qui ne seront jamais implémentés
Booléen
Refusé. Alternative suggérée : type de donnée item.
Modification du type de donnée
Une propriété avec pour type de donnée « chaîne de caractères » (string) peut être convertie en un type de donnée « identifieur externe » (external identifier) par un administrateur système. Pour demander une telle modification, ouvrez un nouveau sujet sur la page de discussion de la propriété ou de la Discussion des projets. Dès qu'un consensus est trouvé, une requête peut être faite sur Contacter l'équipe de développement. Pour convertir une propriété créée avant 2016, veuillez lire la discussion précédente.
Les autres modifications du type de donnée nécessitent de passer par la création d'une nouvelle propriété et supprimer l'ancienne. Vous devez utiliser Propriétés à supprimer pour de telles demandes.