Configurations des entêtes des gabarits d'importation
- 05 Jul 2022
- 2 Minutes à lire
- Contributeurs
- Impression
- SombreClair
- PDF
Configurations des entêtes des gabarits d'importation
- Mis à jour le 05 Jul 2022
- 2 Minutes à lire
- Contributeurs
- Impression
- SombreClair
- PDF
Résumé de l’article
Avez-vous trouvé ce résumé utile ?
Merci pour vos commentaires
1. Configurations des entêtes des gabarits d'importation
Chaque colonne de l'entête d'un gabarit d'importation correspond à une métadonnée du schéma à importer. Chaque colonne doit donc nécessairement débuter par le code de la métadonnée à importer. D'autres paramètres doivent ensuite être ajoutés à l'entête pour spécifier des informations supplémentaires sur la métadonnée ou sur les valeurs à importer, tout dépendant de la métadonnée en question. Ces paramètres additionnels doivent être ajoutés dans la même cellule, sur une nouvelle ligne (Shift+Enter pour insérer une nouvelle ligne).
2. Options de métadonnées
| Mot-clé | Type de métadonnée | Obligatoire? | Description | Exemple d'utilisation |
| pattern | Référence | Non | Correspond à la métadonnée du schéma référencé à utiliser pour effectuer la liaison. Par exemple, pour lier un dossier à son parent en utilisant la métadonnée « Code », on écrirait pattern=code dans l'entête de la colonne. Si « pattern » n'est pas spécifiée, le legacyld (ancien identifiant) est utilisé par défaut. | parent pattern=code |
| pattern | Date ou Date-heure | Oui | Permet de définir le format de date à utiliser pour les métadonnées de type date ou date-heure. | actualTransfertDate type=date pattern=yyyy-MM-dd |
| type | Date ou Date-heure | Oui | Permet de définir le type de date à importer. Valeurs possibles :
| modifiedOn type=datetime pattern=yyyy-MM-dd HH:mm:ss |
| separator | Métadonnées multivaleurs | Oui | Permet de définir le caractère à utiliser pour séparer les valeurs à importer dans une métadonnée multivaleur. | keywords separator=; |
3. Autres options d'importation
| Mot-clé | Métadonnée | Description | Exemple d'utilisation |
|---|---|---|---|
| importAsLegacyId | id | Permet d'utiliser l'ID généré dans Constellio au lieu de l'ancien identifiant lors de l'importation. (Pour mettre à jour des enregistrements existants qui n'ont pas été créés par importation.) | id importAsLegacyId=false |
| useTitleAsFilename | title | Permet de mettre à jour le titre du contenu d'un document lorsqu'on modifie le titre d'un document existant par gabarit d'importation. | title useTitleAsFilename=true |
| keepExtraWhitespace | Métadonnées texte ou chaine de caractère | Permet de conserver les caractères d'espacement (saut de ligne, tabulation, etc.) dans les valeurs importées. Par défaut, ces caractères sont tronqués automatiquement. | description keepExtraWhitespace=true |
| cellRange[ ] | Valeurs | Permet d'importer une plage de valeurs au lieu du contenu de la cellule. La séquence de caractères insérée dans les crochets doit correspondre à une plage de valeur Excel qui est valide, soit dans la même page ou dans une page différente. Le contenu des cellules référencées sera concaténé avant d'être importé comme valeur pour la cellule en question. ATTENTION : ce mot-clé est utilisé dans les valeurs plutôt que dans l'entête d'une colonne. | cellRange[B1:E1] |
| # | Schéma | Permet de définir une page du chiffrier Excel qui ne doit pas être considéré dans l'importation. ATTENTION : Ce symbole est utilisé dans le nom de la page plutôt que dans l'entête d'une colonne. | #Feuille1 |
4. Importation de structures
Pour importer les métadonnées de type « Structure », le mot-clé « structure » doit être ajouté à l'entête, puis importer chaque métadonnée de la structure dans sa propre colonne. Les différents éléments de la structure sont dénotés par le mot-clé « item ».
| Mot-clé | Description | Utilisation |
|---|---|---|
| Structure | Permet d'indiquer que l'élément à importer fait partie d'une métadonnée Structure. | structure=copyRetentionRules |
| Item | Permet d'indiquer à quel élément de la structure la métadonnée appartient. | item=1 |
| multiline | Permet de créer des sous-structures sur plusieurs lignes. | multiline=true |
4.1 Exemple
4.1.1 Structure XML
| XML |
|---|
<copyRetentionRules multivalue="true" type="structure"> <item copyType = "P" code="P" title="Principal" description="" mediumTypes="DM" activeRetentionPeriod="2"/> <item copyType = "S" code="S" title="Secondaire" description="" mediumTypes="DM" activeRetentionPeriod="2"/></copyRetentionRules> |
4.1.2 Structure gabarit d'importation XML
| copyType structure=copyRetentionRules item=1 | code structure=copyRetentionRules item=1 | title structure=copyRetentionRules item=1 | description structure=copyRetentionRules item=1 | mediumTypes structure=copyRetentionsRules item=1 separator=; pattern=code | activeRetentionPeriod structure=copyRetentionRules item=1 |
|---|---|---|---|---|---|
| P | P | Principal | DM | 2 | |
| copyType structure=copyRetentionRules item=2 | code structure=copyRetentionRules item=2 | title structure=copyRetentionRules item=2 | description structure=copyRetentionRules item=2 | mediumTypes structure=copyRetentionRules item=2 separator=; pattern=code | activeRetentionPeriod structure=copyRetentionRules item=2 |
| S | S | Secondaire | DM | 2 |
Cet article vous a-t-il été utile ?