Log in

Login to your account

Username *
Password *
Remember Me

Create an account

Fields marked with an asterisk (*) are required.
Name *
Username *
Password *
Verify password *
Email *
Verify email *
Captcha *

L'objectif de cet article est de présenter la démarche pour créer son premier scénario.

Avant de développer le processus technique de création, il est essentiel d'avoir défini le périmètre et l'objectif du scénario :

  • quel événement doit-on observer?
  • quelle(s) action(s) doit-on déclencher?
  • des restrictions de déclenchement de ces actions sont-elles nécessaires?
  • si plusieurs actions sont identifiées, l'ordre est-il important?
  • qui sont les destinataires des actions?

Nous conseillons lors d'une prise en mains de permettre à toutes les séquences d'enregistrer des logs. Ces informations pourront vous permettre de comprendre l'enchainement des événements et des actions.
 

 

Tableau de bord et interface

Obsewhere se présente sous la forme d'un tableau de bord et d'un espace de navigation sur la gauche.

Le tableau de bord est composé de widgets affichant les principaux indicateurs tels que nombre de logs du mois, nombre d'emails envoyés, nombre d'enregistrement en cours dans la file d'attente...

L'espace de navigation sera composé de 3 onglets :

  • "Admin" : menu principal d'administration d'Obsewhere
  • "Alertes" en développement : affiche plusieurs types d'alertes liées à votre environnement : alertes de sécurité (anomalies de connexion, tentative de flooding, fichier système modifié), alertes d'installation (plugin manquant ou dépublié en relation avec un scénario existant).
  • "Mises à jour" en développement : information de nouvelles versions de plugins.

Le principe du scénario

Pour rappel, le scénario est constitué d'1 séquence de type "Observation" et de 1 ou plusieurs séquences de type "Action".

Vous pouvez créer autant de scénarios que vous souhaitez. Dès lors que vous avez acquis la mécanique de création, qui est toujours la même, le processus vous paraîtra simple.

Les scénarios peuvent avoir des objectifs très différents : surveiller les accès au site, administrer des paramètres utilisateurs, alerter l'équipe de rédacteurs d'une mise à jour d'un contenu, afficher une pop-up sur votre boutique en ligne, créer une aide en ligne pour votre administration etc...

 

Etape 1- création d'une nouvelle séquence Observateur

Il est possible de créer la séquence observateur lors de la création du scénario, mais nous allons procéder ici étape par étape et créer individuellement chaque séquence "Observateur" et "Action".

Pour accéder à la création et la gestion des séquences "Observateur" il vous suffit de cliquer sur le lien dans le menu de votre environnement : lien menu principal sequences observateur("26" indique le nombre de séquences "Observateur" déjà créées).

Sur la liste des séquences "Observateur", cliquer sur le bouton bouton nouvel observateur

Sur l'image ci-dessous, indiquer un titre explicite (1), cette séquence peut être à usage unique ou réutilisée dans le cadre d'autres scénarios. Vous pouvez créer autant de séquences "Observateur" que vous le souhaitez.

creation sequence observateur
Puis, cliquer sur le bouton bouton selection type plugin observeur, cela déclenche l'ouverture d'une pop up qui propose tous les plugins possibles sur votre installation (les plugins gratuits et ceux que vous avez acheté). L'image ci-dessous, présente les plugins ou mini-programmes sont classés par thématique :

plugins sequences observateurs

Nous allons choisir la thématique "Contenu" puis trouver le type de séquence "Article" et cliquer sur son bouton bouton choisir sequence

A noter que le bouton bouton tutoriel sequence vous donne accès à la page de tutoriel spécifique de ce plugin, avec le détail des explications de ses paramètres.

Chaque plugin correspond à un objectif précis d'observation et est donc associé à ses propres paramètres.

Voici les explications des paramètres du plugin "Article" :

 

<capture à venir ...>

 

Liste des séquences Observateur

Liste des séquences Observateur

Vous pouvez créer autant de séquences Observateur que vous le souhaitez.
Une séquence peut être unique pour un scénario ou être réutilisée dans plusieurs scénarios.

Nom des séquences

Nous conseillons de rendre les noms des séquences les plus explicites possibles. Vous pouvez trier cette colonne.

Type de séquence

Possibilité de sélection par type de séquence ("navigation URL", "Accès utilisateur" ...).
Les restrictions concernent les utilisateurs habilités à déclencher l'événement d'observation.

Utilisé dans...

Le nombre de scénarios est cliquable, et permet d'afficher une pop up avec la liste des scénarios qui utilisent la séquence observation.

Notes

