Marquer les artefacts de page via Connect

En bref

Cette recette encapsule les ornements de pagination — en-têtes et pieds de page courants, numéros de page, filigranes, arrière-plans — dans du contenu balisé comme artefact via les transports Connect. Ces ornements restent visibles sur la page, mais demeurent hors de l’arbre de structure et de l’ordre de lecture des technologies d’assistance. L’outil d’artefacts est de niveau Enterprise : NextPDF le découvre au moyen d’une sonde class_exists() et ne l’enregistre que lorsque nextpdf/premium est installé avec le serveur. Le sous-type est une énumération typée (Pagination, Layout, Page, Background).

Pour la vérification, utilise l’outil de contrôle des normes Enterprise, qui produit un rapport au regard de PDF/UA-2. Un résultat conforme signifie que le contrôle propre à l’outil réussit, et non qu’il s’agit d’une certification de conformité indépendante.

Installation

composer require nextpdf/server

Vérifie que l’outil d’artefacts Enterprise est présent au moyen d’un appel tools/list. Voir /connect/tool-catalog/.

Aperçu conceptuel

Le contenu qui ne fait pas partie de la structure logique est marqué comme artefact et exclu de l’ordre de lecture (PDF/UA-2 §8.3). Les artefacts correspondent à du contenu de pagination, de mise en page, de page ou d’arrière-plan, distinct du contenu réel (PDF/UA-2 §8.3). Le contenu réel est représenté dans l’arbre de structure ; ce n’est pas le cas des artefacts (PDF/UA-2 §8.2.4).

L’outil ouvre une séquence de contenu balisé comme artefact avec le sous-type demandé. Toutes les opérations de dessin que tu émets jusqu’à la fermeture correspondante sont encapsulées dans cette séquence.

Surface de l’API

Vérifie les noms des outils dans le registre actif avec tools/list. Le catalogue de référence est /connect/tool-catalog/. Cette recette ne reproduit pas le décompte des outils.

Exemple de code — Démarrage rapide

Ouvre un artefact Background, dessine le filigrane, puis ferme-le :

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "emit_artifact",
    "arguments": { "document_id": "<id>", "subtype": "Background" }
  }
}

Exemple de code — Production

Associe chaque ouverture à une fermeture et vérifie que la page ne contient aucun contenu orphelin :

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "emit_artifact",
    "arguments": { "document_id": "<id>", "subtype": "Page", "attached": "Bottom" }
  }
}

Après avoir dessiné le texte du pied de page, ferme la séquence avec l’outil de fin d’artefact et exécute le contrôle des normes au regard de PDF/UA-2. L’arbre de structure ne doit contenir que le contenu du corps ; le filigrane et le pied de page doivent être exclus.

Cas limites et pièges

Sous-type inconnu (par exemple "Header") : il est rejeté. Fournis l’une des valeurs Pagination, Layout, Page, Background.
Fermeture sans ouverture : l’opération échoue avec un message de profondeur nulle. Associe toujours l’ouverture et la fermeture.
Dessiner avant tout contexte d’artefact ou de structure produit du contenu orphelin et fait échouer la règle de structure. Ouvre d’abord un contexte de structure ou d’artefact.
Outil absent. Sans nextpdf/premium, l’outil d’artefacts Enterprise n’est pas enregistré, et l’appel échoue avec une erreur d’outil inconnu.

Performance

Le budget du front-matter est un plafond indiqué à titre documentaire. L’encapsulation en artefact n’ajoute aucune phase distincte mesurable.

Notes de sécurité

Sans objet au-delà des recommandations générales relatives au transport Connect.

Conformité

Correspondance PDF/UA-2

Sous-type	Cas d’usage
`Pagination`	headers/footers courants, numéros de page, ornements de navigation
`Layout`	filets, séparateurs, bordures décoratives
`Page`	Repères liés à la page (traits de coupe, repérage)
`Background`	Filigranes, remplissages d’arrière-plan, image de marque

Renvoi balise → ISO 32000-2 §14.9

Affirmation	Clause	reference_id
Contenu non structurel marqué comme artefact, exclu de l’ordre de lecture	PDF/UA-2 §8.3
Sous-types d’artefact : pagination/layout/page/background	PDF/UA-2 §8.3
Contenu réel dans l’arbre de structure ; pas les artefacts	PDF/UA-2 §8.2.4

Correspondance WCAG 2.2

Exclure les ornements décoratifs de l’ordre de lecture contribue au critère de succès WCAG 2.2 SC 1.3.1 (Information et relations) au niveau du contenu.

Un résultat conforme dans le contrôle des normes reste un contrôle, et non une certification de conformité. Cette détermination revient à un vérificateur indépendant.

Contexte commercial

L’outil d’artefacts est de niveau Enterprise et n’est enregistré que lorsque nextpdf/premium est installé avec le serveur.

Spécificités de Connect

Disponibilité par transport (MCP / REST / gRPC)

Tu invoques ces outils de la même manière via MCP tools/call, le point de terminaison REST des outils et le service gRPC, tous trois via l’exécuteur d’outils partagé.

Niveau de risque HITL

L’émission d’artefacts et le dessin de contenu relèvent du niveau prudence ; le contrôle des normes est en lecture seule. Aucun d’eux n’est approval_required par défaut. Voir /connect/hitl-risk-tiers/.

Enveloppe JSON du verrou de confirmation

Ces outils ne déclenchent pas le verrou, sauf si une dérogation opérateur en élève un au niveau approval_required. Le contrat de l’enveloppe et du jeton à usage unique figure dans /connect/hitl-risk-tiers/.

Voir aussi

/cookbook/connect/aria-tagged-pdf/ — correspondance des rôles de repère.
/cookbook/connect/figure-caption/ — regroupement accessible d’images.
/connect/tool-catalog/ — calcul de l’ensemble d’outils par niveau.
/connect/hitl-risk-tiers/ — le modèle de risque et le verrou.