Programmation et technique surcharge A5MFLASH
- Bertrand Littel
La gestion des flashs est centralisée dans le module A5PMFLASH.
SOMMAIRE
- 1 Description de fichiers
- 2 Référence du module A5PMFLASH : fonctions et procédures publiques
- 2.1 A1 : enregistrement public du message
- 2.2 A5_Flash_Envoi (FlashCod, Etb, Depo, Entite)
- 2.3 int A5_Flash_Ajouter_Destinataire_BCC_Internet_Spe (AdrDest)int A5_Flash_Ajouter_Destinataire_BCC_Mail_Spe (AdrDest)int A5_Flash_Ajouter_Destinataire_CC_Internet_Spe (AdrDest)int A5_Flash_Ajouter_Destinataire_CC_Mail_Spe (AdrDest)int A5_Flash_Ajouter_Destinataire_Internet_Spe (AdrDest)int A5_Flash_Ajouter_Destinataire_Mail_Spe (AdrDest)
- 2.4 int A5_Flash_Ajouter_Fichier_Joint_Spe (FicJoint)
- 3 Listes des ouvertures possibles lors d’un envoi de flash
- 4 Exemple 1 : utilisation de l’envoi d’un flash standard
- 5 Exemple 2 : Rajout de numéros de flashs distributeurs
- 6 Exemple 3 : en saisie de pièce
Description de fichiers
Le fichier A5FFLASH du dictionnaire A5DD.dhsd est le groupe contenant le paramétrage des flashs, notamment la table MFLASH
Référence du module A5PMFLASH : fonctions et procédures publiques
A1 : enregistrement public du message
L’enregistrement A1 porte les informations du message (texte et objet)
A5_Flash_Envoi (FlashCod, Etb, Depo, Entite)
Signature
Public function int A5_Flash_Envoi ( FlashCod, Etb, Depo, Entite)
Description
Envoi d’un mail si un paramétrage est trouvé pour le numéro de flash et s’il y a au moins un destinataire.
Paramètres : voir intelliSense
Remarques
L’objet et le texte du message sont personnalisables. Les enregistrements utilisés doivent être renseignés au préalable.
L’entité est à préciser s’il y a une recherche de destinataires variables à effectuer en fonction du tiers (tiers, contact, représentant)
Valeurs de l’entité :
2 Prospect
3 Client
4 Fournisseur
5 Représentant
6 Autre tiers)
0 Pas lié à un tiers
int A5_Flash_Ajouter_Destinataire_BCC_Internet_Spe (AdrDest)
int A5_Flash_Ajouter_Destinataire_BCC_Mail_Spe (AdrDest)
int A5_Flash_Ajouter_Destinataire_CC_Internet_Spe (AdrDest)
int A5_Flash_Ajouter_Destinataire_CC_Mail_Spe (AdrDest)
int A5_Flash_Ajouter_Destinataire_Internet_Spe (AdrDest)
int A5_Flash_Ajouter_Destinataire_Mail_Spe (AdrDest)
Les fonctions ci-dessus permettent d’ajouter des destinataires. Attention, une seule adresse à la fois
La version ‘Internet’ ou ‘Mail’ se distingue par MAPI_INTERNET ou MAPI_MAIL
int A5_Flash_Ajouter_Fichier_Joint_Spe (FicJoint)
Ajoute le fichier ficjoint au A1 courant
int A5_Flash_Destinataire (&NewMess, Entite)
int A5_Flash_Recherche_Flash (FlashCod,Etb,Depo)
Recherche du flash
retourne 0 si flash trouve
retourne 1 si aucun flash n'a été trouvé
retourne 2 si le flash n'est pas valide
Listes des ouvertures possibles lors d’un envoi de flash
A5_Flash_Creation_Message_Av
Cette surcharge permet de modifier éventuellement le contenu de l’objet et du texte du message.
Elle est appelée après la recherche des champs dans l’objet et le texte de la définition du flash (MFLASH.MSGOBJ et MFLASH.MSGTXT) et leur substitution par leur contenu avant la création du pointeur de message (MapiCreateMessage).
L’objet du message se trouve dans A1.msgobj
Le texte du message se trouve dans A1.msgtxt
A5_Flash_Envoi_Av
Cette surcharge permet de compléter le message, (rajouter un destinataire, ou rajouter un fichier joint)
Elle est appelée avant l’envoi du message (MapiSendMessage).
Le pointeur du message se trouve dans A1.NewMess
Pour compléter le message avec un fichier joint :
Appeler la fonction A5_Flash_Ajouter_Fichier_Joint_Spe (Fic) de A5PMFLASH
Fic correspond au nom complet du fichier (256)
Ne pas oublier de supprimer le fichier s’il y a lieu
Pour rajouter un destinataire avec une adresse interne
Appeler la fonction A5_Flash_Ajouter_Destinataire_Mail_Spe (AdrMail) de A5PMFLASH
la fonction A5_Flash_Ajouter_Destinataire_CC_Mail_Spe (AdrMail) de A5PMFLASH (pour un destinataire en copie)
la fonction A5_Flash_Ajouter_Destinataire_BCC_Mail_Spe (AdrMail) de A5PMFLASH (pour un destinataire en copie caché)
AdrMail correspond à une adresse interne (20)
Pour rajouter un destinataire avec une adresse internet
Appeler la fonction A5_Flash_Ajouter_Destinataire_Internet_Spe (AdrInternet) de A5PMFLASH
la fonction A5_Flash_Ajouter_Destinataire_CC_Internet_Spe (AdrInternet) de A5PMFLASH (pour un destinataire en copie)
la fonction A5_Flash_Ajouter_Destinataire_BCC_Internet_Spe (AdrInternet) de A5PMFLASH (pour un destinataire en copie caché)
AdrInternet correspond à une adresse internet (80)
A5_Flash_Envoi_Ap
Cette surcharge est appelée après l’envoi du message, avant la suppression du message.
Le pointeur du message se trouve dans A1.NewMess
A5_Flash_Remplacer_Champ_Specifique
Cette surcharge est appelée dans le cas où le datacompute sur un champ détecté dans l’objet ou le texte a renvoyé une erreur.
Le nom du champ se trouve dans A1.EnregChampNom
Le contenu est à mettre dans A1.EnregChampContenu
A5_Flash_Destinataire_Ap
Cette surcharge est appelée après le rajout de tous les destinataires paramétrés dans le flash, avant la suppression des listes d’adresses.
La variable A5XT.TABLEAU(2) contient la liste des adresses internes de messagerie (adresse de 20 caractères).
La variable A5XT.TABLEAU(3) contient la liste des adresses internet de messagerie
(email de 80 caractères).
Le pointeur du message se trouve dans A1.NewMess
Elle permet de rajouter des destinataires autres que ceux paramétrés dans le flash :
Pour rajouter un destinataire avec une adresse interne
Appeler la fonction A5_Flash_Ajouter_Destinataire_Mail_Spe (AdrMail) de A5PMFLASH
la fonction A5_Flash_Ajouter_Destinataire_CC_Mail_Spe (AdrMail) de A5PMFLASH (pour un destinataire en copie)
la fonction A5_Flash_Ajouter_Destinataire_BCC_Mail_Spe (AdrMail) de A5PMFLASH (pour un destinataire en copie caché)
AdrMail correspond à une adresse interne (20)
Pour rajouter un destinataire avec une adresse internet
Appeler la fonction A5_Flash_Ajouter_Destinataire_Internet_Spe (AdrInternet) de A5PMFLASH
la fonction A5_Flash_Ajouter_Destinataire_CC_Internet_Spe (AdrInternet) de A5PMFLASH (pour un destinataire en copie)
la fonction A5_Flash_Ajouter_Destinataire_BCC_Internet_Spe (AdrInternet) de A5PMFLASH (pour un destinataire en copie caché)
AdrInternet correspond à une adresse internet (80)
Exemple 1 : utilisation de l’envoi d’un flash standard
Exemple d’utilisation dans le programme de gestion des tiers lors de la création d’un client
if SOCCRM.FlashDifCod(1)=2
A5_Flash_envoi (3001, MZ.ETB,MZ.DEPO,3)
Endif
Exemple d’utilisation dans le zoom des clients lors de la création d’un client
if SOC.FLASHDIFCOD(1) = Oui
A5_Flash_Envoi(1,' ',' ',3)
endif
Exemple 2 : Rajout de numéros de flashs distributeurs
Exemples :
On rajoute le numéro de flash 9000 associé à la saisie d’une facture de 5000 Euros et le numéro de flash 9001 associé à la saisie d’un impayé.
Saisie du paramétrage des flashs 9000 et 9001
Surcharge de gtup230.hsp : Génération d’un flash lors de la validation de la saisie d’une facture ] 5000 Euros.
overwrite 'GTTT230.hop'
include "GTTC000.hsp"
module 'A5PMFLASH.HOP'
Public Record gtfdd.hsd ENT
Public Record gtfdd.hsd G1
Public Record gtfdd.hsd CLI
public record g3dd.hsd MZ
;*
Procedure CLI_Maj_Finpiece
beginp
; Test si la facture crée est supérieure à 5000 Euros
if ENT.TTCMT>5000 and G1.PRGMODE=3
A5_Flash_envoi(9000,MZ.ETB,MZ.DEPO,3)
endif
endp
Surcharge de rcut040.hsp : Génération d’un flash lors de la saisie d’un impayé.
Exemple 3 : en saisie de pièce
Voir le GTTTPCE000.DHSP en recherchant ‘flash’