Ce package permet l'envoi d'un mail de supervision d'un environnement pour obtenir des informations sur celui-ci. Ces données sont formatées en HTML pour plus de lisibilité.

Introduction :

• Les prérequis pour maintenir ce package.
• conception du package.

Les fonctions d'envoi du mail / de mise en forme :

• procedure envoi_mail.
• function get_header.
• function get_footer.
• function get_html_row.
• function get_paragraphe.

Les rubriques du mail:

• Les fonctions pour récupérer les rubriques du mail.
• Appel des fonctions de mise en forme pour une rubrique.

• Le mail étant basée sur les technologies HTML et CSS, il est préférable de connaitre dans les grandes lignes la conception d'une page web statique avec ces technologies.

• Le développement d'un mail HTML est particulier en comparaison avec une page web classique. Du fait que les boîtes mail n'ont pas toutes les mêmes rendus et mêmes restrictions, les règles “classiques” ne sont pas toujours applicables pour conserver une compatibilité sur toutes les boîtes mail. Voici un lien utile : Un e-mail en HTML.

Ce package permet l'envoi d'un mail à l'API APEX_MAIL. De ce fait, un seul “objet” est publique pour ce package : il s'agit de la procédure envoi_mail présentée ci-dessous.

Variable globales :

• g_date_supervision : permet de simuler la supervision à un jour précis (remplacer “sysdate” par “TO_DATE('23/10/2015', 'DD/MM/YYYY')” par exemple).

• g_str_array : contient l'ensemble des codes dépositaires pour requêter les bons imports dépositaire dans la rubrique du mail dédiée.

• g_prefix_type_dep : préfix pour la colonne “type” de la table “notifications” dans le cas des imports dépositaires.

PROTOTYPE :

procedure envoi_mail();

BUT :

envoyer un mail de supervision pour un environnement.

FONCTIONNEMENT :

Cette procédure appelle une autre procédure “APEX_MAIL.SEND” :

apex_mail.send(
    p_to          => 'rmorice@salamander-soft.com, yroselier@salamander-soft.com, renaldmorice@hotmail.fr'
    ,p_from       => 'noreply@salamander-soft.com'
    ,p_body       =>  v_body
    ,p_body_html  =>  v_body_html
    ,p_SUBJ       => 'Supervision : '||v_app_name||'/'||'[S@M-'||v('G_CLIENT_NAME')||']'
    ,p_cc         => NULL
    ,p_bcc        => NULL
    ,p_replyto    => NULL
);

• p_to : adresses électroniques de destination.

• p_from : l'émetteur.

• p_body : envoi d'un contenu purement textuel dans le cas d'une boîte mail ne voulant pas interpréter du HTML.

• p_body_html : envoi du contenu HTML de la variable v_body_html.

• p_SUBJ : sujet du mail.

PROTOTYPE :

function get_header();

BUT :

retourne la partie fixe du HTML se trouvant en haut du contenu HTML.

PROTOTYPE :

function get_footer();

BUT :

retourne la partie fixe du HTML se trouvant en bas du contenu HTML.

PROTOTYPE :

function get_html_row(
    p_partie number
    ,p_feu number default 0
    ,p_titre varchar2 default null
)return varchar2;

BUT :

retourne le code HTML pour le formatage d'une rubrique.

FONCTIONNEMENT :

Le code HTML renvoyé par cette fonction dépend des paramètres passés :

• p_partie : envoyer 1 pour recevoir le début de la partie HTML d'une rubrique. Envoyer 2 pour recevoir la fin de la partie HTML d'une rubrique.

• p_feu : permet de choisir la couleur du feu à gauche de la rubrique. 0 : rouge; 1 : orange ; 2 : vert.

• p_titre : titre de la rubrique (exemple : “Historisation”).

CAS D'UTILISATION:

Généralement, cette fonction est appelée sous deux formes différentes :

• pour obtenir le début d'une rubrique (dans cet exemple, le feu est vert et le nom de la rubrique est “Rubrique de test”) :

get_html_row(1,2,'Rubirque de test');

• pour obtenir la fin d'une rubrique :

get_html_row(2);

PROTOTYPE :

function get_paragraphe(
    p_titre varchar2
    ,p_para varchar2 default null
)return varchar2;

BUT :

retourne le code HTML pour le formatage d'un paragraphe interne d'une rubrique.

FONCTIONNEMENT : Le code HTML renvoyé par cette fonction dépend des paramètres passés :

CAS D'UTILISATION: