Cycle de vie de la procédure

Chaque procédure s'exécute via un cycle de vie complet.

Le cycle de vie d'exécution d'une procédure comprend les étapes suivantes :

  1. Reconnaissance et initialisation
  2. Sélection (facultatif)
  3. Exécution
  4. Destruction

Reconnaissance et initialisation

Unica Plan doit être informé de toutes les procédures personnalisées et standard disponibles pour une instance d'installation particulière. Ce processes est appelé détection.

Remarque : Les procédures standard (procédures définies par l'équipe d'ingénierie Unica Plan) sont connues implicitement et ne nécessitent donc pas de reconnaissance.

Les procédures personnalisées sont définies dans le fichier de définition du plug-in de procédure. Le gestionnaire du plug-in Unica Plan lit ce fichier lors de l'initialisation. Pour chaque procédure détectée, le gestionnaire de plug-in effectue les tâches suivantes :

  1. Instanciation de la procédure ; passage de son état à INSTANCIEE.
  2. Création d'un enregistrement d'audit de procédure.
  3. Si la procédure a été instanciée, sa méthode initialize() est appelée avec tout paramètre d'initialisation trouvé dans son fichier de description de plug-in. Si cette méthode émet une exception, le statut est consigné et la procédure est abandonnée. Dans le cas contraire, la procédure passe à l'état INITIALISEE. Elle est alors prête à être exécutée.
  4. Création d'un enregistrement d'audit de procédure.
  5. Si la procédure a été initialisée, sa méthode getKey() est appelée pour identifier la clé utilisée par les clients pour référencer la procédure. Cette clé est associée à l'instance et sauvegardée pour une recherche ultérieure.

Sélection

De temps en temps, il peut arriver que Unica Plan présente une liste des procédures disponibles aux utilisateurs, par exemple, pour permettre aux administrateurs de définir un déclencheur. Unica Plan présente cette liste uniquement une fois que la procédure a été initialisée, via ses méthodes getDisplayName() et getDescription().

Exécution

Une fois la procédure initialisée, Unica Plan reçoit une demande d'exécution de la procédure. Cela peut se produire en même temps que pour d'autres procédures (ou pour la même) s'exécutant sur d'autres unités d'exécution.

Au moment de l'exécution, le gestionnaire d'exécution de procédure effectue les tâches suivantes :

  1. Démarrage d'une transaction de base de données.
  2. Définition de l'état de la procédure sur EN COURS D'EXECUTION.
  3. Création d'un enregistrement d'audit de procédure.
  4. Appel de la méthode execute() de la procédure avec un contexte d'exécution et tout paramètre d'exécution fourni par le client. La mise en oeuvre de la méthode utilise l'API Unica Plan si nécessaire, en acquérant les verrous d'édition et en transmettant le contexte d'exécution. Si la méthode d'exécution émet une exception, le gestionnaire d'exécution marque la transaction comme devant être annulée.
  5. Validation ou annulation de la transaction en fonction des résultats de l'exécution ; définition de l'état de la procédure sur EXECUTEE.
  6. Libération de tout verrou d'édition en suspens.
  7. Création d'un enregistrement d'audit de procédure.
Remarque : La méthode execute() ne doit pas modifier les données d'instance de la procédure.

Destruction

A l'arrêt d'Unica Plan , le gestionnaire du plug-in de procédure passe en revue toutes les procédures chargées. Pour chaque procédure détectée, il effectue les tâches suivantes :

  1. Appel de la méthode destroy() de la procédure afin de permettre à cette dernière d'effectuer un nettoyage avant la destruction de l'instance.
  2. Passage de l'état de la procédure à FINALISEE (elle ne peut pas être exécutée).
  3. Création d'un enregistrement d'audit de procédure.
  4. Destruction de l'instance de la procédure.