Charger les données automatiquement

Au lieu de téléverser chaque fois le même export, UnionOps Data peut le recevoir d’un petit programme qui envoie le fichier selon un horaire. UnionOps le lit comme un téléversement, puis applique la règle que vous avez fixée pour cette source. Un fichier n’est jamais publié simplement parce qu’il est arrivé. Ce guide a deux parties : ce qu’un dirigeant met en place, puis ce que fait la personne qui s’occupe des ordinateurs de la section locale.

Avant de commencer

• L’admin du site doit permettre l’envoi signé pour l’ensemble du site. Si le panneau Sources récurrentes affiche L’envoi signé est désactivé sur ce site, adressez-vous à l’admin du site.
• Une personne administratrice du syndicat active l’envoi pour votre syndicat.
• Vous devez avoir accès à UnionOps Data dans la section locale à laquelle appartient la liste.

Activer l’envoi pour votre syndicat

Seule une personne administratrice du syndicat voit le bouton. Rien ne peut être envoyé tant qu’il n’est pas activé.

1. 1Ouvrez UnionOps Data dans le menu du Hub des dirigeants et choisissez l’onglet Importations.
2. 2Sous Sources récurrentes, appuyez sur Activer l’envoi pour le syndicat.
3. 3Saisissez le code de votre application d’authentification dans Code d’authentificateur et confirmez. Le panneau affiche alors L’envoi signé est activé pour votre syndicat.

Pour arrêter tous les envois dans votre syndicat, appuyez sur Désactiver l’envoi pour le syndicat. Les fichiers envoyés ensuite sont refusés.

Créer une source d’envoi

Une source, c’est le même export qui arrive chaque fois dans le même jeu de données. Elle garde le modèle de fichier, la règle de révision et le jeton d’envoi.

1. 1Sous Sources récurrentes, saisissez un Nom de la source et choisissez le Jeu de données.
2. 2Pour une liste de membres, remplissez Provenance de cette liste : Qui l’a fournie, Autorité pour la détenir, À quoi elle servira et À réviser au plus tard le. UnionOps consigne ce que vous déclarez, sans le vérifier. Chaque fichier envoyé dans la source la porte.
3. 3Appuyez sur Créer la source.

Une liste de membres envoyée est refusée si la déclaration manque ou si sa date de révision est passée. Ouvrez la source, appuyez sur Indiquer la provenance de cette liste ou sur Modifier la provenance de cette liste, mettez-la à jour, puis appuyez sur Enregistrer.

Créer un jeton et copier l’adresse d’envoi

1. 1Sur la source, appuyez sur Créer un jeton d’envoi. Saisissez un nouveau code de votre application d’authentification.
2. 2Copiez le jeton tout de suite. Il est affiché une seule fois et UnionOps n’en garde aucune copie. Appuyez sur Je l’ai copié une fois qu’il est rangé en lieu sûr.
3. 3Copiez l’Adresse d’envoi affichée sous la source. Le programme d’envoi a besoin des deux.

Choisir ce qui arrive à un fichier

Par défaut, un dirigeant révise chaque fichier. Un fichier envoyé attend dans l’onglet Importations comme un téléversement, comparé au précédent.

Appuyez sur Publier dans des limites si vous voulez qu’un fichier se publie de lui-même. Cela demande un nouveau code. Par défaut, cela n’arrive qu’après deux fichiers révisés de la source, et seulement si un fichier apporte au plus 10 nouvelles personnes, au plus 5 % de départs et les mêmes en-têtes de colonnes. Tout ce qui dépasse attend un dirigeant. Si la personne qui l’a activée perd son accès à la section locale, les fichiers attendent de nouveau.

L’admin du site peut désactiver la publication automatique pour l’ensemble du site. Tant qu’elle n’est pas rétablie, chaque fichier attend un dirigeant. Appuyez à tout moment sur Revenir à la révision par un dirigeant pour revenir à la révision.

Renouveler ou retirer un jeton

