Jeu d'instructions

Description métier

Une instruction permet de créer, modifier, associer ou supprimer une partie de vos données dans votre offre.

Un jeu d’instructions se définit au sein d’un espace de travail. Il est composé :

  • d'une liste d’instructions séquencées (les instructions seront exécutées dans l’ordre que vous avez défini)

  • de contextes pouvant contenir eux même une liste d’instructions

Un contexte permet de filtrer les données à mettre à jour.

Votre jeu d’instruction va se représenter de la manière suivante :

Jeu instructions.png
Jeu d’instructions

Une instruction est disponible dans une bibliothèque qui va s'enrichir au fur et à mesure des évolutions du produit https://enroute.atlassian.net/wiki/spaces/PUBLIC/pages/1938128917/Jeu+d+instructions#Biblioth%C3%A8que-d%E2%80%99instructions. Celle-ci est généralement paramétrable pour correspondre à votre contexte et vos objectifs.

Consulter les Jeux d’instructions

La gestion des jeux d’instructions se trouve sur votre “Espace de travail” puis “Jeux d’instructions”.

image-20240207-155204.png

Vous pouvez accéder de cette façon à la liste des jeux d’instructions définis dans votre Espace de Travail.

Pour chaque jeu d’instruction, nom, commentaires et la date d'édition, sont affichés.

Pour chaque jeu d’instruction, une roue dentée permet de lancer les actions disponibles :

  • afficher ce jeu d’instruction

  • éditer ce jeu d’instruction

  • exécuter un jeu d’instruction

  • supprimer ce jeu d’instruction (avec confirmation)

Créer un jeu d’instructions

En cliquant sur le bouton “Créer un jeu d’instructions”, vous accédez à la fiche d'édition d’un nouveau jeu d’instructions.

Pour commencer, il faut attribuer un nom à votre jeu d’instructions. Vous pouvez ajouter un commentaire indicatif optionnellement.

Ensuite, dans la section “Macros” vous pouvez ajouter différentes instructions.

Vous pouvez utiliser les instructions avec ou sans contexte. Un contexte permet de filtrer les données à traiter par l’instruction. Si aucun contexte n'est choisi l’instruction ajoutée va s’appliquer sur l’ensemble des données de la cible.

Pour ajouter une instruction sans contexte, il suffit de laisser le champs de contexte vide et ouvrir directement la liste des instructions, sélectionner une instruction, puis appuyer sur le bouton “Ajouter une nouvelle instruction”.

Le formulaire s’ouvre, proposant les champs avec différents paramètres. Selon l’instruction que vous aurez choisie, vous devrez y renseigner l'information nécessaire pour son exécution.

Indépendamment de l’instruction choisie, il vous sera toujours proposer d’ajouter une description de l’objectif de l’instruction et d’ajouter un commentaire :

Vous pouvez ajouter ainsi autant d’instructions que vous voulez, puis cliquer sur le bouton “Valider” pour terminer la création de votre jeu d'instructions.

Contexte

Vous pouvez utiliser les jeux d’instructions avec ou sans contexte. Un contexte permet de filtrer les données à mettre à jour.

Pour ajouter une instruction avec un contexte à votre jeu d’instructions, il faut cliquer sur le premier champs, sélectionner un contexte dans la liste proposée. Actuellement un seul contexte “Mode de transport” est disponible.

Ensuite, il faut cliquer sur le bouton “Ajouter un nouveau contexte”.

Une liste de différents modes de transport apparait.

Vous sélectionnez un mode de transport pour ce contexte, puis vous choisissez une instruction de la liste proposée, par exemple “Définir l’adresse postale”, et vous cliquez sur le bouton “Ajouter une nouvelle instruction”.

Dans le formulaire qui s’ouvre il faut préciser le Modèle cible.

Une fois les paramètres choisis, vous pouvez cliquer sur le bouton “Valider”.

La page du nouveau jeu d’instructions est affichée. Il peut désormais être utilisé et ne s’exécutera que sur les objets ayant le mode de transport sélectionné. Les objets ayant d'autres modes de transports seront ignorés.

Vous pouvez ajouter plusieurs instructions au même contexte.

Éditer le jeu d’instructions

A tout moment, vous pouvez modifier votre jeu d’instructions en cliquant sur le bouton “Éditer ce jeu de instructions”.

Si votre jeu d’instructions contient plusieurs instructions, la roue dentée vous permet d’organiser l’ordre de vos instructions. Ainsi les instructions en première position seront exécutées en premier, et ainsi de suite.

Lancer un jeu d’instruction manuellement

Après avoir créé votre jeu d’instructions, vous pouvez l’exécuter. Il faut aller dans la liste des jeux d’instructions, sélectionner sur la roue dentée “Exécuter un Jeu d’instructions” :

Un formulaire s’ouvre, vous proposant de nommer le rapport et de sélectionner une cible pour l’exécution.

