Créer un projet test – Apidae Tourisme - Site d'aide aux utilisateurs

Chaque membre à la possibilité de créer un projet test (bac à sable) pour expérimenter les exports et les APIs

A noter avant de commencer

Un projet test est limité en nombre d'objets :
- le nombre total d’objets est limité à 200 par sélection via les APIs
- le nombre total d’objets est limité à 1 000 via les exports
Les projets tests bénéficient de priorités de traitement moindre que les projets standards. Ils sont traités en fin de cycle d'export
A la différence avec un projet standard, aucune validation du réseau Apidae n'est nécessaire pour la création d'un projet test
Les projets test ne peuvent pas être transformés en projet standard. Tout projet destiné à être utilisé en production doit donc donner lieu à la création d'un projet normal validé par le réseau Apidae. Savoir comment Créer son projet numérique
Les projets tests sont automatiquement désactivés s'ils ne sont pas reconfigurés pendant 6 semaines (réception d'une notification par mail avec possibilité de réactiver le projet si besoin. Cf. plus bas)
Aucune garantie de service n'est donnée pour les projets test

Création du projet test

Naviguez dans le menu Diffuser / Projets / Mes projets

Sur cet écran, cliquez sur le bouton Créer un projet de test situé en haut à droite de la barre de navigation
A noter : A la création du projet de test, une sélection contenant un filtre est automatiquement créée. Vous pourrez reconfigurer ou supprimer cette sélection ultérieurement.
Dans cette fenêtre, renseignez les éléments suivants :

Le nom que vous souhaitez donner à votre projet de test
Le type d'outil alimenté par le projet (appli, site, etc.)7
Description de l'usage du projet
La partie de droite de la fenêtre vous permet de configurer la sélection et le filtre qui vont être automatiquement créés pour l'alimentation du projet :
Le nom que vous souhaitez donner à la sélection
Le nom que vous souhaitez donner au filtre qui alimentera la sélection
Le département sur lequel doit porter la recherche (facultatif). Renseigner un département ici vous permet de filtrer la liste des territoires disponibles dans le champ Territoire (7)
Le territoire précis sur lequel doit porter la recherche
Validez la création de votre projet de test

Une fois la création du projet validée, vous êtes redirigé sur la fiche détaillée du projet et retrouvez les éléments suivants :

Identifiant numérique du projet
Informations générales du projet contenant notamment la clé d'API
Visualisation du contenu du projet
Rapports de calcul des sélections et exports
Configuration technique
Lancement d'opérations exceptionnelles
Ajout de collaborateurs sur le projet
Modification des informations générales du projet

Visualisation du contenu du projet

Les onglets sélections, filtres et marquages vous permettent de visualiser et gérer le contenu du projet. Par défaut, ils contiennent la sélection et le filtres qui ont automatiquement été créés avec le projet de test.
Vous pouvez modifier, ajouter ou supprimer de nouvelles sélections, filtres ou objets marqués (dans les limites du nombre d'objets exploitables dans les projets de test).

Modification de la configuration technique du projet

En cliquant sur l'onglet Configuration technique, vous avez la possibilité de modifier le paramétrage de votre projet

Vous pouvez configurer les éléments suivants :

1. Technologies utilisées API et/ou Exports

2. Fréquence de génération : quotidienne, hebdomadaire ou mensuelle

3. Inclure ou non les objets masqués dans les flux. Il est recommandé de ne pas exporter les objets masqués. A noter : si vous utilisez cette option, il est nécessaire de veiller à ce que les objets masqués ne soient pas diffusés au piblic

4. Choix du format JSON ou XML

5. Choix de version (une seule version disponible actuellement : V2).

6. Grouper ou non les objets exportés. Si les objets sont groupés, ils sont exportés par paquets de 50. Dans le cas contraire, chaque objet exporté fait l'objet d'un fichier individuel

7. Exporter ou non les dates d'ouverture. Si l'export est activé, les objets sont exportés avec la liste des jours d'ouverture (visibilité à 1 an minimum)

8. et 9. URL et email de notification. A la fin de l’export, l’application envoie des informations concernant l’issue de l’export au web service ainsi désigné. En cas d'erreur, la ou les adresses mail renseignées sont notifiées. Pour renseigner plusieurs adresses mail, vous devrez les séparer par des espaces, des virgules ou des points-virgules.

10. Enregistrement des paramètres

Opérations exceptionnelles

En cas de problème survenu sur votre projet numérique (site, appli, bornes, etc.) ou pour répondre à un besoin de mettre à jour tout ou partie de votre projet, il peut arriver que vous ayez besoin de relancer le calcul des sélections. Cette opération doit cependant rester exceptionnelle.
Pour plus d'info sur les opérations exceptionnelles, consultez cette documentation

Réactiver un projet test désactivé

Dans le cas où votre projet test a été désactivé (pas d’activité sur le projet dans les 6 semaines), vous pouvez le réactiver en vous rendant dans le menu Diffuser / Projets / Mes projets

Dans la liste des projets, cochez la case afficher les projets désactivés (1) puis sur le bouton filtrer (2). Cliquez ensuite sur le nom (3) de votre projet test

Puis cliquez sur le bouton Activer le projet