Règles d'importation et d'exportation XML SOLIDWORKS PDM

SOLIDWORKS PDM La version professionnelle est remplie de fonctionnalités conçues pour simplifier la documentation et la saisie de données. Cependant, peu d'outils sont efficaces sans une compréhension, une configuration et une mise en œuvre adéquates. C'est pourquoi cet article aborde l'objectif, la configuration et le dépannage des règles d'import/export XML dans PDM.

Quelles sont les règles d'importation/exportation XML et à quoi servent-elles ?

Avant d'aborder le sujet, il est important de comprendre les principes de l'import/export XML. Les règles d'importation et d'exportation XML de SOLIDWORKS PDM Professional sont une fonctionnalité conçue pour automatiser le transfert de données entre le système SOLIDWORKS PDM et les systèmes externes.

Exporter: Comme son nom l'indique, les règles d'exportation permettent de générer automatiquement des fichiers XML contenant des données, notamment des nomenclatures (BOM), destinées à être utilisées en dehors de votre système SOLIDWORKS PDM. Ces fichiers XML peuvent ensuite être lus par d'autres systèmes, tels que les systèmes de planification des ressources de l'entreprise (ERP) ou de gestion du cycle de vie des produits (PLM).

ImportationParallèlement, les règles d'importation permettent d'importer des données, via des valeurs de variables, à associer à des fichiers spécifiques de votre coffre-fort SOLIDWORKS PDM à partir de fichiers XML.

Vous vous demandez peut-être encore en quoi c'est utile. Comme mentionné précédemment, la « synchronisation » manuelle de ces données implique souvent une saisie manuelle, source d'erreurs humaines ou de ralentissements lors des opérations d'import/export. Si une connexion logicielle directe entre les deux systèmes est impossible, l'échange de « notes » (fichiers XML) constitue la meilleure solution.

Exemples de cas d'utilisation

Il est facile de dire : « Vous pouvez utiliser des règles d’importation et d’exportation pour transférer des données XML vers et depuis PDM », mais cela ne permet pas de saisir pleinement l’intérêt de cette fonctionnalité. Pour y remédier, voici deux des scénarios les plus courants que nous rencontrons avec les règles XML. Nous les examinerons plus en détail lors de la configuration.

Scénario 1

Exportations - Envoi des données de pièces ou d'assemblages aux systèmes ERP une fois la conception finalisée.

• Les systèmes ERP nécessitent souvent des données détaillées sur les assemblages ou les pièces. Il peut donc être nécessaire, dans votre flux de travail, d'extraire les propriétés et les données d'une pièce ou d'un assemblage après validation et de les transmettre à l'ERP sous forme de fichier XML. Cette exportation peut être déclenchée par des actions de transition.

Scénario 2

Importations - Migration de fichiers vers PDM

• Supposons que vous ayez des fichiers créés en dehors de votre système PDM et dont les fiches de données sont incomplètes. Si ces données étaient suivies ailleurs et pouvaient être reformatées dans un fichier XML approprié, elles pourraient être importées dans PDM via une règle XML, et les valeurs des fiches de données seraient automatiquement mises à jour lors de leur prochaine modification.

Création de la règle

Après avoir décidé comment vous allez utiliser les règles d'importation/exportation XML, la question suivante est : comment les configurer ?

Ouvrez l'outil d'administration PDM et développez Exportation/Importation de données. Faites un clic droit sur l'un des deux éléments suivants : Règles d'exportation ou Règles d'importation > Nouvelle règle d'exportation/importation.

Champs des règles d'importation

Nom de la règle

Fréquence de vérification du dossier d'importation: Définissez la fréquence (en minutes) à laquelle le système analysera le dossier désigné à la recherche de nouveaux fichiers à importer dans le système.

• Un réglage trop fréquent peut ralentir votre système. Nous recommandons généralement des intervalles de 5 à 10 minutes.

