Instructions pour le générateur de rapports SOLIDWORKS PDM

Article de GoEngineer sur févr. 04, 2019

Présentation

Qu'est-ce que le générateur de rapports SOLIDWORKS PDM ? Il s'agit d'un outil de SOLIDWORKS PDM Professional qui permet à tout utilisateur d'exécuter une requête SQL prédéfinie, sans avoir besoin de se connecter au serveur SQL.

La plupart des utilisateurs trouvent que l'outil de recherche intégré répond parfaitement à leurs besoins. Cependant, certains ont besoin d'effectuer une recherche personnalisée dans la base de données SQL. Si cette recherche doit être effectuée plusieurs fois, la transformer en rapport peut être utile. De plus, la conversion en rapport permet de partager la requête avec n'importe quel utilisateur de SOLIDWORKS PDM.

Ce document vise à aider le lecteur à créer un rapport personnalisé qui répond à ses besoins. Il propose plusieurs modèles de rapport que le lecteur peut modifier pour créer son propre rapport.

Informations complémentaires

Pour obtenir des informations détaillées sur la création de rapports pour le générateur de rapports, consultez le menu Aide de l'outil d'administration SOLIDWORKS PDM : Guide d'administration et recherchez « Générateur de rapports ». Vous trouverez également des exemples dans un fichier intitulé « …\SOLIDWORKS PDM\Examples 1.crp de report ». REMARQUE : l'extension « crp » est destinée aux fichiers de rapport.

Utilisez le Bloc-notes pour modifier les rapports. Une fois prêts, ajoutez-les au générateur de rapports PDM.

Démarrage du générateur de rapports

  • Connectez-vous à votre vue de coffre-fort local
  • Sélectionnez l'élément de menu « Outils : Générateur de rapports »

Ajout de rapports au générateur de rapports

L'utilisateur ajoutant le rapport doit avoir l'autorisation administrative « Peut mettre à jour les requêtes de rapport »

  • Dans le générateur de rapports, sélectionnez « Fichier : Importer une requête », puis accédez à un fichier crp à importer.
  • Faites glisser un fichier de l'Explorateur vers la fenêtre « Requête » du Générateur de rapports

La fenêtre du générateur de rapports

SOLIDWORKS-PDM-Report-Generator-Instructions-Report-Generator-window

Rapports de construction

Les rapports sont basés sur une requête SQL. La première étape consiste donc à créer la requête SQL et à vérifier son exécution dans SQL Management Studio. L'étape suivante consiste à déterminer les arguments nécessaires à l'exécution du rapport. Bien sûr, certaines requêtes n'ont pas besoin d'arguments à l'exécution.

Je vais diviser la discussion ci-dessous entre les rapports qui nécessitent des arguments et ceux qui n'en nécessitent pas.

Modèle : Rapport sans arguments

Le modèle de requête sans arguments se trouve ci-dessous, entre « Début de la requête » et « Fin de la requête ». Pour l'utiliser, copiez le texte entre les lignes « Début » et « Fin » et collez-le dans un document Bloc-notes. Dans chaque section, modifiez le texte entre []. Assurez-vous de laisser les []. Les remplacements requis sont dans rouge texte.

Sauvegardez le document, puis remplacez l'extension « txt » par « crp ». Vous avez maintenant un rapport. Suivez les instructions ci-dessus pour l'ajouter au générateur de rapports. Cochez la case à côté du rapport et sélectionnez « Modifier : Exécuter la requête » ou cliquez sur l'icône « Exécuter la requête ».

Commencer la requête

@[Nom unique pour la requête]
§Nom [Nom affiché dans la case « Requêtes »]

§Entreprise [Facultatif]

§Description [Facultatif]

§Version [1.0]

§ Arguments []

§Sql
[

La requête SQL va ici

]

Fin de la requête

SOLIDWORKS-PDM-Report-Generator

Exemple : rapport sans arguments

La requête ci-dessous affichera tous les messages et notifications en attente d'être envoyés.

Commencer
@[Messages en attente de traitement]
§ Nom [Notifications en attente]

§Entreprise []

