菜单
Lit des enregistrements dans les fichiers binaires ISAM Divalto (.dhfi) via DhxIsam64.dll (ctypes). Supporte la lecture par cle, le parcours sequentiel, les filtres et la projection de champs. A utiliser pour consulter le contenu des fichiers indexes proprietaires Divalto.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Trouve un EnrNo libre dans le fichier menu `g3f.dhfi` d'un domaine ERP, selon la plage demandee (`standard` < 100000 reserve ERP, `custom` >= 100000 recommande pour creations utilisateur). Scan des enregistrements M2 (Ce=2) avec filtre obligatoire (piege multi-structure M0/M2, cf RETEX R-006), puis calcul max+1 dans la plage. Previent les collisions d'EnrNo lors de l'ecriture d'un nouveau choix de menu. A utiliser avant d'ecrire un enreg M2 dans `g3f.dhfi` (ou un enreg M1 de visibilite F7 dans `a5f.dhfi`) pour une entite metier custom.
Trouve un numero de zoom libre en cross-checkant les sources enregistrees (`a5tczoom.dhsp` constantes standard, `a5f.dhfi` zooms standard, **`a5fu.dhfi` zooms specifiques/surcharge**, `a5f.dhfi` versionx9 optionnel), puis verifie le candidat par une recherche large dans les sources specifiques uniquement (occurrences remontees et etiquetees pour jugement, jamais de decision auto). Convention : un nouveau zoom specifique partenaire demarre a 90000. Previent les collisions entre zooms declares, enregistres et reellement appeles dans le code. A utiliser avant d'allouer un nouveau numero de zoom (creation d'entite ou de zoom).
Orchestre l'analyse pre-action d'une demande DIVA (user story + criteres d'acceptation, ou ticket myService d'anomalie) en mode collaboratif. Produit un rapport de preparation pour le developpeur : exemples de code similaires dans l'ERP X.13, fonctions du langage DIVA reutilisables, etude d'impact, points d'action concrets (fichiers/fonctions a toucher), pistes complementaires et points d'attention. Strategie hybride : interroge en priorite le graphe Neo4j `diva-mcp` (snapshot X.12 advisory) puis verifie systematiquement dans le code X.13 standard. 5 checkpoints de validation humaine -- Claude s'arrete apres chaque etape significative pour expliquer et attendre le feu vert. A utiliser quand un developpeur colle une user story ou un ticket dans la conversation et demande par ou commencer.
Ajoute un binding "FK par zoom standard" a une entite metier DIVA existante (post-creation). Pour chaque FK declaree, enrichit le Module Check (.dhsp) avec `Module "Gttmchk<cible>.dhop"` + procedures `Check_<SRC>_Field_<CHAMP>(+_Lib)`, puis enrichit le masque (.dhsf) avec `f8=<zoom>`, `table_associee`, `diva_apres`, bouton zoom + procedure callback dans `[diva]`. A utiliser pour reproduire le workflow RETEX R-003 (ajout post-hoc de binding zoom pays/devise/... sur une entite deja creee). Pattern documente dans reference/fk-pattern.md.
Assemble un rapport d'analyse pre-action a partir des 3 JSON intermediaires (request, candidates_x12, evidence_x13). Modele catalogue-driven : evalue 9 types de contenus par pertinence (via `content_types.py`), amorce deterministement la matiere de chaque type retenu (propositions, grep commands, table Ce4, ...), assemble les fragments Jinja correspondants. Produit un markdown et un JSON de metriques avec tracabilite `types_included`. Applique les regles de marquage X.12/X.13 systematique et les criteres de qualite pre-action. A utiliser quand les 3 JSON (request, candidates, evidence) sont disponibles et qu'il faut produire le rapport markdown final destine au developpeur.
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.
| name | reading-isam-files |
| description | Lit des enregistrements dans les fichiers binaires ISAM Divalto (.dhfi) via DhxIsam64.dll (ctypes). Supporte la lecture par cle, le parcours sequentiel, les filtres et la projection de champs. A utiliser pour consulter le contenu des fichiers indexes proprietaires Divalto. |
# Lire tous les enregistrements zoom (cle A4)
py .claude/skills/reading-isam-files/scripts/read_isam.py \
--file "{CHEMIN_FICHIERS}/a5f.dhfi" \
--structure .claude/skills/reading-isam-files/scripts/structures/structure_a5f_m4.json \
--key A4
# Chercher un enregistrement par valeur de cle
py .claude/skills/reading-isam-files/scripts/read_isam.py \
--file "{CHEMIN_FICHIERS}/g3f.dhfi" \
--structure .claude/skills/reading-isam-files/scripts/structures/structure_xmenuf_m2.json \
--key A2 --key-value "FIC"
# Filtrer + projeter des champs
py .claude/skills/reading-isam-files/scripts/read_isam.py \
--file "chemin/a5f.dhfi" \
--structure .claude/skills/reading-isam-files/scripts/structures/structure_a5f_m4.json \
--key A4 --filter "ZoomNum=9490" --fields "ZoomNum,Lib,ZoomEnr"
| Mode | Parametres | Description |
|---|---|---|
| Parcours sequentiel | --key A4 | Lit tous les enregistrements dans l'ordre de la cle |
| Recherche par cle | --key A2 --key-value "FIC" | Positionne sur la cle puis lit sequentiellement tant que la cle correspond |
| Parcours inverse | --reverse | Lit du dernier au premier (positionne via 0xFF en fin de cle TDF, lit en mode reservation P) |
| Filtre | --filter "Champ=Valeur" | Filtre les enregistrements (cumulable, AND logique) |
| Projection | --fields "Champ1,Champ2" | Ne retourne que les champs specifies |
| Limite | --max 5 | Limite le nombre d'enregistrements retournes (defaut: 100) |
Les modes sont combinables : --key A4 --filter "ZoomNum=9490" --fields "Lib" --max 10.
--reverse)--key-value : positionne en fin de fichier (KEY charge avec un octet 0xFF apres la lettre d'index) puis remonte--key-value : usage non recommande (la verification d'egalite de cle stoppe des le premier enreg qui quitte la plage)xisam_tpreadlong avec mode de reservation P (Partage, pas de lock). La direction (remontee) est portee par la cle TDF, pas par le mode. Revision R-014 (2026-04-22) : avant cette date, le script passait des modes F/P/S/D/G comme codes de direction, ce qui etait une interpretation erronee -- mode est un code de reservation uniquement..dhfi : chemin complet du fichier ISAMUtiliser validate_structure.py pour verifier la structure avant lecture :
py .claude/skills/reading-isam-files/scripts/validate_structure.py \
--path .claude/skills/reading-isam-files/scripts/structures/structure_a5f_m4.json
Champ=Valeur pour filtrer les resultatsExecuter read_isam.py avec les parametres choisis. La sortie JSON contient :
{
"success": true,
"file": "chemin/a5f.dhfi",
"records": [ { "Ce": "4", "ZoomNum": "9490", "Lib": "..." }, ... ],
"count": 1
}
success=true : au moins 1 enregistrement trouvesuccess=false + exit code 1 : aucun enregistrement correspondant| Script | Role | Entree | Sortie JSON |
|---|---|---|---|
scripts/read_isam.py | Lit des enregistrements ISAM | --file --structure --key [+ --key-value] [+ --filter] [+ --fields] [+ --max] [+ --reverse] | {success, records[], count} |
scripts/validate_structure.py | Valide un fichier de structure JSON | --path | {valid, errors[], fields, record_size} |
Exit codes :
| Script | 0 | 1 | 2 |
|---|---|---|---|
read_isam.py | Enregistrements trouves | Aucun enregistrement | Erreur (DLL, fichier, structure) |
validate_structure.py | Structure valide | Structure invalide | Fichier introuvable |
| Structure | Fichier | Table | Taille |
|---|---|---|---|
| Zoom des zooms (A5F.dhfi) | scripts/structures/structure_a5f_m4.json | M4 | 1000 octets, 46 champs (Ce=4) |
| Visibilite F7 (A5F.dhfi) | scripts/structures/structure_a5f_m1.json | M1 | 50 octets, 6 champs (Ce=5) |
| Menu domaine choix (Xmenuf .dhfi) | scripts/structures/structure_xmenuf_m2.json | M2 | 1000 octets, 21 champs (Ce=2) |
| Menu domaine header (Xmenuf .dhfi) | scripts/structures/structure_xmenuf_m0.json | M0 | 508 octets, 12 champs (Ce=0) |
| Dictionnaire multichoix (gtfdmc.dhfi) | scripts/structures/structure_gtfdmc_ch60.json | ch60 (vue 6.0) | 420 octets, 12 champs (dont datemc Type="B") |
Pour une lecture interpretee du dictionnaire multichoix (liste des Nc, detail par Nc, resolution des 3 Types 1/3/4), utiliser le skill dedie reading-multichoix qui orchestre les vues specifiques aux Types.
Piege multi-structure G3F (R-006, 2026-04-23) : le fichier g3f.dhfi (base Xmenuf) contient 2 tables distinctes M0 (Ce=0, parametres generaux, 1 enreg = header du domaine) et M2 (Ce=2, choix du menu, N enregs). Un scan M2 sans filtre Ce=2 inclut l'enreg M0 decode avec les offsets M2 -> valeurs aberrantes. Toujours --filter "Ce=2" quand on analyse les choix de menu, --filter "Ce=0" pour le header. Structure M0 disponible ci-dessus.
Plage d'allocation EnrNo M2 (R-005, 2026-04-23) : hypothese empiriquement validee sur Achat-Vente X.13 : EnrNo < 100000 = zone standard (allouee par l'IHM native), EnrNo >= 100000 = zone customisation. Skill dedie allocating-menu-enrno automatise la selection.
Type dans la structure)| Type | Semantique | Traitement |
|---|---|---|
C (caractere) | Chaine texte | decode cp1252 + rstrip (preserve les espaces de tete) |
N (numerique) | Numerique ASCII | decode cp1252 + strip (2 cotes) |
D (date) | Date ASCII | decode cp1252 + strip (2 cotes) |
B (binaire) | Champ binaire (FILETIME, UID, bytes non-cp1252...) | retour hex uppercase, aucun decode texte |
| absent | Comportement historique | decode cp1252 + strip (2 cotes) |
Le type "B" (ajoute 2026-04-23) evite les UnicodeDecodeError sur des zones binaires non encodables en cp1252 (ex : datemc de gtfdmc.dhfi, 8 octets FILETIME-like avec bytes 0x9D / 0x8F hors table). Un fallback errors="replace" avec warning stderr protege aussi les champs texte des bytes invalides isoles.
reference/isam-api.md : API DhxIsam64.dll (signatures ctypes, TDF, modes, erreurs)reference/json-formats.md : format des fichiers structure JSONreference/a5f-zoom-record.md : structure specifique des enregistrements zoom A5F