Il est possible d'ajouter une note, qui peut être un critère de recherche/regroupement des séquences.
  • Liste des séquences Observateur

    Vous pouvez créer autant de séquences Observateur que vous le souhaitez.
    Une séquence peut être unique pour un scénario ou être réutilisée dans plusieurs scénarios.
  • Nom des séquences

    Nous conseillons de rendre les noms des séquences les plus explicites possibles. Vous pouvez trier cette colonne.
  • Type de séquence

    Possibilité de sélection par type de séquence ("navigation URL", "Accès utilisateur" ...).
    Les restrictions concernent les utilisateurs habilités à déclencher l'événement d'observation.
  • Utilisé dans...

    Le nombre de scénarios est cliquable, et permet d'afficher une pop up avec la liste des scénarios qui utilisent la séquence observation.
  • Notes

    Il est possible d'ajouter une note, qui peut être un critère de recherche/regroupement des séquences.

 

Etape 2- création d'une nouvelle séquence Action

Dès lors qu'une personne va créer un nouvel article, notre objectif est d'afficher une aide en ligne, par exemple liée pour signaler la démarche à suivre suite à une création d'article.
La séquence "Action" va être un message de type "Pop-in Joomla" :

creation sequence action popin

 

 <capture du form de l'action rempli ...à venir>

 

Liste des séquences Actions

Liste des séquences Action

Vous pouvez créer autant de séquences Action que vous le souhaitez.
Une séquence peut être unique pour un scénario ou être réutilisée dans plusieurs scénarios.

Nom des séquences

Nous conseillons de rendre les noms des séquences les plus explicites possibles. Vous pouvez trier cette colonne.

Type de séquence

Possibilité de sélection par type de séquence ("Pop in", "Courriel", "EngageBox" ...).
Les restrictions concernent les utilisateurs habilités à déclencher l'événement d'observation.

Utilisé dans...

Le nombre de scénarios est cliquable, et permet d'afficher une pop up avec la liste des scénarios qui utilisent la séquence action.
  • Liste des séquences Action

    Vous pouvez créer autant de séquences Action que vous le souhaitez.
    Une séquence peut être unique pour un scénario ou être réutilisée dans plusieurs scénarios.
  • Nom des séquences

    Nous conseillons de rendre les noms des séquences les plus explicites possibles. Vous pouvez trier cette colonne.
  • Type de séquence

    Possibilité de sélection par type de séquence ("Pop in", "Courriel", "EngageBox" ...).
    Les restrictions concernent les utilisateurs habilités à déclencher l'événement d'observation.
  • Utilisé dans...

    Le nombre de scénarios est cliquable, et permet d'afficher une pop up avec la liste des scénarios qui utilisent la séquence action.

 

Etape 3 - création du scénario

Rappelons qu'un scénario est associé à 1 séquence "Observation" et X séquences "Action" (1 ou plusieurs).

Lors de la création d'un scénario, vous pouvez :

  • créer directement les séquences "Observation" et "Action" - creation scenario creation sequence
  • rechercher les séquences "Observation" et "Action" préalablement créées (image ci-dessous)

 

<capture du formulaire du scénario ... à venir>

 

Etape 4 - test du scénario

Dans notre exemple, lorsqu'un utilisateur va intervenir pour administrer le menu principal (et activer l'url "option=com_menus&view=items&menutype=mainmenu"), le message ci-dessous sera affiché:

<capture de la creation d'un article avec Pop-in du scénario ... à venir>

 

Liste des scénarios

L'image ci-dessous représente une partie de la diversité des applications d'Obsewhere. Les étiquettes de type liste scenarios etiquette sequence observation renseignent sur les séquences "Observateur" utilisées dans chaque scénario.

Liste scénarios Obsewhere

Liste des scénarios

Vous pouvez créer autant de scénarios que vous le souhaitez.
Utilisez des libellés très explicites pour vos scénarios.

Séquences

Etiquette verte : nom de la séquence "Observation"
Etiquette orange : nombre de séquences "Action"
Ces étiquettes sont cliquables : affichage en pop up d'une synthèse du scénario et de ses séquences.

Statut

Les statuts sont les suivants :
  • Publié
  • Publié avec délai de pause (entre chaque exécution du scénario)
  • En attente de publication
  • Non publié

Traitements

Si un traitement est en cours d'exécution et non terminé, il sera signalé par une valeur.

Note

