Comments
Transcript
ASTERIA WARPチュートリアルガイド - ASTERIA Developer Network
チュートリアル
～
はじめまして
ガイド
「ASTERIA WARP」
第１１版
インフォテリア株式会社
～
目次
●
はじめに .......................................................................................................................................... 1
1. ASTERIA WARP の起動と接続 ........................................................................................................... 2
1.1 ASTERIA WARP について ............................................................................................................. 2
1.2 サーバーを起動する....................................................................................................................... 2
1.3 デザイナーを起動する ................................................................................................................... 3
1.4 デザイナーからサーバーへ接続する ............................................................................................. 3
1.5 デザイナーの画面 .......................................................................................................................... 5
2．フローの実行（基本操作） .................................................................................................................. 6
2.1 教材フローの処理を確認し、実行してみましょう ....................................................................... 6
2.2
新規にフローを作成して、実行してみましょう ........................................................................11
2.3
FSMC へログインし、実行ログの確認をしてみましょう ........................................................ 19
3．フローの作成と実行 ........................................................................................................................... 21
3.1 RDB にアクセスするフローを作成して、実行してみましょう .................................................. 21
3.2 RDB から取り出したデータを CSV 形式に変換(マッピング)するフローを作成して、実行してみ
ましょう................................................................................................................................................ 34
3.3 Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう ....................... 42
3.4 RDB を更新するフローを作成して、実行してみましょう ......................................................... 69
補足 1 データベース（MySQL）との連携 ..................................................................................... 77
補足 2 ログビューアーについて..................................................................................................... 82
補足 3 Exception 設定について ...................................................................................................... 90
改版履歴 ........................................................................................................................................ 92
１．ASTERIA WARP の起動と接続
● はじめに
本書は、初めて ASTERIA WARP を操作する方を対象にしたチュートリアル基本編です。
前提として ASTERIA WARP の概要を理解している必要があります。本書を読む前に、ASTERIA WARP
について説明を受けるか、弊社のホームページの ASTEIRA WARP 情報をご一読ください。
◇ 製品概要
http://www.infoteria.com/jp/asteria/pd_warp.php
◇ ソリューション
http://www.infoteria.com/jp/asteria/solution/use.php
◇ 導入事例
http://www.infoteria.com/jp/asteria/case/
◇ 技術者向け情報サイト（ASTERIA Developer Network）
http://www.asteria.jp/
◇ ASTERIA Facebook
https://www.facebook.com/asteriajp
ASTERIA WARP 無料体験版のご案内
ASTERIA WARP 無料体験版を利用出来ます。
https://www.infoteria.com/jp/product/asteria/trial/
・ASTERIA WARP の最新版をフルオプションで試用可能。
・試用期間は 30 日間。
是非お試しください。
1
１．ASTERIA WARP の起動と接続
1.
ASTERIA WARP の起動と接続
ここでは、ASTERIA WARP Server と Flow Designer の起動方法などを説明します。
1.1
ASTERIA WARP について
ASTERIA WARP は、次の４つの構成で各機能を提供します。
No
名称
内容
1 ASTERIA WARP Server
フローおよびパイプラインの実行環境となるプ
ラットフォーム
2 Flow Designer
フローを作成する GUI ベースの統合設計環境
3 Flow Service Management Console
ASTERIA WARP Server のフローサービス管理コン
(FSMC)
ソール
実習では、実際に Flow Designer(以降、デザイナー)を使ってフローを作成して ASTERIA WARP
Server(以降、サーバー)上で実行する方法について解説していきます。Flow Service Management Console
（以降、FSMC）は、フローサービスの運用状況の監視、各種設定、メンテナンスなどが可能な Web
ベースの管理コンソールですが、実習でのフロー作成、実行時には必要がないため、説明を省略します。
1.2
サーバーを起動する
ASTERIA WARP では、デザイナーからサーバーに接続してサーバー上にフローを作成していくため、
先にサーバーを起動します。
○Windows の[スタート
]メニューから→[フローサービス開始
]を選択します。起動するとモニタ
ー画面が表示され、サービスの起動状況を確認することができます。
※画面の右上にある[X](閉じる)ボタンをクリックすると、強制終了してしまうため注意してください。
＊Windows 環境の場合は Windows サービスにもインストール時登録されます。
2
１．ASTERIA WARP の起動と接続
1.3
デザイナーを起動する
デスクトップに作成された[フローデザイナー]のショートカットをダブルクリックします。
1.4
デザイナーからサーバーへ接続する
デザイナーからサーバーへ接続するには、サーバー上で管理している ASTERIA アカウントでログイン
します。実習では、インストール時に自動的に作成される初期アカウントの１つ、guest ユーザーを使
います。各ユーザーはホームディレクトリを持ち、ホームディレクトリは作成したフローの保存先とな
ります。
① ツールバーの一番左にある「サーバーを追加」をクリックして「ログイン」ウィンドウを開きます。
[メニューバー]
[ツールバー]
「サーバーを追加」をクリック
3
１．ASTERIA WARP の起動と接続
② 「ログイン」ウィンドウの各項目へ以下の内容を入力し、「OK」ボタンをクリックします。
③ 接続に成功すると、デザイナー画面の左側にサーバーの情報(サーバーリスト)が表示されます。
サーバーリスト
4
１．ASTERIA WARP の起動と接続
1.5
デザイナーの画面
ここで、デザイナーの画面構成について簡単に説明します。
デザイナーの画面はフローの構成要素ごとにペインが独立しています。
【１
【２
【３
【４
【５
【６
【７
【８
【９
パレット】
ツリーペイン】
ファイルペイン】
コネクションペイン】
インスペクタ】
変数ペイン】
ストリームペイン】
メッセージペイン】
ワークスペース】
【１ パレット】
【
２
ツ
リ
ー
ペ
イ
ン
】
【
５
イ
ン
ス
ペ
ク
タ
】
【９ ワークスペース】
【
３
フ
ァ
イ
ル
ペ
イ
ン
】
【４ コネクションペイン】
【７ ストリームペイン】
【８ メッセージペイン】
※レイアウトを好みに変更することができ、また、メニューからすぐに初期状態
きます。
5
【
６
変
数
ペ
イ
ン
】
に戻すことがで
２．１ 教材フローの処理を確認し、実行してみましょう
2．フローの実行（基本操作）
ここでは、フローの基本概念と実行方法などを説明します。
2.1
教材フローの処理を確認し、実行してみましょう
教材にあるすでに作成されたフロー(Excel ファイルから CSV ファイルを作成する)を実行します。
プロジェクトとフロー
１つの処理を行う単位で「フロー」を作成します。複数のフローをまとめて管理するものを「プロジェ
クト」といいます。ASTERIA WARP では、一つのプロジェクトを一つのファイルとして保存し、その
ファイルのことをプロジェクトファイル、または拡張子から xfp ファイルといいます。保存先はユーザ
ーのホームディレクトリです。
ユーザー環境の確認
すでに guest ユーザーのホームディレクトリには、ここで使うための教材のフローとデータファイルが
置かれています。デザイナー画面の左側にあるツリーペインとファイルペインにて確認してください。
ツリーペイン
ファイルペイン
フローの確認
○教材にある Work.xfp の「work1」フローをダブルクリックして開いてください。
6
２．１ 教材フローの処理を確認し、実行してみましょう
このフローは、Excel で作成された注文書(order1.xls)から CSV データを生成し、ホームディレクトリの
output フォルダに order1003_yyyy-MM-dd.csv というフローの実行日を含んだ名前でファイルを作成し
ています。
フローの実行
① 左側のツリーから「Work.xfp」プロジェクトの「work1」フローをダブルクリックして開きます。
② ツールバーの「フローの実行」をクリックして「フローの実行」ウィンドウを開きます。
フローの実行
③ デザイナー下部のメッセージペインにコンパイルの結果が表示されます。
コンパイルとは、デザイナーで作成したフローの記述に間違いがないかどうか確認することをいい
ます。デザイナーの初期状態の環境設定では、フローの保存時にコンパイルするようになっている
ため、この実習時には特に意識する必要はありません。また、デザイナーからのフローの実行時に
は、保存してコンパイルするようになっています。
7
２．１ 教材フローの処理を確認し、実行してみましょう
フ
ロ
ー
の
実
行
ウ
ィ
ン
ド
ウ
実行ボタン
コンパイルの結果
メ
ッ
セ
ー
ジ
ペ
イ
ン
④ 「フローの実行」ウィンドウ下部の「実行」ボタンをクリックし、フローを実行します。
ステータスが「正常終了」になります。出力ストリームの欄では、ファイルに出力された内容を確
認することができます。
出力された内容
実行結果
⑤ 確認後、
「閉じる」ボタンをクリックします。
8
２．１ 教材フローの処理を確認し、実行してみましょう
フローは、以下のようなイメージで呼び出され、実行されています。
実行結果の確認
フローで生成したファイルを確認します。
① 左側のファイルペインの上段にある「最新の状態に更新」ボタンをクリックします。
最新の情報に更新
9
２．１ 教材フローの処理を確認し、実行してみましょう
② ツリーから output フォルダをダブルクリックして、出力されたファイルを表示します。
ダブルクリック
③ 「order1003_yyyy-MM-dd.csv」(yyyy-MM-dd は今日の日付)をダブルクリックして、CSV ファイル
を開きます。
（CSV ファイルの場合、Excel が起動します）
ダブルクリック
④ 実行結果の CSV データの内容を確認することができます。
10
２．２ 新規にフローを作成して、実行してみましょう
2.2 新規にフローを作成して、実行してみましょう
ここでは、フローの作成手順と基本的な操作方法などを説明します。
先ほど実行した「work1」フローが出力したファイルを読み込むフローを作成、実行します。
新規プロジェクト、新規フローの作成
フローを作成するには、まずプロジェクトを作成します。
① ツリーペインのサーバーを選択し、右クリックで表示されるメニューから「プロジェクトの作成」
を選択して、
「プロジェクトの作成」ウィンドウを開きます。
選択
② ここでは初期値のままプロジェクトを作成します。
「OK」ボタンをクリックします。
11
２．２ 新規にフローを作成して、実行してみましょう
③ 左側のツリーペインに、新規プロジェクトとフローが追加されます。ワークスペースには新規フロ
ーが表示されます。
コンポーネント
ファイルの読み書きや、データベースとの入出力など、さまざまな機能を持ったアイコンをつなぎ合わ
せていくことで、フローの処理を作成していきます。そのアイコンのことを「サービスコンポーネント」
といい、通常「コンポーネント」と呼んでいます。各コンポーネントはデザイナーの上部にあるパレッ
トに機能ごとのタブにまとめられています。(コンポーネントによっては、別途ライセンスを必要とする
場合があります。
コンポーネントの使い方を参照するには：
メニューバーにある「ヘルプ」を選択し、表示されたメニュー内の「ヘルプ」を選択すると、Web ブラ
ウザで「フローサービスマニュアル」が表示されます。「コンポーネント」タブを選択すると、各種コ
ンポーネントの詳細が表示されます。
また、コンポーネントがパレットにある状態、またはフローに配置した状態で右クリックして表示され
るメニューから「ヘルプ」を選択すると Web ブラウザでヘルプが表示されます。
ストリーム
フロー、コンポーネントが入出力するデータを ASTERIA WARP では「ストリーム」といいます。
12
２．２ 新規にフローを作成して、実行してみましょう
処理の作成
新規フローの初期状態には、Start コンポーネントが配置されています。
① Start に続けて、ファイルを読み込むコンポーネント(「ファイル」タブの「FileGet」)を、ワークス
ペースにドラッグ＆ドロップして配置します。
※コンポーネント間は配置された段階で自動的に連結されます。
ドラッグ＆ドロップ
② フローを終了するコンポーネント(パレット内の「お気に入り」にある「EndResponse」)を配置し
ます。
ドラッグ＆ドロップ
13
２．２ 新規にフローを作成して、実行してみましょう
コンポーネントや連結を削除するには：
コンポーネントまたは連結線をクリックして選択し、Delete キーを押すか、右クリックして表示された
メニューから「削除」を選択します。
コンポーネントとコンポーネントを連結するには：
コンポーネントの下部にある丸印（コネクタ）にマウスカーソルを合わせます。アイコンの形状が下記
になります。
その状態でドラックし、連結したいコンポーネントにドロップして連結を行います。
自動的に連結させないようにするには：
パレットからワークスペースに、Ctrl キーを押しながら配置すると、自動的に連結されません。また、
メニューバーの「ツール」 >> 「環境設定」にある「表示／編集」タブの「フロー」欄 >> 「コンポー
ネントドロップ時に直近のコンポーネントに自動リンクする」を解除すれば、自動的に連結されません。
解除
14
２．２ 新規にフローを作成して、実行してみましょう
処理内容の設定
コンポーネント毎に、必要となるプロパティを設定します。
このフローでは、
「FileGet」コンポーネントで読み出すファイル名(［ファイルパス］プロパティ)のみの
設定で、フローの作成は完了です。
① 「FileGet」コンポーネントをクリックして、右上のインスペクタにプロパティを表示します。
選択したコンポーネント
(FileGet)のプロパティ
② ［ファイルパス］プロパティの右側の入力欄をクリックし、さらに右端に表示される「...」をクリ
ックして、ファイルパスの入力ウィンドウを表示します。
15
２．２ 新規にフローを作成して、実行してみましょう
③ ホームディレクトリが表示されるので、ここでは「output」を選択します。
④ 「output」ディレクトリが表示されるので、ここでは「order1003_yyyy-MM-dd.csv」(yyyy-MM-dd
は今日の日付)を選択し、
「開く」ボタンをクリックします。
⑤ 右下のストリームペインにあるプロパティ名のストリーム型の左側に表示される「＋」をクリック
します。
16
２．２ 新規にフローを作成して、実行してみましょう
⑥ 切り替わった下部の内容を以下のように設定します。
これで、フローの作成が完了しました。
フローの実行
フローを保存し、コンパイル処理が OK になりフローが実行可能であるか確認します。
① ツールバーの「プロジェクトを保存」ボタンをクリックします。
下部のメッセージペインのコンパイル結果が OK であるか確認します。
コンパイルの結果に NG が表示された場合は、フローの内容を確認してください。
② ツールバーの「実行」をクリックして「フローの実行」ウィンドウを開きます。
フローの実行
17
２．２ 新規にフローを作成して、実行してみましょう
③ ウィンドウ下部の「実行」ボタンをクリックし、フローを実行します。
ステータスが「正常終了」になります。出力ストリームの欄では、読み込んだファイルの内容を確
認することができます。
④ 確認後、
「閉じる」ボタンをクリックします。
18
２．３ FSMC へログインし、実行ログの確認をしてみましょう
2.3 FSMC へログインし、実行ログの確認をしてみましょう
ここでは、FSMC(Flow Service Management Console)よりフローの実行ログを閲覧し、上記フローの実
行確認をします。
FSMC へのアクセス
フローデザイナー[ツール]メニューから[FSMC を開く]を実行し、FSMC ログイン画面を表示します。
① FSMC へのログイン
ログイン画面右上の「ユーザー名」と「パスワード」を入力し、
「ログイン」ボタンをクリックします。
[ユーザー名：asu パスワード： (ブランク)]
19
２．３ FSMC へログインし、実行ログの確認をしてみましょう
② ログ情報の閲覧
[状態]メニューの[ログ] >> [システム] 画面（FSMC ログイン直後の遷移画面）でログ表示設定をデフォ
ルトの状態で「表示」ボタンをクリックします。
表示されたログ情報一覧よりフローの実行を確認することができます。
※（補足）ユーザ・ドメインの追加/変更/削除
FSMC より[ツール]メニューの[アカウント]画面で設定/確認することができます。
実習では ASTERIA WARP Server をインストールした初期状態で作成されているアカウント[guest]を使
用しますのでユーザ・ドメインの作成は省略します。
20
３．１ RDB にアクセスするフローを作成して、実行してみましょう
3．フローの作成と実行
フローの作成と実行（RDB アクセス）
ここでは、ASTERIA WARP でよく使われるデータベースからデータを取り出すコンポーネントの使い
方などを説明します。
3.1
RDB にアクセスするフローを作成して、実行してみましょう
教材のデータベースからデータを取り出し、
HTML 形式に変換して出力するフローを作成、
実行します。
RDB
「RDBGet」コンポーネントを使って、教材として用意した MySQL のデータベースから注文データを
取り出します。
「RDBGet」コンポーネントは「SQL ビルダー」という SQL 文を生成する GUI ツールを
持っています。
ASTERIA WARP から MySQL に接続するためには、事前に JDBC ドライバの設定や Flow
Service 管理ツールで RDB 接続情報(コネクション)を定義しておくことが必要ですが、実習時には定義
済みになっています。
HTML
「Velocity」コンポーネントと、教材として用意したテンプレートファイルを使って、HTML を出力し
ます。テンプレートファイルの中身では、Velocity というテンプレート言語を用いて HTML の中にデー
タの差込み処理を記述しています。フローを実行すると、
「Velocity」コンポーネントは、データベース
から取り出したデータを入力として処理し、HTML データを出力します。
実行
ASTERIA WARP には、フローと URL を関連づけ、Web ブラウザから URL を入力するとフローが実行
されてフローの実行結果が Web ブラウザに表示されるという実行方法(URL 実行)があります。ここで
は、URL 実行してフローの実行結果(HTML)を Web ブラウザで表示してみます。
21
３．１ RDB にアクセスするフローを作成して、実行してみましょう
フローの作成
ツリーペインのプロジェクトを選択し、右クリックで表示されるメニューから「フローの作成」を選択
して、
「フローの作成」ウィンドウを開きます。
ここでは初期値のままフローを作成します。
「OK」ボタンをクリックします。
22
３．１ RDB にアクセスするフローを作成して、実行してみましょう
ワークスペースに、新しいフロー「Flow2」が表示されます。
「RDBGet」コンポーネントの配置
「データベース」タブの「RDBGet」コンポーネントを、ワークスペースにドラッグ＆ドロップし
て配置します。
ドラッグ＆ドロップ
「Velocity」コンポーネントの便利な配置方法
左側のファイルペインからテンプレートファイル「order.vm」をドラッグして、ワークスペース上でド
ラッグを終了します。すると、使用可能なコンポーネント（一部）の一覧が表示されますので、ここで
は「Velocity」コンポーネントを選択します。
23
３．１ RDB にアクセスするフローを作成して、実行してみましょう
ドラッグ＆ドロップ
ワークスペースに「Velocity」コンポーネントが配置され、
［ファイルパス］プロパティに「order.vm」
が設定された状態になります。ここでは［ファイルのエンコーディング］プロパティを「Windows-31J」
に変更します。
通常のように、下部のパレットの「ツール」タブから「Velocity」コンポーネントを配置してプロパテ
ィを設定する方法でもできます。
ワークスペース上にある「Velocity」コンポーネントの下側(“TXT”という文字列)をクリックすると、ス
トリーム型を変更することができますので、ここでは「HTML」を選択します。
24
３．１ RDB にアクセスするフローを作成して、実行してみましょう
「EndResponse」コンポーネントの配置
「お気に入り」にある「EndResponse」コンポーネントを、ワークスペースにドラッグ＆ドロップ
して配置します。
ドラッグ＆ドロップ
25
３．１ RDB にアクセスするフローを作成して、実行してみましょう
「RDBGet」コンポーネントの設定 (SQL ビルダーによる設定)
① 「RDBGet」コンポーネントをクリックして、右上のインスペクタにプロパティを表示します。
② 「基本」タブで［コネクション名］プロパティをクリックして、リストから「work_order」を選択
します。これは、RDB 接続情報に任意の名前(ここでは「work_order」)をつけた定義を参照してい
ます。(接続情報は、デザイナーのコネクションペイン、または、フローサービス管理コンソール
(FSMC)で設定・変更することができますが、実習では省略しています。)
「コネクション名」のリストから選択
選択
※上記画面キャプチャでは「フィルターを指定」を選択しているように見えますが、実際は「コネ
クション名」のリストから選択しています。
26
３．１ RDB にアクセスするフローを作成して、実行してみましょう
③ 「RDBGet」コンポーネントを選択して、右クリックで表示されるメニューから「SQL ビルダー」
を選択します。
選択
④ 「SQL ビルダー」ウィンドウが表示されますので、左側に表示されているテーブル一覧から「注文」
テーブルを選択し、中央の白いキャンバスにドラッグ＆ドロップして配置します。すると、
「注文」
テーブルのフィールド一覧が表示されます。
ドラッグ＆ドロップ
27
３．１ RDB にアクセスするフローを作成して、実行してみましょう
⑤ 白いキャンバス上の「注文」テーブルを選択し、右クリックして表示されたメニューから「全選択」
を選択します。
選択
⑥ フィールド一覧のチェックボックスが全てチェックされ、下段には自動生成された SQL 文が表示
されます。
28
３．１ RDB にアクセスするフローを作成して、実行してみましょう
⑦ 次に、フィールド「注文 ID」で昇順に取り出すために、右側中段の「ソート」タブを選択し、
「フ
ィールド名」で「注文 ID」を選択します。
選択
⑧ 「Java データ型」と「ソート順」
（デフォルトでは“昇順”）が表示されます。ここでは「ソート順」
は変更せずに、そのままの設定とします。下段に表示された SQL 文に“ORDER BY”が追加され
ていることを確認してください。
・「ソート」タブ欄
・自動生成された SQL 文（下段）
29
３．１ RDB にアクセスするフローを作成して、実行してみましょう
⑨ 次に、自動生成された SQL 文で取得可能かテストします。右下にある「SELECT テスト」ボタン
をクリックしてください。
⑩ 「SELECT テスト」ウィンドウが表示され、テスト結果が表示されます。内容確認後、「閉じる」
ボタンをクリックして閉じてください。
⑪ このテスト結果で問題がなければ、最下段にある「OK」ボタンをクリックします。すると、以下
の確認ダイアログが表示されますので、
「はい」ボタンをクリックしてください。
30
３．１ RDB にアクセスするフローを作成して、実行してみましょう
⑫ この操作で、テーブルのすべてのカラムが読み込むフィールドとして定義されました。右下のスト
リームペインに表示されています。
これで、フローの作成が完了しました。
フローの実行
フローを保存し、コンパイル処理が OK になりフローが実行可能であるか確認します。
① ツールバーの「プロジェクトを保存」ボタンをクリックします。
下部のメッセージペインのコンパイル結果が OK であるか確認します。
コンパイルの結果に NG が表示された場合は、フローの内容を確認してください。
② ツールバーの「実行設定一覧」をクリックして、実行設定の一覧を表示し、
「URL」を選択します。
一覧
クリック
31
３．１ RDB にアクセスするフローを作成して、実行してみましょう
③ 「実行設定」ウィンドウが表示されますので、下段にある「登録」ボタンをクリックします。
④ 中段に表示された「URL の設定」
「公開するプロトコル」の「ブラウザから実行」ボタンが押下可
能となるので、このボタンをクリックしてフローを実行します。
32
３．１ RDB にアクセスするフローを作成して、実行してみましょう
⑤ 自動的に Web ブラウザが表示され、ブラウザ内に実行結果が表示されます。
33
３．２ RDB から取り出したデータを CSV 形式に変換(マッピング)するフローを作成して、
実行してみましょう
フローの作成と実行（マッピング）
ここでは、ASTERIA WARP の重要な機能のひとつであるデータのマッピングなどを説明します。
3.2
RDB から取り出したデータを CSV 形式に変換(マッピング)するフローを作成して、
実行してみましょう
先ほどのフローを更新して、教材のデータベースからデータを取り出し、CSV 形式のファイルを出力す
るフローを作成、実行します。
パラレル
あるコンポーネントが出力するストリームに対して異なる複数の処理を行いたい場合、そのコンポーネ
ントから複数のコンポーネントに直接連結することができます。このようなストリームの分岐を「パラ
レル」といいます。ここでは、パラレルを使って先ほどのフローから複数の処理をするフローを作成し
ます。
フローの実行結果(レスポンス)は１つであるため、実行結果を出力する EndResponse コンポーネント
はフローの中で１つにし、他の処理の終了は End コンポーネントを使います。
データのマッピング
データのマッピングとは、データ形式の変換(たとえば、CSV→RDB、RDB→XML など)や、データ項目
間のマッピングを行う処理のことで、Mapper コンポーネントを使います。この実習では、RDB→CSV
の変換を行います。
マッピングウィンドウでは、左側に入力データ項目、右側に出力データ項目がツリー形式で表示されま
す。左から右へ矢印をつなぐことで、データのマッピングを定義します。中央のキャンバスでは、「マ
ッパー関数」という変換処理を示すアイコンを配置してデータを加工することができます。
入力データ項目
出力データ項目
マッパー関数
34
３．２ RDB から取り出したデータを CSV 形式に変換(マッピング)するフローを作成して、
実行してみましょう
フローの作成(複製)
① 左側のツリーペインから先ほど作成したフロー「Flow2」を選択して、右クリックして表示される
メニューから「複製」を選択します。
選択
② 入力ウィンドウが表示されますので、フロー名に「Flow3」を入力し、「OK」ボタンをクリックし
ます。
③ ツリーペインに「Flow3」フローが追加されます。ワークスペースには「Flow3」フローが表示され
ます。
35
３．２ RDB から取り出したデータを CSV 形式に変換(マッピング)するフローを作成して、
実行してみましょう
コンポーネントの配置、連結
Mapper、FilePut、End コンポーネントを下図のように配置して連結します。
・フロー
・Mapper
・FilePut
・End
36
３．２ RDB から取り出したデータを CSV 形式に変換(マッピング)するフローを作成して、
実行してみましょう
Mapper コンポーネントの設定
① 「Mapper」コンポーネントをクリックして、右下のストリームペインにある［ストリーム型］の右
側のリストボックスを選択し、
「CSV」を選択します。
選択
② ［出力エンコーディング］プロパティを選択しリストボックスから「Windows-31J」を選択します。
選択
③ 「Mapper」コンポーネントをダブルクリックして、マッピングウィンドウを表示します。
37
３．２ RDB から取り出したデータを CSV 形式に変換(マッピング)するフローを作成して、
実行してみましょう
④ 左側の「注文 ID」からドラッグして、右側の「field1」でドラッグを終了します。フィールドがマ
ッピングされます。
同様に、
「型番」を「field2」へ、
「数量」を「field3」へマッピングします。
⑤ ファイルパスとして、今日の日付が含まれた名前を作成します。
それぞれのタブから以下のようにマッパー関数を配置し、右側の［ファイルパス］プロパティに連
結します。
(2)
(1)
38
３．２ RDB から取り出したデータを CSV 形式に変換(マッピング)するフローを作成して、
実行してみましょう
(1) Now 関数 (現在の日時を返します)
(2) Embed 関数
(文字列中に入力値を埋め込んで出力します)
⑥ Now 関数をクリックして、右上のインスペクタにプロパティを表示します。
［日付フォーマット］
プロパティに「yyyyMMdd」を入力します。(y は西暦年、M は月、d は日とそれぞれの桁数を指し
ます。)
“yyyyMMdd”と入力
⑦ Embed 関数をクリックして、右上のインスペクタにプロパティを表示します。
［データ］プロパテ
ィの右側にある「…」をクリックして、
「データプロパティの編集」ウィンドウを表示させます。
クリック
⑧ 入力欄に「output/order${input1}.csv」と入力し、
「OK」ボタンをクリックします。これは、${input1}
の部分を Embed 関数への(一番目の)入力値に置き換えて動的な文字列を生成し、それをファイルパ
ス名に設定しています。これにより、次の FilePut コンポーネントのプロパティで［ファイルパス］
への設定は不要になります。(設定されていた場合、マッピングした値に置き換えられます。)
39
３．２ RDB から取り出したデータを CSV 形式に変換(マッピング)するフローを作成して、
実行してみましょう
⑨ 「Mapper」タブの右側の「×」ボタンをクリックして、ウィンドウを閉じます。
フローの実行
先ほど HTML データの内容を Web ブラウザで確認したので、ここでは簡単に「ASTERIA Designer か
ら実行」で結果を確認します。
フローを保存し、コンパイル処理が OK になりフローが実行可能であるか確認します。
① ツールバーの「プロジェクトを保存」ボタンをクリックして、下部のメッセージペインのコンパイ
ル結果が OK であるか確認します。
コンパイルの結果に NG が表示された場合は、フローの内容を確認してください。
② ツールバーの「実行」をクリックして「フローの実行」ウィンドウを開きます。
フローの実行
③ ウィンドウ下部の「実行」ボタンをクリックし、フローを実行します。
ステータスが「正常終了」になります。出力ストリームの欄では、EndResponse コンポーネント
からの出力である HTML データの内容を確認することができます。
40
３．２ RDB から取り出したデータを CSV 形式に変換(マッピング)するフローを作成して、
実行してみましょう
④ 確認後、
「閉じる」ボタンをクリックします。
出力ファイルの確認
フローで生成したファイルを確認します。
① 左側のファイルペインの上段にある「最新の情報を更新」ボタンをクリックします。
② ファイルペインから output フォルダをダブルクリックして、output フォルダを展開します。
ダブルクリック
③ output フォルダにある「orderyyyyMMdd.csv」(yyyyMMdd は今日の日付)をダブルクリックして、
CSV ファイルを開きます。（CSV ファイルの場合、Excel が起動します）
ダブルクリック
④ 実行結果の CSV データの内容を確認することができます。
41
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
フローの作成と実行(Excel 連携)
ASTERIA WARP でよく使われる Excel からデータを取り出すコンポーネントの使い方を説明します。
3.3
Excel 連携
教材フローと同じ処理のフローを作成して、実行してみましょう
教材にあるすでに作成されたフローと同じ、
Excel ファイルから CSV ファイルを作成するフローを作成、
実行します。
フローの確認
○教材にある Work.xfp の「work1」フローをクリックして開いてください。
このフローは、Excel で作成された注文書から CSV データを生成し、ホームディレクトリの output フ
ォルダに order1003_yyyy-MM-dd.csv というフローの実行日を含んだ名前でファイルを作成しています。
42
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
Excel
「ExcelInput」
コンポーネントを使って教材として用意した order1.xls から注文データを取り出します。
「ExcelInput」コンポーネントは、
「Excel ビルダー」という取り出すワークシートを定義する GUI ツー
ルを持っています。
「Excel ビルダー」は、Excel 2000 以上で動作するアドオンソフトウェアです。デザ
イナーをインストールするより前に、Microsoft Excel があらかじめインストールされている必要があり
ます。また、「Excel ビルダー」はマクロを使用するため、Excel でマクロの実行権限(Excel の[ツール]
メニューの[マクロ]→[セキュリティ]または[オプション]→[マクロ]→[セキュリティ]での設定)を「中」以
下に設定します。
「ExcelInput」コンポーネントは、Excel ファイルではなく Excel データを入力ストリームとしてデータ
を取り出す処理を行います。つまり、教材フローのように Excel ファイルを処理する場合は、
「FileGet」
コンポーネントでファイルを読み込んだデータを入力とします。
※「ExcelInput」コンポーネントは、オプションのライセンスが必要です。
43
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
新規プロジェクト、新規フローの作成
フローを作成するには、まずプロジェクトを作成します。
① ツリーペインのサーバーを選択し、右クリックで表示されるメニューから「プロジェクトの作成」
を選択して、
「プロジェクトの作成」ウィンドウを開きます。
選択
② ここでは初期値のままプロジェクトを作成します。
「OK」ボタンをクリックします。
③ 左側のツリーペインに、新規プロジェクトとフローが追加されます。
44
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
コンポーネントの配置、連結
各コンポーネントを下図のように配置します。
・フロー
①
②
③
④
⑤
・①FileGet、④FilePut
・②ExcelInput
※「FileGet」コンポーネントと「ExcelInput」コンポーネントを接続すると、以下の確認ダイアログが表示されますので、
「はい」ボタンをクリックしてください。
「FileGet」コンポーネントのアイコンの右下に表示される出力ストリームの型が自動的に「BIN」(Binary)に変わります。
・③Mapper、⑤EndResponse
45
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
「FileGet」コンポーネントの［ファイルパス］プロパティの特殊な設定方法
左側のファイルペインからテンプレートファイル「order1.xls」をドラッグして、ワークスペースの
「FileGet」コンポーネント上でドラッグを終了します。すると、
「FileGet」コンポーネントの［ファイ
ルパス］プロパティに「order1.xls」が設定された状態になります。通常のように、［ファイルパス］プ
ロパティのフィールドをクリックし、入力して設定する方法でもできます。
ドラッグ＆ドロップ
「ExcelInput」コンポーネントの設定
① 「ExcelInput」コンポーネントをダブルクリックすると、Excel が起動されます。
マクロのセキュリティの設定によって以下のダイアログが表示された場合、マクロを使用するため、
「マクロを有効にする」ボタンをクリックします。
（＊Excel2007）
② 起動された Excel のツールバーに「Excel ビルダー」アイコンがあるかどうか確認します。
（＊Excel2007）
46
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
③ [ファイル]メニューの[開く]から、
「C:¥asteriahome¥flow¥home¥guest¥order1.xls」を選択して開き
ます。
ここでは、以下のワークシートから名前と注文内容を取り出します。
※ 「Excel ビルダー」での定義時に使用する Excel ファイルは、フォーマットが同じで値の設定が
ないテンプレートとなるファイルやここでのように実際のファイルなどを参照します。(定義時
のワークシート名とフロー実行時に参照するワークシート名は同じである必要があります。)
④ ツールバーの「Excel ビルダー」のアイコンをクリックします。
（＊Excel2007）
47
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
⑤ 「Excel ビルダー」ウィンドウが表示されます。
「Excel ビルダー」を使って取り出す単一セル、レ
コードを定義します。
⑥ まず、レコードの取り出しを定義します。「レコード」タブで「■レコード」欄の「追加」ボタン
をクリックします。
※ ここから Excel 上のデータ領域を、マウスを使って選択するので、データ領域と「Excel ビルダ
ー」ウィンドウが重なっている場合は位置をずらしておきます。
48
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
⑦ Excel のワークシート上でマウスをドラッグして、I 列 34 行から B 列 25 行まで選択します。
※ 矩形領域を選択する場合、下から上へドラッグして選択するほうが操作しやすくなります。
⑧ 「範囲指定」ウィンドウに範囲が設定されたことを確認して、「OK」ボタンをクリックします。
⑨ 「レコード名入力」ウィンドウでは、
「注文」と入力して「OK」ボタンをクリックします。
49
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
⑩ 「レコード行数入力」ウィンドウでは、
「1」と入力して「OK」ボタンをクリックします。
⑪ レコードのフィールド(列)の名前を変更します。(名前を付けると、マッピング時にわかりやすくな
ります。)
「■レコード」欄で追加されたレコードを選択します。下部の「■レコードフィールド」欄が表示
されます。
50
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
⑫ 「■レコードフィールド」欄で「B」フィールドを選択し、「変更」ボタンをクリックします。
⑬ 表示された「名前入力」ウィンドウで「商品」と入力して「OK」ボタンをクリックします。
「レコ
ード終了条件を指定しますか？」のメッセージボックスでは「いいえ」をクリックします。
51
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
⑭ 同様に、
「E」フィールドを「型番/メーカー」、
「H」フィールドを「数量」に名前を変更します。
52
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
※「フィールド名取得」ボタンからの操作でも設定することが出来ます。
「フィールド名取得」ボタンをクリック
「範囲指定」ウィンドウにフィールド名を取得する範囲を設定して、
「OK」ボタンをクリック。
53
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
⑮ 次に、セルの取り出しを定義します。ここでは名前を取り出します。
「Excel ビルダー」の「単一セル」タブで「■単一セル」欄の「追加」ボタンをクリックします。
⑯ Excel のワークシート上で、マウスで C 列 8 行を選択します。
「範囲指定」ウィンドウに範囲が設定されたことを確認して、「OK」ボタンをクリックします。
⑰ 「項目入力」ウィンドウでは、
「名前」と入力して「OK」ボタンをクリックします。
54
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
⑱ すべての設定が終了したら「登録」ボタンをクリックします。「登録しました」というメッセージ
の確認ダイアログが表示されるので「OK」ボタンをクリックします。
※ 「閉じる」ボタンで終了すると、設定内容は保存されないので注意してください。
⑲ Excel を終了して、デザイナーに戻ります。
⑳ 右上のインスペクタにある「単一セル」タブで、「単一セル」として定義したフィールドが設定さ
れているか確認します。
また、右下のストリームペインにあるストリーム情報で、「レコード」として定義したフィールド
が設定されているか確認します。
これで、
「Excel ビルダー」での定義が完了しました。
55
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
「Mapper」コンポーネントでの CSV 形式の定義（インポートによるフィールド定義）
以下の形式の CSV ファイルを出力するようにマッパーを使って Excel データから変換します。
“注文 ID”,”顧客 ID”,”申込日”,”商品名”,”型番”,”メーカー”,”数量”
注文 ID
次の顧客 ID にレコード番号を付加したもの
顧客 ID
顧客テーブルにある名前に対応する顧客 ID
申込日
フロー実行日
商品名
Excel の注文書での「商品名」欄のデータ
型番
Excel の注文書での「型番/メーカー」欄の”/”の左の文字列
メーカー
Excel の注文書での「型番/メーカー」欄の”/”の右の文字列
数量
Excel の注文書での「数量」欄のデータ
① 「Mapper」コンポーネントをクリックして、右下のストリームペインにあるプロパティ名のストリ
ーム型を選択します。そして、ストリーム型の値で表示されるリストボックスから「CSV」を選択
します。
選択
② 切り替わった下部の内容を以下のように設定します。
設定済み
56
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
③ マッピング時に作成する CSV 形式のフィールドをわかりやすくするためにフィールド名を変更し
ます。
フィールドの定義ファイルを用意しておいて、それをインポートすることで一括定義することがで
きます。ここでは、field_name.csv として以下の定義ファイルを参照します。
④ 右下のストリームペインにあるプロパティ名のストリーム型の左側に表示される「－」をクリック
して、CSV ファイルのフィールドを表示します。
クリック
⑤ 表示されたフィールド欄上で右クリックして表示されるメニューから「インポート」を選択します。
選択
57
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
⑥ 「フィールド定義のインポート」ウィンドウで、ファイルタイプ、エンコーディングを以下のよう
に選択し、参照で「C:¥asteriahome¥flow¥home¥guest¥field_name.csv」を選択して「開く」ボタ
ンをクリックします。
②shift_jis に変更
①CSV ファイル(*.csv)に変更
以下のように、フィールドの名前が変更されます。
※表示されたフィールドをダブルクリックして名前を変更することもできます。
58
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
マッピング
① 「Mapper」コンポーネントをダブルクリックして、マッピングウィンドウを表示します。
② 左側の「商品」からドラッグして、右側の「商品名」でドラッグを終了します。フィールドがマッ
ピングされます。同様に、左側の「数量」を右側の「数量」へマッピングします。
③ Excel のメーカー欄の値から、型番とメーカーの値を生成します。 たとえば、Excel のメーカー欄
の値「xxxx-yyyyy-ppppp/ロジ」を型番「xxxx-yyyyy-ppppp」とメーカー｢ロジ｣にします。
以下のように左側の「型番/メーカー」からマッパー関数を使って右側の「型番」と「メーカー」に
マッピングします。
59
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
・Split 関数
(入力文字列を指定した区切り文字で分割します)
プロパティを以下のようにします。
（
「/」は半角文字）
（１）”/”で文字列を分割
④ データベースにある「顧客」テーブル(下図参照)から、Excel の名前欄の値(顧客名)に対応する顧客
ID を取得し、注文 ID を生成します。
60
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
⑤ 以下のように左側の「名前」からマッパー関数（TableDB）を使って右側の「顧客 ID」にマッピン
グし、（１）のマッパー関数（TableDB）の出力と「レコード番号」から、（２）のマッパー関数
（Concatenate）を使って右側の「注文 ID」にマッピングします。
（１）TableDB 関数
(データベースのテーブルから検索を行い、その結果を値として返します)
（２）Concatenate 関数 (複数の文字列を結合して一つの連結文字列につなげます)
⑥ TableDB 関数をクリックして、右上のインスペクタにプロパティを表示します。
［コネクション名］プロパティをクリックして表示されるリストから「work_order」選択します。
⑦ 「TableDB」関数を選択して、右クリックで表示されるメニューから「SQL ビルダー」を選択。
61
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
「SQL ビルダー」ウィンドウの左側に表示されているテーブル一覧から「顧客」テーブルを選択し、中
央の白いキャンバスに配置後、顧客テーブルのフィールド一覧から「顧客 ID」を選択
顧客テーブルのフィールド一覧から「顧客名」を選択し、右クリックメニューより「条件の追加」を
選択
条件の編集ウィンドウで「パラメータとの比較」を選択し、パラメータリストから「input1」を選択し、
OK ボタンをクリック
62
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
条件が設定され、下段に表示された SQL 文に“WHERE”句が追加されていることを確認後、
「OK」ボ
タンをクリック
TableDB 関数の「SQL 文」プロパティは以下の内容で設定されます。
63
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
⑧ Concatenate 関数のプロパティはそのまま使用します。Concatenate 関数では、関数に連結した順
番に文字列をつなげます。Concatenate 関数を右クリックして表示されるメニューから「入力順序
の並べ替え」を選択して、マッピングウィンドウに表示されるリンクが以下のようになっているか
確認します。
※ 順番が逆になっている場合、
「入力順序の並び替え」ウィンドウの右側にある矢印にて、順番を
入れ替えます。
⑨ 以下のようにマッパー関数を使って右側の「申込日」にマッピングします。
64
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
（１） Now 関数 (現在の日時を返します)
⑩ Now 関数をクリックして、右上のインスペクタにプロパティを表示します。
［日付フォーマット］
プロパティに「yyyy-MM-dd」を入力します。(y は西暦年、M は月、d は日とそれぞれの桁数を指
します。)
“yyyy-MM-dd”と入力
⑪ 「Mapper」タブの右側の「×」ボタンをクリックして、ウィンドウを閉じます。
「FilePut」コンポーネントの［ファイルパス］プロパティの設定方法（プロパティ式の使用）
ここでは、
「FilePut」コンポーネントの「ファイルパス」プロパティにプロパティ式を設定します。
プロパティ式とは、フロー変数、外部変数や現在日付、UUID などの値を直接コンポーネントのプロパ
ティに設定できる機能です。但し、プロパティ式では値を加工することはできませんので、値の加工が
必要な場合は Mapper コンポーネントを使用します。
① プロパティ式の編集ダイアログを表示します。
「FilePut」コンポーネント - 「インスペクタ」タブ -「ファイルパス」プロパティの
値フィールドにある歯車マークをクリックし、プロパティ式の編集ダイアログを表示します。
65
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
② 現在日付を選択します。
ダイアログの左側のプロパティ式から[datetime.toString(“yyyyMMdd”)]をダブルクリックします。
（編集テキストボックスにドラッグすることもできます。）
③ 編集テキストボックスに固定文字を入力します。
[output/order_${datetime.toString("yyyyMMdd")}.csv]
④ 編集ダイアログの「OK」ボタンをクリックして、ウィンドウを閉じます。
「FilePut」コンポーネントの「ファイルパス」プロパティにプロパティ式が反映されます。
これで、フローの作成が完了しました。
66
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
フローの実行
フローを保存し、コンパイル処理が OK になりフローが実行可能であるか確認します。
① ツールバーの「プロジェクトを保存」ボタンをクリックして、下部のメッセージペインのコンパイ
ル結果が OK であるか確認します。
コンパイルの結果に NG が表示された場合は、フローの内容を確認してください。
② ツールバーの「実行」をクリックして「フローの実行」ウィンドウを開きます。
フローの実行
③ ウィンドウ下部の「実行」ボタンをクリックし、フローを実行します。
ステータスが「正常終了」になります。出力ストリームの欄では、EndResponse コンポーネント
からの出力である CSV データの内容を確認することができます。
④ 確認後、
「閉じる」ボタンをクリックします。
67
３．３ Excel 連携 教材フローと同じ処理のフローを作成して、実行してみましょう
出力ファイルの確認
フローで生成したファイルを確認します。
① 左側のファイルペインの上段にある「最新の情報を更新」ボタンをクリックします。
② ファイルペインから output フォルダをダブルクリックして、output フォルダを展開します。
ダブルクリック
③ output フォルダにある「order_yyyyMMdd.csv」(yyyyMMdd は今日の日付)をダブルクリックして、
CSV ファイルを開きます。
（CSV ファイルの場合、Excel が起動します）
ダブルクリック
④ 実行結果の CSV データの内容を確認することができます。
68
３．４ RDB を更新するフローを作成して、実行してみましょう
フローの作成と実行(RDB 更新)
ここでは、データベースを更新するコンポーネントの使い方を説明します。
3.4
RDB を更新するフローを作成して、実行してみましょう
先ほどのフローを元に、データベースへ格納するフローを追加して、実行します。
フローの作成
① 左側のツリーペインから先ほど作成したフロー「Flow1」を選択して、右クリックして表示される
メニューから「複製」を選択します。
選択
69
３．４ RDB を更新するフローを作成して、実行してみましょう
② 入力ウィンドウが表示されますので、フロー名に「Flow2」を入力し、「OK」ボタンをクリックし
ます。
③ ツリーペインに「Flow2」フローが追加されます。ワークスペースには「Flow2」フローが表示され
ます。
④ Mapper、RDBPut コンポーネントを追加するので、EndResponse コンポーネントを削除します。
EndResponse コンポーネントを削除
70
３．４ RDB を更新するフローを作成して、実行してみましょう
コンポーネントの配置、連結
Mapper、RDBPut、EndResponse コンポーネントを下図のように配置して連結します。
・フロー
・Mapper
・RDBPut
※RDBPut コンポーネントを配置した際に、以下の確認ダイアログが表示されますので、「はい」ボタンをクリックして
ください。
・EndResponse
71
３．４ RDB を更新するフローを作成して、実行してみましょう
「RDBPut」コンポーネントの設定
① 「RDBPut」コンポーネントをクリックして、右上のインスペクタにプロパティを表示します。
［コ
ネクション名］プロパティをクリックして、リストから「work_order」を選択します。
② 「RDBPut」コンポーネントを選択して、右クリックで表示されるメニューから「テーブルの選択」
を選択します。
選択
③ 「テーブルの選択」ウィンドウが表示されます。左側には［コネクション名］プロパティで設定し
たデータベースから取得できるテーブルの一覧が表示されるので、リストから「注文」テーブルを
選択して「OK」ボタンをクリックします。
72
３．４ RDB を更新するフローを作成して、実行してみましょう
④ この操作で、テーブルのすべてのカラムが更新対象フィールドとして定義されました。右上のプロ
パティにある［入力］タブには、選択されたフィールドが表示されます。ここでは、
「注文 ID」の
「キーにする」を「はい」に修正します。
追加した「Mapper」コンポーネント（Mapper2）の設定
「RDBPut」コンポーネントと連結したときに出力が CSV から Record に自動的に変更されます。
① 「Mapper2」コンポーネントをダブルクリックして、マッピングウィンドウを表示します。
73
３．４ RDB を更新するフローを作成して、実行してみましょう
② 左側の「注文 ID」からドラッグして、右側の「注文 ID」でドラッグを終了します。
同様に、
「顧客 ID」
、
「申込日」
、
「商品名」、「型番」
、「メーカー」、
「数量」をマッピングします。
複数フィールドの連結機能を使用すると簡単にマッピングを行うことが出来ます。
マッピングウィンドウの中央キャンバス上で右クリックして表示されるメニューから「複数フィー
ルドの連結方法」を選択します。
「選択したフィールド」から「フィールドの順序」、または「フィ
ールドの間隔」に変更します。
左側の「注文 ID」をクリックし Shift キーを押しながら「数量」をクリックします。Shift キーを押
したまま、カーソルを右側に移動すると、全フィールドの矢印が移動しますので、同じフィールド
名につなぎます。
入力データ項目を複数選択する方法は、
入力データ項目を Ctrl キーで複数選択する方法もあります。
③ 「Mapper2」タブの右側の「×」ボタンをクリックして、ウィンドウを閉じます。
これで、フローの作成が完了しました。
74
３．４ RDB を更新するフローを作成して、実行してみましょう
フローの実行
フローを保存し、コンパイル処理が OK になりフローが実行可能であるか確認します。
1. ツールバーの「プロジェクトを保存」ボタンをクリックして、下部のメッセージペインのコンパイ
ル結果が OK であるか確認します。
コンパイルの結果に NG が表示された場合は、フローの内容を確認してください。
2.
ツールバーの「フローの実行」をクリックして「フローの実行」ウィンドウを開きます。
フローの実行
3.
ウィンドウ下部の「実行」ボタンをクリックし、フローを実行します。
ステータスが「正常終了」になります。出力ストリームの欄では、EndResponse コンポーネント
からの出力である Record を ASTEIRA WARP の XML 形式で出力した内容を確認することができま
す。
4.
確認後、
「閉じる」ボタンをクリックします。
75
３．４ RDB を更新するフローを作成して、実行してみましょう
データベースへの登録の確認
「チュートリアルガイド～はじめまして ASTERIA WARP～」の実習で作成した「Project1.xfp」の
「Flow2」では、教材のデータベースの内容を HTML で表示します。これをブラウザから実行し、デー
タベースへの登録結果を確認することができます。
○「Project1.xfp」の「Flow2」
○実行結果
以上で、すべての実習は終了です。
76
補足２ ASTERIA WARP からデータベースへの接続
補足 1 データベース（MySQL）との連携
ここでは、MySQL データベースへ接続するための定義について説明します。
ASTERIA WARP から RDB へ接続を行う場合は、JDBC ドライバを用います。どのタイプの JDBC ドラ
イバが供給されているかは RDB によって異なります。
RDB 接続手順の概略は、以下のとおりです。
１）JDBC ドライバのインストールを行う。
JDBC ドライバのファイルを ASTERIA サーバ環境の[INSTALL_DIR]/jre/lib/ext 下にコピー
２）ASTERIA WARP サービスを起動する。
３）デザイナーで新規に接続情報（コネクション）を追加する。
ここでは、デザイナーでの設定手順を説明します。
デザイナーの左下にあるコネクションペインを選択します。
選択
1.
コネクションペイン上で右クリックをし、表示されたメニューから「コネクションの作成」を選択
します。
77
補足２ ASTERIA WARP からデータベースへの接続
2.
「コネクションの作成」ウィンドウが表示されますので、接続種別から「RDB」を選択し、名前に
「work_order」と入力してください。入力後、「OK」ボタンをクリックします。
3.
コネクションペインに、作成した「work_order」が表示されます。
4.
右上のインスペクタには、コネクションの設定情報が表示されます。
5.
プロパティ名「データベースタイプ」を選択し、表示されたリストから「MSAccess（ODBC）」を
選択します。
選択
78
補足２ ASTERIA WARP からデータベースへの接続
6.
以下のように接続設定を行います。
7.
コネクションペイン上で右クリックをし、表示されたメニューから「保存」を選択します。
8.
接続情報が保存され、
「work_order（更新）
」から“（更新）”が削除されます。
79
補足２ ASTERIA WARP からデータベースへの接続
４）コネクションをテストする。
接続を確認するために、接続テストを行います。
コネクションペイン上で右クリックをし、表示されたメニューから「接続テスト」を選択します。
「テスト結果」ダイアログが表示され、接続に成功すると、以下の内容になります。確認後は「閉じ
る」ボタンをクリックしてください。
確認後は、
「閉じる」ボタンをクリックしてください。
※FSMC で作成可能なコネクションは「システムコネクション」と「ユーザーコネクション」です。
※FSMC では「システムコネクション」を作成できますが、ここでは省略します。
80
補足２ ASTERIA WARP からデータベースへの接続
５）デザイナーによるフロー作成時に、作成したコネクションを使用する。
「ASTERIA チュートリアルガイド～はじめまして ASTERIA WARP～」の RDB アクセスのフロー
「Flow2」を参照してください。
○RDBGet コンポーネントをクリックして、右上のインスペクタにプロパティを表示します。
インスペクタにある「基本」タブの［コネクション名］プロパティをクリックして表示されるリス
トで、FSMC で定義した接続名一覧が表示されるので、「work_order」を選択することにより、コ
ンポーネントから使用することができます。
81
補足３ ログビューアーについて
補足 2 ログビューアーについて
ここでは、ログビューアーについて説明します。
ログビューアーとは、運用時にサーバーに接続して、フローサービスで出力されるログを表示する機能
をもつフローデザイナーに同梱されているツールです。タブ形式で複数のログを並べて表示したり、ロ
グにフィルターをかけて条件に一致した行だけを表示させたりすることができます。また
FlowService.log を解析して、1 日のフローの実行状況をレポートすることができます。さらに、
FlowService.log の解析結果は、フローのパフォーマンスチューニングを行う際に利用します。
ログビューアーで閲覧できるログは、以下のとおりです。
ログファイル
asteria.log
FlowService.log
FlowAccess.log
FlowCompile.log
FTPService.log
アプリケーションログ
説明
フローサービス全体での（各サービス、起動時のメッセージに
出る複数のデーモンを管理する上での）ログ
FlowService の起動・実行に関するログ
FlowService に対する HTTP レベルのアクセスログ
Flow のコンパイル結果ログ
FtpService の実行に関するログ
フローの各コンポーネントに記述した内容を出力したログ
82
補足３ ログビューアーについて
ログビューアーの起動・終了
① ログビューアーの起動
[スタート]メニューから[プログラム]→[ASTERIA WARP – Flow Designer]→[ログビューアー]
を選択してください。
または、フローデザイナーの[ツール(T)]メニューの[ログビューアー]を選択します。
② ログビューアーの終了
ログビューアーの画面で、[ファイル]メニューから[終了(X)]を選択してください。または、ロ
グビューアーの画面の右上にある[×]（閉じる）ボタンをクリックします。
サーバーへの接続
サーバーへ接続する手順は次のようになります。
① 新規にサーバーを追加するには、[ファイル]メニューの「サーバーを追加」を選択します。
そしてサーバーに接続するにはサーバーのアイコンをダブルクリックするか、サーバーのアイコ
ンを選択し、右クリックメニューの「接続」を選択します。
② 「ログイン」ダイアログが表示されますので、参照するログのサーバー名、ユーザー名、
パスワード、ドメインを入力し、「OK」ボタンをクリックします。
③ ツリーペインのサーバーのアイコンをダブルクリックすると、ログビューアーで参照でき
るログが表示されます。
83
補足３ ログビューアーについて
④ ログを最新の情報に更新するには、ツリーペイン上で右クリックし、メニューより「最新
を表示」を選択します。
サーバーとの切断
サーバーとの接続を切断するには、次の手順で行います。
ツリーペインのサーバーのアイコンを選択し、右クリックメニューの「切断」を選択します。
サーバーの削除
ツリーペインからサーバーを削除するには、削除対象となるサーバーのアイコンを選択し、右
クリックメニューの「削除」を選択します。
84
補足３ ログビューアーについて
ログの表示
表示するログのアイコンをダブルクリックするか、アイコンの前にある「+」をクリックし、内
容を展開します。さらに、日付ごとのログのアイコンが表示されますので、対象となる日付の
ログアイコンをダブルクリックするか、右クリックメニューの「開く」を選択します。
ログの表示列を変更するには、[表示(V)]メニューの[表示列]を選択して表示される左側にあるチ
ェックを外すことで、表示されなくなり、チェックすることで、表示されるようになります。
メッセージ内容の検索
メニューの下にある検索ツールメニューに、検索対象の文字列を入力し、
「次を検索」をクリッ
ク、または、Enter キーを押すと、
「メッセージ」列の内容を検索します。
ログファイル内に検索対象の文字列があった場合、その文字列が赤くハイライトされます。
また、
「カテゴリー」列、
「スレッド」列に対して、フィルターをかけて、そこから「メッセー
ジ」列内を検索することもできます。
85
補足３ ログビューアーについて
フィルター機能
「カテゴリー」列、
「スレッド」列に対して、フィルターをかけるには、[表示(V)]メニューの[フ
ィルター]を選択し、フィルターペインを表示します。
フィルターペインでは、
「カテゴリー」列、「スレッド」列にドロップダウンリストより値を選
択します。フィルターペインの「フィルター行のみ表示」が選択されていれば、フィルターで
該当した行のみが表示されます。また、
「大文字小文字を区別」や「正規表現を使う」、
「and or を
使う」
、「全フィールド対象」をチェックすることができ、検索ツールバーから検索を行うより
も、詳細な検索条件を指定することができます。
検索やフィルター機能を使用して、表示したログを元の表示に戻すには、検索ツールバーの検
索文字列やフィルターペインで設定した情報をクリアするか、対象となるログのタブを閉じ、
再度、開いてください。
FlowService.log の解析
FlowService.log の解析を行うには、次の手順で行います。
① 解析対象となる FlowService.log を開き、[ツール(T)]メニューの[FlowService ログを解析]
を選択します。
② 「FlowService ログを解析」ダイアログが表示されますので、解析の時間間隔を設定し、
「実
行」ボタンをクリックします。
86
補足３ ログビューアーについて
③ FlowService.log を指定された時間間隔で解析し、その結果が表示されます。
時間帯ごとに実行されたフローの実行回数や最大処理時間、平均処理時間などを知ることがで
きます。
FlowService.log の解析結果をファイルに出力するには、
「FlowService ログの解析」ダイアログ
の右下にある「ファイル出力」ボタンをクリックします。解析結果が CSV 形式で出力されます。
また、レポートの種類も時間間隔で出力される「日時集計レポート」
、フローごとの解析結果を
出力する「フロー集計レポート」
、実行されたフロー全ての解析結果を出力する「全フロー実行
レポート」を出力することができます。さらに「ヘッダをつける」チェックボックスをチェッ
クすることで、出力結果に項目名を付加することができます。
87
補足３ ログビューアーについて
日時集計レポートの出力項目
項目
時間
｛時間｝
実行回数
｛実行回数｝
最大処理時間
｛時間(ms),フロー名｝
最大同時起動数
｛最大同時起動数｝
ログレベル
｛警告回数,エラー回数｝
実行設定
｛URL,SOAP,スケジュー
ル,メール,FTP｝
プロジェクトキャッシュ
オーバーフロー
｛プロジェクトキャッシ
ュオーバーフロー｝
説明
一日の時間が間隔で指定した単位で分割されて表示されま
す。
例えば、間隔を「1 時間」とした場合は「00:00:00 - 01:00:00」
のように 1 時間ごとの行が 24 行表示されます。
その時間帯でフローが実行された回数です。
その時間帯で最も実行に時間のかかったフローの名前と時間
です。
その時間帯で最も多く同時に複数のフローが実行された時の
同時起動数です。
その時間帯で警告またはエラーレベルのログが出力された回
数です。
その時間帯で各種実行設定が実行された回数です。
その時間帯でプロジェクトがキャッシュから削除された回数
です。
「日時集計レポート」で時間帯の行をクリックすると、ダイアログ下部（フロー集計レポート
欄）にフローごとの実行状況である「フロー集計レポート」が表示されます。
フロー集計レポートの出力項目
項目
フロー名
｛フロー名｝
実行回数
｛実行回数｝
最大処理時間
｛最大処理時間(ms)｝
最小処理時間
｛最小処理時間(ms)｝
平均処理時間
｛平均処理時間(ms)｝
説明
「アカウント名.プロジェクト名.フロー名」の形式でフロー名
が表示されます。
その時間帯でそのフローが実行された回数です。
その時間帯のそのフローの実行の中で最も実行に時間がかか
った時の処理時間です。
その時間帯のそのフローの実行の中で最も実行に時間が短か
った時の処理時間です。
その時間帯のそのフローの実行時間の平均です。
88
補足３ ログビューアーについて
全フロー実行レポートの出力内容
項目
フロー名
｛フロー名｝
スレッド名
｛スレッド名｝
開始時間
｛開始時間｝
終了時間
｛終了時間｝
実行時間(ms)
｛実行時間(ms)｝
説明
「アカウント名.プロジェクト名.フロー名」の形式でフロー名
が表示されます。
フローが実行されたスレッド名です。
フローの実行が開始された時刻です。
フローの実行が終了した時刻です。
4 ．
フローの実行にかかった時間です。
「FlowService ログの解析」ダイアログを終了するには、「キャンセル」ボタンをクリックしま
す。
※ログビューアーの詳細については、フローサービスマニュアルの
「フローデザイナー」→「ログビューアー」を参照してください。
89
補足 4 Exception 設定について
補足 3 Exception 設定について
フローの実行中に発生するエラーを例外（Exception）と呼びます。
フロー実行中に例外が発生した場合、例外処理の設定を何もしていないと例外が起きた時点ですぐにフ
ローが終了（異常終了）してしまいます。業務で使うフローなど、それでは困る場合は「例外フロー
（Exception フロー）
」を使ってエラーに対処する処理をあらかじめ書いておくことができます。
「例外フロー（Exception フロー）
」を使ってエラー内容をログに書き出したり、エラー内容をメールで
担当者に通知したりする使用例などがあります。
例外フローの呼び出し方
Exception.xfp に入っている、
「main」フローがあります。
このフローは、テキストファイルを読み込んでレスポンスするようになっています。しかし、実はこの
フローを実行すると例外が発生します。それは、FileGet コンポーネントのファイルパスプロパティに
何も設定が入っていないからです。
「main」フローで例外が発生したときには、
「exception」フローが例外フローとして呼び出されるよう
に設定されています（設定方法 は後述）
。この「exception」フローは、いくつかのシステム変数から例
外処理中にだけ設定されるデータを取得し、実行日時とともに CSV ファイルに出力しています。
90
補足 4 Exception 設定について
設定方法を見る前に、
「main」フローをフローデザイナーから実行してみましょう。
「ファイルが見つか
りません」という例外が 発生し、その内容がログファイル（[HOME]/outputdata.txt）に書き出されます。
では、
「main」フローと「exception」フローは、どこの設定で関連付けられているのでしょうか。それ
は、
「main」フローの、
「エラー処理」プロパティです。
このプロパティは、次のようにして表示し、入力することができます。
１．
「main」のフローを開きます。
２．つづいて、左側のサーバリストで、
「main」の前にあるアイコンをクリックします。
３．すると、プロパティウインドウが次のようになります。
91
補足 4 Exception 設定について
４．「汎用エラー処理」プロパティをクリックすると、フロー一覧ウィンドウが開きます。
５．一覧から、
「exception」を選択します。
なお、この手順で設定するプロパティはフロー全体に対するプロパティ設定ですので、そのフローに含
まれるどのコンポーネントで例外が発生した場合でも、ここで設定された Exception フローが起動され
ます。
参考：もし例外処理がなかったら
「main」フローは、
「exception」フローから、例外フローの設定をはずしたものです。このフローをフ
ローデザイナーから実行すると、下図のようにエラーメッセージが直接画面に表示されます。
----------------------------------------------------------------------------------------------------------------------------------------
改版履歴
版数
日付
内容
2006/05/26
第１版
新規作成
2006/08/02
第2版
誤植の修正、補足説明の追加
2007/05/11
第3版
ASTERIA WARP 対応
2007/07/11
第４版
ASTERIA WARP 4.1 対応、フロー変更、補足説明の追加
2008/07/14
第５版
ASTERIA WARP 4.2 対応 誤植の修正
2009/03/30
第６版
ASTERIA WARP 4.3 対応 誤植の修正
2009/11/27
第7版
ASTERIA WARP 4.4 対応 誤植の修正
2010/11/17
第8版
ASTERIA WARP 4.5 対応 誤植の修正
2012/03/07
第9版
ASTERIA WARP 4.6 対応
2013/02/07
第 10 版
ASTERIA WARP 4.7 対応
2013/07/12
第 11 版
Windows8 画面対応
※本書で使用している ASTERIA WARP のバージョンは、
「ASTERIA WARP 4.7.0.7139」です
※本チュートリアルガイドの内容を許可無しに無断転載・転用・複製することを禁じます
92