ページの先頭行へ戻る
Interstage Service Integrator V9.2.0 アプリケーション開発ガイド
付録C 定義の例 > C.1 サービスエンドポイント定義 > C.1.3 ファイル転送の定義
前次

C.1.3 ファイル転送の定義

FTPを利用したファイル転送を行う場合、サービスエンドポイント定義に、ファイル転送で必要な情報を定義します。
ファイル転送の定義には、以下の種類があります。

C.1.3.1 受信

受信側サービスエンドポイント定義の指定例は、以下のとおりです。

指定例

サービスエンドポイント定義

サービスエンドポイント定義：endpoint.xml
<?xml version="1.0" encoding="UTF-8" ?>
<EndpointList xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="esi-endpoint.xsd">
    <Endpoint name="endpoint01" sync="false">
        <SequenceName>gyoumu01</SequenceName>
        <ServiceName>service001</ServiceName>
        <QueueName>ESIInboundQueue</QueueName>
    </Endpoint>
    <Endpoint name="endpoint02" sync="false">
        <SequenceName>gyoumu02</SequenceName>
        <ServiceName>service002</ServiceName>
        <QueueName>ESIInboundQueue</QueueName>
    </Endpoint>
    <Endpoint name="endpoint03" sync="false">
        <SequenceName>gyoumu03</SequenceName>
        <ServiceName>service003</ServiceName>
        <QueueName>ESIInboundQueue</QueueName>
    </Endpoint>
</EndpointList>
表C.7 定義項目

キー名

説明

指定例

1

Endpoint

name

サービスエンドポイント名を指定します。

endpoint01

sync

サービスエンドポイントの同期タイプ“false”(非同期通信)を指定します。

false

SequenceName

シーケンス名を指定します。シーケンス定義に指定したシーケンス名を指定してください。

gyoumu01

ServiceName

サービス名を指定します。サービス情報に指定したサービス名を指定してください。

service001

QueueName

JMSキュー名を指定します。

ESIInboundQueue

2

Endpoint

name

サービスエンドポイント名を指定します。

endpoint02

sync

サービスエンドポイントの同期タイプ“false”(非同期通信)を指定します。

false

SequenceName

シーケンス名を指定します。シーケンス定義に指定したシーケンス名を指定してください。

gyoumu02

ServiceName

サービス名を指定します。サービス情報に指定したサービス名を指定してください。

service002

QueueName

JMSキュー名を指定します。

ESIInboundQueue

3

Endpoint

name

サービスエンドポイント名を指定します。

endpoint03

sync

サービスエンドポイントの同期タイプ“false”(非同期通信)を指定します。

false

SequenceName

シーケンス名を指定します。シーケンス定義に指定したシーケンス名を指定してください。

gyoumu03

ServiceName

サービス名を指定します。サービス情報に指定したサービス名を指定してください。

service003

QueueName

JMSキュー名を指定します。

ESIInboundQueue

サービス情報

サービス情報：service001.xml(改行コードを指定して分割する場合)
<?xml version="1.0" encoding="UTF-8" ?>
<Service name="service001" type="filewatch" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="esi-service.xsd">
    <PropertyList>
        <Property name="filename">/FTPhome/recvdata.dat</Property>
        <Property name="watch">true</Property>
        <Property name="split">CR</Property>
        <Property name="split_CR">0x0D0A</Property>
        <Property name="jmsr.messageAccumulate">true</Property>
    </PropertyList>
</Service>
表C.8 定義項目

キー名

説明

指定例

Service

name

サービス名を指定します。

service001

type

“filewatch”(ファイルの受信を監視し、シーケンスを開始)を指定します。

filewatch

Property

filename

監視対象のファイル名を指定します。ファイル名は、絶対パスで指定してください。

/FTPhome/recvdata.dat

watch

ファイルを監視するかどうかを指定します。

  • true：ファイルを監視する(デフォルト)

  • false：ファイルを監視しない

true

split

ファイル分割の種類を指定します。

  • no：ファイルを分割しない(デフォルト)

  • Size：ファイルサイズで分割
    “Size”を指定した場合は、“split_size”で、分割するファイルサイズを指定してください。

  • CR：監視ファイルのデータを改行コードで分割
    “CR”を指定した場合は、“split_CR”で、改行コードを指定してください。

