16.12 importDocuments

16.12.1 Description

Le script importDocuments permet d'importer des définitions de familles ou d'importer des documents.

Voir aussi :

• Importer des documents par ligne de commande

16.12.2 Usage

file (obligatoire)

Le fichier à importer.

Le fichier peut être au format CSV, XML ou bien une archive (si l'option --archive=yes est utilisée).

analyze (default no)

Permet d'effectuer (yes) seulement une validation du format et de la structure du fichier importé.

archive (default no)

Permet d'indiquer si le fichier est une archive (yes) ou bien un fichier d'importation texte (no).

Voir Importation d'archive pour le format de ces archives.

log

Permet de spécifier un fichier de log dans lequel seront inscrits les résultats de l'import.

policy (default update)

Permet de spécifier le comportement lorsqu'on importe un document qui existe déjà.

La détection des documents existants est spécifiée par la directive d'import KEYS.

Les valeurs possibles pour l'option policy sont :

add

Un nouveau document est créé systématiquement, même si un document existant est détecté.

keep

Si un document existant est détecté, alors le document existant est conservé en l'état, et l'importation ne crée pas un nouveau document.

update

Si un document existant est détecté, alors le document existant est mis à jour avec les données du document importé.

htmlmode (default yes)

Permet de spécifier si les messages du fichier de log doivent être inscrits au format HTML (yes) ou au format texte (no).

reset[]

Permet de spécifier les éléments qui doivent être supprimés, ou redéfinis, lors de l'importation d'une définition de famille.

Les valeurs possibles sont celles de l' instruction de RESET.

Cette option peut être utilisée plusieurs fois afin de spécifier plusieurs valeurs.

to

Permet d'envoyer le log au format HTML à l'adresse mail indiquée par cette option.

dir

Identifiant, ou nom logique, d'un répertoire Dynacase dans lequel seront insérés les documents importés.

strict (default yes)

Permet de spécifier (yes) si une erreur d'importation d'un document invalide l'importation de tous les documents. Si le mode strict est désactivé (no), alors une erreur sur un document n'empêchera pas les autres documents d'êtres importés.

csv-separator (default ;) 3.2.12

Dans le cas d'importation en fichier csv permet d'indiquer le caractère de séparation des champs. Généralement le caractère est , (virgule) ou ; (point-virgule).
Si la valeur est auto, le caractère de séparation parmi , et ; est trouvé automatiquement.

csv-enclosure (default vide) 3.2.12

Dans le cas d'importation en fichier csv permet d'indiquer le caractère de de délimiteur de texte. Généralement le caractère est " (double quote) ou ' (simple quote)
Si la valeur est auto, le caractère de séparation parmi " et ' est trouvé automatiquement.

csv-linebreak (default "\n - 2 caractères \ et n") 3.2.12

Dans le cas d'importation en fichier csv permet d'indiquer une séquence de caractère indiquant un retour chariot (CRLF). Si csv-enclosure n'est pas vide, le retour chariot (caractère "\n") est pris en compte quelque soit la valeur de cet argument. Cet argument permet en plus d'indiquer une séquence qui sera interprétée comme un retour à la ligne.

16.12.3 Limite d'usage

En cas d'importation de fichier CSV, la détection automatique de délimiteur et de séparateur (csv-enclosure=auto et csv-separator=auto) peux être erroné car la détection se base sur des statistiques d'apparition de ces caractères. Si ces paramètres sont connus, il est recommandé de les indiquer explicitement.