アプリ管理アプリのレコードを現在のアプリ一覧情報に基づいて更新・追加します。
kintone アプリストアの「その他」に「kintoneアプリ管理」という名前のアプリテンプレートがありますので、このアプリテンプレートからアプリを作成しておきます。作成したアプリに対し、独自にフィールドを追加しても構いません。もとからあるフィールドのフィールドコード、フィールドタイプは変更しないでください。
「kintoneアプリ管理」アプリの説明文にもあるとおり、このアプリのレコードを更新する場合は、アプリ管理画面の「CSV形式でダウンロードする」でダウンロードしたCSVファイルからレコードを読み込む、という運用が想定されています。「アプリ管理アプリのレコードを更新する」は、この手順を自動化します。ただし、全ての情報を更新できるわけではなく、以下の情報のみが更新されます。
「kintoneアプリ管理」テンプレートから作成したアプリ管理アプリは、いくつかフィールドを追加してCustomineのカスタマイズアクセス権限機能の管理に用いることができます。カスタマイズアクセス権限機能用の管理アプリに対しても「アプリ管理アプリのレコードを更新する」を用いることができます。カスタマイズアクセス権限機能の詳細は、gusukuサポートサイト をご覧ください。
アプリ管理アプリに未登録のアプリ情報があれば新規レコードを作成し、すでにあれば上書き更新します。レコード更新時に競合の検出は行われません。削除されたアプリについては、アプリ管理アプリの当該レコードは更新されません。アプリが削除されてもアプリ管理アプリのレコードを削除することはありません。
アプリ管理アプリに対してユーザーが独自にフィールドを追加している場合、「アプリ管理アプリのレコードを更新する」はそのフィールドを変更せず、元の値を維持します。
「アプリ管理アプリのレコードを更新する」は Job Runner でも特殊な位置づけの「やること」になります。通常、Job Runner ではレコード更新はできるだけ複数行をまとめて更新しようとしますが、「アプリ管理アプリのレコードを更新する」は１行ずつ更新を行います。
「アプリ管理アプリ」「ドメイン」「接続kintoneユーザー名」「接続kintoneユーザーのパスワード」を設定します。
レコードをセットする先のアプリ管理アプリを指定します。
このアプリも Customine へ登録しておく必要があります。
アプリ管理アプリのあるドメインを選択します。
このドメインに対して Customine の契約が必要です。
アプリ一覧情報の取得や、アプリ管理アプリへのアクセスをどのユーザーのアカウントで行うかを指定します。
このユーザーは以下の権限を持っている必要があります。
アプリ管理アプリそのものに対するレコード追加権限と編集権限の両方
アプリ管理アプリで管理されるアプリに対するレコード閲覧権限またはレコード追加権限
| 条件 | 発生有無 |
|---|---|
| 「レコード１行が準備できた時」 | 発生しません |
| 「レコード全行が準備できた時」 | 発生しません |
アプリ管理アプリに「レコードの追加」または「レコードの編集」条件で Webhook 通知を行うように設定されている場合、通知が発生します。
バージョン 1.204(2023年11月30日リリース) 以前は以下のフィールドも更新対象になっていましたが、バージョン 1.205(2023年12月21日リリース)以降、これらのフィールドは更新対象外となります。
バージョン 1.204(2023年11月30日リリース) 以前は kintone の非公開 API を使用していましたが、バージョン 1.205(2023年12月21日リリース)以降は公開 API のみを使用しています。
Basic認証には対応していません。
アプリ管理アプリがゲストスペースにある場合には対応していません。