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.
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.
- le fichier
-
- 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.
nom | espèce | classe |
---|---|---|
Rotor | ZOO_ESP_ALLI | Reptilia |
Théodor | ZOO_ESP_ALLI | Reptilia |
Bouti | 2456 | Mammalia |
Germiné | 2476 | 1678 |
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
.
nom | espèce | classe |
---|---|---|
Rotor | Alligator | Reptile |
Théodor | Alligator | Reptile |
Bouti | Agouti | Mammifère |
Germiné | Caille des blés | Oiseau |
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.