§Description [Toutes les configurations, y compris les données de l'onglet @]

§Version [1]

§ Arguments []

§Sql
[
sélectionner *
de DocumentActionInfo
]
Fin

Rapports avec arguments

Cette section concerne les rapports nécessitant des renseignements supplémentaires lors de l'exécution. Le nom de l'utilisateur connecté ou certains noms de fichiers pourraient être nécessaires. Je donne quelques exemples ci-dessous, mais pour une liste complète des arguments possibles et leur utilisation, veuillez consulter le « Guide d'administration » décrit dans la section « Définition des arguments ».Informations complémentairesSection «  ». Notez qu'il existe bien d'autres combinaisons possibles que celles présentées ici. Elles sont décrites dans la section « Arguments de requête de rapport » du « Guide d'administration ».

Dans l'exemple ci-dessous, j'utilise une substitution simple : je remplace l'argument dans le script SQL par la variable entre {}. Veuillez noter qu'il est également possible d'utiliser un « OR » pour plusieurs valeurs dans l'argument. Veuillez vous référer à la documentation du « Guide d'administration » pour savoir comment l'utiliser.

La section ci-dessous est copiée du « Guide d'administration » sur les « Arguments » :

§ Arguments
[
§type nom[compter] [instruire]
]

Où:

  • type est un type d'argument prédéfini. Les types possibles sont décrits dans le Guide d'administration.
  • le nom est une variable utilisée dans l'élément WHERE de la requête SQL
  • [compter] définit comment les valeurs sont retournées à la requête SQL
  • [instruire] apparaît dans le générateur de rapports comme une instruction utilisateur

Une requête de rapport peut avoir plusieurs arguments.

Tous les composants de l'argument doivent être sur une seule ligne.

 

Exemple:

Dans l'exemple d'argument ci-dessous, le nombre de groupes à sélectionner est ouvert. L'utilisateur peut choisir autant de groupes qu'il le veut dans la liste des groupes dans PDM. Lorsque le rapport est exécuté, une boîte de dialogue apparaît et l'utilisateur peut choisir les groupes à ajouter à la liste de sélection.

Début de la section
§ Arguments
[
GroupID TheGroupID[N] [Sélectionner des groupes]
]
Section de fin

Exemple de rapport avec un argument

Dans l'exemple ci-dessous, l'argument est une entrée de texte unique : le nom du fichier. La variable s'appelle « theFileName ». Notez que la variable est placée entre accolades lorsqu'elle est utilisée dans la requête : {theFileName}

Commencer la requête
@[Rechercher les fichiers extraits en référence]
§ Nom [Fichiers qui font référence à ce fichier et qui sont actuellement extraits]

§Société [SolidWorks]

§Description
[Cette requête trouvera tous les fichiers qui font référence au fichier cible et qui sont extraits]

§Version [1.2]

§ Arguments
[
Chaîne theFileName[1] [Entrez le nom du fichier]
]

§Sql
[
sélectionnez b.DocumentID, a.Filename comme ref_File
à partir de documents à
rejoindre XRefs b sur a.DocumentID=b.DocumentID
où b.XRefDocument=(sélectionnez DocumentID parmi les documents où Filename={theFileName})
et a.LockPath !=”
Fin de la requête

Modèle : Rapport avec arguments

Dans le « modèle » ci-dessous, l'argument est une valeur de chaîne unique assignée à la variable « theFileName ». Vous pouvez changer le nom de la variable comme vous le souhaitez. Si vous voulez plusieurs valeurs, remplacez [1] par le nombre souhaité. Vous pouvez également modifier l'invite utilisateur de « Saisir le nom du fichier » par la valeur de votre choix ; gardez simplement les crochets.

Commencer la requête
@[Nom unique pour la requête]
§Nom [Nom affiché dans la case « Requêtes »]

§Entreprise [Facultatif]

§Description
[Facultatif]

§Version [1.0]

§ Arguments
[
Chaîne theFileName[1] [Entrez le nom du fichier]
]

§Sql
[
La requête SQL va ici
]
Fin de la requête

Conclusion

Cet article présente l'utilisation et la modification du générateur de rapports SOLIDWORKS PDM. Nous espérons que cet article et les modèles vous seront utiles. Pour en savoir plus sur ce sujet, veuillez consulter le « Guide d'administration ».

Ce lien Nous vous fournirons 13 exemples de rapports. Vous devrez peut-être modifier certains paramètres pour les adapter à votre environnement. Les rapports fournis effectuent les opérations suivantes :

Nom du fichier Description
Fichier d'assemblage dans un projet Cette requête répertorie tous les documents d'assemblage et leurs noms de configuration sous le dossier spécifié.
Dossiers sans fichiers Cette requête répertoriera le dossier Vault sans fichiers.
Obtenir le nom de la configuration Obtenir les noms de configuration dans le résultat de la recherche de variables
Lister les fichiers dans un flux de travail spécifique Cette requête répertorie tous les documents d'un flux de travail
Renommer les fichiers Obtenir la liste des fichiers renommés avec leur ancien nom
Signaler les dossiers de coffre vides non supprimés Cette requête répertorie tous les dossiers vides et non supprimés dans Vault
Rapport des fichiers extraits sur une machine spécifique Cette requête répertorie tous les fichiers extraits sur un client spécifique.
Rapport de flux de travail Cette requête répertoriera les détails du fichier de la dernière version de tous les fichiers du projet sélectionné.
Rapport de fichiers qui ne sont pas référencés par d'autres documents Cette requête répertorie les fichiers qui ne sont pas référencés en fonction de l'extension de fichier
Structure arborescente de niveau supérieur Cette requête répertorie l'arborescence d'un fichier au niveau supérieur seulement
Variables par fichier par configuration, y compris vides Énumère les colonnes de toutes les valeurs des variables choisies, même si elles ne sont pas définies pour toutes les configurations des fichiers sélectionnés
Variables par fichier par configuration Énumère les colonnes des dernières valeurs des variables choisies pour toutes les configurations des fichiers sélectionnés
Version avec rév. Cette requête énumère les versions de fichiers qui ont été révisées
 

À propos de GoEngineer

GoEngineer offre des logiciels, des technologies et une expertise qui permettent aux entreprises de libérer l'innovation en matière de conception et de livrer de meilleurs produits plus rapidement. Avec plus de 40 ans d'expérience et des dizaines de milliers de clients dans les secteurs de la haute technologie, des dispositifs médicaux, de la conception de machines, de l'énergie et d'autres industries, GoEngineer fournit des solutions de conception de premier plan avec SOLIDWORKS CAD, l'impression 3D Stratasys, la numérisation 3D Creaform et Artec, CAMWorks, PLM, et plus.

Voir tous les messages de GoEngineer