Listez les signets PDF avec pages et niveaux

Chaque élément contient le titre du signet, son niveau hiérarchique compté à partir de un et sa page cible également comptée à partir de un. Le parcours respecte l’ordre du plan et place chaque enfant immédiatement après son parent. Une arborescence vide est explicitement refusée, afin que l’absence de table des matières ne soit jamais confondue avec un résultat valide dépourvu de données.

Convertissez une arborescence en lignes exploitables

Les signets PDF sont généralement organisés sous forme d’arbre. Les chapitres occupent le premier niveau, les sections figurent sous les chapitres et les rubriques peuvent descendre encore plus loin. Cette structure est pratique dans un lecteur, mais moins adaptée à l’audit de navigation, à la création d’un rapport, à la comparaison d’éditions ou à l’envoi vers un tableur. Cette capacité parcourt le plan en préordre : elle émet d’abord le parent, puis tous ses descendants dans leur ordre initial, avant de passer au frère suivant. Chaque ligne contient les données utiles à un inventaire : titre, niveau et page cible. Les niveaux et les pages commencent à un. La liste respecte ainsi l’ordre de lecture visible tout en supprimant l’imbrication récursive. Elle n’ouvre et ne modifie aucun fichier PDF ; elle reçoit le plan déjà produit par un analyseur ou une étape documentaire antérieure.

Maîtrisez la validation et l’ordre déterministe

Chaque signet doit être un objet doté d’un titre non vide et d’une page exprimée par un entier positif. Les enfants facultatifs doivent former un tableau d’autres signets. Les espaces placés aux extrémités du titre sont supprimés, sans modifier le texte intérieur. L’algorithme ne trie jamais par ordre alphabétique ou par numéro de page, car un tel tri pourrait dénaturer l’intention de l’auteur. Il suit la séquence reçue et déduit le niveau de la profondeur. Une entrée identique donne donc toujours une sortie identique, sans réseau, horodatage, identifiant aléatoire ni comportement lié à l’environnement. Un plan racine vide entraîne une erreur de saisie. Une automatisation peut ainsi s’arrêter lorsqu’un document ne possède aucun signet au lieu de publier un index vide en apparence valable. Les enfants mal formés, titres manquants, destinations incorrectes, profondeurs excessives, cycles et arbres trop volumineux sont également refusés.

Intégrez la liste à vos traitements documentaires

Une liste plate constitue une frontière simple entre l’analyse PDF et les règles métier suivantes. Vous pouvez l’afficher comme table des matières, vérifier la présence des chapitres attendus, comparer les titres et destinations de plusieurs versions ou associer des pages à des sections pour une extraction ultérieure. La réponse comprend le nombre total et les enregistrements ordonnés ; un système peut donc contrôler le volume avant de traiter chaque élément. Le niveau permet de recréer l’indentation, voire l’arbre, tandis que la page facilite la navigation et le calcul de plages. Cette capacité restitue uniquement le plan fourni : elle ne vérifie pas l’existence des pages dans un PDF précis, ne déduit pas les titres depuis le texte et ne répare pas les liens défectueux. Si l’analyseur fournit le nombre de pages, validez les limites séparément. L’exécution dans le navigateur est gratuite et l’automatisation par API coûte $0.002 par requête, avec une logique identique dans les deux canaux.