Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update schema.json #19

Closed
wants to merge 16 commits into from
Closed

Conversation

celestinleroux
Copy link
Collaborator

Nouvelle version du schéma de données (V2)

Nouvelle version du schéma de données (V2)
schema.json Outdated Show resolved Hide resolved
schema.json Outdated Show resolved Hide resolved
schema.json Outdated Show resolved Hide resolved
schema.json Outdated Show resolved Hide resolved
schema.json Outdated Show resolved Hide resolved
schema.json Outdated Show resolved Hide resolved
schema.json Outdated Show resolved Hide resolved
schema.json Outdated Show resolved Hide resolved
schema.json Outdated Show resolved Hide resolved
celestinleroux and others added 10 commits April 2, 2024 15:12
Co-authored-by: Marc Gavanier <[email protected]>
Co-authored-by: Marc Gavanier <[email protected]>
Co-authored-by: Marc Gavanier <[email protected]>
Co-authored-by: Marc Gavanier <[email protected]>
Co-authored-by: Marc Gavanier <[email protected]>
Co-authored-by: Marc Gavanier <[email protected]>
Co-authored-by: Marc Gavanier <[email protected]>
Co-authored-by: Marc Gavanier <[email protected]>
Co-authored-by: Marc Gavanier <[email protected]>
schema.json Outdated
"author": "Datactivist et la MedNum pour l'Agence nationale de la cohésion des territoires (ANCT)",
"contact": "[email protected]",
"author": "Datactivist, la MedNum et l'équipe de la cartographie nationale de l'ANCT.",
"contact": "[email protected], [email protected]",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pas sûr de cette pratique 🤔 Un seul email pourquoi pas (même si le champ contact n'est pas dans le standard TableSchema je crois), pour plusieurs je ne pense pas que les mettre comme ça soit une bonne idée. A voir pour migrer les adresses mails dans les contributeurs peut-être ? (cf ici)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ça marche, dans ce cas on supprime le mail de la mednum :)

"title": "SIRET ou RNA",
"description": "Ce champ contient une donnée pivot provenant d'une des deux bases de référence : le répertoire SIRENE des entreprises et de leurs établissements de l'Insee ou le Répertoire national des associations du ministère de l'intérieur (RNA). Pour chaque lieu, il faut indiquer soit le code SIRET (dont disposent la majorité des associations) récupérable via annuaire-entreprises.data.gouv.fr soit le numéro RNA (Répertoire National des Associations) du lieu récupérable via journal-officiel.gouv.fr/pages/associations-recherche/. Les associations disposant d'un SIRET doivent renseigner uniquement ce code. Le RNA n'est à renseigner que dans le cas où une association ne disposerait pas de SIRET. Dans la mesure du possible, les concepteurs du schéma mettront à disposition des outils pour associer facilement les données au SIRET correspondant. Dans le cas où le SIRET concernerait plusieurs lieux (plusieurs bibliothèques rattachées à une même commune par exemple), l'identification unique permettra de les dédoublonner. Ce champ est un pré-requis pour assurer la compatibilité avec data.inclusion.",
"title": "SIRET ou RNA ou RIDET",
"description": "Ce champ contient une donnée pivot provenant d'une des deux bases de référence : le répertoire SIRENE des entreprises et de leurs établissements de l'Insee ou le Répertoire national des associations du ministère de l'intérieur (RNA). Pour chaque lieu, il faut indiquer soit le code SIRET (dont disposent la majorité des associations) récupérable via annuaire-entreprises.data.gouv.fr soit le numéro RNA (Répertoire National des Associations) du lieu récupérable via journal-officiel.gouv.fr/pages/associations-recherche/. Les associations disposant d'un SIRET doivent renseigner uniquement ce code. Le RNA n'est à renseigner que dans le cas où une association ne disposerait pas de SIRET. Dans la mesure du possible, les concepteurs du schéma mettrons à disposition des outils pour associer facilement les données au SIRET correspondant. Dans le cas où le SIRET concernerait plusieurs lieux (plusieurs bibliothèques rattachées à une même commune par exemple), l'identification unique permettra de les dédoublonner. Si votre lieu se situe en Polynésie française ou en Nouvelle-Calédonie, nous vous invitons à renseigner le numéro de Répertoire d'Identification Des Entreprises et des Établissements (RIDET) Ce champ est un pré-requis pour assurer la compatibilité avec data.inclusion.",
"example": "43493312300029",
"type": "string",
"constraints": {
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Est-ce que vous souhaitez ajouter des contraintes sur le champ (afin qu'il ne soit pas possible d'y renseigner n'importe quelle valeur) ? Exemple ici

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

on le fait merci !

@@ -142,7 +142,7 @@
},
{
"name": "code_insee",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pourquoi avoir à la fois le nom de la commune, le code postal et le code INSEE ? Ca me semble redondant et propice aux erreurs, et avec l'un des trois on peut retrouver les deux autres assez facilement. Possible de n'en garder qu'un ? (selon vos cas d'usage)

Copy link
Collaborator

@marc-gavanier marc-gavanier Apr 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

La quasi-totalité des données que nous recevons ne contiennent que le code postal et la commune. Nous appliquons effectivement une transformation pour retrouver les codes INSEE (nous corrigeons de très nombreuses incohérences à cette occasion). Mais certains de nos réutilisateurs ont besoin du code INSEE.
Nous avons donc besoin de code postal+commune en entrée car nous n'avons pas le choix (le code INSEE serait idéal).
Et nous proposons le code INSEE en plus en sortie.
C'est pour cela que nous avons besoin de faire apparaître les trois dans le schéma

schema.json Outdated
"example": "[email protected]",
"name": "courriels",
"title": "Courriel(s)",
"description": "Ce champ contient l'adresse email générique de contact du lieu. Si besoin, vous pouvez renseigner plusieurs courriels en les sépérant par un ';'.",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Le ; est souvent utilisé comme séparateur dans les fichiers csv, peut-être choisir un caractère différent pour séparer les valeurs dans un champ (le | est une alternative souvent utilisée)

"type": "string",
"constraints": {
"required": false,
"pattern": "(?:(?:^|;)(Itinérant|Fixe))+$"
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

La contrainte adéquate pour ce cas est enum (cf ici)

schema.json Outdated
"type": "string",
"constraints": {
"required": false,
"pattern": "(?:(?:^|;)(Gratuit : Je peux accéder gratuitement au lieu et à ses services|Gratuit sous condition : La gratuité est conditionnée à des critères (adhésion, situation familiale, convention avec un organisme social, pass numériques…)|Payant : L’accès au lieu et/ou à ses services est payant))+$"
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Idem

schema.json Outdated
"type": "string",
"constraints": {
"required": false,
"pattern": "(?:(?:^|;)(Gratuit : Je peux accéder gratuitement au lieu et à ses services|Gratuit sous condition : La gratuité est conditionnée à des critères \\(situation familiale, convention avec un organisme social\\.\\.\\.\\)|Payant : L'accès au lieu et/ou à ses services est payant|Accepte le Pass numérique : Il est possible d'utiliser un Pass numérique pour accéder au lieu|Adhésion : L'accès au lieu et/ou à ses services nécessite d'y adhérer))+$"
"pattern": "(?:(?:^|;)(Aidants Connect|Bibliothèques numérique de référence|Certification PIX|Conseillers numériques|Emmaüs Connect|France Services|Grande école du numérique |La Croix Rouge|Point d'accès numérique CAF|Promeneurs du net |Relais numérique \\(Emmaüs Connect\\)))+$"
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Idem

"type": "string",
"constraints": {
"required": false,
"pattern": "(?:(?:^|;)(France Services|CNFS|APTIC|Aidants Connect|Fabriques de Territoire|Grandes écoles du numérique|Point relais CAF|Point numérique CAF|Relais pôle emploi|French Tech|Campus connecté))+$"
"pattern": "(?:(?:^|;)(Formé à « Mon Espace Santé »|Formé à « DUPLEX » \\(illetrisme\\)|Arnia/MedNum BFC \\(Bourgogne-Franche-Comté\\)|Collectif ressources et acteurs réemploi \\(Normandie\\)|Fabriques de Territoire|Les Éclaireurs du numérique \\(Drôme\\)|Mes Papiers \\(Métropole de Lyon\\) |ORDI 3.0|SUD LABS \\(PACA\\)))+$"
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Idem

schema.json Outdated
"type": "string",
"constraints": {
"required": false,
"pattern": "(?:(?:^|;)(Se présenter|Téléphoner|Contacter par mail|Prendre un RDV en ligne|Ce lieu n'accueille pas de public|Envoyer un mail avec une fiche de prescription))+$"
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Idem

"type": "string",
"constraints": {
"required": false,
"pattern": "(?:(?:^|;)(Seul : j'ai accès à du matériel et une connexion|Avec de l'aide : je suis accompagné seul dans l'usage du numérique|Dans un atelier : j'apprends collectivement à utiliser le numérique|A ma place : une personne habilitée fait les démarches à ma place))+$"
"pattern": "(?:(?:^|;)(En autonomie|Accompagnement individuel|Dans un atelier collectif|À distance))+$"
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Idem

schema.json Outdated
"created": "2022-07-04",
"updated": "2022-08-01",
"updated": "2022-04-02",
"homepage": "https://github.com/LaMednum/standard-mediation-num",
"uri": "https://raw.githubusercontent.com/LaMednum/standard-mediation-num/v0.1.0/schema.json",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ il faut changer le numéro de version dans tous les champs qui le mentionnent (on a un outil qui arrive pour faire ça automatiquement, cf ici)

Copy link

@Pierlou Pierlou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Désolé pour les mauvaises recommandations de la review précédente, je n'avais pas en tête que des données étaient déjà publiées, et j'ai mal compris le besoin sur les champs avec choix multiples

schema.json Outdated
"role": "contributor"
},
{
"organisation": "Etalab",
"role": "contributor"
}
],
"version": "0.1.0",
"version": "0.2.0",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"version": "v0.2.0" (je peux ajouter l'utilitaire de test qu'on a créé pour les checks des versions si vous voulez)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oui carrément merci

schema.json Outdated
@@ -225,7 +226,7 @@
{
"name": "site_web",
"title": "Site web",
"description": "Ce champ contient une ou plusieurs URL vers le site internet du lieu et/ou les réseaux sociaux. Pour renseigner plusieurs URL, il est nécessaire de les séparer par un point-virgule.",
"description": "Ce champ contient une ou plusieurs URL vers le site internet du lieu et/ou les réseaux sociaux. Pour renseigner plusieurs URL, il est nécessaire de les séparer par une barre verticale |.",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Je reviens sur cette histoire de séparateur : j'ai vérifié (je n'avais pas pensé à le faire la dernière fois) et il y a déjà des fichiers publiés sur data.gouv sous l'égide du schéma (notamment ici), donc ce n'est pas une bonne idée de changer les séparateurs, sinon il faudra repasser sur tous les fichiers déjà publiés. On peut rester sur le point virgule (qui garde malheureusement les inconvénients listés plus haut)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok je modif

schema.json Outdated
"example": "Itinérant",
"type": "string",
"constraints": {
"required": false,
"pattern": "(?:(?:^|;)(Itinérant|Fixe))+$"
"enum": [
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

La contrainte enum ne permet pas de renseigner plusieurs valeurs de la liste (j'avais mal lu votre besoin, désolé 😞). C'est bien une regex qu'il faut, celle d'origine était correcte, my bad (et on reste aussi sur le point virgule)

schema.json Outdated
@@ -309,68 +313,106 @@
{
"name": "services",
"title": "Services",
"description": "Ce champ permet de décrire les types d'accompagnement proposés dans l'offre du lieu. Sélectionner une ou plusieurs valeurs séparées par un point-virgule sans espace parmi la liste suivante : Aide aux démarches administratives;Maîtrise des outils numériques du quotidien;Insertion professionnelle via le numérique;Utilisation sécurisée du numérique;Parentalité et éducation avec le numérique;Loisirs et créations numériques;Comprehension du monde numérique;Accès internet et matériel informatique;Acquisition de matériel informatique à prix solidaire.",
"description": "Ce champ permet de décrire les types d'accompagnement proposés dans l'offre du lieu. Sélectionner une ou plusieurs valeurs séparées par un | parmi la liste suivante : Aide aux démarches administratives|Maîtrise des outils numériques du quotidien|Insertion professionnelle via le numérique|Utilisation sécurisée du numérique|Parentalité et éducation avec le numérique|Loisirs et créations numériques|Compréhension du monde numérique|Accès internet et matériel informatique|Acquisition de matériel informatique à prix solidaire",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

De même ici, on reste sur point virgule + regex

schema.json Outdated
}
},
{
"name": "publics_specifiquement_adresses",
"title": "Publics spécifiquement adressés",
"description": "Par défaut, un lieu d'inclusion numérique est inclusif et peut accueillir tout public. Malgré tout, certains lieux sont habilités à recevoir exclusivement certains publics précis ! Ce champ permet de spécifier si l'action du lieu est tournée vers un public spéficiquement adressé. Sélectionner une ou plusieurs valeurs séparées par un point-virgule sans espace parmi la liste suivante : Jeunes;Étudiants;Familles et/ou enfants;Seniors;Femmes",
"description": "Par défaut, un lieu d'inclusion numérique est inclusif et peut accueillir tout public. Malgré tout, certains lieux sont habilités à recevoir exclusivement certains publics précis ! Ce champ permet de spécifier si l'action du lieu est tournée vers un public spéficiquement adressé. Sélectionner une ou plusieurs valeurs séparées par un | sans espace parmi la liste suivante : Jeunes;Étudiants;Familles et/ou enfants;Seniors;Femmes",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

De même ici, on reste sur point virgule + regex

schema.json Outdated
},
{
"name": "frais_a_charge",
"title": "Frais à charge",
"description": "Ce champ indique les conditions financières d'accès au lieu. Sélectionner une ou plusieurs valeurs séparées par un point-virgule sans espace parmi la liste suivante : Gratuit : Je peux accéder gratuitement au lieu et à ses services;Gratuit sous condition : La gratuité est conditionnée à des critères (adhésion, situation familiale, convention avec un organisme social, pass numériques…);Payant : L’accès au lieu et/ou à ses services est payant",
"description": "Ce champ indique les conditions financières d'accès au lieu. Sélectionner une ou plusieurs valeurs séparées par un | parmi la liste suivante : Gratuit : Je peux accéder gratuitement au lieu et à ses services;Gratuit sous condition : La gratuité est conditionnée à des critères (adhésion, situation familiale, convention avec un organisme social, pass numériques…);Payant : L’accès au lieu et/ou à ses services est payant",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

De même ici, on reste sur point virgule + regex

schema.json Outdated
},
{
"name": "dispositif_programmes_nationaux",
"title": "Dispositifs et programmes nationaux",
"description": "Ce champ indique si le lieu appartient à un dispositif ou à un programme national. Sélectionner une ou plusieurs valeurs séparées par un point-virgule sans espace parmi la liste suivante : Aidants Connect;Bibliothèques numérique de référence;Certification PIX; Conseillers numériques;Emmaüs Connect;France Services;Grande école du numérique;La Croix Rouge;Point d'accès numérique CAF;Promeneurs du net;Relais numérique (Emmaüs Connect)",
"description": "Ce champ indique si le lieu appartient à un dispositif ou à un programme national. Sélectionner une ou plusieurs valeurs séparées par un | sans espace parmi la liste suivante : Aidants Connect;Bibliothèques numérique de référence;Certification PIX; Conseillers numériques;Emmaüs Connect;France Services;Grande école du numérique;La Croix Rouge;Point d'accès numérique CAF;Promeneurs du net;Relais numérique (Emmaüs Connect)",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

De même ici, on reste sur point virgule + regex

schema.json Outdated
},
{
"name": "formations_labels",
"title": "Formations et labels",
"description": "Ce champ indique si le lieu a obtenu un(e) ou plusieurs formations et labels. Cette liste est évolutive, si vous ne trouvez pas ce que vous cherchez vous pouvez vous référer au champ 'Autres formations ou labels'. Sélectionner une ou plusieurs valeurs séparées par un point-virgule sans espace parmi la liste suivante : Formé à « Mon Espace Santé »;Formé à « DUPLEX » (illetrisme);Arnia/MedNum BFC (Bourgogne-Franche-Comté);Collectif ressources et acteurs réemploi (Normandie);Fabriques de Territoire;Les Éclaireurs du numérique (Drôme);Mes Papiers (Métropole de Lyon) ;ORDI 3.0;SUD LABS (PACA)",
"description": "Ce champ indique si le lieu a obtenu un(e) ou plusieurs formations et labels. Cette liste est évolutive, si vous ne trouvez pas ce que vous cherchez vous pouvez vous référer au champ 'Autres formations ou labels'. Sélectionner une ou plusieurs valeurs séparées par un | parmi la liste suivante : Formé à « Mon Espace Santé »;Formé à « DUPLEX » (illetrisme);Arnia/MedNum BFC (Bourgogne-Franche-Comté);Collectif ressources et acteurs réemploi (Normandie);Fabriques de Territoire;Les Éclaireurs du numérique (Drôme);Mes Papiers (Métropole de Lyon) ;ORDI 3.0;SUD LABS (PACA)",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

De même ici, on reste sur point virgule + regex

schema.json Outdated
@@ -385,24 +427,32 @@
{
"name": "modalites_acces",
"title": "Modalités d'accès",
"description": "Ce champ fournit des informations sur les différentes étapes ou démarches à suivre pour se rendre au lieu d'inclusion numérique et bénéficier de ses services. Sélectionner une ou plusieurs valeurs séparées par un point-virgule sans espace parmi la liste suivante : Se présenter;Téléphoner;Contacter par mail;Prendre un RDV en ligne;Ce lieu n'accueille pas de public;Envoyer un mail avec une fiche de prescription",
"description": "Ce champ fournit des informations sur les différentes étapes ou démarches à suivre pour se rendre au lieu d'inclusion numérique et bénéficier de ses services. Sélectionner une ou plusieurs valeurs séparées par un | parmi la liste suivante : Se présenter;Téléphoner;Contacter par mail;Prendre un RDV en ligne;Ce lieu n'accueille pas de public;Envoyer un mail avec une fiche de prescription",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

De même ici, on reste sur point virgule + regex

schema.json Outdated
},
{
"name": "modalites_accompagnement",
"title": "Modalités d'accompagnement",
"description": "Ce champ indique les types d'accompagnement proposés par le lieu. Sélectionner une ou plusieurs valeurs séparées par un point-virgule sans espace parmi la liste suivante : En autonomie;Accompagnement individuel; Dans un atelier collectif : j'apprends collectivement à utiliser le numérique;À distance (par téléphone ou en visioconférence)",
"description": "Ce champ indique les types d'accompagnement proposés par le lieu. Sélectionner une ou plusieurs valeurs séparées par un | parmi la liste suivante : En autonomie;Accompagnement individuel; Dans un atelier collectif : j'apprends collectivement à utiliser le numérique;À distance (par téléphone ou en visioconférence)",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

De même ici, on reste sur point virgule + regex

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants