Export du rapport ROC

Kliper construit un rapport de conformité (ROC) entièrement mis en forme directement à partir des données de votre évaluation : un PDF prêt à imprimer ou un DOCX modifiable (fondé sur le modèle de ROC officiel PCI DSS v4.0.1, révision 3). L’export passe par une fenêtre guidée où vous choisissez les livrables et le format, voyez une vérification de complétude, et chaque export est archivé automatiquement dans la bibliothèque ROC. Vous pouvez aussi importer un ROC existant pour préremplir une évaluation.

Prérequis

Avant de générer le ROC, assurez-vous que les éléments suivants sont complets :

Générer le rapport

Ouvrez votre évaluation, puis utilisez le menu Actions → Exporter pour ouvrir la fenêtre d’export.

Importer un ROC existant

Vous avez déjà un ROC d’une période antérieure ? Importez-le pour préremplir l’évaluation au lieu de tout ressaisir.

Bibliothèque ROC

Chaque ROC que vous exportez est capturé comme version immuable dans la bibliothèque ROC : l’historique complet par engagement, du premier brouillon à la version finale signée. Ouvrez-la depuis Bibliothèque ROC dans la barre latérale.

Parcourez par évaluation ou par client. Chaque version indique :

• Nom de fichier, numéro de version (v1, v2, …) avec un badge Dernière
• Statut Final ou Brouillon · X % (vert à 100 %, ambre en cours)
• Format, taille du fichier, nombre de pages (PDF), qui l’a exporté et quand, et quels livrables il contient
• Aperçu (PDF uniquement) et Télécharger

Suivre l’achèvement

La barre latérale de l’évaluation affiche l’avancement en direct pour que vous sachiez ce qui reste avant d’exporter :

• Points de statut sur chaque section/sous-section : vert quand complet, ambre quand partiel, gris quand vide
• Compteurs par sous-section (par ex. 3.1 → 2/4) et compteurs de spécifications par exigence (par ex. Exig. 1 → 8/12 specs)
• Les en-têtes de groupe se consolident : le résumé exécutif en pourcentage, les exigences et annexes en terminées/total

Ce qui compte comme une unité d’achèvement : chaque champ de configuration en vaut une ; un tableau vaut une unité (terminé seulement lorsqu’il a au moins une ligne complète) ; un groupe de cases à cocher vaut une réponse ; et chaque spécification d’exigence en vaut une (décidée dès qu’elle a une constatation). L’avancement se rafraîchit automatiquement peu après l’enregistrement.

Rapport de synthèse de l’évaluation (PDF)

Pour un instantané rapide du statut, sans générer le ROC complet, exportez un rapport de synthèse aux couleurs de la marque directement depuis l’évaluation. Ouvrez l’évaluation et, sur la carte Statut d’avancement, cliquez sur PDF de synthèse.

C’est un PDF de marque d’une à deux pages couvrant :

• Avancement et conformité : achèvement de la rédaction (exigences décidées) et niveau de conformité (exigences En place), rapportés comme deux nombres distincts pour qu’une évaluation partiellement rédigée se lise honnêtement au lieu de paraître terminée.
• Statut des exigences : la ventilation En place / Non en place / En cours / Non applicable / Non démarré, par exigence PCI.
• Jalons : achèvement par rapport aux jalons de l’approche priorisée PCI DSS.
• Backlog : les tâches ouvertes rattachées à l’évaluation.

Utilisez-le pour tenir un client ou un responsable d’engagement informé entre les exports formels du ROC. Les chiffres correspondent exactement à la Vue d’ensemble de l’évaluation (même source de modèle de risque), et le rapport reflète l’instant où vous l’exportez.

Exports de données

Au-delà du ROC lui-même, la page Rapports (/reports) génère des exports de données complémentaires via la fenêtre Générer un rapport :

