7.5 Exportation de documents

L'accès à l'interface d'exportation se fait depuis le centre d'administration. avec l'application Explorateur de documents.

Figure 73. Exportation de documents

Pour exporter, il faut cliquer sur le menu Outils/Exportation du dossier depuis la fenêtre d'ouverture de dossier (ou de recherche). L'accès à l'exportation est aussi disponible sur le menu contextuel affichable en cliquant sur les icônes de dossier ou de recherche présentes dans l'arborescence.

3.2.18 Les documents ayant des attributs en visibilité I sont exportés uniquement si cette interface est utilisée depuis le centre d'administration. Si l'interface est utilisée hors de ce contexte, les valeurs des attributs en visibilité I ne sont pas exportés.

7.5.1 Options d'exportation

L'exportation propose les options suivantes :

Encodage

Permet de spécifier l'encodage du fichier d'exportation.

• ISO 8859-15 : est utile pour les systèmes ne gérant pas correctement l'UTF8 (cas par exemple d'Excel sous Windows)
• UTF-8 : valeur préférée lorsque le système gère correctement cet encodage.

Lors d'une importation, l'encodage est détecté automatiquement et ces 2 encodages sont supportés.

Profil

Permet d'exporter les profils associés aux documents.

Si des profils sont liés à des documents, le document profil et son profilage sont aussi exportés.

Cette option est utile lorsqu'un concepteur de famille veut récupérer son paramétrage profil.

3.2.21 Une option supplémentaire permet de récupérer les droits avec les références aux comptes (utilisation de :useAccount) ou avec les références aux documents (utilisation de :useDocument)

Fichiers

Permet d'exporter également les fichiers attachés aux documents.

• sans les fichiers : indique que seul le fichier csv contenant les valeurs des attributs sera exporté. Les fichiers liés aux attributs de type file ou image ne sont pas exportés.

• avec les fichiers : indique que l'exportation doit générer un fichier archive de type Zip. Cette archive contiendra

  • le fichier fdl.csv, contenant les valeurs des attributs
  • les fichiers attachées aux documents exportés.

  Cette archive peut être réimporté à au moyen de l'importation d'archive.

  Pour des raisons de compatibilité avec les différents systèmes d'exploitations les noms des fichiers exportés ne comportent pas d'accents.

Identificateur

Permet de sauvegarder les identificateurs systèmes numériques des documents.

• Avec les identificateurs : Cela implique que votre fichier n'est ré-importable que dans la même base. En contrepartie, les documents sont identifiés de manière non ambiguë dans l'objectif d'une restauration.
• Sans les identificateurs : permet de réimporter les documents dans n'importe quelle base. Cela implique que lors d'une réimportation dans la même base, la mise à jour des documents existants n'est pas garantie (voir pour cela la notion de Clés d'importation).

Dans tous les cas, si les documents comportent des noms logiques (propriété name), ces noms sont exportés à la place des identifiants systèmes.

Choisir les colonnes

Permet de n'exporter que certains attributs du documents.

Chaque administrateur peut définir et sauvegarder les attributs qu'il veut exporter pour chaque famille.

L'interface de choix des colonnes est présentée lorsqu'une famille est sélectionnée. Une fois le choix sélectionné et sauvegardé alors seuls les attributs choisis seront exportés. Le choix "Ne pas tenir compte des préférences" permet d'exporter l'ensemble des attributs.

Format

Voir le chapitre suivant

Délimiteur de texte 3.2.17

Permet de configurer le format du CSV produit (uniquement dans le cas d'un format non XML)

Ce paramètre permet de définir le délimiteur de cellule (enclosure) du CSV produit. Le défaut de Dynacase est Aucun délimiteur (chaîne vide), le standard du CSV est ".

Séparateur de cellule 3.2.17

Permet de configurer le format du CSV produit (uniquement dans le cas d'un format non XML)

Ce paramètre permet de définir le séparateur de cellule du CSV produit. Le défaut de Dynacase est ;, le standard CSV est ,.

Attention : A chaque utilisation de l'exportation de documents, le délimiteur de texte et le séparateur de cellule utilisés sont sauvés automatiquement pour l'utilisateur en cours et utilisés pour les exportations suivantes.

7.5.2 Différents formats d'exportation

7.5.2.1 Données réimportables

Le fichier produit est réimportable. Son format dépend de l'option Fichiers :

• Si l'option Sans les fichiers est choisie, le fichier produit est un fichier csv conforme au format d'importation CSV.

  Exemple de fichier csv produit : (ici avec l'option avec les identificateurs)

  //FAM	animal(ZOO_ANIMAL)	Identifiant	Dossier	nom	espèce	classe
  ORDER	ZOO_ANIMAL			an_nom	an_espece	an_classe
  DOC	ZOO_ANIMAL	aliRotor		Rotor	ZOO_ESP_ALLI	Reptilia
  DOC	ZOO_ANIMAL	2079		Théodor	ZOO_ESP_ALLI	Reptilia
  DOC	ZOO_ANIMAL	2080		Éléonore	ZOO_ESP_ALLI	Reptilia

• Si l'option avec les fichiers est choisie, le fichier produit est une archive de type zip conforme au format d'importation d'archive

7.5.2.2 Données brutes

Le fichier produit est un fichier csv. ce fichier n'est pas réimportable. Il ne contient que les valeurs brutes d'attributs.

Pour les relations c'est le nom logique qui est exporté s'il existe, sinon c'est l'identifiant système.

La première ligne contient les libellés des attributs exportés. Ces libellés peuvent différer d'une locale à une autre si des traductions ont été enregistrées. Dans ce cas, ce sont les libellés correspondant à la locale de l'utilisateur qui a fait l'exportation.

7.5.2.3 Données formatées

Le fichier produit est un fichier csv. Ce fichier n'est pas réimportable. Il ne contient que les valeurs formatées d'attributs :

• Les relations sont remplacées par le titre du document cible à la place de son identifiant,
• Les énumérés sont remplacés par leur libellé à la place de la clé.
• Les attribut de type money sont affichés avec séparation des milliers.

À la différence des données brutes, l'espèce contient le titre et non l'identifiant. De même, les énumérés contiendront le libellé et non la clefs. La valeur formatée exportée est celle rendue sur les interfaces web à l'exception des hyperliens. Les éventuelles formats d'affichages sont pris en compte comme par exemple double("%.03f %%") qui donnera 2.000 % au lieu de 2.

La première ligne contient les libellés des attributs exportés.

7.5.2.4 Données XML Zip

Chaque document est enregistré dans un fichier XML. Ces fichiers sont insérés dans un fichier d'archive Zip.

7.5.2.5 Données XML simple

Tous les documents sont enregistrés dans un seul et même fichier XML.

7.5.3 Exportations et révisions

Les documents révisés peuvent faire partie du résultat de l'exportation si la recherche spécifie l'option "toutes les révisions".

Si un document révisé (document figé) à un nom logique, il ne sera pas utilisé comme identificateur. C'est son identifiant numérique qui sera utilisé dans ce cas.

Si un document référence une révision précise d'un document (option docrev différente de "latest"), c'est son identifiant numérique qui sera utilisé même s'il possède un nom logique. Dans ce cas, un avertissement sera affiché.

La réimportation d'une exportation qui comporte des révisions va créer de nouveaux documents si les identifiants n'existent pas déjà ou mettre à jour la révision courante avec les valeurs de révisions précédentes.