Reads ASAM ODS (Open Data Services) data.
Syntax
ReadASAMODS(Connection, ASAMPath, Attribute)
The syntax of the ReadASAMODS function consists of the following parts:
Part |
Description |
|---|---|
Connection |
A string is used that can be used for establishing a connection to an ASAM ODS server. The string consists of multiple parameters separated by a semicolon. CONNECTION specifies the connection type. Valid values are CORBA, ATF and ATFX. PATH specifies the path of the ATF or ATFX file. SERVER specifies the name of the machine hosting the ASAM ODS server. PORT specifies the port of the ASAM ODS server. FACTORYNAME specifies the factory name. Every ASAM-ODS server that is available in the network and is registered with an ORB offers a so-called factory interface and thus enables clients to obtain general information about the server and to establish a connection with this server. The factory interface is uniquely described by name and type. FACTORYTYPE specifies the factory type. USER specifies the user. Permitted data structures are Scalar value. Supported data types are String. If the argument is a list, then the function is executed for each element of the list and the result is also a list. |
ASAMPath |
The ASAM path used to address an instance element. For ATF and ATFX files, the path is a combination of the name of the application element from which the instance element was derived and the instance element ID. Permitted data structures are Scalar value. Supported data types are String. If the argument is a list, then the function is executed for each element of the list and the result is also a list. |
Attribute |
The name of the attribute to be read from the instance element. Permitted data structures are Scalar value. Supported data types are String. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
Remarks
The result provided by the function is the value of the attribute located in the instance element addressed by the ASAM path.
Available in
Option ASAM ODS Import
Examples
ReadASAMODS("CONNECTION = ATF; PATH = C:\\ASAM\\ASAM ATF\\database.atf", "[localcolumn]1", "values")
Reads the value of the attribute values from an ATF file, which is located in the instance element with the path [localcolumn]1 .