kintonePut - kintoneへの出力

kintoneのアプリに対してレコードの登録・更新を行います。
kintoneビルダーを使って、kintoneのアプリ一覧やフィールド定義を取得します。詳細については下記トピック「kintoneビルダーの使い方」を参照してください。

■ストリーム情報

入力	フォーマット	Record
	接続数	1
	説明	入力ストリームのフィールド定義を専用の設定画面で行います。 このフィールド定義は直前に連結したマッパーの出力ストリームのフィールド定義にコピーされ、そこに対して値のマッピングを行います。 そのため、このコンポーネントに連結できるコンポーネントはマッパーのみとなっています。 マッピングする値の詳細については、下記トピック「kintoneのフィールドへのマッピングについて」を参照してください。
出力	フォーマット	Record
	説明	次の２つのフィールド定義が追加されて、入力ストリームが出力されます。 フィールド名 データ型 説明 入力ストリームのフィールド Id Integer レコードIDを出力します。 Revision Integer リビジョンを出力します。

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

名前	プロパティ型	マッピング	説明
コネクション名	connection	-	接続先のkintoneを指定します。コネクションペインまたは管理コンソールにて作成されたkintone接続名を選択します。
アプリID	int	出力	アプリIDを指定します。
実行する処理	choice	-	実行する更新操作を指定します。 追加 [insert] - フィールド定義にあるすべてのフィールドをレコードとして挿入します。 キーの定義は必要ありません。 更新 [update] - 「キーにする」項目で「はい」を指定したフィールドでレコードの検索を行い、マッチするレコードを、キー以外のフィールドを用いて更新します。 キーにするフィールドを更新することはできません。 追加/更新 [upsert] - フィールド定義を用いて「更新」を実行しますが、レコードの検索時にマッチするレコードが存在しなかった場合は「追加」を実行します。 更新処理が必要ない場合は「追加」を指定したほうがパフォーマンスが上がります。
API制限件数	int	-	kintone APIで一度に登録・更新できるレコードの上限値を指定します。この値はkintone APIで定義されているため、制限を超えた値を指定するとエラーが発生します。
入力	category	-	入力ストリームのフィールド定義を行います。実行する処理が「追加」以外の場合、kintoneビルダーでテーブルのキーとなるカラムの「キー」項目をチェックします。

■ループ処理

なし。

■トランザクション処理

コミット	何もしません。
ロールバック	何もしません。

■エラー処理

タイプ	パラ メータ	エラー処理フロー へのストリーム	エラー コード	説明
APIエラー	なし	コンポーネントの入力ストリーム	201	APIの実行でエラーコードを受け取った場合。

■kintoneのフィールドへのマッピングについて

kintoneのフィールド型による値の変換

kintoneのフィールドが日付型（DATE、DATETIME、CREATED_TIME、UPDATED_TIME）の場合は、マッピングされた値をDateTime型に変換して登録します。
それ以外のフィールドについては、マッピングされた値をString型に変換して登録します。

複数値をもつフィールドに値を登録するには

複数値をもつkintoneのフィールド（CHECK_BOX、MULTI_SELECT、FILE、USER_SELECT）に値を登録するには、複数の値を「,」(カンマ)区切りでつないだ文字列をマッピングする必要があります。

サブテーブルフィールドに値を登録するには

サブテーブルフィールド（SUBTABLE）に値を登録するには、JSON形式の文字列をマッピングする必要があります。この文字列のフォーマットについてはkintoneのAPIヘルプレコードの登録（1件）を参照してください。

■制限事項

kintone APIはトランザクションをサポートしていないため、同時にアクセスした場合にレコードの内容に不整合が生じる可能性があります。

■kintoneビルダーの使い方

kintoneビルダーは、プロパティとストリームを設定するための専用ツールです。kintoneビルダーを使うと、簡単な操作で以下のようなことができます。

• kintoneコネクションの作成、編集
• kintoneから取得したアプリ一覧からレコードの登録・更新を行うアプリ、フィールドを指定

●kintoneビルダーを起動する

以下のいずれかの操作でkintoneビルダーを起動します。

• kintonePutコンポーネントをダブルクリック
• kintonePutコンポーネントを右クリックして表示されるメニューから「kintoneビルダー」をクリック

●kintoneビルダーの画面

• (1)画面上部：接続先と実行する処理を表示する領域
• (2)画面左：アプリ一覧を表示する領域
• (3)画面右：フィールド一覧を表示する領域

●コネクションを作成する

(1)の接続先プルダウンリストから「新規kintoneコネクション」を選択します。 「新規コネクション作成」ダイアログが表示されるので、接続先の情報を入力して「保存」をクリックします。

●コネクションを編集する

(1)の接続先プルダウンリストから編集するコネクションを選択して、「編集」をクリックします。 コネクションダイアログが表示されるので、編集を行い「保存」をクリックします。

●コネクションを指定する

(1)の接続先プルダウンリストから使用するコネクションを選択します。(2)に指定した接続先のアプリの一覧が表示されます。

●実行する処理を指定する

(1)の実行する処理プルダウンリストから実行する処理を選択します。

●登録または更新を行うフィールドを指定する

(2)のアプリ一覧からアプリを選択すると(3)に選択したアプリのフィールド一覧が表示されます。 フィールド一覧でフィールド名の左にあるチェックボックスをオンにします。指定したフィールドを取り消すには、チェックボックスをオフにします。

●更新時のキーにするフィールドを指定する

実行する処理が「更新」または「追加/更新」の場合は (3)のフィールド一覧でキーにするフィールドのキーのチェックボックスをオンにします。キーの指定を取り消すには、キーのチェックボックスをオフにします。