N'hésitez pas à placer une note pour compléter l'explication de l'objectif du scénario.
  • Liste des scénarios

    Vous pouvez créer autant de scénarios que vous le souhaitez.
    Utilisez des libellés très explicites pour vos scénarios.
  • Séquences

    Etiquette verte : nom de la séquence "Observation"
    Etiquette orange : nombre de séquences "Action"
    Ces étiquettes sont cliquables : affichage en pop up d'une synthèse du scénario et de ses séquences.
  • Statut

    Les statuts sont les suivants :
    • Publié
    • Publié avec délai de pause (entre chaque exécution du scénario)
    • En attente de publication
    • Non publié
  • Traitements

    Si un traitement est en cours d'exécution et non terminé, il sera signalé par une valeur.
  • Note

    N'hésitez pas à placer une note pour compléter l'explication de l'objectif du scénario.

Un click sur les étiquettes des séquences ouvre une fenêtre pop up de synthèse visuelle du scénario :

<capture de la preview du present scénario ... à venir en rempalcement>

liste scenario pop up sequences

 

 

<lien vers la vidéo de ce tuto ... à venir>

 

En savoir plus - paramètres avancés

Nous vous invitons à consulter notre documentation sur les sujet suivants :

 

Obsewhere est un composant résolument novateur dans le monde Joomla, tant par son mode de fonctionnement et sa terminologie, que par la diversité et l'étendue de ses applications.

Cet article décrit la démarche générale de fonctionnement d'Obsewhere, pour des précisions sur certains paramétrages, merci de vous reporter à nos pages de tutoriels.

L'utilisation d'Obsewhere n'est pas complexe mais nécessite :

  • l'acquisition de modes opératoires non techniques mais très précis,
  • une définition claire des objectifs à réaliser : que doit-on observer et sous quelles restrictions? quelles actions doivent être déclenchées, dans quel ordre et dans quels contextes?
  • une rigueur de paramétrage.

 

Principe général d'Obsewhere

Le fonctionnement d'Obsewhere repose sur l'observation d'un événement qui déclenche 1 ou plusieurs actions.
L'ensemble de cette démarche se nomme "scénario".

Diapositive 1
Scénario
0
Evénement
observé
Action 1
Action 2

1 observation puis 1 ou X actions

La première séquence du scénario repose sur un plugin de type "Observateur"; cette séquence est unique au sein d'un scénario.

La ou les séquences suivantes sont des actions, elles reposent sur des plugins de type "Action".
Lorsque plusieurs actions sont envisagées, leur exécution s'effectue en série, c'est-à-dire que l'action 2 est déclenchée lorsque l'action 1 est terminée. Pour certains scénarios l'ordre des séquences d'action peut avoir son importance.

Le composant Obsewhere et les plugins

L'installation du composant Obsewhere s'accompagne du chargement de plusieurs plugins/types de séquence gratuits. Ceux-ci vous permettent de prendre en main Obsewhere, d'imaginer des objectifs simples et de réaliser vos premiers scénarios.

Les plugins/types de séquences qui ne sont pas installés avec le composant sont payants.

Ne pas confondre "plugin / type de séquence" et "séquence"

Un plugin ou type de séquence correspond à un programme pré-établi et décliné par thématique (Utilisateurs, Contenus, Extensions...).
Chaque plugin comporte un certain nombre de paramètres qui lui sont propres.

L'image ci-dessous représente les types de séquences "Observateur".
Par exemple la thématique "Utilisateurs" contient 5 plugins, traitant cahcun d'événements différents :

  • "Accès utilisateurs" : surveillance des événements de connexion (erreurs de connexion, tentatives de connexion sur compte bloqué..)
  • "Utilisateurs" : surveillance des événements de création, modification et suppression des comptes utilisateurs.
  • "Champ personnalisé" : surveillance de la modification d'un champ personnalisé de type "utilisateur",
  • "Pré-connexion utilisateur" : surveillance de la date de dernière connexion avant connexion.
  • "Champs utilisateurs" : surveillance de la modification des paramètres de type compte bloqué, modification d'email, de mot de passe...

Le nombre de plugins est appelé à augmenter au fil de nos développements.

plugins sequences observateurs

Une séquence correspond à l'application des paramètres d'un plugin; elle est destinée à un objectif précis.
Dans la pratique, à partir d'un type de séquence vous pourrez créer plusieurs séquences différentes; chacune répondant à un objectif différent.
Puisque ces séquences répondent à des objectifs différents, elles pourront donc être utilisées au sein de plusieurs scénarios.

Le scénario est donc une succession de séquences : 1 séquence obervation et X séquences actions.


Création d'une séquence d'observation

L'image ci-dessous permet de comprendre la démarche de création d'une séquence d'observation :

