Phase de conversion
Avant l’importation réelle, les données sources sont validées et préparées : il s’agit de la phase de conversion.
Opérations de conversion
L’objectif de la phase de conversion est de convertir le contenu (par défaut, seul le contenu DITA est converti) et de générer ou préparer des métadonnées.
- La validation du contenu DITA par rapport aux DTD de Content Manager.
- Création du fichier filemap.xml, utilisé pour le mappage dans l’élément suivant.
- Remplacement des chemins d’accès aux fichiers par des identifiants dans des liens internes.
- La génération des conditions de Content Manager (
ishcondition). - La conversion des types de documents, par exemple de
//OASIS//à//RWS//.
- La génération d’identifiants pour les objets.
- La création de fichiers
.3sish. - L’exécution de Post-XSL. Le fichier ContentImporter.xsl est fourni comme exemple de fichier XSL.
- .dita
- .ditamap
.xml
Content Importer ignore les fichiers portant d’autres extensions de fichier, à l’exception des images. Des métadonnées sont préparées pour les images dont les extensions de fichier sont définies selon un mappage de résolution configurée par l’interface utilisateur.
Type d’importation
Le contenu n’est converti que dans les importations standard.
Les métadonnées ne sont modifiées que dans les importations standard et de traduction. Le traitement post-XSL n’est exécuté que dans les importations standard.
Validation
Les mappages et les rubriques DITA sont validés par rapport aux DTD de Content Manager. Ils sont localisés à l’aide du fichier catalog.xml qui se trouve sur le serveur de Content Manager.
Génération d’identifiants
- Les attributs
@iddes éléments racine - Les attributs
@hrefde tous les éléments - Les attributs
@conrefet@conrefend
@keyref ne sont pas modifiées.
GUID), ou des identifiants fournis par l’utilisateur, s’ils sont présents dans l’un des éléments suivants :
- Un fichier .3sish (ou un fichier .met existant, mais .3sish est préférable).
- Le nom de fichier de l’objet à importer.
- Un fichier filemap.xml existant s’il est ajouté manuellement par l’utilisateur au contenu source (ce qui est possible, mais non recommandé).
Génération de conditions Content Manager
Les attributs de traitement conditionnel DITA et leurs valeurs sont convertis en conditions Content Manager. Par exemple, otherprops="screen_shots" est converti en ishcondition="otherprops=screen_shots".
Génération de fichiers
- Fichiers .3sish stockant les métadonnées.
- filemap.xml stocke l’information de mappage avec des chemins d’accès aux fichiers vers des objets dans le Repository (différent du filemap.xml qu’un utilisateur peut fournir en tant qu’entrée).
- importer.statut, stockage de l’information sur le statut de la conversion ou de l’importation de métadonnées et de fichiers de contenu.
- Fichiers journaux d’essai : un fichier Import Report.log est créé. Par défaut, il se voit attribuer dans son nom une balise de date une fois la taille maximale atteinte, et un autre fichier est créé. Le fichier le plus ancien est supprimé lorsque le nombre de fichiers atteint le maximum permis. Le comportement et les niveaux maximums sont définis dans la configuration
NLog.
| Champ de métadonnées | Valeur | Type d’importation |
|---|---|---|
| Auteur | Le nom de l’utilisateur connecté lorsque Content Importer est utilisé. | Standard |
| Title |
| Standard |
| Version | 1 | Standard |
| Langue | La langue par défaut. | Standard |
| Résolution | La résolution par défaut (graphiques seulement). | Standard |
| Statut | L’état initial correspondant tel que défini dans , dans la plupart des cas Ébauche. | Standard |
| Statut | État figurant dans le champ État de la traduction après l’importation. Cette valeur, si elle est précisée, écrase la valeur existante. | Traduction |
S’il y a des fichiers de métadonnées (.3sish ou .met) dans le répertoire source, les métadonnées sont copiées dans les fichiers de métadonnées correspondants (.3sish) du répertoire de conversion.
Les fichiers .3sish qui se trouvent dans le répertoire de conversion ont été modifiés par le fichier de traitement post-XSL personnalisé, le cas échéant.
Reprise et redémarrage
Vous pouvez mettre en pause la phase de conversion et la reprendre plus tard. Cette dernière reprendra et poursuivra les opérations restantes.
- Les fichiers ajoutés sont convertis.
- Les fichiers modifiés sont convertis.
- Les fichiers retirés du dossier source sont également supprimés des fichiers convertis.
Si un fichier filemap.xml est fourni par l’utilisateur dans le dossier source, ou si les paramètres d’importation sont modifiés après l’interruption, tous les fichiers seront reconvertis, qu’ils aient été convertis ou non auparavant.