Créer et configurer des règles

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Le module Règles Drupal vous permet de définir une règle qui spécifie l'action qui se produit automatiquement en réponse à un événement sur le portail. Par exemple, vous pouvez créer une règle pour ajouter automatiquement une application par défaut (action) à tous les nouveaux comptes de développeur (événement). Vous pouvez également créer une règle pour rediriger un utilisateur vers une page spécifique (action) lors de la connexion (événement). La section Ajouter et gérer des comptes utilisateur vous montre comment définir ces deux règles.

Le module Règles est très flexible et vous permet de créer de nombreux types de règles différents. Voici un sous-ensemble d'événements:

  • Ajouter, mettre à jour ou supprimer une application de développeur
  • Modifier l'état d'une application de développeur
  • Ajouter, mettre à jour ou supprimer un compte de développeur
  • Ajouter, mettre à jour ou supprimer un nœud de portail
  • Drupal est initialisé
  • Une entrée de journal Drupal est créée

Voici un sous-ensemble des types d'actions que vous pouvez effectuer:

  • Envoyer un e-mail à une personne ou à un groupe
  • Bloquer un utilisateur
  • Promotion de contenus
  • Afficher un message sur le site
  • Effectuer une redirection de page
  • Bloquer une adresse IP

Vous pouvez également ajouter des conditions aux règles, par exemple pour tester le rôle d'un développeur, lors du traitement de la règle.

Pour obtenir la liste des fonctionnalités, consultez la documentation du module Règles Drupal.

Activer des règles

Avant de pouvoir créer une règle, assurez-vous que tous les modules Drupal nécessaires sont activés.

Pour activer les modules Drupal nécessaires:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
  2. Sélectionnez Modules dans le menu d'administration de Drupal.
  3. Activez les modules suivants s'ils ne sont pas déjà activés :
    • Règles
    • UI des règles
  4. Enregistrez la configuration.
    Il est possible que d'autres modules obligatoires soient activés automatiquement.

Créer une règle

Dans cet exemple, vous créez une règle pour avertir les administrateurs lorsqu'un développeur crée une application sur le portail.

Pour créer une règle:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
  2. Sélectionnez Configuration > Workflow > Rules (Configuration > Workflow > Règles) dans le menu d'administration de Drupal.
  3. Sélectionnez + Ajouter une règle sur la page "Règles".
  4. Indiquez le nom de la règle. Par exemple, E-mail sur la création d'applications.
  5. Vous pouvez également spécifier une balise en tant que app_creation.
  6. Dans la boîte déroulante Réagir à l'événement, sélectionnez Devconnect > Lors de la création d'une application de développement.
  7. Sélectionnez Enregistrer.
    La page Modifier la règle de réaction s'affiche. Comme vous avez déjà défini l'événement à l'étape précédente, il devrait indiquer Lors de la création d'une application de développement sous Événements. Laissez le champ Conditions vide pour cette règle.
  8. Sous Actions, sélectionnez + Ajouter une action.
  9. Sélectionnez Système > Envoyer un e-mail dans le menu déroulant.
    La mise en page de la page Add a new action (Ajouter une nouvelle action) change pour vous permettre de spécifier des informations sur l'e-mail.
  10. Modifiez toutes les informations, y compris les destinataires, le corps du message, l'expéditeur et d'autres informations.
  11. Cliquez sur Enregistrer pour revenir à la page Modifier la règle de réaction.
  12. Cliquez sur Enregistrer les modifications.

    Désormais, lorsqu'un développeur crée une application, un e-mail est automatiquement envoyé à la liste des destinataires spécifiés par la règle.

Modification ou suppression d'une règle

Une fois la règle créée, vous pouvez la modifier ou la supprimer ultérieurement.

Pour modifier ou mettre à jour une règle:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
  2. Sélectionnez Configuration > Workflow > Rules (Configuration > Workflow > Règles) dans le menu d'administration de Drupal.
  3. Sélectionnez la règle à modifier ou à supprimer.