ユーザー定義関数の作成

www.altova.com このトピックを印刷 前のページ 1つ上のレベル 次のページ

ホーム >  関数 > ユーザー定義関数 >

ユーザー定義関数の作成

ユーザー定義関数の作成を始めから作成、または、マッピング上に既存のコンポーネントの選択から作成することができます。

 

 

ユーザー定義関数を最初から作成する方法:

1.「関数」 メニューから、「ユーザー定義関数の作成」をクリックします。 または、代わりに、「ユーザー定義関数の作成」 ( mf_ic_create_udf ) ツールバーボタンをクリックします。

mf_udf_03

2.必要なフィールドに情報を挿入します (下のテーブルを参照してください)。

関数名

必須のフィールド。作成するユーザー定義関数のために名前を入力します。有効な文字:

 

英数字文字 (a-z、A-Z、0-9)
下線 ( _ )
ハイフン/点線 ( - )
コロン ( : )

ライブラリ名

必須のフィールド。関数が属するべきライブラリ名を入力します。関数はライブラリウィンドウ内でこのライブラリ名で表示されます。ライブラリを指定しない場合、関数は "user" という名前のデフォルトのライブラリ内に配置されます。

構文

任意のフィールド。 関数の構文を的確に詳細するテキストを入力します。 (例えば、 期待されるパラメーター)。このテキストは、ライブラリウィンドウ内の関数の横に表示され、関数の実行には影響を与えません。

詳細

任意のフィールド。関数の任意のテキストの詳細を入力してください。このテキストは、ライブライウィンドウ内で、または、他のコンテキスト内でカーソルを動かすと表示されます。

インラインされた使用

関数がインライン関数として作成される場合、このチェックボックスを選択してください。正規関数を作成する場合は、チェックを解除してください。詳細に関しては、 インラインと正規ユーザー定義関数を参照してください。

3.「OK」をクリックします。 上記で指定されているライブラリ名の下のライブラリウィンドウ内で関数がすぐに表示されます。 列:

mf_udf_15

また、マッピングウィンドウが再度描き直され、新規の関数を作成することができます (これは "関数のマッピング"として参照されるスタンドアロンマッピングです)。関数は出力を必要とするため、関数のマッピングにはデフォルトで出力コンポーネントが含まれています。

mf_udf_16

 

左上の角の 「メインマッピングに戻る」 ( mf_ic_gotomainmapping ) ボタンにより、関数のマッピングからメインマッピングに戻ることができます。関数の マッピングを開くためには、ライブラリウィンドウ内の関数をダブルクリックします。 詳細に関しては、 ユーザー定義関数の呼び出しとインポートユーザー定義関数のナビゲートを参照してください。

 

4.関数の定義により必要とされるすべてのコンポーネントを関数のマッピングに追加します。標準のマッピングと同じ方法でこれを行うことができます。 例えば、入力または出力パラメーターを追加するには、次のいずれかを実行してください:

 

メニューコマンド 「関数 | 入力の挿入、または、「関数 | 出力の挿入」 をそれぞれ実行します。
マッピング エリアを右クリックし、「入力の挿入」 または 「出力の挿入」 をコンテキストメニューから選択します。
「入力の挿入」 ( mf_ic_udf_input ) または 「出力の挿入」 ( mf_ic_udf_output ) ツールバーボタンをクリックします。

 

少なくとも、関数はデータが接続される1つの出力コンポーネントを必要とします。入力パラメーターに関しては、関数は、ゼロ、または、1つ以上の入力を持つことができます。入力または出力パラメーターは、単純型 (文字列、または、整数など) 、または、複合型 (構成)であることができます。単純型、および、複合型のパラメーターに関する詳細は、ユーザー定義関数内のパラメーターを参照してください。

 

ユーザー定義関数が作成されましたが、まだ使用されていません。関数をマッピング内で使用するには、ライブラリウィンドウから関数を メインマッピング エリアにドラッグします。 ユーザー定義関数の呼び出しとインポートを参照してください。

 

 

ユーザー定義関数を既存のコンポーネントから作成する方法:

1.マウスを使用して正方形を作成し、マッピング上で複数のコンポーネントを選択します。 「Ctrl」  キーを押したまま、それぞれをクリックして複数のコンポーネントを選択することができます。
2.「関数」 メニューから、「選択からユーザー定義関数を作成する」をクリックします。代わりに、「選択からユーザー定義関数を作成する」 ( mf_ic_create_udf_from_selection ) ツールバーボタンをクリックします。
3.上記のステップ 2-4 を繰り返します。

(C) 2019 Altova GmbH