Après avoir validé le formulaire, le jeu d’instructions se lance et vous êtes redirigé vers un rapport de jeu d’instructions.

Lancement automatique des jeux d’instructions

Vous pouvez automatiser le lancement de jeu d’instructions pour votre organisation à l’aide de règles de traitement.

Un jeu d’instructions peut être lancé automatiquement sur les étapes suivants :

  • après import

  • avant finalisation

  • après la finalisation

Rapports de Jeu d’instructions

Vous pouvez consulter la liste des rapports de jeux d'instructions créés par votre organisation dans “Espace de travail” → “Rapports de jeux d’instructions”.

Vous y trouverez les informations sur le traitement et le jeu d’instructions lancés :

  • le nom donné au rapport de jeu d’instructions

  • le nom du jeu d’instructions

  • le référentiel ciblé, s’il y en a un

  • le statut du jeu d’instructions (terminé ou en cours)

Dans le bloc Rapports d’instructions, vous trouverez un message et un lien pour chaque ressource ciblée par l’instruction avec sa criticité (succès, avertissement ou erreur) :

Bibliothèque d’instructions

Créer un code

Avec l’instruction “Créer un code”, l’utilisateur peut créer un code sur le modèle sélectionné (arrêts, lignes ou courses) à partir de la valeur d’un autre attribut (sur un autre code dans le même modèle ou un autre attribut dans le modèle).

À l'édition du jeu d’instructions, l’utilisateur peut définir :

  • Le modèle cible : arrêts, lignes ou courses.

  • L'attribut ou le code qui est utilisé comme source, c'est-à-dire à partir duquel le nouveau code sera créé.

  • Le modèle de source lorsque la valeur du code ou de l’attribut source est utilisé en partie.

  • L’espace de code cible où sera créé le nouveau code

  • Le modèle de cible lorsque le code ou l’attribut source doit être modifié pour créer le nouveau code

Associer les tracés selon les arrêts

L'utilisateur peut ajouter l’instruction “Associer les tracés selon les arrêts” à un Jeu d’Instructions.

Avant d’exécuter cette instruction, vous devez vous assurer que vous avez des tracés importés dans Chouette.

À l’exécution de l’instruction, un tracé sera associé à une mission les conditions suivantes sont remplies :

  • La mission n’a pas encore de tracé associé

  • Tous les arrêts composants la mission se trouvent géographiquement proches des coordonnées du tracé

  • La longueur du tracé est la plus courte possible en fonction des arrêts. Si deux tracés sont similaires, Chouette prendra donc le tracé le plus court en relation avec les arrêts.

Associer les tracés selon leur code

L'utilisateur peut ajouter l’instruction “Associer les tracés selon leur code” à un Jeu d’Instructions.

Avant d’exécuter cette instruction, vous devez vous assurer que vous avez des tracés importés dans Chouette.

À l’exécution de l’instruction, un tracé sera associé à une mission si les conditions suivantes sont remplies :

  • La mission n’a pas encore de tracé associé

  • Le code de tracé doit correspondre au nom de la mission

Définir l’orientation des arrêts selon les tracés

L’utilisateur peut ajouter l’instruction Définir l’orientation des arrêts selon les tracés.

Lorsqu’un arrêt n’a pas d’orientation définie, elle peut être mise à jour en fonction de l’orientation des tracés dans une mission qui dessert cet arrêt.

 

Lorsque l’arrêt est desservi par plusieurs missions, et ainsi plusieurs tracés associés, Chouette utilise l'orientation moyenne des tracés.

Si un arrêt a déjà une orientation, celle-ci ne sera pas modifiée par l’instruction.

À l’exécution de l’instruction, vous devez choisir comme cible un jeu de données en état d'édition. Seuls les arrêts de ce jeu de données seront pris en compte par le jeu d’instructions.

Créer les arrêts référents

L’utilisateur peut utiliser l’instruction “Créer les arrêts référents” pour créer automatiquement des arrêts référents lorsqu’il y a deux arrêts ou plus avec des coordonnées et une orientation très proches. La tolérance est de 15 m pour la position et de 15 degrés (+/- 7.5o) sur l'orientation.

L’arrêt référent sera utilisé en lieu et place des arrêts auquel il est associé.

Si un arrêt référent existe déjà avec les mêmes critères, il ne sera pas créer à nouveau par l’instruction.

L’algorithme de création des arrêts référents dans Chouette se base sur plusieurs critères. Un arrêt sera créé en référent d’autres arrêts avec :

  • La position moyenne de tous les arrêts regroupés

  • L'orientation moyenne de tous les arrêts regroupés

  • Le nom le plus long de tous les arrêts regroupés

  • Le même type d'arrêt

Une fois que le jeu d’instruction est créé, vous pouvez l’exécuter.

Si la cible n’est pas choisie, le jeu d’instruction va prendre en compte tous les arrêts de votre référentiel.

Pour en savoir plus sur les cas d’usages des arrêts référents, consultez la page Utilisation des référents.

