ReadASAMODS (FPScript)
Lit les données ASAM ODS (Open Data Services).
Syntaxe
ReadASAMODS(Connection, ASAMPath, Attribute)
La syntaxe de la fonction ReadASAMODS se compose des éléments suivants :
Section |
Description |
---|---|
Connection |
On utilise une chaîne qui peut être utilisée pour établir une connexion à un serveur ASAM ODS. La chaîne est constituée de plusieurs paramètres séparés par un point-virgule. CONNECTION précise le type de connexion. Les valeurs valides sont CORBA, ATF et ATFX. PATH précise le chemin d'accès au fichier ATF ou ATFX. SERVER précise le nom de la machine qui héberge le serveur ASAM ODS. PORT spécifie le port du serveur ASAM ODS. FACTORYNAME précise le nom de l'usine. Chaque serveur ASAM ODS disponible sur le réseau et enregistré auprès d'un ORB offre une interface dite d'usine et permet ainsi aux clients d'obtenir des informations générales sur le serveur et de se connecter à celui-ci. L'interface d'usine est clairement décrite par son nom et son type. FACTORYTYPE précise le type d'usine. USER précise l'utilisateur. PASSWORD spécifie le mot de passe de l'utilisateur. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
ASAMPath |
Le chemin ASAM utilisé pour adresser un élément d'instance. Pour les fichiers ATF et ATFX, le chemin est une combinaison du nom de l'élément d'application dont l'élément d'instance est dérivé et de l'ID de l'élément d'instance. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
Attribute |
Le nom de l'attribut à lire dans l'élément d'instance. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Remarques
Le résultat fourni par la fonction est la valeur de l'attribut situé dans l'élément d'instance adressé par le chemin ASAM.
Disponible dans
Option Import de données ASAM ODS
Exemples
ReadASAMODS("CONNECTION = ATF; PATH = C:\\ASAM\\ASAM ATF\\database.atf", "[localcolumn]1", "values")
Lit la valeur de l'attribut values à partir d'un fichier ATF, qui se trouve dans l'élément d'instance avec le chemin [localcolumn]1.
ReadASAMODS("CONNECTION = CORBA;" : _
"SERVER = 192.168.1.27;" : _
"PORT = 1049;" : _
"FACTORYNAME = openaos;" : _
"FACTORYTYPE = ASAM-ODS;" : _
"USER = openaos;" : _
"PASSWORD = openaos", _
"/[Environment]MyEnvironment/[Test]MyTest", "Name")
Lit la valeur de l'attribut values via l'interface CORBA à partir d'un serveur ASAM ODS.