Exportateur de page the-page-exporter

AEM vous permet d’exporter une page sous forme d’une page web complète comprenant des images, des fichiers .js et .css.

Une fois l’exportation configurée, il vous suffit de demander une page dans votre navigateur en remplaçant html avec export.zip dans l’URL et vous obtenez un téléchargement de fichier zip contenant la page rendue au format html et les ressources référencées. Tous les chemins d’accès de la page, par exemple les chemins d’accès aux images, sont réécrits afin de pointer vers les fichiers inclus dans le fichier zip ou vers les ressources du serveur.

Exportation d’une page exporting-a-page

Les étapes suivantes décrivent comment exporter une page et supposent qu’il existe un modèle de configuration d’exportation pour votre site. Un modèle de configuration définit la manière dont une page est exportée et est spécifique à votre site. Pour créer un modèle de configuration, reportez-vous à la section Création d’une configuration d’exportateur de page pour votre site .

Pour exporter une page, procédez comme suit :

Création d’une configuration de l’exportateur de page pour votre site creating-a-page-exporter-configuration-for-your-site

L’exportateur de page repose sur le framework de synchronisation du contenu. Les configurations disponibles dans la boîte de dialogue des propriétés de page sont des modèles de configuration. Ils définissent toutes les dépendances requises pour une page. Lorsqu’une exportation de page est déclenchée, le modèle de configuration est utilisé et le chemin de page et le chemin de conception sont appliqués dynamiquement à la configuration. Le fichier compressé est alors créé à l’aide de la fonctionnalité de synchronisation de contenu standard.

AEM incorpore quelques modèles, notamment :

Pour créer un modèle de configuration de l’exportateur de page :

Nœuds de configuration de l’exportateur de page page-exporter-configuration-nodes

Le modèle de configuration se compose d’une structure de noeud. Chaque nœud possède une propriété type qui définit une action spécifique dans le processus de création du fichier compressé. Pour plus d’informations sur la propriété type, reportez-vous à la section Présentation des types de configuration de la page Structure de synchronisation de contenu .

Les noeuds suivants peuvent être utilisés pour créer un modèle de configuration d’exportation :

noeud de page Le noeud de page est utilisé pour copier le code HTML de la page dans le fichier zip. Il possède les caractéristiques suivantes :

Le nœud page possède les propriétés suivantes :

noeud rewrite Le noeud rewrite définit la manière dont les liens sont réécrits dans la page exportée. Les liens réécrits peuvent pointer vers les fichiers inclus dans le fichier compressé ou vers les ressources sur le serveur.

Reportez-vous à la page Synchronisation du contenu pour obtenir une description complète du rewrite noeud .

noeud design Le noeud de conception est utilisé pour copier la conception utilisée pour la page exportée. Il possède les caractéristiques suivantes :

Le nœud design possède les propriétés suivantes :

noeud générique Un noeud générique est utilisé pour copier des ressources telles que des fichiers clientlibs .js ou .css dans le fichier zip. Il possède les caractéristiques suivantes :

Par exemple, le noeud de configuration suivant copie les fichiers geometrixx clientlibs.js dans le fichier zip :

"geometrixx.clientlibs.js": {
    "extension": "js",
    "type": "clientlib",
    "path": "/etc/designs/geometrixx/clientlibs",
    "jcr:primaryType": "nt:unstructured"
}

Le Geometrixx le modèle de configuration d’export de page vous indique comment une exportation de page peut être configurée. Pour afficher la structure de noeud du modèle dans votre navigateur au format json, demandez l’URL suivante :

http://localhost:4502/etc/contentsync/templates/geometrixx.-1.json

Mise en œuvre d’une configuration personnalisée

Comme vous l’avez peut-être remarqué dans la structure de noeud, la variable Geometrixx Le modèle de configuration d’exportation de page comporte une logo avec un noeud type définie sur image. Il s’agit d’un type de configuration spécial qui a été créé pour copier le logo de l’image dans le fichier zip. Pour répondre à certaines exigences spécifiques, vous devrez peut-être mettre en oeuvre une type property: pour ce faire, reportez-vous à la section Mise en oeuvre d’un gestionnaire de mise à jour personnalisé dans la page Synchronisation du contenu .

Exportation d’une page par programmation programmatically-exporting-a-page

Pour exporter une page par programmation, vous pouvez utiliser le service OSGi PageExporter. Ce service vous permet d’effectuer les opérations suivantes :

Le servlet lié au sélecteur export et à l’extension zip utilise le service PageExporter.

Résolution des problèmes troubleshooting

Si vous rencontrez un problème lors du téléchargement du fichier compressé, supprimez le nœud /var/contentsync du référentiel et renvoyez la demande d’exportation.