ノーツ式読み取り処理

オペレーション名

機能概要

データモデル

プロパティ

基本設定

必須設定

項目名	必須/省略可	変数の使用	説明	備考
接続先	必須	使用不可	グローバルリソースを選択します。 グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
フォーム名	必須	使用可	フォーム名を選択または入力します。	スクリプト変数を指定した場合、[フィールド定義]は設定されません。
フィールド定義	必須	-	[フォーム名]で指定したフォームのフィールド定義を表示します。
フィールド定義/フィールド名	必須	使用可	フィールド名を入力します。 デフォルトでは指定したフォーム内のフィールド名が設定されます。
フィールド定義/型	必須	使用不可	フィールドの型を選択します。 デフォルトでは指定したフォーム内のフィールドの型が設定されます。 [string] [datetime] [double]	型を変更した場合の動作については、「型変換の動作について」を参照してください。
ノーツ式	必須	使用可	Notes/Dominoの式言語を入力します。	SELECT予約語と@関数を組み合わせた式を使用できます。 設定例: 式 説明 SELECT @All データベース内の全文書を検索し、[フォーム名]で設定したフォーム内の文書を取得します。 SELECT Form = "<フォーム名>" <フォーム名>で指定したフォーム内の文書のみを取得します。 ([フォーム名]で設定したフォームを指定する必要があります。) SELECT @Created = @Today 作成日が今日の文書を取得します。 @関数については、Dominoのヘルプを参照してください。
最大取得文書数	省略可	使用可	取得する文書数を入力します。	デフォルト値は「0」です。省略した場合は「0」が設定されます。 「0」を指定した場合、フォーム内の全文書を取得します。 フォーム内の全文書数を超える値を指定した場合、フォーム内の全文書を取得します。
区切り文字	必須	使用可	複数値の区切り文字を入力します。	複数値の区切り文字を任意で指定することができます。 デフォルト値は「,」です。 複数値は、フィールドの種類が「テキスト」の場合のみ取得できます。
添付ファイルを取得	省略可	使用不可	文書内の添付ファイルを取得するかどうかを選択します。 [チェックあり]:(デフォルト) 文書内の添付ファイルを取得します。 [チェックなし]: 文書内の添付ファイルを取得しません。
添付ファイル保存先	必須	使用可	文書内の添付ファイルを保存するディレクトリを選択または入力します。 [参照]ボタンを押下するとファイルチューザが起動し、ディレクトリの選択ができます。	[添付ファイルを取得]にチェックを入れた場合、有効になります。 デフォルト値は「/tmp」です。 ファイルパスはDataSpiderファイルシステムの絶対パスで指定してください。 パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。

プロパティアクション

データ処理方式

コメント

スキーマ

入力スキーマ

出力スキーマ

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

Mapperでのスキーマ読み込み

大容量データ処理

PSPでの使用について

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

型変換の動作について

仕様制限

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


• フィールドの種類が「式」のデータを読み取ることはできません。


• フィールドの種類が「テキスト」のデータについて
  • データサイズが14KB以上の場合、読み取ったデータがnullになる場合があります。
• フィールドの種類が「テキスト」・「ダイアログリスト」・「チェックボックス」・「リストボックス」のデータについて
  • 複数値の場合は、[区切り文字]で指定した文字で区切って読み取ります。
• フィールドの種類が「日付/時刻」のデータについて
  • 「yyyy-MM-dd'T'HH:mm:ss.SSSZZ」形式でフォーマットされます。
  • 1950年1月1日から1999年12月31日までの年表記は、下2桁(5x〜9x)のみ読み取ります。
  • 複数値の場合は、最初の値のみ読み取ります。
• フィールドの種類が「数値」のデータについて
  • Double型で読み取ります。表現可能な実数部は、17桁で最大値は「1.7976931348623157 E308」、最小値は「4.9E-324d」となります。そのほか、型の仕様についてはJavaのDouble型に準拠します。
  • 複数値の場合は、最初の値のみ読み取ります。
• フィールドの種類が「リッチテキスト」・「リッチテキストライト」のデータについて
  • テキストデータおよび文書内の添付ファイルのみ読み取ります。
    「埋め込み設計要素」の「ファイルアップロードコントロール」を使用して添付したファイルは取得することはできません。
  • 添付ファイル名に「DataSpiderファイルシステムの禁止文字」が含まれる場合、「_」(半角アンダースコア)に変換して出力します。
• 文書のフィールドが「表示用の計算結果」または「サブフォームの計算結果」である場合、そのフィールドは[フィールド定義]に表示されません。


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


• Shift_JISコードとしてサポートしているのは、JISX0201/JISX0208の符号化文字集合で定義されている以下の文字コードの範囲です。
  • 1バイト文字:0x20 - 0x7E、0xA1 - 0xDF
  • 2バイト文字:0x8140 - 0xEAA4の中でShift_JISとして定義されている文字
• 以下のベンダー定義外字(NEC特殊文字、IBM拡張文字)、ユーザ定義外字はサポートしていません。
  • NEC特殊文字:0x8740 - 0x8790、0xED40 - 0xEEFC
  • IBM拡張文字:0xFA40 - 0xFBFC
  • ユーザー定義外字:0xF040 - 0xF9F0
  Notesの一部のバージョンでは外字文字の入出力ができる場合がありますが、それは仕様上動作を保証しているものではありません。


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


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

主な例外

注意事項

• 「フォームの一覧が取得できません」というサーバコンソールおよび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の「アイドル状態のセッションのタイムアウト」設定を確認してください。