NotesPutAdv - Notesへの出力(Adv)

Notesデータベースにドキュメントの作成・更新・削除を行い、添付ファイル、リッチテキストフィールドおよびトランザクションの処理の設定をできます。
Notesビルダーを使って、Notesデータベースの一覧やスキーマを取得します。詳細についてはNotesGetAdvコンポーネントのトピック「Notesビルダーの使い方」を参照してください。

■ストリーム情報

入力	フォーマット	Record
	接続数	1
	説明	入力ストリームに「ASNOTES_ATTACHMENTINFO」というフィールド名が設定されている場合、そのフィールドの値は、添付ファイルとなるフィールド名と添付ファイル名との対応が記されている情報として使用されます。「ASNOTES_ATTACHMENTINFO」には、以下のようにフィールド名と対応する添付ファイル名を区切り文字「,」で区切って列挙します。 フィールド名1,添付ファイル名1,フィールド名2,添付ファイル名2, ... 添付ファイルをデータベースに書き込む場合には、「ASNOTES_ATTACHMENTINFO」の情報からファイル名を取得します。「ASNOTES_ATTACHMENTINFO」に、添付ファイルとして書き込もうとしているフィールド名に対応するファイル名が存在しなかった場合には、ファイル名は「npadv-XXXXXX.tmp」（XXXXXXの部分は不定な文字列）となります。
出力	フォーマット	Record
	説明	入力ストリームをそのまま出力します。

■コンポーネントプロパティ

名前	プロパティ型	マッピング	説明
コネクション名	connection	-	接続先のNotesサーバーを指定します。 コネクションペインまたは管理コンソールにて作成したNotes接続名を選択します。
データベース名	string	入力＆出力	クエリーを行うNotesデータベースの名前を指定します。 ループの中でMapperにより値が差し込まれた場合は、初回のみが有効となります。
検索文字列	string	入力＆出力	Notesの@functionフォーミュラを設定します。 この設定のフォーマットについてはNotesのドキュメンテーションを参照してください。 指定されたノーツ文書がレコードとして取得されます。このプロパティは設定されてない場合は、すべてのドキュメントが選択されます。
実行する処理	choice	-	実行するデータベース更新操作を指定します。 入力レコードのフィールドのタイプ データベースのフィールドのタイプ Binary RichText Boolean, Integer, Double, or Decimal Double DateTime DateTime Other String 登録 [Create] - 入力レコードをドキュメントとしてデータベースに登録します。入力レコードのフィールドはドキュメントのフィールドとして作成されます。検索文字列は使用されません。入力レコードのフィールドのタイプによって、データベースに作成をするフィールドのタイプが設定されます。上記の表は入力のフィールドのタイプによって、データベースに作成されるフィールドのタイプ示します。 更新 [Update] - 入力レコードで、データベースの検索されたドキュメントを更新します。検索されたドキュメントが無い場合には、レコードが無いのエラーとなります。 削除 [Delete] - 検索されたドキュメントを削除します。この場合には、入力ストリームが使用されません。検索されたドキュメントが無い場合には、レコードが無いのエラーとなります。
更新処理	choice	-	実行する処理が登録または更新である場合、入力ストリームのデータ型によって実行する更新操作を指定します。 入力されるレコードのフィールドが「Binary」の場合には、添付ファイルで追加、添付ファイルで上書きの設定を行ってください。 入力されるレコードが「Binary」フィールドではなく、かつNotesデータベース側のフィールドが「RichText」の場合には、文字列(入力値)で追加、文字列(入力値)で上書きの設定を行ってください。 入力されるレコードのフィールドが「Binary」ではなく、かつNotesデータベースのフィールドが「RichText」ではない場合には、入力値の文字列表現としてデータベースに上書きされます。 更新する値としてnullを指定した場合は、そのフィールドは更新されません。 添付ファイルで追加 [AppendAttachment] 添付ファイルとして追加されます。 添付ファイルで上書き [ReplaceAttachment] 添付ファイルとして上書きされます。 文字列(入力値)で追加 [AppendString] 入力値の文字列表現が追加されます。 文字列(入力値)で上書き [ReplaceString] 入力値の文字列表現が上書きされます。
トランザクション	choice	-	トランザクションモードを指定します。 フローの終了でコミット [Per Flow] - フローの実行が終了すると、トランザクションをコミットします。 ループの終了でコミット [Per Loop] - ループの実行が終了すると、トランザクションをコミットします。

■ループ処理

なし。

■トランザクション処理

コミット	Notesデータベースに対して、削除・書き込みを行います
ロールバック	Notesデータベースに対して、削除・書き込みを行わずに終了します

■エラー処理

タイプ	パラ メータ	エラー処理フロー へのストリーム	エラー コード	説明
レコードが無い	なし	コンポーネントの入力ストリーム	なし	検索されたドキュメントが無い場合
汎用	なし	コンポーネントの入力ストリーム	なし	コネクション名に指定したコネクションが見つからない場合
			なし	Notesサーバーに接続できない場合
			なし	選択されたNotesデータベースを見つけることができなかった場合
			なし	検索が失敗した場合
			なし	コネクション名に指定したコネクションのユーザーがデータペースへのアクセス権を持たない場合
			なし	入力されたレコードの「Binary」フィールドを、Notesデータベースのドキュメントへ書き込む場合に、Notesデータベースのフィールドが「RichText」ではない場合

■フローサービスをWindowsサービスから起動する場合の注意事項

本コンポーネントを使用する場合で、かつフローサービスをWindowsサービスから起動する場合には、サービスのログオンにはローカルシステムアカウントではなくAdmin権限を持つユーザーを設定してください。