フォーム書き込み処理

オペレーション名

フォーム書き込み

機能概要

入力データをデータベースに書き込みます。

データモデル

本コンポーネントのデータモデルはテーブルモデル型です。

プロパティ

変数の使用については、「変数」を参照してください。
基本設定
項目名 必須/省略可 変数の使用 説明 備考
名前 必須 使用不可 スクリプトキャンバス上での名前を入力します。  
入力データ 必須 使用不可 スクリプトキャンバス上にあるコンポーネントを選択します。  
必須設定
項目名 必須/省略可 変数の使用 説明 備考
接続先 必須 使用不可 グローバルリソースを選択します。
グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。
  • [追加]:
    新規にグローバルリソースを追加します。
  • [一覧の編集]:
    「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
 
フォーム名 必須 使用可 フォーム名を選択または入力します。
  • スクリプト変数を指定した場合、[フィールド定義]は設定されません。
フィールド定義 必須 - [フォーム名]で指定したフォームのフィールド定義を表示します。  
フィールド定義/フィールド名 必須 使用可 フォームのフィールド名を入力します。
デフォルトでは指定したフォーム内のフィールド名が設定されます。
 
フィールド定義/型 必須 使用不可 フィールドの型を選択します。
デフォルトでは指定したフォーム内のフィールドの型が設定されます。
  • [string]
  • [datetime]
  • [double]
更新方法 必須 使用不可 更新方法を選択します。
  • [挿入]:(デフォルト)
    [入力データ]を用いて、新規にデータを作成します。
  • [挿入/更新]:
    [入力データ]を用いて、データを更新します。
  • [削除]:
    [入力データ]を用いて、データを削除します。
 
フィールド設計式を使用する 省略可 使用不可 計算結果フィールド式やフィールド設計式を使用するかどうかを選択します。
  • [チェックあり]:
    データベースに設定された計算結果フィールド式またはフィールド設計式(「デフォルト式」または「入力変換式」)を実行します。
  • [チェックなし]:(デフォルト)
    データベースに設定された計算結果フィールド式またはフィールド設計式(「デフォルト式」または「入力変換式」)を実行しません。
  • フィールド設計式の「入力確認式」には対応していません。
区切り文字 省略可 使用可 複数値の区切り文字を入力します。
  • 複数値の区切り文字を任意で指定することができます。
  • デフォルト値は「,」で、省略した場合は「,」が設定されます。
  • 複数値は、フィールドの種類が「テキスト」の場合のみ取得できます。
キー設定 必須 使用不可 [更新方法][挿入/更新]または[削除]を指定した際に、[キー]を更新キーとして使用するかどうかを選択します。
  • [使用する]:(デフォルト)
  • [使用しない]:
書き込み設定
項目名 必須/省略可 変数の使用 説明 備考
null値が入力された場合にnull値で更新 省略可 使用不可 入力データにnull値が含まれている場合の動作を選択します。
  • [チェックあり]:
    対象のフィールドをnull値で更新します。
  • [チェックなし]:(デフォルト)
    対象のフィールドを更新しません。
  • [更新方法][挿入/更新]を選択した場合、有効になります。
キー設定
項目名 必須/省略可 変数の使用 説明 備考
キー 省略可 - キーを指定します。
キーとして指定したフィールドのデータが文書内のデータとマッチした場合、文書を更新または削除します。

各列は以下のボタンで操作することができます。
  • [追加]:
    列を追加します。
  • [上へ]:
    選択している列の順序を一つ上に上げます。
  • [下へ]:
    選択している列の順序を一つ下に下げます。
  • [削除]:
    列を削除します。
  • 以下の設定時に、更新キーとして使用します。
    • [更新方法][挿入/更新]または[削除]を選択
    • [キー設定][使用する]を選択
  • 詳細については、「キー設定について」を参照してください。
キー/キー名 必須 使用可 フィールド名を入力します。  
コメント
項目名 必須/省略可 変数の使用 説明 備考
コメント 省略可 使用不可 このアダプタの簡単な説明を記述することができます。
説明を記述すると、仕様書に反映させることができます。
 

