Home > リファレンスガイド > フロー > ユーザ定義ストレージ

ユーザ定義ストレージ

Magic xpiのUDS(User Defined Storage)は、多次元ストレージテーブル(配列)を定義することができます。これらの定義をインテグレーションフローで使用して、マルチインスタンスデータタイプの保存や読み出しを行うことができます。

UDSデータはメモリに保存されているため、現在実行中のフローでのみ利用できます。しかし、UDSデータをBLOB形式で受け取ることができるため、後で使用することもできます。UDSリポジトリでUDSモデルを定義します。

UDS機能を利用するには:

  1. ソリューションエクスプローラの[リポジトリ]セクションで、 UDS をダブルクリックしてUDSリポジトリを開きます。または、 SHIFT+F10を押下することで開くこともできます。

  2. UDSリポジトリは二つのペインに分かれています。左側のペインには以下の特性があります。

プロパティ

説明

特定のUDSモデルのために定義する名前。例:顧客

名前には最高30桁の文字を含めることができます。次の特殊文字を含めることができません:  / ? : & \ * " < > | # %、空白、または、3つの疑問符(???)

説明

これはUDSモデルの説明です。特定のUDSモデルを特定できる情報を含めることができます。あるいはUDSモデルの機能の短い説明を入れることもできます。

  1. 右側のペインは[フィールド]テーブルです。これらのフィールドには、左側のペインに追加したUDSモデルに属している配列を定義します。ここには以下のプロパティがあります。

プロパティ

説明

名前

プロパティの名前を定義します。例:CustomerName。名前には最高30桁の文字を含めることができます。

タイプ

データのタイプをドロップダウンリストから以下のいずれかを選択します。

  • Alpha

  • BLOB

  • Date

  • Logical

  • Numeric

  • Time

例えば、CustomerNameと一致させるには、Alpha(文字)を選択します。

複数のBLOBフィールドに各UDSエントリを追加することはできません。

長さ

フィールドの最大長

インデックス

特定のフィールドをもとにUDSをソートします。例えば、[名前]カラムに入力された CustomerName順でレコードをソートさせることができます。

デフォルト値

デフォルト値を入力します。例えば、特定の顧客名あるいは特定の発注日を入力します。

このフィールドは、明示的な値だけを受け入れます。 関数や式、変数、倫理名は利用できません。 入力された値が明示的な値でない場合、チェッカーによってエラーが返ります。

  1. 各ペインには独自の[新規]と[削除]ボタンがあります。これらはUDSリポジトリからUDSモデルとそのフィールドの追加や削除を行います。

  2. 必要な UDSモデルの入力が終了したら、[OK]をクリックしてエントリーを保存し、UDSリポジトリを閉じます。また、[キャンセル]をクリックすると新規エントリーを保存されずUDSリポジトリを終了することもできます。

  • UDSリポジトリでUDSモデルを定義すると、それらはフロー変数タイプのリストに追加されます (変数リポジトリの[タイプ]カラム)。

  • UDS変数は、フローまたはコンテキスト変数としてのみ定義できます。

  • UDSリポジトリには、ユニークな名前を割り当てる必要があります。また、[名前]フィールドは空白のままにはできません。

  • エントリを削除する前に、プロジェクトの別の場所で使用されていないことを確認してください。リファレンス検索ユーティリティを実行するしてこれを行うことができます。

  • UDS変数は接頭辞としてUという文字が自動的に追加されます。Since version: 4.5

  • 無効なエントリが使用された場合、Magic xpiはエラーアイコンを表示します。ツールティップにはエラーの説明が表示されます。 Since version: 4.5

関連トピック