フォーム書き込み処理

オペレーション名

機能概要

データモデル

プロパティ

基本設定

必須設定

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

プロパティアクション

書き込み設定

キー設定

コメント

スキーマ

入力スキーマ

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

出力スキーマ

Mapperでのスキーマ読み込み

トランザクション

PSPでの使用について

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

キー設定について

• [挿入/更新]時、[キー/キー名]に指定したフィールドの入力データがnullの場合、データベース内の全文書が更新の対象になります。
• [キー/キー名]に指定したフィールドが[フィールド定義/フィールド名]と異なる場合、実行時にエラーが発生します。
• データ形式の種類が「リッチテキスト」のデータを含むフィールドはキーとして使用しないでください。
• [型]が[richtext]のフィールドはキーとして使用しません。
• キーとして使用できるフィールドが存在しない場合、検索に一致しなかったものとして処理を行います。

仕様制限

• 複数のバージョンを同時に使用することはできません。


• フィールドの種類が「作成者」・「名前」・「読者」・「パスワード」・「式」のフィールドへの書き込みはサポートしていません。


• フィールドの種類が「テキスト」のデータについて
  • nullまたは空文字はnullとして書き込まれます。
  • フィールド内の複数値を[挿入/更新]または[削除]の[キー]として指定した場合、入力データの最初の値でキーマッチを行います。[挿入/更新]の場合は入力データで更新します。
    例:入力データの最初の値(「abc」)でキーマッチを行い、入力データ(「abc,あいう,123」)で更新
    
    

    更新前文書のフィールドの値
    123,abc

    ↓ 入力データ:「abc,あいう,123」(区切り文字は「,」)

    更新後文書のフィールドの値
    abc,あいう,123



• フィールドの種類が「テキスト」・「ダイアログリスト」・「チェックボックス」・「リストボックス」のデータについて
  • 複数値が設定されたフィールドに対して複数値のデータを書き込むことができます。
• フィールドの種類が「日付/時刻」のデータについて
  • 複数値が設定されたフィールドに対して複数値のデータを書き込むことができません。
  • nullまたは空文字はnullとして書き込まれます。
  • 時間は24時間制となります。
  • 日付を省略した入力データは、1970年1月1日として書き込まれます。時刻を省略した入力データは、00時00分00秒000ミリ秒として書き込まれます。
• フィールドの種類が「数値」のデータについて
  • 複数値が設定されたフィールドに対して複数値のデータを書き込むことはできません。
  • nullまたは空文字は「0」として書き込まれます。
• フィールドの種類が「リッチテキスト」・「リッチテキストライト」のデータについて
  • HTML形式に変換後のリッチテキストデータ、添付ファイル、貼付画像、OLEオブジェクトのプレビュー画像、アイコン画像の挿入/更新/削除はできません。
  • [型]に[string]を指定して、テキストデータの書き込みを行った場合、フィールドの種類が「テキスト」として書き込まれます。
    その場合、テキストデータに含まれた改行はNotesクライアントでは表示されません。
  • [型]に[richtext]を指定して、テキストデータの書き込みを行った場合、フィールドの種類が「リッチテキスト」として書き込まれます。
    その場合、テキストデータに含まれた改行はNotesクライアントでも表示されます。
• 「フォームを文書に格納」オプションが有効に設定されているフォームへの書き込みについて
  • フォーム書き込み処理を実行して挿入および更新した文書は、「フォームを文書に格納」オプションが無効の状態で挿入されます。
• 文書のフィールドが「表示用の計算結果」または「サブフォームの計算結果」である場合、そのフィールドは[フィールド定義]に表示されません。


• サブフォームのフィールドの型は、型設定に関わらず[フィールド定義]の[型]が[string]として設定されます。
  [フィールド定義]の[型]を手動で変更してください。


• フォームに別名が定義されている場合、[フォーム名]にはフォーム名と別名の両方が表示されます。
  最後の別名を選択すると、別名が定義されたフォームを使用することができます。


• 不正な[接続先]を指定している場合、プロパティ設定ダイアログを開くのに時間がかかる場合があります。


• 更新キーが「ユニバーサルID」、「Note ID」、または 「キー設定」、[更新モード]が[挿入/更新]の状態で、同一サーバー・同一データベースの別フォームへの挿入を行うと、読み取りデータが別フォームへ移動されます。

主な例外

注意事項

• 「フォームの一覧が取得できません」というサーバコンソールおよびserver.logのログについて
  デザイナでのスクリプト作成中に、サーバコンソールおよびserver.logに「ds.kernel.mgr.dpc|WARN|フォームの一覧が取得できません。」というログが以下のようなメッセージとともに表示され、プロパティでのフォームの一覧取得やフィールド定義の更新が行うことができなくなる場合があります。
  
  • NotesException: Session closed due to communications failure
  • NotesException: Object no longer exists on server
  • NotesException: Bulk recycler is not running
  • org.omg.CORBA.INV_OBJREF: vmcid: 0x49423000 minor code: 2449 completed: No
  • org.omg.CORBA.INV_OBJREF: vmcid: 0x49420000 minor code: 64 completed: No
  これは、DIIOP Serverに設定された「アイドル状態のセッションのタイムアウト」を超過してフォームの取得やフィールドの更新などの接続が行われなかったため、接続が切断されてしまったことが原因です。
  プロジェクトを閉じて開き直すことで、プロパティでのフォームの一覧取得やフィールド定義の更新を再び行うことができます。
  この現象が頻出するようであれば、DIIOP Serverの「アイドル状態のセッションのタイムアウト」設定を確認してください。