ロゴ
Forma
ガイド

kintoneアプリの接続方法

Formaでkintoneアプリと接続する方法を詳しく説明します

Forma を使用して kintone アプリと接続し、フォームからデータを送信するための設定方法を説明します。

概要

kintone アプリとの接続には、以下の情報が必要です:

  • アプリ ID: kintone アプリの識別番号
  • URL: kintone のドメイン
  • API トークン: アプリへのアクセス権限を持つトークン
  • アプリ名: Forma で管理するための名前

接続手順

kintoneでAPIトークンを取得

kintone アプリの設定画面から、API トークンを生成します。

  1. kintone アプリを開く
  2. アプリの設定アイコン(⚙️)をクリック
  3. 「設定」タブから「API トークン」を選択
  4. 「生成する」ボタンをクリック
  5. 必要な権限を選択(レコード追加が最低限必要です)
  6. 「保存」をクリック
  7. 生成されたトークンをコピー

アプリ ID を確認

kintone アプリの URL からアプリ ID を取得します。

例: https://example.cybozu.com/k/123/ の場合、アプリ ID は 123 です。

Forma で接続を作成

  1. Forma のダッシュボードにアクセス
  2. サイドバーの「kintoneアプリ」を開き、画面右上の「アプリを追加」をクリック
  3. 必要な情報を入力:
    • URL: https://example.cybozu.com のような形式
    • アプリ ID: kintone アプリの ID
    • API トークン: 先ほどコピーしたトークン
    • アプリ名: 管理しやすい名前を設定(「kintoneから取得」で kintone のアプリ名と説明を入力できます。入力済みの内容は上書きされます)
  4. 「アプリを追加」をクリック

保存時に kintone への接続確認が行われ、接続できない場合はエラーが表示されます。

必須項目

アプリ ID

kintone アプリの一意の識別番号です。アプリの URL から確認できます。

例: URL が https://example.cybozu.com/k/123/ の場合、アプリ ID は 123

URL

kintone のドメインを指定します。

形式: https://[サブドメイン].cybozu.com

例:

  • https://example.cybozu.com
  • https://mycompany.cybozu.com

API トークン

アプリへのアクセス権限を持つトークンです。kintone アプリの設定画面から生成できます。

必要な権限:

  • レコード追加

アプリ名

Forma で管理するための名前です。複数の kintone アプリを接続する場合に識別しやすくなります。

例: 「お問い合わせアプリ」「申込フォーム」

アプリ名はFormaで管理するためのものです。kintone側のアプリ名と一致させる必要はありません。

オプション項目

説明

接続の目的や用途を記述できます(100 文字以内)。

ゲストスペース ID

ゲストスペース内のアプリに接続する場合に必要です。

ゲストスペースの URL から確認できます:

  • URL: https://example.cybozu.com/k/guest/456/123/
  • ゲストスペース ID: 456

Basic 認証

kintone 環境で Basic 認証が設定されている場合に使用します。

  • ユーザー名: Basic 認証のユーザー名
  • パスワード: Basic 認証のパスワード

接続済みアプリの管理

サイドバーの「kintoneアプリ」から、接続済みのアプリを一覧で確認できます。一覧には、最近更新した 10 件のアプリが表示されます。

  • 歯車アイコン: 接続設定を編集します。API トークンを再発行した場合などに使用します。
  • このアプリをkintoneで開く: kintone のアプリ画面を開きます。
  • ごみ箱アイコン: 接続設定を削除します。kintone のアプリやレコードには影響しません。

フォームの送信先になっているアプリは削除できません。先に、そのアプリを使っているフォームを削除するか、送信先を別のアプリに変更してください。

接続できるアプリの数はプランによって異なります。詳しくはプランと利用制限を参照してください。

トラブルシューティング

接続エラーが発生する

ゲストスペースに接続できない

ゲストスペース内のアプリに接続する場合は、必ず「ゲストスペース ID」を入力してください。

ゲストスペース ID は、ゲストスペースの URL から確認できます:

  • URL: https://example.cybozu.com/k/guest/456/123/
  • ゲストスペース ID: 456

Basic 認証エラー

kintone 環境で Basic 認証が設定されている場合、必ず Basic 認証のユーザー名とパスワードを入力してください。

次のステップ

kintone アプリとの接続が完了したら、次はフォームを作成してデータを送信しましょう。

関連ドキュメント