DATEX I FTP Interface configuration

The configuration of DATEX I FTP interface is set through a subset of information stored in the file:

/opt/ptv-optima-vv.n.xxxxptv-optima-as/standalone/configuration/optima/optima-configuration.xml.

The configuration structure is placed under the tag <configurations>/<configuration>/<datex-interface>/<datex-process>

Example:

            <datex-interface>
    <settings>
        <sourceName>SVRTOC</sourceName>
    </settings>
    <datex-process enabled="true" name="ftp_publish_datex">
        <logger>ftp_publish_datex</logger>
        <exchanger>
            <country>IT</country>
            <name>svr</name>
        </exchanger>
        <schedule>
            <second>15</second>
            <minute>3</minute>
            <hour>*</hour>
            <dayOfMonth>*</dayOfMonth>
            <month>*</month>
            <dayOfWeek>*</dayOfWeek>
            <year>*</year>
        </schedule>
        <provider action="IMPORT" name="get-from-optima" type="com.sistemaits.datainterfaces.datex.providers.datex2.DATEX2Provider">
            <host>${defaults/baseUrl}/datex2import</host>
        </provider>
        <provider action="PUBLISH" name="ftp-pubblish-datex-file" type="com.sistemaits.datainterfaces.datex.providers.ftp.FTPDatexProvider">
            <path>/ftp-server-folder-test/</path>
            <ftp_host>ftp.test.it</ftp_host>
            <uname>exampleUser</uname>
            <password>examplePassword</password>
        </provider>
    </datex-process>
</datex-interface>

<datex-process> tag

Tag	Type	Description
datex-process	XML Object	It is associated to three attributes: id: contains the identifier of the data provider. name: contains the name of the interface. enabled: contains a Boolean attribute. If FALSE, the interface is off and is not connected to PTV Optima.

Tag

Type

Description

datex-process

XML Object

It is associated to three attributes:

id: contains the identifier of the data provider.
name: contains the name of the interface.
enabled: contains a Boolean attribute. If FALSE, the interface is off and is not connected to PTV Optima.

Example:

                    <datex-pocess name="ftp_publish_datex" enabled="true">
.....
</datex-process>

<provider> tag

Tag	Type	Description
provider	XML Object	It is associated to three attributes: action: contains identifier of the available actions: IMPORT: import data from the interface. PUBLISH: publish the imported data in the DB. name: contains the name of the provider, used for reading theinformation. type: contains the identifier of the Java class used for implementing the action.

Tag

Type

Description

provider

XML Object

It is associated to three attributes:

action: contains identifier of the available actions:

IMPORT: import data from the interface.
PUBLISH: publish the imported data in the DB.

name: contains the name of the provider, used for reading theinformation.
type: contains the identifier of the Java class used for implementing the action.

Example:

                    <datex-process enabled="true" name="ftp_publish_datex">
.....
    <provider action="IMPORT" name="get-from-optima" type="com.sistemaits.datainterfaces.datex.providers.datex2.DATEX2Provider">
.....
    </provider>
    <provider action="PUBLISH" name="ftp-pubblish-datex-file" type="com.sistemaits.datainterfaces.datex.providers.ftp.FTPDatexProvider">
.....
    </provider>
</datex-process>

Important: The values specified in the type parameter can not be changed.

<second>, <minute>, <hour>, <dayOfMonth>, <month>, <dayOfWeek>, <year> tags

These tags are placed in <datex-process>/<schedule>.

Tag	Type	Description
second minute hour dayOfMonth month dayOfWeek year	XML Object	Contains tags to identify the scheduling time to query the interface. The values that you can specify are compliants to the ScheduleExpression class. Please, see the documentation: http://docs.oracle.com/javaee/6/api/javax/ejb/ScheduleExpression.html

Tag

Type

Description

second

minute

hour

dayOfMonth

month

dayOfWeek

year

XML Object

Contains tags to identify the scheduling time to query the interface.

The values that you can specify are compliants to the ScheduleExpression class.

Please, see the documentation: http://docs.oracle.com/javaee/6/api/javax/ejb/ScheduleExpression.html

Example:

                    <datex-process enabled="true" name="ftp_publish_datex">
    <schedule>
        <second>0</second>
        <minute>*</minute>
        <hour>*</hour>
        <dayOfMonth>*</dayOfMonth>
        <month>*</month>
        <dayOfWeek>*</dayOfWeek>
        <year>*</year>
    </schedule>
.....
</datex-process>

<host> tag

Tag	Type	Description
host	String	Contains the URL endpoint to get XML response.

Example:

                    <datex-process enabled="true" name="ftp_publish_datex">
.....
    <provider action="IMPORT" name="here_trafficstate_import" type="com.sistemaits.optima.adi.providers.here.TrafficStateHereProvider">
        <host>${defaults/baseUrl}/datex2import</host>
    </provider>
.....
</datex-process>

<path>, <ftp_host>, <uname>,<password> tags

These tags are placed in <datex-process>/<provider>

Tag	Type	Description
path ftp_host uname password	String String String String	Tags containing the customer specific FTP server information.

Tag

Type

Description

path

ftp_host

uname

password

String

Tags containing the customer specific FTP server information.

Example:

                    <datex-process enabled="true" name="ftp_publish_datex">
.....
    <provider.....>
.....
        <path>/ftp-server-folder-test</appId>
        <ftp_host>ftp.test.it<ftp_host>
        <uname>exampleUser</appId>
        <password>examplePassword</appCode>
.....
    </provider>
.....
</datex-process>