Les principales parties d'une règle de gestion sont les options principales, la section Déclencheur et la section Action. Ces parties peuvent être décrites comme suit:
Options principales : cette section contient le code, le nom et la description de la règle de gestion. Il contient également des indicateurs permettant d'activer la règle de gestion et indique si les exécutions ignorées doivent être journalisées. Enfin, il contient des informations sur le statut actuel de la règle d'affaires et le(s) contact(s) technique(s) qui doit(doivent) être informé(s) si la règle d'affaires est dans un état de santé critique.
Déclencheur : c'est dans cette section que vous définissez l'événement qui active la règle de gestion. Il inclut le type d'objet de données, les variables, les conditions et d'autres paramètres pour la règle de gestion. Lorsque les conditions sont remplies, l'application répond en exécutant l'action indiquée dans la section Action.
Action : c'est dans cette section que vous définissez la réponse de l'application à l'événement spécifié dans la section Déclencheur. Par exemple, si vous avez indiqué dans la section Déclencheur un événement survenant lors de la création d'objet pour un appel de service, dans la section Action, vous pouvez alors sélectionner Action et Envoyer SMS et envoyer la notification à un destinataire spécifique.
Les principales options des règles de gestion sont décrites ci-dessous.
- Code : facultatif. Il peut être utilisé comme identifiant de la règle de gestion. La meilleure pratique consiste à faire court.
- Nom : nom de la règle de gestion.
- Description : description de la règle de gestion. Les balises simples peuvent être codées manuellement, par exemple pour les sauts de ligne, les caractères gras ou les puces.
- Activé : une option oui ou non. Si oui, la règle de gestion sera active.
- Contact technique : inclut les adresses e-mail des contacts pour les questions techniques sur la définition/l'exécution de la règle de gestion. Il est recommandé d'ajouter plusieurs contacts techniques. La ou les personnes répertoriées seront également le point de contact du Support SAP si la règle de gestion entraîne une utilisation excessive des ressources ou d'autres problèmes de serveur.
- Pourcentage de seuil d'erreur : cette zone permet à un utilisateur d'ajuster le seuil, en pourcentage, auquel les contacts techniques d'une règle de gestion sont informés des règles de gestion avec des exécutions ayant échoué. Si la zone n'est pas renseignée, une valeur par défaut de 50 % est appliquée.
- Journaliser les exécutions ignorées : une option oui ou non. Si oui, les exécutions ignorées seront affichées dans le journal d'exécution, auquel il est possible d'accéder dans la vue de gestion. Le nombre de journaux d'exécution ignorés est limité aux 100 dernières entrées de journal ignorées par règle de gestion. Les anciens sont supprimés automatiquement via l'option de société SAP.FSM.BusinessRules.MaxSkippedLogsToKeep. Dans cette option, vous pouvez définir une autre limite, mais avec un maximum absolu de 1000.
- Type : il existe actuellement deux types de règles de gestion prises en charge :
- Type Deux : Ce type de règle d'affaires offre une prise en charge Javascript complète.
- Type trois : ce type de règle de gestion est basé sur la nouvelle architecture de microservices et prend en charge plusieurs types d'actions, d'événements et d'événements différents par rapport aux règles de gestion de type Deux. Dans la mesure du possible, il est conseillé d'utiliser le type Trois. Pour plus de détails, reportez-vous à la documentation la plus récente.
Les options de déclenchement incluent :
- Événements : événement qui déclenche la règle de gestion. Les options pour les objets sont les suivantes :
- Événements basés sur CRUD pour un objet de données donné (créer, mettre à jour, supprimer ou une combinaison de ces événements). Déclencheurs de ce type :
- Lors de la création d'objet : si cette option est sélectionnée, la règle de gestion est déclenchée lors de la création d'un nouvel objet.
- Lors de la création ou de la mise à jour de l'objet : si cette option est sélectionnée, la règle métier est déclenchée lors de la création d'un nouvel objet ou de la mise à jour/modification d'un objet existant.
- Lors de la mise à jour de l'objet : si cette option est sélectionnée, la règle métier sera déclenchée lors de la mise à jour/modification d'un objet existant.
- Lors de la mise à jour ou de la suppression de l’objet : si cette option est sélectionnée, la règle métier est déclenchée lorsqu’un objet existant est mis à jour ou supprimé.
- Dans Objet Supprimer : si cette option est sélectionnée, la règle métier est déclenchée lorsqu’un objet existant est supprimé.
- Lors du téléchargement d'objet à partir du connecteur ERP : si cette option est sélectionnée, la règle de gestion est déclenchée lorsque les données d'objet (par exemple, le partenaire) sont téléchargées à l'aide du connecteur ECC Proaxia.
- Planifiée : si cette option est sélectionnée, la règle métier sera définie pour s'exécuter aux heures et intervalles spécifiés.
- Événements FSM : les événements Field Service Management sont des événements de gestion qui sont publiés par les services de SAP Field Service Management en cas d'occurrence liée.
- Type d'objet : objet de transfert de données (DTO) associé à l'événement. Pour en savoir plus sur ces DTO, reportez-vous au modèle de données.
- Ordre : ordre dans lequel les règles de gestion sont exécutées lorsqu'elles sont déclenchées par le même événement.
- Exécution :
- Asynchrone (se produit après la synchronisation avec l'application client).
- Synchrone (se produit lors de la synchronisation avec l'application client). Les règles de gestion synchrones sont utilisées en combinaison avec une action de validation et peuvent entraîner des retards dans la synchronisation avec les applications client (par exemple, mobiles).
- Retard d'exécution (sec.) : vous pouvez définir une règle de gestion à exécuter avec un délai allant jusqu'à 600 secondes. Seules les règles de gestion avec le type d'exécution "asynchrone" peuvent être retardées, à l'exception des règles de gestion planifiées. Tenez compte des points suivants avant d'utiliser un délai :
- Une règle de gestion n'est exécutée qu'une fois que la durée d'un retard est atteinte.
- Comme le retard définit uniquement la durée minimale à atteindre, il se peut que l'exécution asynchrone d'une règle de gestion soit retardée davantage que ce qui a été défini.
- S'il existe des règles de gestion déclenchées par le même événement (c'est-à-dire la mise à jour d'une activité) et définies avec des retards différents, il n'est pas garanti que l'ordre d'exécution sera basé sur la durée des retards définis.
- Pour garantir que les règles de gestion sont exécutées dans un ordre spécifique, il est préférable d'utiliser la zone d'ordre.
- Si vous combinez à l'aide d'un retard et d'un ordre dans des règles de gestion déclenchées par le même événement, l'ordre sera pris en compte uniquement pour les règles définies avec le même retard. Cela garantit que ces règles sont déclenchées au même moment, puis que l'ordre correct des règles peut être pris en compte. Le système ne peut pas prendre en compte l'ordre des règles déclenchées à différents moments en raison de retards différents.
- En général, il est recommandé d'utiliser les retards avec précaution. Les exécutions en retard entraînent une charge supplémentaire sur le système, ce qui peut avoir un impact sur les performances du système.
- Clause WHERE CoreSQL : cette zone s'affiche lorsque le type d'événement est "planifié". Il est recommandé d'utiliser cette zone pour déterminer les objets pour lesquels la règle doit être exécutée. Pour chaque enregistrement d'objet trouvé, les variables et les conditions seront résolues et les actions exécutées en conséquence.
- Fréquence : ce champ s'affiche lorsque le type d'événement est "planifié". Vous pouvez saisir ici la fréquence à laquelle la règle de gestion doit être déclenchée lorsque les conditions sont remplies.
Règles métier planifiées
Heure de l'action déclenchée : le système vous permet de déclencher une règle de gestion planifiée jusqu'à 4 fois par heure (XX:00, XX:15, XX:30, XX:45).
Remarque
La règle est déclenchée à l'heure exacte, mais l'exécution peut être retardée de plusieurs minutes.
L'exécution des règles de gestion est optimisée pour préserver au mieux les ressources du serveur (CPU, Mémoire, etc.).
Fréquence et temps d'exécution : selon le sous-ensemble de données à traiter et les actions définies dans une règle de gestion, le temps d'exécution varie d'une règle à l'autre. Afin de protéger les ressources du système Cloud, l'exécution d'une règle de gestion peut être ignorée. Cela peut se produire lorsque la même règle est déclenchée pour l'exécution alors que l'exécution de règle précédente est toujours en cours d'exécution.
Pour éviter cela, la planification de règle de gestion doit être configurée de sorte que [TriggerTime]+[ExecutionTime] ne respecte pas la [TriggerTime] suivante.
Pour éviter que les actions définies ne soient pas exécutées en raison d'une règle de gestion ignorée, il est vivement recommandé de définir les conditions de déclenchement de sorte que les conditions de déclenchement ne puissent pas être influencées par un autre processus. En d'autres termes, les conditions de déclenchement doivent être remplies à tout moment tant que les actions souhaitées des règles de gestion ne sont pas exécutées.
Si une fréquence est définie pour une règle de gestion avec une condition, elle s'exécutera à la fréquence indiquée lorsque la règle est déclenchée.
Les variables sont utilisées pour lire les données nécessaires à la bonne exécution de la règle de gestion. Les données des variables peuvent être utilisées dans les variables, conditions et actions suivantes.
Une variable est constituée d'une requête dans CoreSQL (identique à l'API de requête), de fonctions Javascript ou d'une combinaison de ces fonctions. Les valeurs des variables sont résolues lors de la validation et de l'exécution de la règle. Une fois qu'une variable a été définie résolue, la variable et ses propriétés peuvent être référencées à l'aide de javascript. Par exemple ${activity.code} fait référence à la zone "code" d'une variable précédemment définie appelée "activité".
Certaines variables sont prédéfinies et se réfèrent aux éléments suivants :
- L'objet déclencheur pertinent
- Données d'objet « anciennes » ou « nouvelles »
- L'utilisateur actuel, la société et le compte
Les paramètres de l'entreprise et les paramètres utilisateur sont accessibles via les variables ${company.settings} et ${user.settings}. Par exemple, pour récupérer la langue définie par l'utilisateur dans l'application Web, utilisez ${user.settings.Cockpit_SelectedLanguage.data}.
Les variables personnalisées peuvent être définies comme suit :
- Objet : un enregistrement individuel d'un type donné
- Tableau : permet de sélectionner de nombreux objets individuels à l'aide d'une requête complexe
- Valeur : généralement constituée d'une valeur codée en dur/d'une chaîne de texte ou autrement définie par une fonction javascript qui est résolue lors de l'exécution.
Les variables d'objet et de tableau sont spécifiées par les éléments suivants :
- Type d'objet (DTO)
- Version d'objet
- Clause WHERE CoreSQL ou requête CoreSQL complète.
En mode de requête avancée, des requêtes CoreSQL complexes peuvent être définies. Pour accéder au mode avancé, appuyez sur l'icône clé à molette. Lorsque vous utilisez le mode avancé, tous les types d'objets et leurs versions doivent être explicitement définis, par exemple Activity.40;ServiceCall.26. Toutes les requêtes définies peuvent être contrôlées et exécutées dans l'interface API de requête à l'aide de l'icône en forme de triangle.
La requête CoreSQL ou la clause -WHERE peut contenir des extraits de code javascript, entre parenthèses : ${ ... }
Les variables de valeur peuvent contenir, par exemple, une chaîne de texte, un extrait de code Javascript ou similaire.
Les objets et zones personnalisés (également appelés objets et zones définis par l'utilisateur) sont pris en charge. Ils peuvent être référencés dans des variables (à l'aide de la clause WHERE), des conditions et des actions pour tous les objets disponibles.
Les conditions sont définies avec des opérateurs logiques et relationnels intégrés et peuvent comparer les éléments suivants :
- Variables et leurs propriétés
- Chaînes de texte
- Chiffres
- Valeurs booléennes
- Fonctions JavaScript
Les conditions sont évaluées après résolution des variables. Ensuite, si toutes les conditions sont remplies, les actions sont exécutées. Cependant, si l'une des conditions n'est pas remplie, l'exécution de la règle de gestion est ignorée.
Ignorer un grand nombre d'exécutions de règles de gestion coûte toujours des ressources système, car le BR a toujours réagi à l'événement/déclencheur, a résolu les variables et vérifié les conditions.
Une règle de gestion peut exécuter jusqu'à 100 actions qui sont exécutées dans l'ordre si les conditions de la règle de gestion sont remplies. Il existe de nombreux types d'actions différents, chacun avec ses propres paramètres d'entrée spécifiques. Les paramètres d'entrée sont renseignés avec les données des variables, des fonctions JavaScript, des valeurs codées en dur, etc.
Quelques exemples d'actions sont répertoriés ci-dessous.
- Webhook/Webhook FSM : ces actions renvoient une variable de réponse, qui peut être utilisée dans les actions suivantes.
- Exécuter une opération conditionnelle : se compose d'une condition qui détermine si l'action suivante est exécutée ou ignorée.
- Créer/Mettre à jour/Supprimer l'objet : les objets personnalisés sont pris en charge et référencés dans la zone du type d'objet.
- Créer un rapport de liste de contrôle : pour chaque instance de liste de contrôle fermée de l'activité sélectionnée, l'application génère un rapport et le joint à l'activité.
- Valider : utilisé dans les règles de gestion synchrones pour empêcher quelque chose de se produire avant de valider les données correspondantes dans la base de données. Par exemple, un client mobile/Web synchronisant des données nouvelles ou modifiées.
Les actions Webhook FSM sont limitées aux API qui nécessitent une authentification FSM. L'avantage de cette action est que vous n'avez plus besoin de définir une action Webhook explicite pour déterminer un jeton d'autorisation pour OAuth2. Il vous suffit de saisir l'ID client et la clé secrète client pour vous assurer que les identifiants appropriés sont utilisés.
Dans la section Variable, le code sera principalement constitué de CoreSQL, afin de collecter les données pertinentes. Tout au long de la règle de gestion, y compris à l'intérieur des requêtes CoreSQL, Javascript peut être utilisé : soit indépendamment, soit pour référencer et manipuler les données contenues dans les variables précédemment définies. Tout ce qui se trouve entre un signe dollar et des crochets est interprété comme JavaScript ${..}. Les fonctions JavaScript doivent être basées sur la norme ECMAScript 6.0.