API externes

Le logiciel de gestion d’associations Webling propose une API qui peut être intégrée à VOLAGIC.

Webling

Pour connecter VOLAGIC et Webling, vous devez tout d’abord générer une clé API dans Webling. Pour cela, accédez à «Administration» dans la navigation principale. Dans la navigation latérale, vous trouverez «API» sous «Gestion de l’abonnement». Vous pouvez y ajouter une description pour la clé et gérer les droits d’accès. VOLAGIC doit avoir accès aux données des membres. Vous disposez des options suivantes:

• Lire tous les membres – VOLAGIC peut récupérer les données de tous les membres dans Webling
• Lire et modifier tous les membres – VOLAGIC peut récupérer et modifier les données de tous les membres
• Personnalisé – Vous définissez quels Groupes de membres sont accessibles et pour lesquels des droits de lecture ou d’écriture doivent s’appliquer

La comptabilité, les rendez-vous et le matériel ne doivent pas être rendus accessibles.

Une fois la clé créée, vous la trouverez dans la liste et pourrez la copier en cliquant sur l’icône en forme de clé dans la fenêtre de modification.

VOLAGIC

Une fois la clé Webling copiée, vous pouvez cliquer sur le bouton «Configurer maintenant» dans VOLAGIC. Dans VOLAGIC, vous pouvez ensuite définir à nouveau les droits dont VOLAGIC dispose sur les données de Webling (droits de lecture ou d’écriture). IMPORTANT : si vous avez uniquement accordé des droits de lecture dans Webling, vous ne pouvez pas activer de droits d’écriture dans VOLAGIC. Saisissez ensuite votre sous-domaine Webling ainsi que la clé correspondante, puis cliquez sur «Enregistrer».

Modifier l’attribution des champs des Auxiliaires

Vous accédez maintenant à l’attribution des champs des Auxiliaires. Associez les champs Webling que vous souhaitez importer aux champs correspondants dans VOLAGIC.

Par défaut, seuls certains champs (e-mail, prénom, nom, etc.) sont disponibles dans VOLAGIC. Pour importer des champs supplémentaires, vous devez d’abord les créer comme champs personnalisés dans VOLAGIC sous «Organisation» – «Données des Auxiliaires». Vous n’avez pas besoin d’associer les champs dont vous n’avez pas besoin dans VOLAGIC. Seuls le prénom, le nom et l’adresse e-mail sont obligatoires.

Attribuer les Groupes

Une fois l’attribution des champs terminée, vous accédez à l’attribution des Groupes. Comme pour l’attribution des droits dans Webling, vous pouvez définir si les données doivent uniquement être importées depuis certains Groupes. IMPORTANT: les paramètres définis lors de la création de l’API dans Webling ne peuvent pas être remplacés dans VOLAGIC.

Si vous souhaitez importer tous les Groupes disponibles, vous pouvez maintenant les attribuer aux Groupes correspondants dans VOLAGIC. Comme pour les champs des Auxiliaires, les Groupes VOLAGIC doivent avoir été créés au préalable afin de pouvoir être associés aux Groupes Webling. Les Groupes que vous ne souhaitez pas associer peuvent conserver le statut «Non associé».

Configuration principale

Une fois l’attribution des Groupes terminée, vous accédez à la configuration principale. Vous pouvez y vérifier l’ensemble des paramètres, consulter les informations sur d’éventuelles attributions supplémentaires et effectuer des ajustements si nécessaire.

Activation

Lorsque tout est correctement configuré, revenez à «API externes» dans la navigation et cliquez sur «Activer». Si vous souhaitez lancer immédiatement la première importation Webling, cliquez sur «Lancer l’importation». La première importation démarre alors immédiatement et peut prendre quelques minutes.

Utilisation de l’interface

Informations

Une fois l’interface activée, vous trouverez les informations suivantes sous «API externes»:

• Mode – VOLAGIC dispose-t-il de droits de lecture ou d’écriture sur Webling?
• Dernière importation – Quand la dernière importation a-t-elle eu lieu et combien d’Auxiliaires ont été importés?
• Attributions facultatives – Si certains champs VOLAGIC ne sont pas associés, cela vous est indiqué ici. Cette information est purement informative si vous ne souhaitez volontairement pas les associer.
• Erreurs d’importation – Si des erreurs se sont produites lors de la dernière importation, elles sont affichées ici et vous êtes invité à les vérifier.
• Auxiliaires non associés à Webling – Vous trouverez cette information tout en bas de la vue d’ensemble. En cliquant dessus, vous accédez à la liste des Auxiliaires inscrits dans VOLAGIC mais non associés à Webling.

Comportement de l’importation

Si vous avez activé les droits de lecture et d’écriture pour VOLAGIC, aussi bien dans les paramètres de l’interface dans Webling que dans la configuration de VOLAGIC, toutes les modifications que vous ou vos Auxiliaires effectuez dans VOLAGIC sont directement transmises à Webling.

L’importation depuis Webling a lieu pendant la nuit, peu après minuit. Les modifications effectuées dans Webling ne sont donc transmises à VOLAGIC que lors de l’importation suivante.

Modification des Auxiliaires

Si vous avez uniquement défini des droits de lecture, vous ne pouvez plus modifier les Auxiliaires associés dans VOLAGIC une fois l’interface activée. Webling devient alors le système maître et transmet uniquement les informations à VOLAGIC – les modifications des données des membres doivent être effectuées dans Webling.