Importations et exportations dans ThingWorx
Importation et exportation de données, d'entités et d'extensions
ThingWorx met à votre disposition plusieurs outils d'importation et d'exportation de données et d'entités. En fonction de votre point de départ, l'importation dans ThingWorx d'une extension contenant des données et des entités peut constituer la toute première étape. Les informations des flux, flux de valeurs, tables de données, blogs et wikis (entrées de ligne, billets de blog, pages wiki) sont considérées comme des données. Les extensions peuvent uniquement être importées. Si le menu Importer/Exporter ne peut être utilisé que par les administrateurs, les non-administrateurs peuvent quant à eux importer et exporter des données et entités manuellement. Consultez la rubrique
Exportations et importations manuelles.
Pour les importations et exportations de petite taille, vous pouvez utiliser l'option d'importation A partir d'un fichier et l'option d'exportation Vers un fichier, car vous importez ou exportez des fichiers spécifiques. Pour les importations et exportations plus volumineuses, utilisez l'option d'importation A partir de ThingworxStorage et l'option d'exportation Vers ThingworxStorage. Ces options vous permettent d'importer et d'exporter toutes les entités et données voulues de manière asynchrone depuis ou vers le dossier ThingworxStorage/exports.
 |
Les exportations peuvent contenir des informations sensibles qui doivent être correctement protégées. Chaque fois qu'une exportation système, une exportation filtrée ou une exportation d'entité unique se produit, le fichier exporté doit être chiffré et stocké dans un emplacement sensible. L'exportation ne doit pas être partagée avec des parties non approuvées, et lorsque le succès de l'importation est confirmé dans le système cible, l'exportation doit, en toute sécurité, être supprimée ou stockée dans une solution de stockage à long terme. Pour en savoir plus, consultez la rubrique
Mots de passe.
|
Pour en savoir plus sur les diverses options d'importation et d'exportation disponibles dans ThingWorx, reportez-vous aux tables ci-dessous.
Importer
L'importation d'entités précédemment exportées depuis une version plus récente de ThingWorx n'est pas prise en charge.
|
Option
|
Description
|
Formats pris en charge
|
Informations supplémentaires
|
||||
|---|---|---|---|---|---|---|---|
|
A partir d'un fichier
|
Importe un fichier unique d'entités ou de données sélectionné localement (non asynchrone) ou dans un référentiel de fichiers.
|
XML, JSON et binaire
|
• Pour les entités, si vous sélectionnez l'option Utiliser le fournisseur de persistance par défaut , les entités importées sans fournisseur de persistance valide utiliseront le fournisseur de persistance par défaut défini par le système.
• Pour les entités, si vous sélectionnez l'option Inclure les sous-systèmes, les configurations associées de sous-système seront importées avec les entités.
• Concernant les données, si l'option Ignorer les enregistrements de flux de valeurs erronés est sélectionnée, toutes les éventuelles erreurs dans les entrées de flux de valeurs sont ignorées et l'importation se poursuit sans échec.
• Pour les entités, si vous sélectionnez l'option Ecraser les valeurs de propriété, les valeurs de propriété configurées sur une entité seront remplacées par celles qui existent pour cette entité dans l'importation. Si vous ne cochez pas cette case, toutes les valeurs de propriété définies dans l'importation seront ignorées.
|
||||
|
A partir de ThingworxStorage
|
Importe de manière asynchrone les entités et les données (facultatif) contenues dans un fichier sélectionné (côté serveur) stocké dans le dossier ThingworxStorage/exports sur le serveur.
|
XML, JSON et binaire
|
• Concernant les données, si l'option Ignorer les enregistrements de flux de valeurs erronés est sélectionnée, toutes les éventuelles erreurs dans les entrées de flux de valeurs sont ignorées et l'importation se poursuit sans échec.
• Si vous sélectionnez l'option Utiliser le fournisseur de persistance par défaut , les entités importées ne possédant pas de fournisseur de persistance valide utiliseront le fournisseur de persistance par défaut défini par le système. Plus précisément,
◦ si l'entité importée possède un fournisseur de persistance valide, ThingWorx l'importera avec le fournisseur de persistance ;
◦ si l'entité importée ne possède pas de fournisseur de persistance valide, ThingWorx utilisera le fournisseur de persistance par défaut.
• Si vous sélectionnez l'option Inclure les sous-systèmes, tous les paramètres de sous-système configurés seront remplacés lors de l'importation.
• Si vous sélectionnez l'option Ecraser les organisations et permissions de la collection, les permissions de collection et les organisations du fichier d'importation remplaceront le paramétrage correspondant défini sur le serveur. Le comportement par défaut fusionne les permissions de collection et les organisations du fichier importé dans ce qui est déjà défini sur le serveur.
• Chaque fichier de données possède un fichier import.log associé créé lors de l'importation. Les mêmes données ne peuvent pas être importées tant que ce fichier n'est pas supprimé.
• Pour les entités, si vous sélectionnez l'option Ecraser les valeurs de propriété, les valeurs de propriété configurées sur une entité seront remplacées par celles qui existent pour cette entité dans l'importation. Si vous ne cochez pas cette case, toutes les valeurs de propriété définies dans l'importation seront ignorées.
|
||||
|
Entités de contrôle de source
|
Importe les entités ThingWorx contenues dans un dossier de contrôle de source dans un objet FileRepository dans ThingworxStorage ou un dossier de contrôle de source dans un objet Référentiel de contrôle de source. Pour plus d'informations sur ces référentiels, consultez la rubrique
Modèles d'objet.
|
XML
|
• Si vous sélectionnez l'option Utiliser le fournisseur de persistance par défaut, les entités importées sans fournisseur de persistance valide utiliseront le fournisseur de persistance par défaut défini par le système.
• Si vous sélectionnez l'option Inclure les sous-systèmes, les configurations associées de sous-système seront importées avec les entités.
• Si une erreur se produit, aucune entité du dossier ne sera importée. Les fichiers non reconnus à l'analyse comme des fichiers XML ou ThingWorx sont ignorés. Les erreurs sont enregistrées dans le journal de l'application.
• Pour les entités, si vous sélectionnez l'option Ecraser les valeurs de propriété, les valeurs de propriété configurées sur une entité seront remplacées par celles qui existent pour cette entité dans l'importation. Si vous ne cochez pas cette case, toutes les valeurs de propriété définies dans l'importation seront ignorées.
|
||||
|
Extension
|
Importe un fichier ZIP d'extension.
|
.zip
|
Exportation
|
Option
|
Description
|
Format
|
Informations supplémentaires
|
||
|---|---|---|---|---|---|
|
Vers un fichier - Collection d'entités
|
• Permet d'exporter de manière asynchrone les entités de collections d'entités spécifiées (clés d'application, tableaux de bord, applications composites, entités de média, etc.) au moyen de tags de modèle, par projet, ou sur la base d'une date (compte tenu de l'horodatage de la dernière modification du fichier).
• Lorsqu'aucun référentiel n'est spécifié, les entités sont exportées localement.
|
Binaire et XML
|
• Lorsqu'aucun référentiel de fichiers n'est spécifié, un dossier nommé FileRespository est automatiquement créé à l'emplacement suivant : ThingworxStorage\repository\FileRepository.
• Lorsque l'option Exporter les tags de modèle correspondants est sélectionnée, seules les entités contenant tous les tags spécifiés dans le champ Tags sont exportées. Lorsque l'option Exporter les tags de modèle correspondants n'est pas sélectionnée, les entités contenant l'un des tags spécifiés dans le champ Tags sont exportées.
|
||
|
Vers un fichier - Collection de données
|
• Permet d'exporter de manière asynchrone les données de collections spécifiées (blogs, tables de données, flux, flux de valeurs ou wikis) au moyen de tags de modèle ou sur la base d'une date (compte tenu de l'horodatage de l'enregistrement des données).
|
Binaire
|
• Lorsqu'aucun référentiel n'est spécifié, un dossier nommé FileRespository est automatiquement créé à l'emplacement suivant : ThingworxStorage\repository\FileRepository.
• Lorsque l'option Exporter les tags de modèle correspondants est sélectionnée, seules les entités contenant tous les tags spécifiés dans le champ Tags sont exportées. Lorsque l'option Exporter les tags de modèle correspondants n'est pas sélectionnée, les entités contenant l'un des tags spécifiés dans le champ Tags sont exportées.
|
||
|
Vers un fichier - Entité unique
|
Permet d'exporter une entité unique vers une destination locale sélectionnée (synchrone).
|
Binaire ou XML
|
Lorsqu'aucun référentiel n'est spécifié, l'entité est téléchargée localement.
|
||
|
Vers un fichier - Donnée unique
|
Permet d'exporter une donnée unique vers une destination locale sélectionnée (synchrone).
|
Binaire
|
• Lorsque l'option Exporter les tags de modèle correspondants est sélectionnée, seules les entités contenant tous les tags spécifiés dans le champ Tags sont exportées. Lorsque l'option Exporter les tags de modèle correspondants n'est pas sélectionnée, les entités contenant l'un des tags spécifiés dans le champ Tags sont exportées.
|
||
|
Vers ThingworxStorage
|
Exporte de manière asynchrone toutes les entités et données (facultatif) sur le serveur (dans le dossier ThingworxStorage/exports).
|
Binaire
|
• Il n'y a pas de limite de taille pour les exportations vers le dossier ThingworxStorage.
• L'exportation est divisée en dossiers par date, type d'entités/de données et nom de type de données. Par exemple, C:\ThingworxStorage\exports\20150625140545\Blogs\AcmeVendingEquiptmentBlog\data-0.twx
• La taille des fichiers exportés peut être configurée dans le
sous-système de traitement des exportations et importations.
• Un fichier de somme de contrôle (chk) est ajouté pour chaque fichier de données et d'entités.
|
||
|
Entités de contrôle de source
|
Permet d'exporter des entités ThingWorx sur la base de collections, tags de modèle ou dates de début et de fin spécifiés. Les entités spécifiées peuvent être dirigées vers un objet FileRepository ou SourceControlRepository. Lorsque les entités sont exportées, une structure de fichiers est créée sur la destination, prenant en compte la façon dont un système de contrôle de source gère ses artefacts. Si vous souhaitez déplacer ou copier les fichiers exportés vers un autre emplacement, vous pouvez exporter la structure de fichiers sous la forme d'un fichier ZIP.
|
XML
|
• Les options suivantes sont disponibles pour la spécification des entités à exporter :
◦ Collections : Tout, Clés d'application, Tableaux de bord, Formes de données, Tags de données, Services d'annuaire, Packages d'extension, Tables de localisation, Journaux, Applications composites, Médias, Menus, Tags de modèle, Réseaux, Organisations, Fournisseurs de persistance, Projets, Ressources, Bibliothèques de fonctions de script, Définitions d'état, Définitions de style, Sous-systèmes, Packages d'objet, Objets, Formes d'objet, Modèles d'objet, Utilisateurs, Groupes d'utilisateurs.
◦ Projet : spécifiez le projet à prendre en compte pour l'exportation. Lors de l'exportation, toutes les entités auxquelles le projet sélectionné est appliqué seront exportées.
◦ Tags : utilisez le sélecteur magique pour exporter sur la base de tags de modèle spécifiés.
◦ Date de début : spécifiez une date de début pour limiter le volume d'entités exportées en fonction de l'horodatage enregistré de vos entités. Cette option exporte les entités dont l'horodatage est postérieur à la date de début spécifiée.
◦ Date de fin : spécifiez une date de fin pour limiter le volume d'entités exportées en fonction de l'horodatage enregistré de vos entités. Cette option exporte les entités dont l'horodatage est antérieur à la date de fin spécifiée. Lorsqu'aucune date de fin n'est spécifiée, la date et l'heure actuelles sont utilisées.
◦ Référentiel : spécifiez un référentiel pour l'exportation.
◦ Chemin : spécifiez l'emplacement de votre exportation.
◦ Exporter vers un fichier Zip : stocke les entités exportées dans un dossier Zip à l'emplacement spécifié. Un nom de fichier doit être fourni.
|
||
|
Exportation depuis le menu Plus
|
XML
|
 |
|||
|
Exportation universelle
|
Cette option est utile lors de la migration des données d'un système vers un autre, lorsque chaque système utilise des clés de chiffrement uniques. Par exemple, il est utile lors de la migration d'un système de pré-production vers un système de production. Dans ce cas, les informations sensibles chiffrées, telles que les propriétés du type de base PASSWORD, exportées à partir d'un système ne peuvent pas être importées dans l'autre système.
Uniquement disponible pour les administrateurs et destinée à l'exportation d'entités, cette option permet d'exporter des entités à partir d'un serveur ThingWorx pour une importation ultérieure sur un autre serveur. Notez que les données associées aux entités NE sont PAS exportées avec celles-ci.
|
Binaire ou XML
|
Cette option est disponible dans l'interface utilisateur d'exportation lorsque les conditions suivantes sont remplies :
• Option d'exportation est défini sur "Vers un fichier" or "Vers ThingworxStorage".
• Type d'exportation est défini sur "Collection d'entités" ou "Entité unique".
• L'utilisateur est membre du groupe Administrateur.
Si un utilisateur non-administrateur appelle le répertoire de service Export avec l'option universelle activée, le serveur empêchera l'utilisateur d'effectuer l'exportation.
|