Importer à partir d'un dossier : Le dossier où seront stockés les fichiers à importer. Il s'agit généralement d'un dossier situé à l'extérieur du coffre-fort. Vous pouvez coller un chemin d'accès directement dans le champ ou utiliser le bouton « … » pour sélectionner l'emplacement de votre choix.

• Il doit s'agir d'un emplacement accessible par le compte exécutant le service de serveur de base de données PDM (et non le service SQL). Un accès complet en lecture/écriture sera nécessaire.
• Si vous utilisez un emplacement réseau, utilisez les chemins UNC plutôt qu'un « lecteur réseau mappé ».

Ensemble d'alias de variables : Si vous avez créé des ensembles d'alias de variables, c'est ici que vous les sélectionnerez (nous les expliquerons plus loin). Si vos données importées ont les mêmes étiquettes/en-têtes, vous pouvez sauter cette étape et privilégier… N'utilisez pas d'alias.

Champs des règles d'exportation

Nom de la règle

Fichiers XML de sortie dans le dossierDossier de destination des fichiers créés par la règle d'exportation. Ce dossier se trouve généralement à l'extérieur du coffre-fort. Vous pouvez entrer un chemin directement dans le champ ou utiliser le bouton « … » pour sélectionner l'emplacement de votre choix.

• Il doit s'agir d'un emplacement accessible par le compte exécutant le service de serveur de base de données PDM (et non le service SQL). Un accès complet en lecture/écriture sera nécessaire.
• RemarqueSi vous utilisez un emplacement réseau, utilisez des chemins UNC plutôt qu'un « lecteur réseau mappé ».

