Configuration du service Intel Sparx

Le programme SparxIntelService.exe exécute un ou plusieurs services Intel pour Enterprise Architect . Le programme se trouve dans le même dossier d'installation qu'Enterprise Enterprise Architect et utilise un fichier de configuration qui nomme les services pouvant exécuter sur la machine locale.

Dans les exemples de cette rubrique, le programme va tenter d'utiliser le fichier c:\mystuff\myservices.config. Il va rechercher un service nommé EA et, s'il le trouve, le démarrer.

Service d'écoute SparxIntelService.exe = EA config = c:\mystuff\myservices.config

The Config File Format

The configuration file has this format:
# comment
# comment
# comment
{ # start of service definition
    ... # list of directives as pairs
} # end of service definition
{ # start of service definition
   ... # list of directives as pairs
} # end of service definition

Comments are indicated by the # character.
If the config directive is omitted (not recommended), the program will look for a config file of the same name as the program, in the same directory as the program.
In this example the program will attempt to use the file SparxIntelService.config in the same folder:
     SparxIntelService.exe listen service:EA

Directive	Description	See also
nom	Lorsqu'un service est nommé sur la ligne de commande, le service avec l' attribut de nom correspondant sera démarré.
statut	Lorsque le statut gt;= ON, the service will be started; otherwise, it will not be started.
chargement paresseux	Lorsque lazyload est « true », toute base de données Code Miner sera chargée avec retard jusqu'à ce qu'une demande Intel soit adressée au service.
niveau de log	Définit le niveau d'informations enregistrées, sous la forme d'une combinaison de mots-clés {information, avertissement, erreur} séparés par un « \| ». Par exemple : loglevel=Information\|avertissement\|erreur
déconnexion	Spécifie le chemin d'accès complet du fichier log dans lequel écrire. Par exemple : logoutput =c:\logfiles\intel-service-project1. log
base de données	Spécifie le chemin d'accès complet de la base de données Code Miner à charger. Par exemple : base de données =c:\intel--service\project1.cdb Plusieurs directives « base de données » sont autorisées, chacune spécifiant une base de données différente.
permettre	Identifie l'adresse IP autorisée à se connecter au service sur le port. Par exemple : autoriser=localhost autoriser=127.0.0.1 allow=172.160.* (les caractères génériques sont autorisés lorsque le « réseau » la directive a une valeur de « réseau » ou « public », mais pas « local »)
réseau	Permet de restreindre les connexions de service. local - le service n'écoutera aucune connexion autre que localhost réseau - lorsqu'il est utilisé avec les directives génériques « allow », permet aux clients sur une adresse IP autorisée de se connecter pubien - permet toute connexion
montrer	Lorsque la valeur est « true », la fenêtre de la console du service s'affiche ; la valeur par défaut est « false ».
port	Le port sur lequel le service écoutera.

The Service Configuration Template

When choosing the 'Execute > Tools > Services > Code Miner Service > Edit Configuration File' ribbon option you display the Windows 'Save As' browser through which you can choose either the config file to open or where a file should be created.
If no config file is recorded in the registry and you specify a non-existent filename, that file is created, filled with a 'bare bones' configuration skeleton and saved. The selected/new configuration is then shown in the Enterprise Architect default editor.
The 'bare bones' template is shown here.

#--------------------------------------------------------------------------------
# Sparx Intel Service Configuration File
# ---------------------------------------------------------------------------------
# This file is used to describe one or more intel services and the code miner databases that they support
# This file can be used in EA to manage a number of services on the local machine
# ---------------------------------------------------------------------------------
# Service Attributes
# ---------------------------------------------------------------------------------
# name The unique name of the service in this file
# status "ON" - service can run, "OFF" service will never run
# lazyload "true" - databases are loaded n demand, "false" - databases are loaded when service starts
# port           Unique Port number that service will listen on and EA will connect to
# network          [optional,default=local] Restricts service to listening to locahost only (local), to a range of addresses (network) or any address (public)
# allow Allows a specific IP address or wildcard IP address to connect (if network is NOT local)
# (There can be multiple allow directives present)
# autoupdate           "true" - will detect updates to listed databases and reload them, "false" default, changes are not detected
# show [optional,default=false] shows the console window for the service
# logoutput          [optional] The path of a log file which service can write to
# loglevel          [optional] The levels of information logged. Combine with '|' character, e.g.: { information|warning|error }
# database          [Required] The full path to a codeminer database which usually has the .cdb file extension
# (There can be multiple database directives present)
#
# ---------------------------------------------------------------------------------
# Attribute Values
# ---------------------------------------------------------------------------------
#
# <string>   - text. (do not include quotes)
# <boolean> - text, { true, false, ON, OFF }
# <path>     - fully specified file path to codeminer database
# <number>   - digits
# ---------------------------------------------------------------------------------
#
{
name=<string>,
status=<boolean>,
lazyload=<boolean>,
port=<number>,
allow=<string>,
allow=<string>,
network=<string>,
autoupdate=<string>,
show=<boolean>,
logoutput=<string>,
loglevel=<string>,
database=<path>,
database=<path>,
database=<path>
},
{
name=Project1,
status=ON,
lazyload=TRUE,
allow=localhost,
allow=127.0.0.1,
port=9999,
autoupdate=true,
database=c:\Project1\Project1.cdb
}

Options du ruban de service Intel Sparx

Lorsqu'un fichier de configuration de service existe, vous pouvez le modifier ou l'exécuter à l'aide d'un certain nombre d'options disponibles dans l'option de ruban « Exécuter > Outils > Services » dans le groupe d'options de menu Code Miner .

Option	Description
Vue l'état de tous les services	(Au-dessus de toutes les catégories de service.) Cette option affiche une vue qui répertorie l'état de chaque service Enterprise Architect nommé dans le fichier de configuration actuel et son état.
Démarrer	Cette option lit le fichier de configuration de service actuel et démarre les services configurés pour exécuter , et arrête l'exécution des services qui ne sont pas configurés pour exécuter . Un service est configuré si : Il est nommé dans le fichier de configuration. Il a l'attribut status:ON.
Arrêtez tout	Cette option arrête tous les services en cours d'exécution.
Modifier le fichier de configuration	Cette option prompts le fichier de configuration de service à utiliser, puis ouvre ce fichier dans un éditeur de texte Enterprise Architect . Le système se souvient de l'emplacement du fichier.
Démarrer automatique avec EA	Cette option démarre automatiquement les services ayant l'attribut « status:ON » lorsque le modèle s'ouvre. Les messages enregistrés dans la fenêtre de sortie système ici lorsque le modèle est ouvert indiquent que le service était déjà en cours d'exécution.
Arrêt automatique à la fermeture	Cette option arrête automatiquement l'exécution des services lorsque Enterprise Architect est fermé.