• Renouveler le jeton d’envoi crée un jeton et met fin à l’ancien sur-le-champ. Faites-le quand une personne qui connaissait le jeton part, ou si le jeton a pu être vu. Remettez le nouveau jeton à la personne qui lance le programme.
• Retirer le jeton d’envoi arrête les envois dans la source jusqu’à ce que vous en créiez un autre.

Ce que signifie un refus

Le programme affiche une courte ligne et un code. Voici ceux à connaître :

• Refus sans motif (401). UnionOps donne la même réponse pour toutes les causes, afin qu’on ne puisse pas deviner un jeton. Vérifiez que le jeton est à jour, que l’envoi est activé pour le site et pour votre syndicat, que la source n’est pas archivée et que la personne qui a créé la source a toujours accès aux données de la section locale.
• Déclaration échue ou manquante (409). La déclaration de la liste de membres manque, ou sa date de révision est passée. Confirmez-la comme ci-dessus.
• Trop d’envois (429). Une source accepte 12 fichiers par heure. Envoyez une ou deux fois par jour.
• Limite quotidienne (429). La limite quotidienne de votre syndicat pour les fichiers envoyés est atteinte. Réessayez demain.
• Problèmes de fichier. Seuls les fichiers .csv et .xlsx sont acceptés, jusqu’à 12 Mio par défaut. Un fichier qui ne peut pas être lu avec le modèle de fichier de la source est refusé avec un motif.
• A déjà ce fichier exact. L’export n’a pas changé depuis le dernier envoi. C’est normal, pas une erreur.

Lancer le programme d’envoi

Cette partie s’adresse à la personne qui s’occupe des ordinateurs de la section locale. Les étapes complètes, les paramètres et le dépannage se trouvent dans le fichier README du programme (en anglais).

1. 1Installez Node.js 20 ou plus récent. Rien d’autre n’est nécessaire.
2. 2Placez les fichiers du programme dans un dossier, copiez le fichier de paramètres d’exemple vers unionops-push.config.json, puis indiquez l’adresse d’envoi (pushUrl) et le fichier d’export (file).
3. 3Gardez le jeton dans une variable d’environnement (tokenEnv) ou dans un fichier dont l’accès est limité à votre compte (tokenFile). Il ne va jamais dans le fichier de paramètres ni sur la ligne de commande, et le programme refuse --token.
4. 4Lancez-le une première fois à la main avec --verbose et vérifiez la ligne qu’il affiche.
5. 5Planifiez-le. Sous Windows, register-task.ps1 crée une tâche planifiée quotidienne ou hebdomadaire. Sous Linux ou macOS, utilisez cron.

Lire ce que le programme rapporte

Il affiche une ligne simple, par exemple published 1,204 rows, et se termine par un code que votre planificateur affiche.

• 0 : terminé. Le fichier a été publié, ou accepté et en attente d’un dirigeant, ou UnionOps l’avait déjà.
• 2 : problème de configuration. UnionOps n’a pas pris le fichier.
• 3 : en attente d’un dirigeant. Seulement avec --require-published.
• 4 : UnionOps a refusé le fichier ou le jeton, ou a pris le fichier sans dire ce qu’il est devenu. Consultez la source dans UnionOps Data.
• 5 : UnionOps ou le réseau a échoué trois fois. Le prochain lancement réessaie.
• 6 : le fichier a été accepté mais sa lecture n’était pas terminée quand l’attente a pris fin.
• 1 : erreur inattendue. Relancez avec --verbose et demandez de l’aide.

Si vous définissez logFile, une ligne est ajoutée à chaque lancement : l’heure, le nom et la taille du fichier, l’importation, le statut, les nombres et les codes. Elle ne contient jamais le jeton ni rien de l’intérieur du fichier. UnionOps ne renvoie que des nombres et de courts codes. Aucun nom, aucun numéro de membre et aucune ligne ne revient à l’ordinateur qui lance le programme.