ノーツ式読み取り処理

オペレーション名

機能概要

データモデル

プロパティ

基本設定

必須設定

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

データ処理方式

コメント

スキーマ

入力スキーマ

出力スキーマ

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

Mapperでのスキーマ読み込み

大容量データ処理

PSPでの使用について

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

型変換の動作について

仕様制限

• 本アダプタからDominoサーバーのデータベースへアクセスする際のユーザーは、Notesクライアントで設定されているユーザー固定となります。
  また、ユーザーのパスワードが解除されている必要がありますので、Notesクライアントからパスワード解除を行ってください。
  Notesクライアントで設定されているユーザーの「パスワードクオリティスケール」はパスワードなしを許容する設定にしてください。


• 本アダプタの実行時には、Notesクライアントは起動しないようにしてください。


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


• フィールドの種類が「テキスト」・「ダイアログリスト」・「チェックボックス」・「リストボックス」のデータについて
  • 複数値の場合は、[区切り文字]で指定した文字で区切って読み取ります。
• フィールドの種類が「日付/時刻」のデータについて
  • 「yyyy-MM-dd'T'HH:mm:ss.SSSZZ」形式でフォーマットして取得します。
  • 日付のみのデータは、DataSpiderServerが稼働するOSのタイムゾーンを考慮した日時データとして取得します。
    例:OSのタイムゾーンが日本標準時の場合「2009/10/01」→「2009-10-01T09:00:00.000+0900」
  • 日付の年は常に4桁で取得します。
  • ミリ秒の読み取りはサポートしていません。
  • 複数値の場合は、最初の値のみ読み取ります。
• フィールドの種類が「数値」のデータについて
  • 数値は「-1.7976931348623158E+308」から「1.7976931348623158E+308」の範囲が取り扱い可能です。
  • 複数値の場合は、最初の値のみ読み取ります。
• フィールドの種類が「リッチテキスト」・「リッチテキストライト」のデータについて
  • リッチテキストとして指定された文字修飾およびテキストデータは、HTMLファイルとして取得します。
    リッチテキストフィールド1つに対し、HTMLファイルが1つ生成されます。
  • 本アダプタでは、文書内の以下のオブジェクトを「添付ファイル」として取得します。
    • 文書の添付ファイル
    • 文書の画像(GIF、BMP、JPEG、PNG、TIFF 5.0)
    • 文書のOLEオブジェクトのプレビュー画像
    • 文書の添付ファイルのアイコン画像
  • 各添付ファイルのファイル名を結果データとして取得することはできません。
  • フィールドのデータが先頭から64KBを超えた場合、自動的に改行を付与して取得します。
  • 文書の添付ファイルの更新日時は、アダプタで取得した日時ではなく、文書上の添付ファイルの更新日時と同一になります。
  • 各添付ファイルの命名規則は以下の通りです。
    
    

    種類	命名規則	備考
    HTMLファイル	「richtext」 +「_」+「<GID(DataSpiderServerで生成される一意なID)>」+「.html」
    文書の添付ファイル	「<添付ファイル名(拡張子を含む)>」 同一文書内に同名の添付ファイルが存在する場合、2つ目以降のファイルは以下の命名規則になります。 「Notes内部の識別ID」+「<添付ファイル名(拡張子を含む)>」	添付ファイル名に「DataSpiderファイルシステムの禁止文字」が含まれる場合、「_」(半角アンダースコア)に変換して取得します。
    文書の画像	「<(画像が添付されている文書の)ユニバーサルID>」+「-」+「GRAPHIC」+「-」+「<連番>」+「.bmp」	ユニバーサルIDは16桁ずつに分割し「-」でつないで出力します。 連番は文書ごとに付与されます。 同一文書内に同名の画像が存在する場合、1つのみが取得されます。
    文書のOLEオブジェクトのプレビュー画像	「<(画像が添付されている文書の)ユニバーサルID>」+「-」+「GRAPHIC」+「-」+「<連番>」+「.bmp」	ユニバーサルIDは16桁ずつに分割し「-」でつないで出力します。 連番は文書ごとに付与されます。 同一文書内に同名のプレビュー画像が存在する場合、1つのみが取得されます。
    文書の添付ファイルのアイコン画像	「<(画像が添付されている文書の)ユニバーサルID>」+「-」+「PREVIEW」+「-」+「<連番>」+「-」+「<添付ファイル名(拡張子を含む)>」+「.bmp」	ユニバーサルIDは16桁ずつに分割し「-」でつないで出力します。 連番は文書ごとに付与されます。 添付ファイル名に「DataSpiderファイルシステムの禁止文字」が含まれる場合、「_」(半角アンダースコア)に変換して出力します。 添付ファイル名に「.」が含まれる場合、「_2E」に変換して出力します。



• [フォーム名]の表示名は、フォームの「名前」が表示されます。
  フォームに「別名」が設定されている場合は、最初の別名が表示されます。最後の別名を表示するには、プロパティファイルの設定を変更する必要があります。また、無題のフォームは表示できません。
  詳細については、以下の通りです。
  
  

  キー	配置場所	説明	備考
  notes.compat.220	$DATASPIDER_HOME/server/plugin/data_processing/share/classes/ lotusnotescommon.properties	true:(デフォルト) 「別名」が設定されていない場合はフォームの「名前」、設定されている場合は最初の別名を[フォーム名]に表示します。 名前 最初の別名 最後の別名 表示名 有 有 有 最初の別名 有 有 × 最初の別名 有 × × 名前 false: 「別名」が設定されていない場合はフォームの「名前」、設定されている場合は最後の別名を[フォーム名]に表示します。 名前 最初の別名 最後の別名 表示名 有 有 有 最後の別名 有 有 × 最初の別名 有 × × 名前	指定例:notes.compat.220=false



• 文書のフィールドが「表示用の計算結果」または「サブフォームの計算結果」である場合、そのフィールドは[フィールド定義]に表示されません。


• Domino Designerで削除したフィールドが[フィールド定義]に表示されることがあります。
  本動作はDomino Designerの「設計ペインの[フィールドと関数]に削除したフィールド名が表示されてしまう」問題と同一の事象となります。
  詳細については、HCL社に問い合わせてください。


• 本アダプタがサポートしているエンコードはShift_JISです。
  また、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の一部のバージョンでは外字文字の入出力ができる場合がありますが、それは仕様上動作を保証しているものではありません。

主な例外