{"id":27272,"date":"2024-03-11T11:41:04","date_gmt":"2024-03-11T02:41:04","guid":{"rendered":"https:\/\/docs.c-bot.pro\/?p=27272"},"modified":"2024-09-20T10:11:48","modified_gmt":"2024-09-20T01:11:48","slug":"app_or_update_multiple_records","status":"publish","type":"post","link":"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/app_or_update_multiple_records\/","title":{"rendered":"kintone \/ Add or update multiple records"},"content":{"rendered":"\n<p><a href=\"https:\/\/docs.c-bot.pro\/en\/\"><i class=\"fas fa-book\"><\/i>&nbsp;Home<\/a> &gt; <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\">User guide<\/a> &gt; <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/\">BOT<\/a>  &gt; <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\">How to use the BOT editor<\/a> &gt; <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\">Extension<\/a> &gt; <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/\">kintone<\/a> &gt;  Add or update multiple records<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-full is-resized extension_icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2024\/03\/icon-kintone.png\" alt=\"\" class=\"wp-image-26256 extension_border\" width=\"75\" height=\"75\"><\/figure>\n\n\n\n<h2 id=\"outline__1\" class=\"wp-block-heading\">App overview<\/h2>\n\n\n\n<p>Targets multiple records, updates if the record to be updated exists, and adds a new record if it does not exist.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>Extended Feature URL<\/td><td>cbot-extension:\/\/cloud-bot:kintone:upsert-records:4<\/td><\/tr><tr><td>Provider<\/td><td>Extension : Cloud BOT <span style=\"margin-left: 2px ; padding: 2px 7px; border:0px solid #000 ; background-color: #007bff ; border-radius: 5px ; color: #ffffff ; font-size: 0.7em;\" class=\"badge\">official<\/span><br>kintone : <a rel=\"noreferrer noopener\" href=\"https:\/\/cybozu.co.jp\/en\/company\/\" data-type=\"URL\" data-id=\"https:\/\/cybozu.co.jp\/en\/company\/\" target=\"_blank\">Cybozu, Inc.<\/a><\/td><\/tr><tr><td>External communication<\/td><td>Yes<\/td><\/tr><tr><td>Version<\/td><td>4<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 id=\"outline__2\" class=\"wp-block-heading\">Screen description<\/h2>\n\n\n\n<h3 id=\"outline__2_1\" class=\"wp-block-heading\">Input screen<\/h3>\n\n\n\n<h4 id=\"outline__2_1_1\" class=\"wp-block-heading\"><strong><strong>kintone app information settings<\/strong><\/strong><\/h4>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"866\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2024\/09\/img_kintone_addEditMultipleRecord_imput_en-1024x866.png\" alt=\"\" class=\"wp-image-30685\"\/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p class=\"has-black-color has-text-color\"><strong><strong>Domain name<\/strong><\/strong><\/p>\n\n\n\n<p class=\"extension_detail_item_body\">Specify a domain name.<\/p>\n\n\n\n<p class=\"extension_detail_item_body\"><small> Example&gt; c-bot.cybozu.com <\/small><\/p>\n\n\n\n<p class=\"has-black-color has-text-color\"><strong><strong><strong>App ID<\/strong><\/strong><\/strong><\/p>\n\n\n\n<p class=\"extension_detail_item_body\">Specify the app ID.<\/p>\n\n\n\n<p class=\"extension_detail_item_body\"><small> Example&gt; 6 <\/small><\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"840\" height=\"126\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2024\/03\/user_guide_ex_kintone_en_01.png\" alt=\"\" class=\"wp-image-27238\"\/><\/figure>\n\n\n\n<p class=\"has-black-color has-text-color\"><strong><strong><strong><strong>Guest space ID<\/strong><\/strong><\/strong><\/strong><\/p>\n\n\n\n<p class=\"extension_detail_item_body\">Specify the guest space ID. If the specified application belongs to a guest space, it must be entered.<\/p>\n\n\n\n<p class=\"extension_detail_item_body\"><small> Example&gt; 3 <\/small><\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"844\" height=\"126\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2024\/03\/user_guide_ex_kintone_en_02.png\" alt=\"\" class=\"wp-image-27239\"\/><\/figure>\n\n\n\n<p class=\"has-black-color has-text-color\"><strong><strong><strong><strong><strong>Authentication method<\/strong><\/strong><\/strong><\/strong><\/strong><\/p>\n\n\n\n<p class=\"extension_detail_item_body\">Select the authentication method.<\/p>\n\n\n\n<p>Password authentication: Authenticate using your login name (user account) and password.<br>\nAPI Token Authentication: Authenticate using the app's API token.<\/p>\n\n\n\n<p class=\"extension_detail_item_body\"><small> *  <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/kintone_apps_setup\/#outline__1\">Click here<\/a> for about API Token Generation.<br>* If multiple API tokens are used, specify them separated by commas. <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/kintone_apps_setup\/#outline__1_1\">Click here<\/a> for more information<\/small><\/p>\n<\/div>\n<\/div>\n\n\n\n<h4 id=\"outline__2_1_2\" class=\"wp-block-heading\"><strong><strong><strong>Input fields settings<\/strong><\/strong><\/strong><\/h4>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"398\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2024\/09\/img_kintone_addEditMultipleRecord_field_en-1024x398.png\" alt=\"\" class=\"wp-image-30686\"\/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p class=\"has-black-color has-text-color\"><strong><strong><strong><strong>App name<\/strong><\/strong><\/strong><\/strong><\/p>\n\n\n\n<p class=\"extension_detail_item_body\">The application name is displayed.<\/p>\n\n\n\n<p class=\"has-black-color has-text-color\"><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong>Input fields<\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/p>\n\n\n\n<p class=\"extension_detail_item_body\">Specify the fields of the record to be updated. The number of fields to be updated can be increased or decreased by clicking the Add and Delete buttons.<br><small>* Table fields and non-supported fields are not displayed.<br>\n* <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/field_and_operator_input_rules\/\">Click here<\/a> to learn more about field entry rules.<\/small><\/p>\n\n\n\n<p class=\"has-black-color has-text-color\"><\/p>\n<\/div>\n<\/div>\n\n\n\n<h4 id=\"outline__2_1_3\" class=\"wp-block-heading\"><strong><strong><strong><strong><strong><strong><strong><strong>Update record settings<\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/h4>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"566\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2024\/09\/img_kintone_addEditMultipleRecord_config_en-1024x566.png\" alt=\"\" class=\"wp-image-30687\"\/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p class=\"has-black-color has-text-color\"><strong><strong><strong><strong><strong><strong><strong><strong>Key field<\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/p>\n\n\n\n<p class=\"extension_detail_item_body\">Specify the field that serves as the key for the target record conditions.<small><br>* <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/kintone_apps_setup\/#outline__2_4\">Click here<\/a> <\/small>for more information about key field.<\/p>\n\n\n\n<p class=\"has-black-color has-text-color\"><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong><strong>Key&nbsp;valu<\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong>es<\/strong><\/p>\n\n\n\n<p class=\"extension_detail_item_body\">Specify the value for the key field. Records matching this value will be updated.<\/p>\n\n\n\n<p><strong>Filters (optional)<\/strong><\/p>\n\n\n\n<p class=\"extension_detail_item_body\">Records that match the filter will be processed. The number of filter conditions can be increased or decreased by clicking the Add and Delete buttons. <br> <small>* <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/kintone_apps_setup\/#outline__2_6\" data-type=\"URL\" data-id=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/kintone_apps_setup\/#outline__2_6\">Click here<\/a> to learn more about filter condition.<br>* <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/field_and_operator_input_rules\/\">Click here<\/a>  for information on input rules for fields and operators.<\/small><\/p>\n<\/div>\n<\/div>\n\n\n\n<h4 id=\"outline__2_1_4\" class=\"wp-block-heading\">Update record settings(Input data)<\/h4>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"334\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2024\/09\/img_kintone_addEditMultipleRecord_setting_en-1024x334.png\" alt=\"\" class=\"wp-image-30688\"\/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p class=\"has-black-color has-text-color\"><strong><strong><strong><strong><strong><strong><strong>Value of each field<\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/strong><\/p>\n\n\n\n<p class=\"extension_detail_item_body\">Enter a value for each field.<\/p>\n<\/div>\n<\/div>\n\n\n\n<h3 id=\"outline__2_2\" class=\"wp-block-heading\"><strong><strong><strong><strong>Result screen<\/strong><\/strong><\/strong><\/strong><\/h3>\n\n\n\n<h4 id=\"outline__2_2_1\" class=\"wp-block-heading\"><strong><strong>The update is complete.<\/strong><\/strong><\/h4>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"425\" height=\"1024\" src=\"https:\/\/docs.c-bot.pro\/wp-content\/uploads\/2024\/09\/img_kintone_addEditMultipleRecord_result_en-1-425x1024.png\" alt=\"\" class=\"wp-image-30690\"\/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p>Results are displayed.<\/p>\n\n\n\n<p><small>* How the corresponding record is processed depends on the field and key specified in the update condition. <a href=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/kintone_apps_setup\/#outline__2_5\" data-type=\"URL\" data-id=\"https:\/\/docs.c-bot.pro\/en\/user_guide\/bot\/b-bot_editer\/extension\/kintone_apps\/kintone_apps_setup\/#outline__2_5\">Click here<\/a> for more information.<br> * If an error occurs, further processing is aborted.<\/small><\/p>\n<\/div>\n<\/div>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>App name<\/strong><\/td><td>The application name is displayed.<\/td><\/tr><tr><td><strong><strong><strong>Number of addictions<\/strong><\/strong><\/strong><\/td><td>The number of records added is displayed.<\/td><\/tr><tr><td><strong>Number of updates<\/strong><\/td><td>The number of records updated is displayed.<\/td><\/tr><tr><td><strong>Number of filters<\/strong><\/td><td>The number of filtered records is displayed.<\/td><\/tr><tr><td><strong>Number of addiction errors<\/strong><\/td><td>The number of failed record additions is displayed.<\/td><\/tr><tr><td><strong><strong><strong>Number of update errors<\/strong><\/strong><\/strong><\/td><td>The number of failed record updates is displayed.<\/td><\/tr><tr><td><strong><strong>Number of skips<\/strong><\/strong><\/td><td>The number of unprocessed cases interrupted by error handling is displayed.<\/td><\/tr><tr><td><strong>Total<\/strong><\/td><td>The total of Number of updates, Number of update errors, Number of filters, and Number of skips is displayed.<\/td><\/tr><tr><td><strong>Added record keys<\/strong><\/td><td>The key of the added record is displayed.<\/td><\/tr><tr><td><strong>Revision number of the added records<\/strong><\/td><td>The revision numbers of the added records will be displayed.<\/td><\/tr><tr><td><strong>Update record keys<\/strong><\/td><td>The key of the updated record is displayed.<\/td><\/tr><tr><td><strong>Revision number of the updated records<\/strong><\/td><td>The revision numbers of the updated records will be displayed.<\/td><\/tr><tr><td><strong>Filtered record keys<\/strong><\/td><td>The key of the filtered record is displayed.<\/td><\/tr><tr><td><strong><strong>Key of the records that failed to add<\/strong><\/strong><\/td><td>The keys of the records that failed to add will be displayed.<\/td><\/tr><tr><td><strong>Key of the records that failed to update<\/strong><\/td><td>The keys of the records that failed to update will be displayed.<\/td><\/tr><tr><td><strong>Error<\/strong><\/td><td>When a record update fails, the error message is displayed.<\/td><\/tr><tr><td><strong>Error details<\/strong><\/td><td>Details of the error are displayed.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n","protected":false},"excerpt":{"rendered":"<p>&nbsp;Home &gt; User guide &gt; BOT &gt; How to use the BOT editor &gt; Extension &gt; kintone &gt; Add or update multiple records App overview Targets multiple records, updates if the record to be updated exists, and adds a new record if it does not exist. Extended Feature URL cbot-extension:\/\/cloud-bot:kintone:upsert-records:4 Provider Extension : Cloud BOT officialkintone : Cybozu, Inc. External communication Yes Version 4 Screen description Input screen kintone app information settings Domain name Specify a domain name. Example&gt; c-bot.cybozu.com App ID Specify the app ID. Example&gt; 6 Guest space ID Specify the guest space ID. If the specified application belongs to a guest space, it must be entered. Example&gt; 3 Authentication method Select the authentication method. Password authentication: Authenticate using your login name (user account) and password. API Token Authentication: Authenticate using the app's API token. * Click here for about API Token Generation.* If multiple API tokens are used, specify them separated by commas. Click here for more information Input fields settings App name The application name is displayed. Input fields Specify the fields of the record to be updated. The number of fields to be updated can be increased or decreased by clicking the Add and Delete [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_locale":"en_US","_original_post":"https:\/\/docs.c-bot.pro\/?p=27052","footnotes":""},"categories":[123],"tags":[68,53,59,57],"class_list":["post-27272","post","type-post","status-publish","format-standard","hentry","category-kintone_apps","tag-bot","tag-kintone","tag-59","tag-57","en-US"],"_links":{"self":[{"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/posts\/27272","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/comments?post=27272"}],"version-history":[{"count":11,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/posts\/27272\/revisions"}],"predecessor-version":[{"id":30877,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/posts\/27272\/revisions\/30877"}],"wp:attachment":[{"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/media?parent=27272"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/categories?post=27272"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.c-bot.pro\/wp-json\/wp\/v2\/tags?post=27272"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}