Paramètres d'Up ! Simple Object Activation Protocol

Up ! Simple Object Activation Protocol est l'adaptateur générique entre Up ! Application System et le protocole Simple Object Activation Protocol (SOAP) pour des modules clients dans cette technologie.

Tous les modules en technologie Up ! Virtual Technical Machine ou dans une autre supportée peuvent être aussi exposés en technologie Single Object Activation Protocol (SOAP).

Up ! Simple Object Activation Protocol n'est pas un programme mais un module complémentaire des adaptateurs :

Compilés par les paramètres de AdaptateurClientSoap et AdaptateurServeurSoap de Up ! Compiler.
Interprétés par les paramètres AdaptateurClientSoap et AdaptateurServeurSoap de Up ! Script Engine.

Up ! Simple Object Activation Protocol est automatiquement invoqué si :

Le paramètre UpsMmr.Soap est activé pour référencer ou déréférencer les objets exposés sur Internet / Intranet correspondant aux modules en technologie Up ! Virtual Technical Machine.
Une application écrite en JavaScript utilise un module exposé en Simple Object Activation Protocol (SOAP) correspondant à un module en technologie Up ! Virtual Technical Machine.
Le service Soap, qui est l'adaptateur serveur d'un module en technologie Up ! Virtual Technical Machine, est chargé par le serveur Internet / Intranet pour l'application écrite en JavaScript.
L'application en technologie Up ! Virtual Technical Machine charge un module correspondant à un module exposé en Simple Object Activation Protocol (SOAP) dans un langage quelconque.
Le service Soap est chargé par le serveur Internet / Intranet pour l'application en technologie Up ! Virtual Technical Machine.

Pour lancer un serveur Soap, il suffit d'invoquer Up ! Virtual Technical Machine en mode serveur ou Up ! Server en passant en paramètre le nom du module dynamique en technologie Up ! Virtual Technical Machine. Voici un exemple :

upsmmr UpsMmr.Serveur=Oui UpsMmr.RfcSap=Executer Module=finance upssrv UpsMmr.Soap=Executer Module1=finance Module2=rh

Quel que soit son mode d'invocation, Up ! Simple Object Activation Protocol possède les mêmes paramètres cités dans la section suivante.

Certains paramètres font référence à des fichiers ou à des chemins d'accès. En ce cas, il est possible d'employer des variables environnement dans l'expression des chemins d'accès. Exemple :

Tmp=${UPS_HOME}/demo/tmp/${UPS_USER}

D'autre part, le séparateur de répertoire est le caractère division / et les noms de fichiers ou de répertoires peuvent utiliser les partitions montées automatiquement par Up ! System.

Les paramètres sont lus successivement dans :

Les variables environnement.
Le fichier d'initialisation.
${UPS_HOME}/ini/${UPS_LANGUAGE}/upsaps.ini en mode mono-utilisateur ou ${UPS_HOME}/ini/${UPS_USER}/upsaps.ini en mode multi-utilisateur.
La section est UpsSoa.
Le fichier de paramètres.
S'il existe.
La ligne de commande.
Il s'agit soit de :
- La ligne de commande stricto sensu.
- La valeur de la variable environnement QUERY_STRING.
  En ce cas, le programme s'exécute automatiquement et obligatoirement en mode batch en respectant la norme Common Gateway Interface (CGI).
Les paramètres peuvent être préfixés par UpsSoa.

Les valeurs des paramètres comportant des caractères espace doivent être mises entre caractères guillemet " ou entre caractères apostrophe ' .

Paramètres d'exécution

TracerSoap

TracerSoap permet de tracer l'activité de Up ! Simple Object Activation Protocol. La valeur par défaut est Non.

Cette trace est inscrite dans le fichier ${UPS_HOME}/log/${UPS_LANGUAGE}/${UPS_APPLICATION}-upssoa-${UPS_SESSION}.log en mode mono-utilisateur ou dans le fichier ${UPS_HOME}/log/${UPS_USER}/${NomProgramme}-upssoa-${UPS_APPLICATION}.log en mode multi-utilisateur.

TracerSoap=Oui

Exemple de configuration d'Up ! Simple Object Activation Protocol


; ------------------------------------------------------------------- 

; Fichier    : upsaps.ini                                             

; Objet      : Initialisation d'Up ! Virtual Technical Machine.        
   
;                                                                     

; Module      : Up ! Application System.                              

; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.                    

; ------------------------------------------------------------------- 

;                          Observations

;                                                                      

;                                                                      

; ------------------------------------------------------------------- 



[UpsSoa]

TracerSoap=Oui