Nom du fichier XML de sortieVous pouvez utiliser du texte statique et/ou des variables dynamiques (à l'aide du bouton >) en fonction du fichier source pour créer un nom unique pour chaque fichier.

• Si un fichier portant le même nom existe déjà, le système ajoutera automatiquement un compteur à la fin du nom afin de garantir des valeurs uniques.
• N’incluez pas l’extension .XML dans le fichier de sortie. Le système l'ajoute automatiquement.

Type de données à exporter :

• Nomenclature CAOGénère un fichier XML pour les fichiers de dessin ou d'assemblage contenant une nomenclature CAO.
  • C'est la mise en page de la nomenclature, et non la règle d'exportation, qui détermine les variables, les configurations et les références à inclure ou à exclure dans les données XML.
  • Votre transition de flux de travail devrait utiliser Exécuter pour les fichiers option dans l'action pour déclencher correctement cela.

• Nomenclature calculéeExporte les données de la nomenclature calculée. Génère un fichier XML pour tous les fichiers, à condition qu'une nomenclature soit définie.
  • Votre transition de flux de travail devrait utiliser Exécuter pour les fichiers option dans l'action pour déclencher correctement cela.
  • Pour exporter les listes de découpe ou les nomenclatures d'articles, sélectionnez Nomenclature calculée comme type, puis sélectionnez un modèle de nomenclature calculée configuré pour inclure des listes de découpe ou des éléments dans le Nomenclature à exporter menu déroulant ci-dessous.

• Nommé BOMExporte les nomenclatures nommées. Comme pour les nomenclatures CAO, les variables sont définies par la disposition du modèle de nomenclature et non par la règle elle-même.
  • Votre transition de flux de travail devrait utiliser Exécuter pour les nomenclatures nommées option dans l'action pour déclencher correctement cela.

• Exporter la nomenclature au format tableauCette option formate la sortie dans une structure de tableau plate correspondant à la nomenclature affichée dans l'interface utilisateur. Si elle n'est pas cochée, les données sont formatées hiérarchiquement, comme un arbre d'assemblage.
  • Les nomenclatures CAO et nommées sont toujours formatées sous forme de tableaux et ne peuvent pas être modifiées.

• Exporter uniquement les nomenclatures activéesL'exportation ne s'exécutera que si une nomenclature CAO ou calculée est marquée comme « activée ».

(Ces trois onglets ne sont disponibles que lorsque vous sélectionnez « BOMS calculés ».)

Onglet Variables

• Nomenclature à exporter : choisissez le modèle de nomenclature que vous voulez utiliser. Ces modèles sont créés dans le nœud « Nomenclatures » de l’outil d’administration.
• Variable d'identification de fichier : valeur unique pour identifier un fichier. Il est généralement préférable d'utiliser la valeur par défaut. SOLIDWORKS PDM ID de fichier, cependant Numéro de document, Nom du fichier, etc., fonctionnent bien aussi.
• Ensemble d'alias à utiliser dans le fichier XML : si les données générées nécessitent une traduction des étiquettes/en-têtes de données, sélectionnez l'ensemble d'alias approprié.

Onglet ConfigurationsCela vous permet de choisir les configurations que vous souhaitez inclure dans l'exportation.

Onglet Référence de fichierCela vous permet de choisir le type et les versions des références que vous souhaitez inclure.

Ensembles d'alias de variables

Si votre ERP ou autre système exige des noms de champs spécifiques pour les valeurs que vous avez mappées sur votre fiche de données, mais que le nom de la variable et le nom du champ ne correspondent pas, vous pouvez utiliser un ensemble d'alias pour modifier le nom dans le fichier XML exporté afin qu'il corresponde. Vous pouvez mapper des variables spécifiques dans PDM à leur nom de champ équivalent dans le système destinataire en sélectionnant les variables à gauche, puis en entrant leur alias à droite.

Les ensembles d'alias ne sont pas obligatoires, et si aucun n'est choisi, le système exporte simplement les noms de variables tels quels.

Règles de déclenchement d'importation/exportation

Une fois les règles définies, nous devrons choisir la transition qui les déclenche. Une fois ce choix fait :

1. De la part de Administration PDM Dans l'outil, développez les flux de travail et double-cliquez pour modifier le flux de travail souhaité.
2. Cliquez sur la transition pendant laquelle vous souhaitez qu'une règle XML s'exécute.
3. Allez à Actes onglet > Ajouter Action.
   
   
   
   
4. Sélectionner Exporter les données au format XML ou Importer des données à partir d'un fichier XML de la Type dérouler.
   1. Pour Exporter les données au format XML, Sélectionnez la règle d'exportation.
   2. Pour Importer des données au format XML, Sélectionnez le nom du fichier à importer.
      1. RemarqueSauf raison particulière de spécifier un nom de fichier précis (par exemple, pour appeler des données provenant de différents fichiers pour différentes transitions), vous pouvez laisser cette valeur générique ; sa valeur par défaut est : *
         
         
         
         
         

Finalement, nos règles étant établies et leurs actions mises en place, nous devrions pouvoir récolter les fruits de notre travail. Nos attentes concernant la règle d'exportation sont légèrement moins complexes que celles concernant la règle d'importation. Si tout fonctionne correctement, l'exportation XML est déclenchée par la transition de fichier, et le fichier XML est placé dans le dossier prévu, avec le nom et les informations attendus.

Lors de l'exécution de l'importation, les étapes sont toutefois un peu plus complexes. Tout d'abord, le fichier XML formaté est placé dans le dossier prévu pour traitement. Généralement, le service du serveur de base de données récupère le fichier en moins de 60 secondes. Il charge ensuite les données du fichier XML dans la base de données et attend d'être sollicité. Lorsque la pièce, l'assemblage ou le dessin est transféré vers la zone cible, le processus se déroule comme prévu. Importer des données à partir d'un fichier XML Cette action déclenche l'écriture des données importées dans l'enregistrement de la base de données correspondant à ce fichier ou à ces fichiers.

Formatage XML pour les importations

L'exemple ci-dessus illustre comment ces données peuvent être appliquées aux fichiers de modèle/dessin, mais l'importation n'est pas la seule fonction possible. Dans ce cas, le formatage du fichier XML détermine son utilisation.

Vous pouvez consulter une liste des exemples de fichiers d'importation et leurs formats dans le dossier SWPDMClient/Support/ERP des fichiers d'installation sous « …\SOLIDWORKS Downloads\SOLIDWORKS 20XX SPXX\SWPDMClient\Support\ERP ».

SOLIDWORKS fournit également un ensemble de règles générales pour nous aider à comprendre ces exemples de fichiers XML.

• L'encodage spécifié dans l'en-tête XML doit correspondre à l'encodage dans lequel le fichier est enregistré.
• Dans chaque fichier XML, tous les identifiants doivent être uniques (par type) (c'est-à-dire que deux fichiers ne peuvent pas partager le même identifiant) ; cependant, les fichiers et les dossiers peuvent partager le même identifiant car ils ne sont pas du même type.
• Tous les identifiants doivent être supérieurs à 0. Toutes les valeurs supérieures ou égales à 1 sont valides, sauf 0 (zéro).
• Les valeurs des attributs sont considérées comme du texte et doivent être placées entre guillemets doubles (c'est-à-dire que les attributs alphanumériques doivent être entre guillemets doubles) : id = a devrait être id = « un », id= 3 devrait être id = « 3 »).
• Certains caractères spéciaux sont réservés au format XML (aussi appelé caractères réservés XML) et ne peuvent pas être utilisés. Il s'agit notamment des éléments suivants (en gras) : < > & ‘ “Ils peuvent encore être utilisés en les remplaçant par le substitut approprié :
  • < devient <
  • > devient >
  • & devient &
  • « devient &apos
  • « devient "

• Le fichier XML devrait comprendre une déclaration DTD. Celui-ci permet de déclarer le type du fichier, d'où le terme « DTD » (Document Type Declaration). Cette déclaration se trouve généralement sur la première ou la deuxième ligne du fichier XML, à l'aide de l'appel DOCTYPE.
  
  

Dépannage

Voici quelques-uns des problèmes les plus courants que vous pouvez rencontrer lors de l'utilisation des règles d'importation/exportation, ainsi que les mesures que vous pouvez prendre pour les résoudre.

Les importations échouent

À quoi ça ressemble?Une fois importés, les fichiers devraient disparaître du dossier d'importation. S'ils y restent après l'intervalle d'interrogation défini, il se peut que la règle ne fonctionne pas.

Étapes à suivre :

1. Vérifiez-le Serveur de base de données SOLIDWORKS PDM Le service est en cours d'exécution.
2. Vérifiez-le Serveur de base de données PDM Le service a accès au dossier d'importation.
   1. Si le dossier d'importation se trouve sur un emplacement réseau, essayez de le déplacer vers un emplacement sur le serveur exécutant le Serveur de base de données PDM Utilisez plutôt ce service. Assurez-vous de modifier la règle d'importation pour qu'elle tienne compte du nouvel emplacement.
   2. Si un emplacement réseau est nécessaire, veuillez utiliser un chemin UNC plutôt qu'un lecteur réseau mappé.
3. Vérifiez que les fichiers XML ne sont pas en lecture seule.
4. Assurez-vous que le compte de connexion pour le Serveur de base de données PDM Ce service a accès en lecture et en écriture au dossier cible.
5. Consultez les journaux de l'Observateur d'événements sur le serveur hébergeant le service de base de données pour rechercher les erreurs associées.Observateur d'événements > Journaux Windows > Candidature).
6. Vérifiez que le fichier XML est correctement formaté.

Noms de fichiers XML : valeurs de variables manquantes

À quoi ça ressemble? Exporter les fichiers sous forme de :

• .XML, 001.XML, 002.XML, etc.
• Nom du fichier de sortie défini sur [variable1]-[variable2][counter].XML.
• Certains fichiers semblent être nommés correctement, d'autres apparaissent sous le nom « variable1-counter.XML ».

Étapes à suivre :

• Vérifiez-le Nom du fichier XML de sortie.
  • Le problème peut venir du fait que le nom de la sortie est défini sur quelque chose comme [variable][counter].XML.
  • Dans ce cas, ces fichiers ne contiennent pas de valeur pour la variable utilisée dans le nom, donc seul le compteur est exporté.
  • Il est aussi possible que le champ variable n'existe pas dans tous les fichiers.

Les caractères spéciaux ne sont pas reconnus lors de l'importation de fichiers XML.

À quoi ça ressemble? Les noms de fichiers et les variables contenant des caractères spéciaux peuvent s'afficher incorrectement ou ne pas s'afficher du tout.

Cela peut être dû à un encodage incorrect (par exemple, UTF-8) dans l'en-tête XML. L'encodage indiqué dans l'en-tête doit correspondre à celui utilisé lors de l'enregistrement du fichier.

Étapes à suivre :

Ouvrez le fichier dans le Bloc-notes et vérifiez l'encodage dans l'en-tête. Si nécessaire, corrigez l'encodage indiqué et enregistrez à nouveau le fichier avec ce nouvel encodage.

Erreur : Impossible de trouver une valeur de variable correspondant à l’attribut id du nœud [document].

À quoi ça ressemble? Certaines valeurs ne peuvent pas être importées et une erreur apparaît dans les journaux d'application Windows (Observateur d'événements > Journaux Windows > Candidature) avec des références comme :

• Des erreurs sont survenues lors du démarrage de l'importation des données pour la base de données 'cex'.
• Erreur : 0x0 Description : La méthode a été exécutée avec succès.
• Échec de l'importation des attributs du document à partir du nœud (#1) dans le fichier « C:\XML\ImportValues.XML ».
• Impossible de trouver une valeur de variable « S-2014-0034 » correspondant à l’attribut « idattribute » « DocNumber » du nœud (VariableID 142).
• Erreur : 0x800402A6. Description : La variable spécifiée n’existe pas.

Pour que l'importation puisse localiser et mettre à jour les valeurs des variables pour des fichiers spécifiques, elle doit être capable d'identifier/localiser le fichier. Dans le fichier XML (comme dans l'exportation XML), une étiquette spécifique indique au système la valeur à utiliser. Si cette valeur est introuvable dans la base de données PDM pour un fichier donné, cette erreur s'affiche.

Cela peut se produire si le fichier XML d'importation contient des données d'identification incorrectes pour un fichier donné (par exemple, « 1234 » au lieu de « 1233 »), ou s'il recherche une valeur nommée « partnum » alors que la variable est nommée « partnumber », etc. De plus, cela peut provenir d'un problème de formatage du fichier XML lui-même. Si la valeur utilisée pour la correspondance des fichiers est une variable, pdmweid doit être défini à 0. Sinon, si la valeur est spécifique à la configuration, la valeur de « idcfgname » doit être définie.

Étapes à suivre :

1. Vérifiez le message d'erreur pour connaître la valeur qui n'a pas été trouvée.
2. Ce problème peut se produire avec plusieurs fichiers simultanément. Comparez les champs mentionnés pour identifier la cause exacte.
3. Vérifiez quel identifiant est utilisé et que la valeur du fichier cible correspond à la valeur du fichier XML.
4. Vérifiez quelle variable est utilisée pour faire correspondre les données XML aux fichiers du coffre-fort et si la valeur pdmweid est correctement définie dans le fichier XML.
5. Vérifiez si la valeur est spécifique à une configuration et si le champ « idcfgname » est vide ou s'il fait référence à une configuration spécifique.

Erreur : L'élément d'importation/exportation de données est introuvable dans la base de données.

À quoi ça ressemble? Si PDM rencontre un problème lors du traitement de la nomenclature pendant l'exportation XML, il générera une erreur dans Observateur d'événements > Journaux Windows > Candidature: Échec du traitement des lots d'exportation dans la base de données [Nom de la base de données].

L'erreur peut se produire plusieurs fois, car le système tente de traiter le fichier et échoue chaque fois. Vous devrez trouver le fichier à l'origine du problème.

Étapes à suivre : 

La résolution de cette erreur implique généralement de modifier votre base de données SQL. Contactez-nous. Assistance technique pour obtenir de l'aide afin de régler ce problème en toute sécurité.

Le service de base de données n'est pas en cours d'exécution.

À quoi ça ressemble? Les règles d'importation/exportation XML sont gérées par le service de base de données PDM. Ce service gère aussi d'autres fonctionnalités ; par conséquent, si vos règles XML échouent, il peut être judicieux de chercher d'autres signes.

• Les notifications ne sont pas envoyées (les notifications de type SMTP et base de données échouent toutes deux).
• Affichage des mises à jour : Actualisation automatique de l’affichage du coffre-fort local d’un utilisateur pour afficher automatiquement les mises à jour des autres utilisateurs (nouveaux fichiers ajoutés, mises à jour de variables, archivages/extractions) dans le même dossier sans avoir à actualiser l’Explorateur de fichiers.
• Mises à jour des listes de cartes : les cartes utilisant une liste SQL peuvent charger une version antérieure de la liste ou ne pas se charger du tout.
• Entrepôt frigorifique.
• La réplication à la demande fonctionnerait toujours, mais la réplication planifiée échouerait.

Étapes à suivre :

1. Depuis Windows Services application, localiser le Serveur de base de données SOLIDWORKS PDM Service.
2. Vérifiez que ce programme est en cours d'exécution et, si ce n'est pas le cas, essayez de le démarrer.
3. Une fois lancé, le processus devrait traiter la file d'attente des messages et des exportations accumulées depuis sa dernière exécution. Selon la taille de la file d'attente, ça peut prendre du temps.
   
   
   
   
   1. Si le système ne démarre pas, il se peut qu'il y ait un problème plus profond. Dans ce cas, contactez Assistance technique.
4. Si le service est déjà en cours d'exécution, vérifiez qu'aucun journal ne mentionne de problèmes de connexion au serveur SQL. Pour ce faire, ouvrez le fichier de configuration. Observateur d'événements > Journaux Windows > Candidature.
5. Si des erreurs sont détectées, vous pouvez les voir s'exécuter périodiquement (habituellement 1 à 2 fois par minute, minimum). Souvent, ces erreurs indiqueront quelque chose comme :L'identifiant de sécurité du propriétaire (SID) d'un abonnement par utilisateur n'existe pas..
   1. Si tel est le cas, l'étape suivante consiste à vérifier le nom d'utilisateur et le mot de passe SQL utilisés à la fois pour le service de serveur d'archivage et (plus important encore dans ce cas) pour le service de serveur de base de données.
   2. Si, pour une raison quelconque, le mot de passe est incorrect parce que le nom d'utilisateur et le mot de passe SQL ont été perdus, nous avons un guide sur réinitialisation des identifiants SA.

Réflexions finales

Les règles d'importation et d'exportation XML constituent un moyen polyvalent de migrer des données vers et depuis un système d'exploitation. SOLIDWORKS PDMOutre les étapes décrites dans ce blogue, la mise en place et l'utilisation optimales de cet outil peuvent souvent nécessiter du temps et des essais. Il est donc préférable de procéder avec l'aide d'un administrateur PDM expérimenté.

Si GoEngineer est votre revendeur et que vous avez des questions, veuillez communiquer avec notre service client. Équipe de soutien pour obtenir de l'aide !

Articles connexes

Mise à niveau de SOLIDWORKS PDM Vault : de la version standard à la version professionnelle

Notifications SOLIDWORKS PDM dans le coffre-fort

Autorisations de déplacement de fichiers et de dossiers dans le coffre-fort SOLIDWORKS PDM

Autorisations de lecture et de modification des fichiers dans le coffre-fort SOLIDWORKS PDM

Adhésions aux groupes SOLIDWORKS PDM par dossier

CONSULTER TOUS LES ARTICLES SUR SOLIDWORKS PDM