1- sélection du plugin/type de séquence d'observation, ici "Navigation url"
2- la définition du paramètre de l'url à observer. C'est la visite de cette dernière qui va constituer l'événement déclencheur de l'action. Dans notre exemple, l'url observée correspond au "checkout" ou tunnel de conversion d'une boutique en ligne. Par exemple : https://www.monsite.fr/terminer-la-commande/checkout/task-step/step-1
Le paramètre "checkout" renseigné ci-dessous dans le champ "Url à surveiller", va permettre de constituer comme événement déclencheur, toutes les urls qui contiennent l'expression "checkout".

L'action résultant de cet événement pourrait être l'affichage d'une pop up avec une offre, un conseil, etc..., que l'on jugerait pertinent de rappeler à cette étape du processus d'achat.

fonctionnement navigation url

L'important ici est de comprendre, au travers cet exemple, l'étendue infinie des possibilités d'observation et donc des applications d'Obsewhere.


Autre exemple de paramètres de plugins "Observateur"

L'important ici est de bien comprendre que chaque plugin/type de séquence "Observateur" propose des paramètres différents.
Ces paramètres sont destinés à définir précisément quel événement va déclencher la ou les action(s).

Nous avons vu précédemment quels paramètres d'urls pouvaient être renseignés pour une séquence de type "Navigation url".
L'exemple ci-dessous concerne une séquence d'observation basée sur un type de séquence "Contenus", et thématique "Articles".
L'objectif est ici d'informer automatiquement un groupe d'utilisateurs dès qu'un nouvel article est enregistré.

exemple observateur article publié

On constate sur cette image :

  • que les paramètres sont spécifiques aux événements d'administration des articles,
  • que seul un paramètre est activé, dans le but d'atteindre l'objectif du suivi défini de façon précise (événement = enregistrement d'un nouvel article).

 

Les plugins/types de séquence "Action"

Suite à l'observation d'un événement grâce à la première séquence de type "Observateur", vous allez pouvoir définir 1 ou plusieurs actions qui en découlent, afin de réaliser votre objectif.

L'objet des séquences de type "Action" est donc de définir :

  • quelle(s) action(s) sera ou seront déclenchée(s),
  • avec quels paramètres il est pertinent d'enrichir l'information liée à l'action (le contenu d'un email par exemple),
  • le ou les destinataire(s) de l'action.

Les actions possibles sont les suivantes (liste non exhaustive, des développements sont en cours) :

  • envoi d'email,
  • affichage de pop in (ou message système) sur le site ou dans l'administration,
  • envoi d'un message dans la messagerie Joomla,
  • affichage d'une pop up (Engage Box),
  • redirection vers une url,
  • comparaison et calcul entre 2 valeurs (par exemple comparer le montant en cours du panier avec un montant de "seuil", comparer 2 dates...),
  • récupérer un champ et une valeur dans une table SQL,
  • modifier certains paramètres de contenu (par exemple publier/dépublier un module),
  • devt en cours : graphique / reporting,
  • devt en cours : application externe - Trello,
  • devt en cours : application externe - Zapier, etc ...

De la même façon que pour les types de séquences "Observateur", les actions sont regroupées par thématiques. La thématique "Messages" propose 3 modes de messages différents. A noter que la pop up (ou Engage Box) est proposée dans l'onglet "Extensions".

types plugins action messages

Exemple de paramètres d'un plugin/type de séquence "Action"

Prenons l'exemple de l'action d'envoi d'email :

1- Indiquer un libellé très précis correspondant au contexte et l'objectif de l'envoi du mail.
2- Créer le contenu du mail : insertion possible de HTML et de chaînes de substitution.
3- Paramétrer le ou les destinataires, par exemple les membres d'un groupe d'abonnés.

fonctionnement exemple parametre action email

Le principe du scénario

L'image ci-dessous de création d'un nouveau scénario permet de se représenter l'enchainement des 2 séquences "Observateur" et "Action" évoquées précédemment.

 

Il est possible de créer directement depuis le scénario une séquence "Observateur" ou "Action", ou de sélectionner celles que vous avez préalablement paramétré.
Là-aussi le titre doit être explicite et présenter de façon détaillée l'objectif / le contexte du scénario. En effet, les scénarios peuvent rapidement se multiplier selon vos besoins.

Les scénarios peuvent être importés et exportés entre 2 sites, en prêtant attention à la cohérence des paramètres d'un site à l'autre.

Notre article "Première prise en mains" détaille les étapes de création d'un scénario.

 

Logs des événements et des actions

Chaque séquence permet de définir si l'événement ou l'action doit être logguée. Outre le suivi nécessaire dans de nombreux cas, ceci est très pratique lors de la mise en place afin de bien identifier si un événement est survenu et quelles actions il a déclenché.