CR

split_CR

“split”に“CR”を指定した場合、監視ファイルのデータの改行コードを指定します。

  • 0x0D0A：監視ファイルのデータの改行コードがCRLFの場合

  • 0x0A：監視ファイルのデータの改行コードがCRの場合

  • 0x0D：監視ファイルのデータの改行コードがLFの場合

0x0D0A

jmsr.messageAccumulate

JMS-Rキューを使用する場合、メッセージを蓄積するかどうかを指定します。

  • true：蓄積する(デフォルト)

  • false：蓄積しない

true

サービス情報：service002.xml(サイズを指定して分割する場合)
<?xml version="1.0" encoding="UTF-8" ?>
<Service name="service002" type="filewatch" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="esi-service.xsd">
    <PropertyList>
        <Property name="filename">/FTPhome/recvdata2.dat</Property>
        <Property name="watch">true</Property>
        <Property name="split">Size</Property>
        <Property name="split_size">1024</Property>
        <Property name="jmsr.messageAccumulate">true</Property>
    </PropertyList>
</Service>
表C.9 定義項目

キー名

説明

指定例

Service

name

サービス名を指定します。

service002

type

“filewatch”(ファイルの受信を監視し、シーケンスを開始)を指定します。

filewatch

Property

filename

監視対象のファイル名を指定します。ファイル名は、絶対パスで指定してください。

/FTPhome/recvdata2.dat

watch

ファイルを監視するかどうかを指定します。

  • true：ファイルを監視する(デフォルト)

  • false：ファイルを監視しない

true

split

ファイル分割の種類を指定します。

  • no：ファイルを分割しない(デフォルト)

  • Size：ファイルサイズで分割
    “Size”を指定した場合は、“split_size”で、分割するファイルサイズを指定してください。

  • CR：監視ファイルのデータを改行コードで分割
    “CR”を指定した場合は、“split_CR”で、改行コードを指定してください。

Size

split_size

“split”に“Size”を指定した場合、分割するファイルサイズを指定します。

1024

jmsr.messageAccumulate

JMS-Rキューを使用する場合、メッセージを蓄積するかどうかを指定します。

  • true：蓄積する(デフォルト)

  • false：蓄積しない

true

