| name | coding-diva-advanced |
| description | Reference des patterns avances du langage DIVA : HTTP/REST, JSON/XML, integration .NET, surcharge (OverWrite), module table (mtab), RecordSql avance (Reader, Collate, Paging), tunnels inter-modules (Ping/Pong), evenements Harmony. A consulter pour generer du code DIVA utilisant des fonctionnalites au-dela de la syntaxe de base.
|
coding-diva-advanced
Contenu
- Quand utiliser ce skill
- Domaines couverts (8)
- Anti-patterns avances
- References
Quand utiliser ce skill
Ce skill est une reference, pas un generateur. Le consulter quand :
- L'utilisateur demande un appel HTTP/REST depuis DIVA
- L'utilisateur veut parser du JSON ou XML
- L'utilisateur veut integrer une DLL .NET
- L'utilisateur veut surcharger un module standard (OverWrite)
- L'utilisateur veut creer un module table (mtab) avec controles
- L'utilisateur veut utiliser Reader, Collate, ou Paging sur un RecordSql
- L'utilisateur veut communiquer entre modules (tunnels Ping/Pong)
- L'utilisateur veut gerer des evenements clavier/souris dans un Zoom (Harmony)
Ce skill ne couvre PAS la syntaxe de base (types, procedures, fonctions, boucles, chaines) : elle est implicite dans les autres skills de generation.
Domaines couverts
| # | Domaine | Cas d'usage | Reference |
|---|
| 1 | HTTP/REST | Appel API externe, WebRequest, WebServiceDiva | http-rest.md |
| 2 | JSON/XML | Parsing JSON (JsonOpen), lecture XML (XmlRead), HMP | json-xml.md |
| 3 | Integration .NET | Appel DLL .NET (AssemblyLoad/Invoke) | dotnet-integration.md |
| 4 | Surcharge | OverWrittenBy/OverWrite, convention nommage U/UU, codes retour hooks Zoom* | overwrite-pattern.md, zoom-hooks-reference.md |
| 5 | Module table (mtab) | Controles en cascade Switch TRUE, initialisation defauts | module-table.md |
| 6 | RecordSql avance | Reader, Collate, Paging, Where fluent, RecordSqlPtr | recordsql-advanced.md |
| 7 | Tunnels | Ping/Pong, PingLocal, ProgramCall | tunnels.md |
| 8 | Harmony | Record Harmony, codes touches, timer, ZoomArret | harmony-events.md |
Anti-patterns avances
NE JAMAIS generer :
+ pour concatener → utiliser &ForEach → DIVA n'en a pas, utiliser ListBegin/ListNext/ListEnd ou ReaderTry/Catch → DIVA n'a pas d'exceptions, utiliser codes retour + ErrorFatal/ErrorWarningClass → DIVA n'a pas d'OOP, utiliser les modules mchk- Threads → utiliser
ProgramCall pour l'execution parallele
- Oublier
WebRequestClose(ticket) apres un appel HTTP (fuite)
- Oublier
JsonClose(ticket) apres parsing JSON
GG_* pour un module DAV → utiliser GT_*GT_* pour un module Production → utiliser GG_*
Pieges de syntaxe DIVA (a priori mainstream souvent faux) :
; introduit un commentaire (pas une fin d'instruction) ; le separateur de ligne logique est | (ni un OU, ni un commentaire)- constante booleenne standard :
OUI = 2, NON = 0, etat intermediaire = 1 -- ne jamais supposer OUI = 1
- date du jour :
today() -- le champ MZ.DateJour n'existe pas
- borne / valeur par defaut : variable locale typee +
init (ex init InvNo_Defaut = '9') plutot qu'une constante en dur
_ de continuation dans un If multi-ligne combine a des appels prefixes module -> Erreur 37 ; ecrire la condition sur une seule ligne
References
- HTTP/REST -- WebRequest API, WebServiceDiva
- JSON/XML -- JsonOpen/Parse, XmlOpen/Read, HMP
- Integration .NET -- AssemblyLoad, codes erreur
- Surcharge -- OverWrittenBy/OverWrite, convention U, pattern canonique de procedure surchargee
- Hooks Zoom* -- grille de codes retour O/N/I/C, couverture validee, pattern d'utilisation
- Module table -- mtab, Switch TRUE, controles
- RecordSql avance -- Reader, Collate, Paging, Direct, Transactions, Performance, Callbacks
- Tunnels -- Ping/Pong, PingLocal, ProgramCall
- Harmony -- Evenements, codes touches, timer