スキーマ

入力スキーマ

<?xml version="1.0" encoding="UTF-8" ?>
<table>
  <row>
    <column>ユニバーサルID</column>
    <column>Note ID</column>
    <column>フィールドのデータ</column>
    :
  </row>
  <row>
    :
  </row>
</table>

出力スキーマ

ありません。

Mapperでのスキーマ読み込み

スキーマは自動で読み込まれます。
詳細については、「スキーマ編集」を参照してください。

トランザクション

トランザクションはサポートしていません。

PSPでの使用について

PSPでは使用できません。

使用できるコンポーネント変数

コンポーネント変数名 説明 備考
count 書き込んだ文書の件数が格納されます。
  • デフォルト値はnullです。
  • 「insert_count」、「update_count」、「delete_count」の合計です。
insert_count 書き込んだ文書のうち、挿入した文書の件数が格納されます。
  • デフォルト値はnullです。
update_count 書き込んだ文書のうち、更新した文書の件数が格納されます。
  • デフォルト値はnullです。
delete_count 書き込んだ文書のうち、削除した文書の件数が格納されます。
  • デフォルト値はnullです。
message_category エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。
  • デフォルト値はnullです。
message_code エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。
  • デフォルト値はnullです。
message_level エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。
  • デフォルト値はnullです。
error_type エラー発生時、発生したエラーの種類が格納されます。
  • デフォルト値はnullです。
  • エラーの種類は、以下のような形式となります。
    例:「java.io.FileNotFoundException」
  • DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_message エラー発生時、発生したエラーのメッセージが格納されます。
  • デフォルト値はnullです。
  • DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_trace エラー発生時、発生したエラーのトレース情報が格納されます。
  • デフォルト値はnullです。
  • DataSpider Servistaのバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

型変換の動作について

[フィールド定義][型]を指定した場合の型変換の動作は以下の通りです。

[型] 動作 備考
[string] 入力データをString型に変換して書き込みます。
  • 空文字はnullに変換されます。
[datetime] 入力データをDate型に変換して書き込みます。
  • 入力データがDate型に変換できないデータの場合、書き込むことはできません。
  • 空文字はnullに変換されます。
[double] 入力データをDouble型に変換して書き込みます。
  • 入力データがDouble型に変換できないデータの場合、書き込むことはできません。
  • 空文字はnullに変換されます。

キー設定について

仕様制限

主な例外

例外名 原因 対策
ResourceNotFoundException
リソース定義が見つかりませんでした。名前:[]
[接続先]が指定されていません。 [接続先]を指定してください。
ResourceNotFoundException
リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]
[接続先]で指定したリソース定義が存在しません。 [接続先]で存在するグローバルリソースを指定してください。
InputDataNotFoundException [入力データ]が指定されていません。 [入力データ]を指定する、またはデータフローを引いてください。
InvalidPropertyConfigurationException
「<プロパティ名>」が指定されていません。
[<プロパティ名>]が指定されていません。 [<プロパティ名>]を指定してください。
LotusNotesException
The UniversalID "(<ユニバーサルID>)" is invalid.
[挿入/更新]または[削除]処理時、入力データ内の「ユニバーサルID」と一致する文書がありませんでした。 入力データを確認してください。
LotusNotesException
no document in the database file "<Note ID>".
[挿入/更新]処理または[削除]時、入力データ内の「Note ID」と一致する文書がありませんでした。 入力データを確認してください。
LotusNotesException
The column "<キー名>" in input data is not found.
[挿入/更新]または[削除]処理時、[キー名]で指定したフィールドが存在しません。 [キー名]を確認してください。
LotusNotesException
Cannot use the empty column "<フィールド名>" as update key.
[挿入/更新]または[削除]処理時、キーとして使用されている<フィールド名>のデータにnullが含まれています。 入力データを確認してください。