レコード追加処理

オペレーション名

レコード追加

機能概要

kintoneのレコードを追加します。

データモデル

本コンポーネントのデータモデルはXML型です。

プロパティ

= 備考 =

変数の使用については、「変数」を参照してください。

基本設定

項目名

必須/省略可

変数の使用

説明

備考

名前

必須

使用不可

スクリプトキャンバス上での名前を入力します。

 

入力データ

必須

使用不可

スクリプトキャンバス上にあるコンポーネントを選択します。

 

必須設定

項目名

必須/省略可

変数の使用

説明

備考

接続先

必須

使用不可

コネクションリソースを選択します。

[追加]

新規にコネクションリソースを追加します。

[一覧の編集]

> HULFT INTEGRATE > コネクションで、コネクションリソースの設定を編集することができます。

 

キーの値と一致するレコードは更新

省略可

使用不可

キーとして指定したフィールドの値が一致するレコードの更新を行うか、全件追加を行うかを選択します。

[チェックあり]

キー値が一致するレコードは更新します。キー値が一致しないレコードは追加します。

[チェックなし]

(デフォルト)

全件追加します。

  • [キーの値と一致するレコードは更新]にチェックを入れ、[フィールド一覧][キー]が指定されていない場合には、エラーが発生します。

    詳細については、「キーの値と一致するレコードは更新について」を参照してください。

フィールド一覧

必須

-

フィールドを指定します。

 

フィールド一覧/書き込み対象

省略可

使用不可

各フィールドを、書き込み対象に含めるかどうかを選択します。

[チェックあり]

書き込み対象に含めます。

[チェックなし]

(デフォルト)

書き込み対象に含めません。

  • チェックを入れた列の列名がMapperのスキーマに表示されます。

  • ヘッダに表示されたチェックボックスをクリックすることで、一括操作を行うことができます。

注意

1つ以上の列にチェックが入っている必要があります。

フィールド一覧/キー

必須

使用不可

更新条件に含めるキーを選択します。

[チェックあり]

更新条件に含めます。

[チェックなし]

(デフォルト)

更新条件に含めません。

  • [キーの値と一致するレコードは更新]にチェックを入れた場合、有効になります。

  • [キーの値と一致するレコードは更新]にチェックを入れ、[フィールド一覧][キー]が指定されていない場合には、エラーが発生します。

注意

[キー]に指定するフィールドは[書き込み対象]にチェックを入れる必要があります。

詳細については、「キーの値と一致するレコードは更新について」を参照してください。

フィールド一覧/フィールド名

省略可

使用不可

フィールド名を表示します。

 

フィールド一覧/フィールドコード

省略可

使用不可

フィールドコードを表示します。

 

フィールド一覧/フィールドの型

省略可

使用不可

フィールドの型を表示します。

 

フィールド一覧/サブテーブル

省略可

使用不可

フィールドがサブテーブルに含まれる場合にサブテーブルのフィールドコードを表示します。

 

プロパティアクション

項目名

説明

備考

フィールド一覧の更新

kintoneアプリからフィールド情報を取得し[フィールド一覧]に設定します。

 

添付ファイル

項目名

必須/省略可

変数の使用

説明

備考

添付ファイルの入力方法

省略可

使用不可

添付ファイルの入力方法を選択します。

[データ(Base64)]

(デフォルト)

追加するファイルの内容をBase64形式で入力します。

[ファイル]

添付ファイルをファイルとして追加します。

 

コメント

項目名

必須/省略可

変数の使用

説明

備考

コメント

省略可

使用不可

このコネクターの簡単な説明を記述することができます。

 

スキーマ

入力スキーマ

= 備考 =

本コネクターが使用するスキーマについては、「レコードスキーマ」を参照してください。

出力スキーマ

ありません。

Mapperでのスキーマ読み込み

スキーマは自動で読み込まれます。

= 備考 =

詳細については、「スキーマ編集」を参照してください。

トランザクション

トランザクションはサポートしていません。

PSPでの使用について

PSPでは使用できません。

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

コンポーネント変数名

説明

備考

count

追加したレコードの件数が格納されます。

  • デフォルト値はnullです。

message_category

エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。

  • デフォルト値はnullです。

message_code

エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。

  • デフォルト値はnullです。

message_level

エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。

  • デフォルト値はnullです。

error_type

エラー発生時、発生したエラーの種類が格納されます。

  • デフォルト値はnullです。

  • エラーの種類は、以下のような形式となります。

    例:「java.io.FileNotFoundException」

error_message

エラー発生時、発生したエラーのメッセージが格納されます。

  • デフォルト値はnullです。

error_trace

エラー発生時、発生したエラーのトレース情報が格納されます。

  • デフォルト値はnullです。

キーの値と一致するレコードは更新について

レコード追加処理で更新を行う場合には、[キーの値と一致するレコードは更新]にチェックを入れ、キーとなる[フィールドコード]を選択します。

キーとして選択したフィールドの値が一致したレコードを更新し、一致しないレコードを追加します。

Upsert
  • 複数のキーを更新条件として指定できます。キーとして選択したすべてのフィールドの値が一致するレコードを更新します。

メッセージコード、例外メッセージ、制限事項

コネクター

メッセージコード

例外メッセージ

制限事項

kintone コネクターのメッセージおよび制限事項

check

check

check