サービス情報：service003.xml(ファイルを監視する場合)
<?xml version="1.0" encoding="UTF-8" ?>
<Service name="service003" type="filewatch" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="esi-service.xsd">
    <PropertyList>
        <Property name="watchtype">ackfile</Property>
        <Property name="filename">/FTPhome/*.dat</Property>
        <Property name="ackfilename">/FTPhome/$[FILENAME].ack</Property>
    </PropertyList>
</Service>
表C.10 定義項目

キー名

説明

指定例

Service

name

サービス名を指定します。

service003

type

“filewatch”(ファイルの受信を監視し、シーケンスを開始)を指定します。

filewatch

Property

watchtype

ファイルの監視方法を指定します。以下のいずれかを指定します。

  • time
    時間で監視します。

  • ackfile
    指定したファイルが到着するまで監視します。

ackfile

filename

監視対象のファイル名を指定します。ファイル名は、絶対パスで指定してください。
ファイル名には、ワイルドカードを指定できます。

/FTPhome/*.dat

ackfilename

監視する完了ファイルのファイルパス（絶対パス）を指定します。ファイルパス内の監視完了ファイル名には、埋込み文字列“$[FILENAME]”を必ず指定してください。埋込み文字列“$[FILENAME]”は、[filename]で指定したファイル名に置き換えられます。

/FTPhome/$[FILENAME].ack
“/FTPhome/*.dat.ack”になります。

C.1.3.2 送信

送信側サービスエンドポイント定義の指定例は、以下のとおりです。

指定例

サービスエンドポイント定義

サービスエンドポイント定義：endpoint.xml
<?xml version="1.0" encoding="UTF-8" ?>
<EndpointList xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="esi-endpoint.xsd">
    <Endpoint name="endpoint02" sync="false">
        <ServiceName>service002</ServiceName>
        <QueueName>ESIFTPQueue</QueueName>
    </Endpoint>
</EndpointList>
表C.11 定義項目

キー名

説明

指定例

Endpoint

name

サービスエンドポイント名を指定します。

endpoint02

sync

サービスエンドポイントの同期タイプ“false”(非同期通信)を指定します。

false

ServiceName

サービス名を指定します。サービス情報に指定したサービス名を指定してください。

service002

QueueName

JMSキュー名を指定します。

ESIFTPQueue

サービス情報

サービス情報：service002.xml
<?xml version="1.0" encoding="UTF-8" ?>
<Service name="service002" type="ftpsend" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="esi-service.xsd">
    <PropertyList>
        <Property name="dirname">/FTPhome/</Property>
        <Property name="filename">senddata_$[DATE].dat</Property>
        <Property name="sendackfile">true</Property>
        <Property name="ackdirname">/FTPhome/</Property>
        <Property name="ackfilename">$[FILENAME].ack</Property>
        <Property name="hostname">127.0.0.1</Property>
        <Property name="port">21</Property>
        <Property name="username">user</Property>
        <Property name="password" secret="true">password</Property>
        <Property name="merge">0</Property>
        <Property name="overwrite">true</Property>
        <Property name="statuscheck">true</Property>
        <Property name="jmsr.messageAccumulate">true</Property>
    </PropertyList>
</Service>
表C.12 定義項目

キー名

説明

指定例

Service

name

サービス名を指定します

service002

type

“ftpsend”(シーケンスの実行結果をFTP送信)を指定します。

ftpsend

Property

dirname

送信先のディレクトリ名を指定します。
デフォルトは、“./”(ログイン時のカレント・ディレクトリ)です。
ディレクトリ名には、アスキーコードを指定してください。

/FTPhome/

filename

送信先のファイル名を指定します。
ファイル名にはアスキーコードを指定してください。
埋込み文字列“$[DATE]”、“$[SEQNAME]”を指定できます。

senddata_$[DATE].dat

sendackfile

送信完了ファイルを転送するかどうかを指定します。以下のいずれかを指定します。

  • true
    転送します。

  • false
    転送しません。

true

ackdirname

送信する完了ファイルのディレクトリを指定します。
デフォルトは、“./”(ログイン時のカレント・ディレクトリ)です。ディレクトリ名には、アスキーコードを指定してください。

/FTPhome/

ackfilename

送信する完了ファイルのファイル名を指定します。ファイル名にはアスキーコードを指定してください。
埋込み文字列“$[FILENAME]”を指定すると、[filename]で指定したファイル名に置き換えられます。

$[FILENAME].ack
“senddata_$[DATE].dat.ack”になります。

hostname

接続先のサーバ名、またはIPアドレスを指定します。

127.0.0.1

port

接続先のポート番号を指定します。標準は、“21”です。

21

username

接続サーバのログインユーザ名を指定します。

user

password

接続サーバのログインパスワードを指定します。

password

  

secret

プロパティの情報(パスワードなど)を暗号化するかどうかを指定します。

  • true：暗号化する

  • false：暗号化しない

true

merge

ファイルを集約するかどうかを指定します。

  • 0：ファイルをすべて集約して送信(デフォルト)

  • 1：ファイルを集約せず、1ファイルずつ送信

0

overwrite

送信先に同一のファイル名が存在した場合、上書きするかどうかを指定します。

  • true：上書き保存する(デフォルト)

  • false：上書き保存しない

true

statuscheck

ファイル転送結果を確認するかどうかを指定します。

  • true：転送が成功したかどうかを確認する(デフォルト)

  • false：転送が成功したかどうかを確認しない

通常は“true”を指定してください。
転送先のファイル一覧を取得し、転送結果を確認します。転送先のFTPサーバがlsコマンドをサポートしていない場合は、“false”を指定してください。

true

jmsr.messageAccumulate

メッセージを蓄積するかどうかを指定します。

  • true：蓄積する(デフォルト)

  • false：蓄積しない

true

前次
Copyright 2010 FUJITSU LIMITED