Importer des données

Convertisseur de données

Le modules d'import permet la convertion de données en onthologie PH décrit ci-dessous :

Onthologie PH

{
    "\_id" : ObjectId("STRING"),
    "name" : "STRING",
    "email" : "STRING",
    "type" : "STRING",
    "address" : {
        "@type": "PostalAddress",
        "postalCode" : "STRING",
        "addressLocality" : "STRING",
        "codeInsee" : "STRING",
        "streetAddress" : "STRING",
        "addressCountry" : "STRING",
    "regionName": "Nord-Pas-de-Calais-Picardie",
    "depName": "NORD"
    },
    addresses : [
        "address"
        ],
    "geo" : {
        "latitude" : "FLOAT",
        "longitude" : "FLOAT",
        "@type": "GeoCoordinates",
    },
    geoPosition": {
        "type": "Point",
        "coordinates": [ 
           "latitude -> FLOAT",
           "longitude -> FLOAT"
            ]
},
    "description" : "STRING",
    "shortDescription" : "STRING",
    "url" : "STRING",
    "image" : "STRING",
    "urlFacebook" : "STRING",
    "urlTwitter" : "STRING",
    "source" : {
        "id" : "STRING",
        "url" : "STRING",
        "key" : "STRING",
        keys": [ 
            "STRING"
    ],
"insertOrign": "STRING",
        "update" : "DATETIME"
    },
    "tags" : [ 
        "STRING"
    ],
    "telephone" : {
        "fixe" : [ 
            "STRING"
        ],
        "mobile" : [ 
            "STRING"
        ],
        "fax" : [ 
            "STRING"
        ]
    },
    "contacts" : [ 
        {
            "name" : "STRING",
            "role" : "STRING",
            "telephone" : [ 
                "STRING"
            ],
            "email" : "STRING"
        }
    ],
     "preferences" : {
        "isOpenData" : "BOOLEAN",
        "isOpenEdition" : "BOOLEAN",
    },
    "state" : "STRING",
    "profilImageUrl" : "STRING",
    "profilThumbImageUrl" : "STRING",
    "profilMarkerImageUrl" : "STRING",
    "profilMediumImageUrl" : "STRING",
    "modified" : "ISODate",
    "updated" :"INT",
    "links" : {
        "members" : {
            },
        "events" : {
            },
        "projects" : {
            },
         "memberOf" : {
            },
            "needs" : {
            }, 
            "follows" : {
            },
    },
    "modifiedByBatch" : [ 
        {
            "NameBatch" : "ISODate"
        }
    ]
    "creator" : "STRING",
    "created" : "INT"
    
}

Etape 1 : Choix des données à convertir

Organisation

Selections obligatoire:

Element disponibles :

• Organisation
• Citoyens
• Evenement
• Projet

Types de source disponibles :

• URL
• FILE

Selection optionnelle :

• Le lien ( le mapping )

Types de fichier disponibles pour une url

• JSON

Types de fichier disponibles pour un fichier

• JSON
• CSV

Remplir le champ "Path to Elements" qui indique où se trouve la données pertinentes

Exemple

Pour un fichier JSON suivant, la donnée pertinente se trouve dans le tableau "features" :

{
	"type": "FeatureCollection",
	"features": [{
		"type": "Feature",
		"geometry": {
			"type": "Point",
			"coordinates": [55.433699, -21.259772]
		},
		"properties": {
			"name": "Damien Grondin",
			"username": "Femu",
			"img": "http:\/\/127.0.0.1\/ph\/upload\/communecter\/citoyens\/5880b24a8fe7a1a65b8b456b\/1489667898_linkpkm.jpg"
		}
	}]
}

Etape 2 : Création du mapping

Dans cette étape, nous allons réaliser ce qu'on apelle un mapping. C'est à dire renseigné à quel champ de l'onthologie PH correspond tel ou tel champ des données du fichier source.

Dans la colonne de gauche : "Source", on peut selectionner toutes les branches du fichier source. Dans la colonne de droite : "Communecter", on peut selectionner le champ de l'onthologie PH auquel on veut associer la branche du fichier source de la colonne de gauche.

On ajoute une ligne simplement en cliquant sur la bouton "Ajouter" dans la troisième colonne. On supprime une ligne en cliquant sur la croix rouge qui apparait dans la troisième colonne lors d'un ajout de ligne.

Lors d'un nouveau mapping, on peut à tout moment Sauvegarder le mapping actuel simplement en cliquant sur le bouton "Save Mapping". ( Si lors de l'étape 1, on avait selectionné un mapping enregistré, les bouttons "Update Mapping" et "Delete Mapping" appraissent. Boutton qui permettent respectivement de modifier ou de supprimer un mapping existant ).

Remarque : si on clique sur le boutton étape précédente, le mapping reste enregistré jusqu'au nouveau rafraîchissement de la page.

Avant de pouvoir passer à l'étape suivante, il est impératif de :

• faire au moins une assignation dans le mapping
• avoir renseigné la "key" dans le champ adéquat

Champ obligatoire pour la convertion d'organisations :

• name
• type

Champ obligatoire pour la convertion de citoyens :

• name
• username
• birthdate

Champ obligatoire pour la convertion d'évènements :

• name

Champ obligatoire pour la convertion de projets :

• name

La checkbox "Test" permet de tester la convertion et donc de visualiter les données qui sont bien converties ainsi que les données qui sont rejetée avec le message d'erreur qui décrit le pourquoi du rejet.

Etape 3 : Sauvegarder des données converties et/ou des données rejetées

Lors de la troisième étape, on peut enregistré au format JSON, les données du fichier source qui ont été converties avec succées au format PH.

On peut également enregistré les données qui ont été rejetés au format JSON.

Injecter des données

Organisations

Type de fichiers autorisés :

• CSV
• JSON

Règles :

• Les doublons sont INTERDIT : Une organisation ne doit apparaître qu'une seule fois dans le fichier
• Avant de mettre un organisme, vérifier qu'il n'existe pas sur communecter.org
• NE pas mettre formations/projets/ qui peuvent être regroupés dans une seule organisation.

Informations obligatoires :

• Nom de l'organisme
• Code Postal
• Ville
• Code Pays (exemple : FR)
• Type : (Association, Groupe, Entreprise ou Groupe Gouvernemental)

Informations optionnelles :

• Téléphones * Format recommandé : "+33 6 00 00 00 00") * Si plusieurs numéros, mettre un seul numéro par colonne) * On peut en ajouter autant qu'on le souhaite * Différents types de téléphone : Mobile, Fixe et Fax
• URL
• Description
• Numéro et nom de la voie
• Email
• Tags ( Si plusieurs tags, mettre un seul tags par colonne)
• Site Web
• Latitude / Longitude
• Contact ? : * Nom et Prénom du contact * Rôle du contact au sein de l'organisme * Téléphone du contact ( Si plusieurs numéros, mettre un seul numéro par colonne) * Email du contact

Citoyens

Events

Projets