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);

Le résultat des deux commandes précédentes :

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 :

retourne le contenu envoyé via les paramètres en paragraphe HTML :

• p_titre : correspond au titre du paragraphe. Celui-ci apparaitra en premier en gras précédent d'un '→'.

• p_para : le contenu du paragraphe.

CAS D'UTILISATION:

Deux possibilités :

• Soit un souhaite un paragraphe avec seulement un titre (pratique quand on souhaite afficher une phrase) :

get_paragraphe('titre du paragraphe.');

Ce qui donne :

• Soit un souhaite un paragraphe avec un titre et du contenu :

get_paragraphe('titre du paragraphe :', 'contenu du paragraphe.');

Ce qui donne :

Voici la liste des fonctions rubriques :

• get_historisation : contrôle la notification d'historisation + % d'écart des lignes PTF entre ajourd'hui et hier.

• get_import_frs : contrôle les notifications fournisseurs + si les lignes PTF ont une valeur calculée pour “perf3_YTD” et “perf3_TOTAL”.

• get_import_depositaires : contrôle les notifications dépositaires + si des lignes n'ont pas été traitées pendant l'import de données dépositaires.

• get_sauvegardes : contrôle les notifications sauvegardes.

• get_jobs : contrôle si des jobs sont en erreur.

• get_objets_invalides : contrôle si des objets Oracle sont invalides.