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 :

Open

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/Jeux+d%27instructions#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”.

Open

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; il faut cliquer sur le premier champs, sélectionner un contexte dans la liste proposée.

Les contextes proposées sont :

• Mode de transport

• Recherche sauvegardée

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

Vous pouvez ajouter plusieurs instructions dans un même contexte. Les instructions placées sous un contexte spécifique seront filtrées en fonction de celui-ci. Par exemple, si vous définissez le contexte "mode de transport" comme "Bus", les macros ne traiteront que les modèles liés au "Bus" et ignoreront les autres.

É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, le code postal et la région postale d’un modèle.

Vous pouvez sélectionner un fournisseur. Si vos arrêts sont situés en France, il convient d’utiliser le fournisseur “Base Adresse Nationnale française”.

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

Ces 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.

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.

Associer les documents

L'utilisateur peut associer automatiquement ces documents aux arrêts et aux lignes. Pour ce faire, il doit d'abord avoir créé les documents dans son Espace de Travail

L’instruction Associer les documents permet de faire correspondre un arrêt ou une ligne à un document grâce à son code sur l’Espace de code choisit. 

À l’exécution de ce jeu d’instruction, si le document et l’arrêt/ligne ont le même code, alors ils seront automatiquement associés. 

Dans le rapport de jeu d’instruction, vous trouverez un message descriptif pour chaque objet traité.

Créer un code à partir d’un UUID 

L’utilisateur peut créer automatiquement un code dans un format spécifique à partir de l’UUID du modèle sélectionné. 

Dans le champ "Format", il faut inclure la valeur %{value} en plus du format que vous souhaitez appliquer à votre code.

Les modèles disponibles pour ce jeu d’instructions sont : 

• Arrêts

• Lignes

• Transporteurs

• Itinéraires

• Missions

• Calendrier 

• Course 

À l’exécution, les codes seront automatiquement ajoutés aux modèles ciblés. Dans le rapport de jeu d’instruction, vous trouverez un message descriptif pour chaque objet traité.

Créer un code en séquence 

L’utilisateur peut créer automatiquement un code sur un modèle à partir d’une séquence définie.

Il faut sélectionner une séquence existante dans le paramétrage du jeu d’instruction “Créer un code en séquence” : 

À l’exécution de cette instruction, Chouette va créer les codes pour la cible choisie à partir de la séquence sélectionnée. Dans le rapport de jeu d’instruction, vous trouverez un message descriptif pour chaque objet traité.

Définir le mode de transport des arrêts

Le jeu d’instruction “Définir le mode de transport des arrêts” permet d’attribuer automatiquement le mode de transport des arrêts à partir des lignes.

Ainsi si un arrêt est associé à une ligne dans un jeu de données, à l’exécution du jeu d’instruction, l’arrêt aura automatiquement le même mode de transport que la ligne auquel il est associé.

Forcer la valeur d’un attribut

Un utilisateur a la possibilité de sélectionner l'instruction "Forcer la valeur d’un attribut" pour attribuer automatiquement une valeur à un attribut spécifique.

Les attributs qui peuvent être modifiés incluent :

• Le référent pour les lignes, arrêts et transporteurs.

• Le nom de la commune pour un arrêt, un transporteur, un point d’entrée et un point d’intérêt.

Lors de l’exécution de cette instruction, la valeur de l'attribut sera automatiquement assignée.

Définir le nom des itinéraires

L'utilisateur peut définir automatiquement les noms des itinéraires dans un jeu de données en utilisant des syntaxes spécifiques. Ces syntaxes permettent de formater les noms d'itinéraires à appliquer à l'ensemble du jeu de données.

• %{direction} : ajoute la direction de l'itinéraire (aller/retour)

• %{departure.name} : ajoute le nom du premier arrêt

• %{arrival.name} : ajoute le nom du dernier arrêt

A l’exécution, les itinéraires du jeu de données cibles seront renommés :