Associer les arrêts à un référent

L’utilisateur peut utiliser l’instruction “Associer les arrêts à un référent” pour associer ses arrêts aux référents créés qui ont des coordonnées et des orientations proches.

 

À l’exécution de cette instruction, il n’y a pas besoin de choisir une cible.

 

.

Définir l’adresse postale

L’utilisateur peut utiliser l’instruction “Définir l’adresse postale” pour définir la commune et le code postal d’un modèle

L’instruction peut être exécutée sur les arrêts, les points d’accès ou les points d’intérêt :

 

Ces deux attributs seront calculés selon les coordonnées géographiques et sont consultables dans le référentiel d’arrêt :

Définir l'attribut d’un Référent à partir des Particuliers

L’utilisateur peut sélectionner l’instruction “Définir un attribut d’un Référent à partir des Particuliers” pour définir un attribut d’un Référent selon les attributs fournis par ses arrêts particuliers. L’instruction peut être exécutée sur les arrêts ou les transporteurs.

Pour en savoir plus sur les Référents, consultez les pages https://enroute.atlassian.net/wiki/spaces/PUBLIC/pages/1938128907 et https://enroute.atlassian.net/wiki/spaces/PUBLIC/pages/1937965057.

 

Par exemple, l’utilisateur peut définir le code postal des arrêts Référent avec les codes postaux fournit par les arrêts particuliers du Référent.

Condition pour définir la valeur :

  • Si tous les Particuliers d'un Référent donné fournissent la même valeur (en ignorant les particuliers sans valeur), cette valeur commune est utilisée pour définir l'attribut du Référent.

  • Si l'attribut est déjà défini dans le modèle du Référent, la valeur actuelle est laissée inchangée par l’instruction.

  • Si le jeu d’instruction ne trouve pas de valeur commune aux Particuliers, l’attribut du Référent reste inchangé.

Exemples :

  • Référent Fuseau Horaire : inconnu
    Particulier 1 Fuseau Horaire : Europe/Paris
    Particulier 2 Fuseau Horaire : Europe/Paris
    ⇒Le fuseau horaire du référent est défini sur Europe/Paris.

 

  • Référent Fuseau Horaire : inconnu
    Particulier 1 Fuseau Horaire : Europe/Paris
    Particulier 2 Fuseau Horaire : inconnu
    ⇒ Le fuseau horaire du référent est défini sur Europe/Paris.

 

  • Référent Fuseau Horaire : inconnu
    Particulier 1 Fuseau Horaire : Europe/Paris
    Particulier 2 Fuseau Horaire : Europe/Madrid
    ⇒ Le fuseau horaire du Référent est inchangé

 

Définir la durée des missions à partir des heures de passage

L'utilisateur peut utiliser l’instruction "Définir la durée des missions à partir des heures de passages” pour mettre à jour les missions en fonction de la durée moyenne entre les heures d'arrivée et de départ des courses.

À l’exécution de cette instruction, un jeu de données doit être choisi pour cible. Le calcul se fera uniquement sur les missions du jeu de données cible.

Définir les distances des missions à partir du tracé

L’utilisateur peut utiliser l’instruction “Définir les distances des missions à partir du tracé” pour mettre à jour les missions en fonction de la distance fournie par le tracé associé.

A l’exécution de ce jeu d’instructions, un jeu de données doit être défini pour cible.

Lorsque le jeu d’instructions a été exécuté, toutes les missions doivent afficher des distances :

Supprimer toutes les courses

L’utilisateur peut utiliser l’instruction “Supprimer toutes les courses” pour nettoyer toutes les courses d’un jeu de données.

À l’exécution de ce jeu d’instruction, un jeu de données doit être indiqué pour cible. Toutes les courses de cette cible seront ainsi automatiquement supprimées.

Mettre à jour un attribut à partir du Référent

L’utilisateur peut utiliser l’instruction “Mettre à jour un attribut à partir du Référent” pour mettre à jour les attributs d’un arrêt particulier ou d’un transporteur particulier.

À l’exécution de ce jeu d’instruction, Chouette va mettre à jour le modèle choisi (arrêt, transporteur) en remplissant l’attribut sélectionné avec les valeurs du Référent.

Si le référent ne possède aucune valeur, les particuliers ne sont pas mis à jour. Pour la réécriture des valeurs existantes des attributs d’un particulier, il faut cocher l’option “Remplacer le valeur existante”.

Calculer le nombre de services

L’utilisateur peut utiliser l’instruction “Calculer le nombre de services” pour mettre à jour les statistiques de services de son offre, c’est à dire calculer le nombre de courses par mission circulant chaque jour.

Le calcul des statistiques de service est automatiquement réalisé à la fin de la construction d’une offre finalisée ou agrégée

Après l’exécution de ce jeu d’instruction, un nouveau tableau apparaîtra dans la page de votre jeu de données avec le marquages des périodes couvertes et des trous d’offre.