Operator

Owned by Mickael François
30/09/2024
3 min read

L'Operator permet d'envoyer le paramétrage du projet en cours vers un projet cible.
Les données provenant du projet en cours sont copiées vers le projet cible.

Prérequis

Il est nécessaire d'avoir un compte valide sur le projet cible (même nom d'utilisateur, même mot de passe).

Liste des travaux et logs

operator.png


1. Il est nécessaire de se connecter via le Studio sur le projet cible et d'autoriser le projet en cours comme source avant tout lancement.

operator_source.png

Il est possible de lancer -2- le traitement de l'Operator, ainsi que de l'arrêter s'il est déjà en cours -3.

L'actualisation -4- permet de rafraîchir la liste des travaux en cours et terminés -5- ainsi que les logs -6.

Lorsque le traitement de l'Operator est en cours, le log se rafraîchit au fur et à mesure du traitement, afin de pouvoir suivre son exécution.

Lancement d'un Operator

Il est nécessaire de préciser quel projet cible doit avoir son paramétrage écrasé.

Il est possible de préciser si l'on souhaite écraser les enquêtes et formulaires, les automates Backend et Event et les définitions des champs dynamiques.
Il est également possible de préciser si l’on souhaite écraser la configuration de l’agent distant, et également, les variables et les scénarios.

Exécution de l'Operator

L'exécution de l'Operator bloque les synchronisations et la surveillance des services Backend, Alert, et Event durant son traitement. Dans le cas où le projet cible est une production, il donc recommandé de l'exécuter en dehors des heures de synchronisations importantes des utilisateurs, afin de ne pas les gêner dans leur travail.

La première action réalisée par l'Operator est de mettre à niveau la base de données du projet cible, donc les champs modifiés et ajoutés.

Le détail des tables transférées est affiché lors de l'exécution dans le journal (log).

Voici un résumé :

  • Dictionnaire de données (ainsi que le schéma)

  • Configuration complète des mobiles

  • Configuration Backend

  • Configuration Event

  • Configuration Synchronisation

  • Configuration des notifications

  • Configuration des traductions

  • Configuration Agent distant

  • Configuration des Entrpypoints

 

EntryPoints

Certains types d’entrypoints sont liés à un compte (device). Ce compte doit exister également sur le projet cible (même nom)

Agent distant

Les sources de données doivent être crées au préalable sur le projet cible (même code).
La release de la configuration n’est pas copiée. Il faudra se connecter sur le projet cible pour générer la release si nécessaire.

Backend

Les sources de données doivent être créées au préalable sur le projet cible (même code).

Entités supplémentaires

Il est possible de copier les données d’autres entités.
La liste est définie dans la variable 'Operator.Entities' (nom de table sans le préfixe sw_data_).

 

ℹ️ Il est à noter que le contenu de la table des variables projet “sw_data_basevariable” n'est pas transféré. Il peut donc être nécessaire, par exemple dans le cas de modifications de droits de profils de mettre en place en plus de l'Operator une interface Backend sur le projet cible.

ℹ️ Operator transfère les informations du dictionnaire de données. Il est donc primordial dans le fonctionnement de projets de développement / préproduction / production de bien respecter la chaine d'exécution de l'Operator, à savoir un premier Operator de développement vers préproduction puis un Operator de préproduction vers production.