Comment importer un référentiel de certifications

Introduction

Ce guide vous explique comment importer un nouveau référentiel de certifications dans votre application DoYouBuzz Showcase.

Préparer votre fichier d'import

Deux formats d'import sont disponibles :

  • Un fichier CSV
  • Un fichier ZIP contenant :
    • Le fichier CSV
    • Les images/logos des certifications

☝️ Si votre template de Dossier de compétence inclut des logos pour les certifications, nous vous recommandons d'utiliser l'import d'un fichier .zip

Structure du fichier CSV

Le fichier CSV doit contenir les intitulés de colonne et les colonnes doivent être séparées par des virgules. Un exemple de fichier .csv est proposé en téléchargement depuis la page d'import de votre application.

Données du fichiers csv :

Nom de la colonne Obligatoire Format Description
id oui texte

Identifiant unique de la catégorie ou de la certification

S'il s'agit d'un nouveau référentiel, ces id seront convertis dans un autre format par l'application, mais les relations seront respectées
name oui texte nom de la catégorie ou de la certification
type oui category | model

category : la ligne correspond à une catégorie

model : la ligne correspond à une certification
category_id non texte catégorie dans la quelle est classée la certification (valable uniquement si la ligne décrit une certification)
logo_path non texte nom du fichier utilisé pour le logo (fonctionne uniquement si vous utilisez un .zip ; le format URL ne fonctionne pas).
name_en_US non texte nom de la traduction en anglais (1)
has_mandatory_end_date non 0 | 1 mentionne si la date de fin de la certification doit être remplie par le consultant quand il saisit son DC.

A propos des traductions

Si vous avez activé vos DC dans d'autres langues, d'autres options de traduction des certifications seront disponibles.

Vous pourrez ainsi traduire l'intitulé des catégorie et certifications dans toutes les langues activées sur vos DC. Le nom de la colonne sera name_[locale]. Exemple : name_es_ES.

Structure du fichier ZIP

Si vous souhaitez importer également les logos, il faudra créer un fichier zip qui devra contenir :

  • le fichier CSV, avec le champ logo_path renseigné pour les certifications avec logo
  • les images, d'une taille maximum de 300x300 pixels

Attention, le fichier zip ne devra pas contenir de répertoire : toutes les données (fichier .csv et .zip) seront à plat dans le fichier.

Créer un fichier .zip à plat sur mac

Procédure d'import

  1. Accédez à la page de gestion de votre référentiel de certifications
  2. Cliquez sur le bouton "Importer"

  1. Sélectionnez votre fichier :
    • Soit le fichier CSV seul
    • Soit le fichier ZIP contenant le CSV et les images
  2. Validez l'import

Comportement de l'import

Lors de l'import :

  • Si une ID est fournie et correspond à une certification existante : la certification sera mise à jour (idem pour les catégories)
  • Si aucune ID n'est fournie ou si l'ID ne correspond pas : une nouvelle certification sera créée (idem pour les catégories)

Si vous souhaitez mettre à jour votre référentiel, exportez au préalable votre référentiel actuel en utilisant le bouton "Exporter", vous disposerez ainsi des bons ID.

Après l'import

Une fois l'import terminé :

  • Vérifiez que toutes vos certifications apparaissent correctement
  • Vous pouvez réorganiser l'ordre des catégories et des certifications si nécessaire
  • En cas de mise à jour, les modifications seront automatiquement synchronisées avec les DC existants