サービスまたはサブフローの入力フィールドの定義

サービスまたはサブフローの入力フィールドを定義するには、Input ステージを使用します。

注: 入力フィールドで階層データを定義した場合は、データをインポートしたり、データを垂直に表示したりすることはできません。

Input ステージをキャンバス上にドラッグします。
Input ステージを、データフローの後続ステージに接続します。
Input ステージをダブルクリックします。
入力として使用するフィールドを選択します。表示されるフィールドの一覧は、Input ステージが接続されているステージによって異なります。
フィールドリストに新しいフィールドを追加するには、[追加] をクリックします。[カスタムフィールドの追加] ウィンドウが表示されます。
[追加] を再度クリックします。
[フィールド名] フィールドに、このフィールドに対して使用する名前を入力します。
データタイプを選択します。
次のデータタイプがサポートされています。
bigdecimal

小数点以下 38 桁の精度をサポートする数値データタイプ。高い精度が必要な算術計算で使用されるデータ (特に金融データ) には、このデータタイプを使用してください。bigdecimal データタイプは、double データタイプより正確な計算をサポートします。

boolean

true と false の 2 つの値を持つ論理タイプ。

bytearray

バイトの配列 (リスト)。

注: bytearray は REST サービスの入力としてはサポートされていません。

date

月、日、年を含むデータタイプ。例: 2012-01-30、January 30, 2012。デフォルトの日付の形式は Management Console で指定できます。

datetime

月、日、年、時、分、秒を含むデータタイプ。例: 2012/01/30 6:15 PM。

double

正と負の倍精度数を含む数値データタイプ。値の範囲は、2^-1074 ～ (2-2^-52)×2¹⁰²³。指数表記すると、値の範囲は、-1.79769313486232E+308 ～ 1.79769313486232E+308 となります。

float

正と負の単精度数を含む数値データタイプ。値の範囲は、2^-149 ～ (2-2²³)×2¹²⁷。指数表記すると、値の範囲は、-3.402823E+38 ～ 3.402823E+38 となります。

integer

正と負の整数を含む数値データタイプ。値の範囲は、-2³¹ (-2,147,483,648) ～ 2³¹-1 (2,147,483,647)。

list
厳密に言えば、リストはデータタイプではありません。しかし、フィールドが階層データを含む場合、"リスト" フィールドとして扱われます。Spectrum™ Technology Platform では、リストは複数の値で構成されるデータのコレクションです。例えば、Names フィールドには名前の値のリストを含めることができます。これは、XML 構造では次のように表すことができます。
```
<Names>
    <Name>John Smith</Name>
    <Name>Ann Fowler</Name>
</Names>
```
XML のリストデータタイプが複数の値で構成される単純データタイプであるのに対し、Spectrum™ Technology Platform のリストデータタイプは XML の複合データタイプに似ているという点で、Spectrum™ Technology Platform のリストデータタイプは XML スキーマのリストデータタイプと異なることに注意してください。
long

正と負の整数を含む数値データタイプ。値の範囲は、-2⁶³ (-9,223,372,036,854,775,808) ～ 2⁶³-1 (9,223,372,036,854,775,807)。

string

文字シーケンス。

time

時刻を含むデータタイプ。例: 21:15:59 or 9:15:59 PM。
また、必要に応じて、ユーザ定義の新しいデータタイプを追加して、定義済みのデータタイプの一覧に加えることができます。例えば、名前 (文字列) のリストや、AddressLine1 (文字列)、City (文字列)、StateProvince (文字列)、PostalCode (文字列) などを含む住所の新しいデータタイプを定義できます。フィールドを作成した後は、[入力オプション] ダイアログにアクセスして [データタイプ] 列のボタンを押すと、そのデータタイプを表示できます。[データタイプ詳細] ダイアログボックスが表示され、フィールドの構造が示されます。
OK を再度クリックします。
[エクスポーズ] 列のチェックボックスをオンにすると、フィールドがステージ操作で使用可能になります。このチェックボックスをオフにして [OK] をクリックすると、フィールドがフィールドリストから削除されます。
[データタイプ名] フィールドには、このサービスに対する SOAP および REST Web サービスリクエストにおいて、入力レコードに使用するデフォルトの要素名が表示されます。デフォルト値は Row です。入力レコードに対して別の要素名を使用する場合は、ここに入力します。
例えば、デフォルト値 Row を使用する場合、JSON Web サービスリクエストでは以下に示すように、Row を入力レコードの要素名として使用します。
```
{
  "Input": 
  {
    "Row": [
      {
        "AddressLine1": "1825 Kramer Ln",
        "City": "Austin",
        "StateProvince": "TX"
      }
    ]
    
  }
}
```
[データタイプ名] フィールドの値を " Address" に変更する場合は、JSON リクエストでは以下に示すように、Address を Row の代わりにレコードの要素名として使用する必要があります。
```
{
  "Input": 
  {
    "Address": [
      {
        "AddressLine1": "1825 Kramer Ln",
        "City": "Austin",
        "StateProvince": "TX"
      }
    ]
    
  }
}
```