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 conversion de contenu comprend :
  • 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 préparation des métadonnées comprend :
  • 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.
La conversion est appliquée aux fichiers dont les extensions sont les suivantes :
  • .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 valeurs des attributs suivants sont converties en identifiants pour les objets :
  • Les attributs @id des éléments racine
  • Les attributs @href de tous les éléments
  • Les attributs @conref et @conrefend
Les valeurs des attributs @keyref ne sont pas modifiées.
Content Importer fait appel à des identifiants d’objets existants (en commençant par 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

Content Importer ajoute les fichiers suivants au dossier de conversion :
  • 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.
Par défaut, les métadonnées suivantes sont définies dans les fichiers de métadonnées (.3sish) dans le répertoire de conversion :
Champ de métadonnéesValeurType d’importation
AuteurLe nom de l’utilisateur connecté lorsque Content Importer est utilisé.Standard
Title
Mappages DITA
La valeur de l’élément de <titre>. Si rien n’est trouvé : la valeur de l’attribut de @titre sur l’élément de <mappage>. Si rien n’est trouvé : le nom du fichier.
Rubriques DITA
Le contenu de l’élément de <titre>. Si le contenu de l’élément de <titre> contient un attribut @conref ou @conkeyref, cette valeur n’est pas résolue.
Graphiques
Le nom de fichier original de l’objet.
Standard
Version1Standard
LangueLa langue par défaut.Standard
RésolutionLa résolution par défaut (graphiques seulement).Standard
StatutL’état initial correspondant tel que défini dans Paramètres > Paramètres XML > États, 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.

Si vous interrompez l’importation pendant la phase de conversion (lorsque vous annulez l’importation par exemple), puis la redémarrez, Content Importer ne convertira que les fichiers qui ne l’avaient pas été avant l’interruption. De plus :
  • 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.