| Pré. | Proc. |
Ajouter/modifier un fournisseur de données
L'écran Ajouter/ modifier un fournisseur de données s'affichera chaque fois que vous demanderez de créer un nouveau fournisseur de données ou d'en modifier un existant. Le comportement de l'écran sera identique dans les deux modes, la seule différence étant que les détails du fournisseur de données sélectionné seront affichés lors du chargement de l'écran en mode "Modifier".
Lorsque vous choisissez d'ajouter un nouveau fournisseur de données, l'écran s'affiche initialement comme indiqué :
Dans la mesure du possible, l'écran Ajouter/Modifier le fournisseur de données remplira chaque champ avec une valeur par défaut afin de vous faciliter la tâche ; si les valeurs par défaut ne sont pas correctes, écrasez-les simplement. À cette fin, chaque fois que la valeur ' valeur ' est modifiée, un certain nombre d'autres champs seront définis sur les valeurs par défaut pour le nouveau fournisseur, tels que le préfixe du fournisseur de données, comme indiqué ici lorsque Enterprise Architect est sélectionné :
Note : lors de la définition d'un fournisseur de données, un certain nombre de champs obligatoires (indiqués par un '*') nécessitent une valeur avant que le fournisseur de données puisse être enregistré.
Paramètres du fournisseur de données
Item |
La description |
Voir également |
|---|---|---|
|
Activé |
Valeur par défaut : décochée Cette valeur contrôle si le serveur d'intégration (SBPI.exe) doit autoriser le transfert des communications vers ce fournisseur de données. |
|
|
Nom |
Cette valeur représente le nom convivial du fournisseur de données actuel. Il sera montré aux utilisateurs d Enterprise Architect . |
|
|
Fournisseur |
Cette valeur spécifie le type de fournisseur du fournisseur de données actuel ; seules les valeurs prises en charge peuvent être utilisées. Comme mentionné, chaque fois que cette valeur est modifiée, un certain nombre d'autres champs seront automatiquement mis à jour pour faciliter la saisie des données pour l'utilisateur. |
|
|
Préfixe |
Cette valeur représente un nom court et unique pour identifier le fournisseur de données actuel. Cette valeur sera enregistrée pour chaque élément Enterprise Architect lié à un élément externe. |
|
|
Groupe |
Ce champ est disponible uniquement lorsque le type de fournisseur "Intégration personnalisée" est sélectionné. Généralement dans Enterprise Architect , les intégrations sont regroupées par le type de fournisseur (tel que 'Jira' ou 'Dropbox'). Pour les intégrations personnalisées, le regroupement est appliqué en fonction de la valeur saisie dans ce champ. |
|
|
Durée maximale de la demande |
Ce champ est disponible uniquement lorsque le type de fournisseur "Service personnalisé" est sélectionné. Cette valeur représente la durée maximale (en secondes) pendant laquelle les appels au système du fournisseur attendront avant d'expirer. L'augmentation de cette valeur est particulièrement utile lorsque les systèmes du fournisseur sont distants ou ont des performances lentes. La valeur par défaut est 60 secondes. Note : Il s'agit d'un nouveau paramètre introduit dans Pro Cloud Server v4.2 build 65. |
Paramètres du plug-in d'intégration
Ce groupe de paramètres définit la relation entre le plug-in d'intégration et le serveur d'intégration et la façon dont les deux interagissent.
Item |
La description |
Voir également |
|---|---|---|
|
Début automatique |
Valeur par défaut : cochée Cette valeur contrôle si le serveur d'intégration (SBPI.exe) doit maintenir un processus en cours d'exécution (*sbpi.exe) pour ce fournisseur de données. Pour les plug-ins d'intégration standard, nous nous attendrions à ce que cette valeur soit vérifiée ; cependant, pour ceux personnalisés, il peut être utile de ne pas démarrer automatiquement le plug-in et de contrôler manuellement son exécution, en particulier lors de son développement. |
|
|
Port |
Valeur par défaut : 8081 Cette valeur représente le port que le serveur d'intégration doit utiliser pour communiquer avec le plug-in d'intégration. Le Serveur d'intégration suppose que le port est relatif à la machine actuelle (ou http://localhost :{port}). Chaque plug-in d'intégration nécessite un numéro de port unique, qui sera vérifié lors d'une tentative d'enregistrement des paramètres du plug-in. Cependant, le Pro Cloud Server ne peut vérifier que les ports utilisés par le Pro Cloud Server lui-même et ses composants, il existe toujours une possibilité de conflit de port avec d'autres applications. |
|
|
Protocole |
Cette valeur représente le protocole que le serveur d'intégration doit utiliser pour communiquer avec le plug-in d'intégration ; dans la configuration la plus simple, ce sera 'HTTP'. |
|
|
Chemin DLL |
Ce champ n'est disponible que pour les types de fournisseur 'Service personnalisé', 'Intégration personnalisée' et 'Traducteur'. Cette valeur représente le chemin physique vers la DLL personnalisée, qui sera appelée par les processus du fournisseur de données CustomService.exe ou CustomIntegration.exe. Pour plus de commodité, l'application remplit la liste déroulante avec tous les fichiers .DLL qui sont présents dans le dossier .\SBPI\Custom\ (C:\Program Files (x86)\ Sparx Systems \ Pro Cloud Server \SBPI\Custom\). |
Propriétés personnalisées
La section Custom Propriétés n'est affichée que pour les Data Providers de type 'Custom Service'.
Item |
La description |
Voir également |
|---|---|---|
|
Liste des Propriétés personnalisées |
Répertorie les propriétés actuelles du fournisseur de données personnalisé. |
|
|
Ajouter |
Ce bouton affiche l'écran « Ajouter une propriété personnalisée du fournisseur SBPI » et permet la saisie d'une nouvelle propriété personnalisée, définie comme une paire Item /valeur. |
|
|
Éditer |
Ce bouton affiche l'écran "Modifier la propriété personnalisée du fournisseur SBPI" et permet de modifier une définition de propriété personnalisée existante. |
|
|
Effacer |
Ce bouton supprime définitivement la propriété personnalisée sélectionnée du fournisseur de données actuel. |
Paramètres du serveur fournisseur
Ce groupe de paramètres définit les détails du fournisseur de données externe, tel que Dropbox, Jira ou TFS. Le plug-in d'intégration utilisera les détails définis pour se connecter au système distant et en récupérer les données afin qu'elles puissent être renvoyées à Enterprise Architect . La combinaison de 'Protocole', 'Nom du serveur' et 'Port' doit pouvoir être résolue par le serveur hébergeant le plug-in d'intégration, qui dans le cas le plus simple est le Pro Cloud Server .
Item |
La description |
Voir également |
|---|---|---|
|
Protocole |
Cette valeur représente le protocole que le plug-in d'intégration doit utiliser pour communiquer avec le fournisseur de données externe. Note : La plupart des fournisseurs hébergés dans le cloud en ligne nécessitent https et le port 443. |
|
|
Nom/IP du serveur |
Cette valeur représente le nom du serveur ou l'adresse IP que le plug-in d'intégration doit utiliser pour communiquer avec le fournisseur de données externe. |
|
|
Port |
Cette valeur représente le port que le plug-in d'intégration doit utiliser pour communiquer avec le fournisseur de données externe. Note : La plupart des comptes hébergés en ligne fonctionnent via https, ce qui nécessite un port 443. Les serveurs auto-hébergés dépendront de la configuration individuelle du serveur.
|
|
|
URL de base |
Certains fournisseurs de données externes autorisent le concept de référentiels multiples à un seul emplacement ; pour ces fournisseurs de données, ce champ agit comme un filtre. Par exemple, il est possible d'utiliser un autre modèle Enterprise Architect comme source de données externe ; dans ce cas, le 'Protocol', 'Server' et 'Port' déterminent le Pro Cloud Server (par exemple, http://myEAServer:804) tandis que 'Base URL' est l'Alias DB du référentiel (myModel). Ainsi: http://myEAServer:804/myModel Détails pour des fournisseurs spécifiques :
|
|
|
Durée maximale de la demande |
Cette valeur représente la durée maximale (en secondes) pendant laquelle les appels au système du fournisseur attendront avant d'expirer. L'augmentation de cette valeur est particulièrement utile lorsque les systèmes du fournisseur sont distants ou ont des performances lentes. La valeur par défaut est 60 secondes. Note : Il s'agit d'un nouveau paramètre introduit dans Pro Cloud Server v4.2 build 65. |
|
|
Nom d'utilisateur |
Cette valeur représente le nom d'utilisateur qui doit être utilisé (en combinaison avec le mot de passe) pour accéder aux données dans le système externe. Si une valeur est définie dans ce champ, tous les utilisateurs d' Enterprise Architect du fournisseur de données actuel utiliseront le même ensemble d'informations d'identification pour lire le système externe. Sinon, si le champ du nom d'utilisateur est laissé vide, Enterprise Architect prompt chaque utilisateur indépendamment ses informations d'identification. Note : Pour de nombreux comptes Cloud en ligne, le nom d'utilisateur peut être une adresse e-mail pour le compte. |
|
|
Mot de passe |
Cette valeur représente le mot de passe correspondant au nom d'utilisateur spécifié dans le champ 'Nom d'utilisateur'. Note : Pour les comptes hébergés sur Atlassian Cloud (Jira, Confluence), l'utilisation de mots de passe réguliers a été remplacée par une clé API. Consultez la documentation Atlassian pour savoir comment obtenir une clé API et collez la clé API dans le champ du mot de passe. |
|
|
Créer Items |
Valeur par défaut : valeur Cette case à cocher contrôle si les utilisateurs Enterprise Architect sont capables de créer de nouveaux éléments dans le système externe. |
|
|
Modifier les Items |
Valeur par défaut : valeur Cette case à cocher contrôle si les utilisateurs Enterprise Architect peuvent modifier les détails des éléments externes dans le système externe. |
|
|
Publier des discussions |
valeur par défaut : cochée Cette case à cocher contrôle si les utilisateurs Enterprise Architect sont capables de créer des discussions sur des éléments du système externe. |
|
|
Ignorer les erreurs SSL |
valeur par défaut : décochée Cette case à cocher contrôle si le plug-in d'intégration doit ignorer les erreurs liées à SSL qui se produisent suite à la communication avec le système externe. |
Paramètres de journalisation
Ce groupe de paramètres définit la manière dont le plug-in d'intégration créera des entrées dans son ou ses fichiers log . Étant donné que les plug-ins exécuter sans intervention de l'utilisateur, il est important qu'ils puissent écrire des messages ou des rapports de problèmes potentiels dans un fichier log . Cependant, une attention particulière doit être accordée pour s'assurer que les performances ne sont pas affectées par l'écriture dans de tels fichiers, ce qui est possible si le fichier log grandit continuellement sans limites. Il est également déraisonnable de s'attendre à ce qu'une intervention manuelle soit nécessaire pour s'assurer que la taille et le nombre de fichiers log n'affectent pas les performances. Pour ces raisons, chaque plug-in d'intégration possède son propre ensemble de fichiers log et d'options de configuration pour gérer ces fichiers log .
Le fichier log actuel inclura toujours un '1' à la fin de son nom de fichier. Un nouveau fichier log sera créé chaque fois que le plug-in d'intégration est démarré ou que la taille physique du fichier log actuel atteint la taille maximale du fichier. Lorsque cela se produit, tous les fichiers existants seront "renversés", ce qui signifie que leurs numéros de fichiers seront incrémentés et un nouveau "{filename}1. log ' créé. Si le processus de substitution entraîne l'existence d'un plus grand nombre de fichiers que le paramètre « Nombre de fichiers » ne le permet, ces fichiers supplémentaires seront supprimés.
Item |
La description |
Voir également |
|---|---|---|
|
Nombre de fichiers |
valeur par défaut : 3 Cette valeur représente le nombre « continu » de fichiers log qui doivent être conservés pour le plug-in d'intégration actuel. |
|
|
Taille de fichier maximale |
Valeur par défaut : valeur Cette valeur représente la taille maximale, en nombre d'octets, qu'un fichier log peut atteindre avant qu'un nouveau fichier log ne soit créé. |
|
|
Niveau |
valeur par défaut : AVERTISSEMENT Cette valeur représente le niveau maximum de messages qui doivent être écrits dans le fichier log . Les niveaux sont : OFF, FATAL, WARNING, INFO et SYSTEM. Un niveau de log défini inclut tous les niveaux inférieurs ; par conséquent, si un plug-in est défini sur un niveau de log INFO, tous les messages FATAL, WARNING et INFO seront écrits dans son fichier log . |
|
|
Annuaire |
(LECTURE SEULE) Ce champ affiche l'emplacement physique du répertoire dans lequel les fichiers log du fournisseur de données actuel seront enregistrés. |
Paramètres du proxy
Ce groupe de paramètres définit la manière dont le plug-in d'intégration doit communiquer avec le fournisseur de données externe lorsqu'ils sont séparés par un serveur proxy.
Item |
La description |
Voir également |
|---|---|---|
|
Nom/IP du serveur |
Le nom du serveur (ou IP) et le numéro de port du serveur proxy ; par exemple, proxyserver.com:3131 |
|
|
Contourne |
Ce champ fournit un mécanisme permettant à certaines adresses de contourner le proxy ; il accepte plusieurs valeurs séparées par des points-virgules (;). Par exemple, 192.168.*;*.domainelocal.com;www.mondomaine.com |
|
|
Nom d'utilisateur |
Si le serveur proxy requiert des informations d'identification, ce champ fournit le nom d'utilisateur. |
|
|
Mot de passe |
Si le serveur proxy requiert des informations d'identification, ce champ fournit le mot de passe de l'utilisateur. |