データベース Functoid
データベース Functoid は、出力インスタンス メッセージで使用するためにデータベースからデータを抽出します。
概要
データベース Functoid の一覧と、それらを使用する方法を次に示します。
データベース検索。 データベース参照 Functoid を使用してデータベースから情報を抽出し、Microsoft ActiveX Data Objects .NET (ADO.NET) レコードセットとして格納します。 この Functoid には、次の順序で 4 つの入力パラメーターが必要です。
参照値
データベース接続文字列
テーブル名
参照値の列の名前
エラー通知。 実行時に発生するエラー情報 (データベース接続エラーなど) をキャプチャするには、 Error Return Functoid を使用します。 この Functoid には、 データベース参照 Functoid からのリンクという 1 つの入力パラメーターが必要です。
メッセージの書式設定。 引数の代入によって書式設定とローカライズが行われた文字列が返されます。また場合によっては、ID と値が返されます。
アプリケーション ID を取得します。 アプリケーション オブジェクトの識別子を取得します。
アプリケーション値の取得。 アプリケーション値を取得します。
共通 ID の取得。 共通オブジェクトの識別子を取得します。
共通値の取得。 共通値を取得します。
アプリケーション ID を削除します。 アプリケーション値を削除します。
共通 ID を設定します。 共通オブジェクトの識別子を設定して返します。
値抽出。 Value Extractor Functoid を使用して、データベース参照 Functoid によって返されるレコードセット内の指定された列からデータを抽出します。 この Functoid には、 データベース参照 Functoid へのリンクと列名という 2 つの入力パラメーターが必要です。
7 つのデータベース Functoid (メッセージの書式設定、アプリケーション ID の取得、アプリケーション値の取得、共通 ID の取得、共通値の取得、アプリケーション ID の削除、共通 ID の設定) は、クロスリファレンス Functoid です。 これらの Functoid は、入力メッセージの ID と値を、出力メッセージで必要とされる ID と値に変換します。 詳細については、「UI ガイダンスと開発者 API 名前空間リファレンス」の「Database Functoids リファレンス」を参照してください。
例
次の例では、一部の Database Functoid を使用しています。 この例では、広範な地域に店舗を持つ大規模な小売メーカーを対象としています。 店舗を追跡するために、本社は各ストアに StoreID と呼ばれる一意のコードを割り当てます。 さらに、本社は次の情報を各 StoreID に関連付けます。
StoreName
StoreAddress
市区町村
郵便番号
StorePhoneNumber
StoreManager
この情報は、データベースに保存され、定期的に取引先に配布されます。 メーカー側では、すべての購入が店舗ではなく本社で行われます。 本社が取引先に注文書を送る場合、通常、複数の店舗が受け取る商品を 1 つの注文書で処理します。 本社は、商品を受け取る店舗ごとに名前と住所の情報を送信する代わりに、 StoreID を送信するだけです。 名前と住所の情報を高度な出荷通知に挿入するために、取引先は Database Functoids を使用して、この情報を出力インスタンス メッセージに自動的に挿入します。 次の図は、取引先がマップ内で StoreID の置換を実装する方法を示しています。
この図では、送信元スキーマは受信する注文書を表し、送信先スキーマは詳細な出荷通知を表しています。 データベース参照 Functoid は、適切なデータベース テーブルから適切なレコードを検索します。 Value Extractor Functoids は、参照レコードから適切な列を抽出します。 Error Return functoid は、実行時にエラー (接続エラーなど) がある場合にエラー情報を含む文字列を出力します。
前の例では、最初の入力パラメーターは受信発注書の StoreID フィールドから取得され、残りの 3 つの入力パラメーターは、データベース参照Functoid の [Functoid> Functoid の構成] ダイアログ ボックスで構成<された定数です。 4 つの入力パラメーターすべての値を提供するために、送信元スキーマからのリンクを作成できます。
Note
一部の Microsoft SQL Server データ型 (テキスト、ntext、イメージなど) をデータベース参照 Functoid の参照値として使用することはできません。 この Functoid には、テキスト文字列として表すことができるデータ型が必要です。
データベース参照 Functoid の入力パラメーターに一致するレコードが複数ある場合、Value Extractor Functoid は最初のレコードからのみデータを抽出します。
接続文字列で NT 認証を使用して、パスワードを暗号化で保護します。
使用可能な Functoid
データベース Functoid は次のとおりです。
- データベース検索
- エラー通知
- メッセージの書式設定
- アプリケーション ID の取得
- アプリケーション値の取得
- 共通 ID の取得
- 共通値の取得
- アプリケーション ID の削除
- 共通 ID の設定
- 値抽出
これらの Functiod の詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの Functoid リファレンスを参照してください。
参照
- マップに基本 Functoid を追加する方法
- UI ガイダンスと開発者 API 名前空間リファレンスの Database Functoids リファレンス