3
edits
Système de Triggers: Difference between revisions
→Ajouter son code sur un événement Dolibarr
| Line 43: | Line 43: | ||
3) Revenez maintenant à l'édition du fichier trigger afin d'ajouter votre code dans la fonction ''run_trigger''. | 3) Revenez maintenant à l'édition du fichier trigger afin d'ajouter votre code dans la fonction ''run_trigger''. | ||
Cette fonction est appelée à chaque évènement Dolibarr. Placer votre code en fonction du ou des évènements sur lesquels vous voulez réagir, chaque évènement étant identifié par un code (voir chapitres suivant pour la liste des codes), on peut réagir ou non à un évènement | Cette fonction est appelée à chaque évènement Dolibarr. Placer votre code en fonction du ou des évènements sur lesquels vous voulez réagir, chaque évènement étant identifié par un code (voir chapitres suivant pour la liste des codes), on peut réagir ou non à un évènement donné par un test sur la variable '''$action''': | ||
<source lang="php"> | <source lang="php"> | ||
function | public function runtrigger($action,$object,$user,$langs,$conf) | ||
{ | { | ||
// Mettre ici le code à exécuter en réaction de l'action | // Mettre ici le code à exécuter en réaction de l'action | ||
| Line 65: | Line 65: | ||
</source> | </source> | ||
Vous pouvez faire ce que vous voulez dans cette portion de code du moment que la fonction | Vous pouvez faire ce que vous voulez dans cette portion de code du moment que la fonction runtrigger renvoie un code retour sur le principe suivant: | ||
<0 si ko, 0 si aucune action faite, >0 si ok | <0 si ko, 0 si aucune action faite, >0 si ok | ||
| Line 76: | Line 76: | ||
4) Une fois le code réalisé, il n'y a plus qu'à tester, en provoquant l'évènement déclencheur dans Dolibarr. Attention, l'appel au ''' | 4) Une fois le code réalisé, il n'y a plus qu'à tester, en provoquant l'évènement déclencheur dans Dolibarr. Attention, l'appel au '''runtrigger''' et encapsuler dans un transaction. Si votre trigger renvoie un code ko, la fonction appelante peut annuler la transaction (ceci dépend de la fonction appelante). | ||
Ajouter des traces dans un fichier dans la fonction '''run_trigger''' afin de vous assurer que le code s'exécute bien. Vous pouvez pour cela si vous le désirer, utiliser la fonction | Ajouter des traces dans un fichier dans la fonction '''run_trigger''' afin de vous assurer que le code s'exécute bien. Vous pouvez pour cela si vous le désirer, utiliser la fonction | ||
dol_syslog("mon texte de trace", LOG_DEBUG); | dol_syslog("mon texte de trace", LOG_DEBUG); | ||