Chacun s’exporte en Excel stylisé (.xlsx) (ligne d’en-tête sombre, cellules colorées par statut, filtres déroulants et colonnes auto-dimensionnées) ou en CSV (UTF-8 avec BOM, pour une ouverture propre dans Excel et Google Sheets).

Fonctionnement de l’export

Le moteur d’export DOCX traite le modèle de ROC via un pipeline en plusieurs étapes :

Étape 1 : chargement du modèle

Le moteur charge un modèle de document Word depuis le répertoire templates/. Le modèle par défaut est report.docx, fondé sur le modèle de ROC officiel du PCI SSC (révision 3). Des modèles personnalisés peuvent être utilisés en indiquant un nom de modèle.

Le modèle est un fichier .docx standard (archive ZIP contenant du XML). Les balises sont placées en ligne dans le document Word sous forme d’espaces réservés {{Tag-Name}}.

Étape 2 : fusion des runs XML

Word fragmente fréquemment le texte en plusieurs éléments XML <w:r> (runs) à cause des marqueurs de correction orthographique, des changements de mise en forme et des attributs de langue. Une balise comme {{Client-Name}} peut donc être répartie sur 3 éléments XML ou plus.

Le moteur fusionne les runs adjacents de chaque paragraphe pour que les balises {{ ... }} apparaissent dans un seul élément <w:t>. Cela garantit une détection et un remplacement fiables des balises.

Étape 3 : traitement des boucles (clonage de lignes de tableau)

Pour les données répétitives (tableaux à plusieurs lignes), le modèle utilise des balises de boucle :

{{#LoopName}}
  {{.fieldA}}  |  {{.fieldB}}  |  {{.fieldC}}
{{/LoopName}}

Le moteur :

1. Identifie les éléments <w:tr> (ligne de tableau) qui contiennent les balises d’ouverture et de fermeture de la boucle.
2. Traite la ou les lignes englobées comme un modèle.
3. Clone la ligne modèle une fois par élément du tableau de données.
4. Remplace {{.fieldName}} par les valeurs de champ de chaque élément.
5. Rend les champs booléens comme des symboles de case à cocher : true → ☒, false → ☐.

Sources de données de boucle prises en charge :

Étape 4 : insertion des images de schémas

Pour les sections 4.1 (schémas réseau) et 4.2 (schémas de flux de données de compte), le moteur :

1. Interroge les fichiers image téléversés et rattachés à ces sections.
2. Intègre les images directement dans le document Word aux emplacements des balises {{diagrams-4.1}} et {{diagrams-4.2}}.
3. Crée les relations XML Word nécessaires au rendu des images en ligne.

Étape 5 : remplacement des balises

Tous les espaces réservés {{Tag-Name}} restants sont remplacés par les données de l’évaluation. Le moteur maintient une table de balises complète couvrant chaque section du ROC :

Étape 6 : résolution des cases à cocher

Le modèle utilise des balises de case à cocher pour les champs de sélection (boutons radio dans l’interface de l’évaluation) :

{{check-onsite}}     → ☒ (si sélectionné) ou ☐ (sinon)
{{check-combination}} → ☒ ou ☐
{{check-remote}}      → ☒ ou ☐

Les balises de case à cocher couvrent : méthode de test à distance, consultation d’un QSA, recours à des sous-traitants, type d’achèvement de l’évaluation et résultat global de conformité.

Étape 7 : génération de la sortie

Le document traité est compressé en DEFLATE et renvoyé sous forme de tampon. Le fichier est nommé selon le motif {client-slug}-roc-{date}.docx et transmis en flux au navigateur de l’utilisateur pour téléchargement.

Modèles personnalisés

Les organisations peuvent utiliser des modèles Word personnalisés en plaçant des fichiers .docx dans le répertoire templates/. Les modèles personnalisés doivent utiliser la même convention {{Tag-Name}}. Si un modèle demandé n’est pas trouvé, le moteur se replie sur le report.docx par défaut.

Dépannage