はじめて使う方は、先に共通ガイドをご覧ください。
1. 本プラグインでできること
kintone アプリに登録した案件レコードをもとに、クラウドログのプロジェクトをまとめて作成します。プロジェクトへの部署・メンバー・工程グループの割り当ても同時に行うことが可能です。
- データはkintone→ クラウドログ の一方向です。
- 実行ボタンを押すと、一覧の絞り込み結果のレコードを対象にプロジェクトをまとめて作ります。絞り込みをしていない場合は、アプリ内の全レコードが対象になります。
- すでに作成済みのプロジェクト(同じコードのもの)は、自動でスキップされ二重作成されることはありません。
- 割り当てる部署・メンバー・工程グループは、レコードの追加・編集画面でクラウドログの一覧から検索して選びます(任意・3-3、3-5参照)。
- 作成したプロジェクトの編集ページURLを、kintoneレコードに登録することもできます(任意・3-4参照)。
本プラグインを実行すると、対象レコードのうち設定でマッピングした項目(プロジェクトコード・プロジェクト名・開始日など)がクラウドログへ送信され、クラウドログのサーバー上にプロジェクトとして保存されます。部署・メンバー・工程グループの割り当てを設定している場合は、レコードで選んだ部署・メンバー・工程グループのIDも送信されます。それ以外の項目は送信されません。
2. 使う前に必要な準備
2-1. kintoneアプリに必要なフィールドを用意する
案件情報を入れるフィールドを用意します。下表は一例です。本プラグインはフィールドを自動では作りません。
| フィールド(例) | 種類 | 用途 | 必須 |
|---|---|---|---|
| 案件コード | 文字列1行 | プロジェクトコードとして使用 | ◯ |
| 案件名 | 文字列1行 | プロジェクト名 | ◯ |
| 開始日 | 日付 | プロジェクト開始日 | ◯ |
| 終了日 | 日付 | プロジェクト終了日 | 任意 |
| 部署の選択欄 | スペース | 割り当てる部署を選ぶ欄を表示する場所 | 任意(部署を割り当てる場合は必須) |
| 部署ID | 文字列1行 または 文字列(複数行) | 選んだ部署のIDの保存先 | 任意(部署を割り当てる場合は必須) |
| 部署名 | 文字列1行 または 文字列(複数行) | 選んだ部署の名称の保存先(表示用) | 任意 |
| メンバーの選択欄 | スペース | 割り当てるメンバーを選ぶ欄を表示する場所 | 任意(メンバーを割り当てる場合は必須) |
| メンバーID | 文字列1行 または 文字列(複数行) | 選んだメンバーのIDの保存先 | 任意(メンバーを割り当てる場合は必須) |
| メンバー名 | 文字列1行 または 文字列(複数行) | 選んだメンバーの氏名の保存先(表示用) | 任意 |
| 工程グループの選択欄 | スペース | 割り当てる工程グループを選ぶ欄を表示する場所 | 任意(工程グループを割り当てる場合は必須) |
| 工程グループID | 文字列1行 | 選んだ工程グループのIDの保存先 | 任意(工程グループを割り当てる場合は必須) |
| 工程グループ名 | 文字列1行 | 選んだ工程グループの名称の保存先(表示用) | 任意 |
| プロジェクトURL | リンク | 作成したプロジェクトのURLの登録先 | 任意 |
部署・メンバー・工程グループのフィールドは、使うものだけ用意すれば構いません。用意するときは次の点にご注意ください。
-
スペースには「要素ID」を設定してください。kintone アプリの設定 →「フォーム」で、配置したスペースの設定メニュー(右上の歯車)→「設定」を開くと「要素ID」欄があります。空の場合は任意の ID(例:
department_picker)を入力して保存してください。要素IDがプラグイン設定と一致していないと、レコード画面に選択欄が表示されません。 - 部署・メンバー・工程グループの選択欄は、それぞれ別のスペースにしてください。
- 部署・メンバーのID・名称の保存先には、「文字数制限(最大文字数)」を設定しないでください。選べる数に上限がないため、制限があるとレコードを保存できなくなることがあります。
- ID・名称の保存先とプロジェクトURLの登録先には、プラグインが値を書き込みます(元の値は上書きされます)。業務で使っているフィールドと兼用せず、プラグイン専用のフィールドを新しく作ってください。
2-2. クラウドログ側の準備
部署・メンバー・工程グループの割り当てを使う場合は、次の準備が必要です。プロジェクトの作成とURLの登録だけを使う場合は不要です。
- APIトークンを発行するユーザーに、クラウドログの「管理者」権限が必要です。レコード画面で部署・ユーザー・工程グループの一覧を取得するためです。システム管理者のユーザーがAPIトークンを発行するか、ロールで「管理者」権限を付与されたユーザーがAPIトークンを発行してください。
- 工程グループは、クラウドログの管理画面であらかじめ作成してください。本プラグインは登録済みの工程グループを選んで割り当てる機能です。工程リストの内容を kintone から作成・同期することはできません。
3. 設定手順
プラグイン設定画面を開き、次を設定します。
フィールドの選び方(各項目共通)
kintone のフィールドを指定する項目は、ドロップダウンから選びます。選択肢は「フィールド名(フィールドコード)」の形式で表示されます(例:案件名(project_name))。
- レコード番号・作成者・更新日時などの kintone が自動で持つ項目、テーブル・添付ファイル・ユーザー選択・組織選択・グループ選択・関連レコード一覧、ラベル・スペース・罫線・グループは選択肢に表示されません。
- 部署・メンバーのID・名称の保存先は、文字列1行・文字列(複数行)のフィールドだけが選択肢に表示されます。
- 設定したいフィールドが選択肢に出てこない場合は、kintone アプリにそのフィールドがあるかをご確認ください。フィールドを追加したときは、「アプリを更新」を実行してから、プラグイン設定画面を開き直してください。設定画面は開いた時点のフィールドを表示します。
3-1. API接続設定
| 項目 | 入力内容 |
|---|---|
| APIトークン | クラウドログのAPIトークン(必須)。部署・メンバー・工程グループの割り当てを使う場合は、「管理者」権限を持つユーザーが発行したもの(2-2参照) |
3-2. プロジェクト基本項目のマッピング
クラウドログのプロジェクト項目に、kintone のどのフィールドを対応させるかを選びます。各項目には、フィールドのほかに「型」(文字列 / 数値 / 日付)を選ぶ欄があります。
| クラウドログの項目 | 選ぶ型 | 必須 |
|---|---|---|
| プロジェクトコード | 文字列 | ◯ |
| プロジェクト名 | 文字列 | ◯ |
| 開始日 | 日付 | ◯ |
| 終了日 | 日付 | 任意 |
| コメント | 文字列 | 任意 |
3-3. 部署の割当・メンバーの割当(任意)
「部署の割当」「メンバーの割当」のそれぞれで、次の項目を設定します。使わない場合は「アサイン方式」を「使用しない」のままにしてください。
| 項目 | 設定内容 |
|---|---|
| アサイン方式 | 「クラウドログから選択」を選ぶと、下の3項目が表示されます。 |
| ID 格納先フィールド(必須) | 2-1で用意した部署ID(メンバーID)のフィールドを選びます。 |
| 選択欄を表示するスペースの要素ID(必須) | 2-1で用意したスペースの要素IDを入力します(この項目だけは手入力です)。 |
| 名称の格納先フィールド(任意) | 一覧画面などで選んだ部署名・氏名を確認したい場合に、2-1で用意した部署名(メンバー名)のフィールドを選びます。空欄にすると名称は保存されません。 |
- 「クラウドログから選択」にして ID 格納先またはスペースの要素IDを空のまま保存すると、エラーになり保存できません。
- 部署・メンバー・工程グループの間で、同じフィールドや同じスペースの要素IDを指定すると、エラーになり保存できません。
3-4. プロジェクトURLの登録(任意)
作成したプロジェクトの編集ページURLを、kintoneレコードに登録できます。「kintoneフィールドコード」で、URLの登録先にするリンクフィールドを選んでください。未設定の場合、URLは登録されません。
- 登録先には「リンク」フィールドを指定してください(2-1参照)。
- 登録されたURLを開くには、クラウドログ側でプロジェクト情報の参照権限が必要です。
- クラウドログへ送信する項目の読み取り元として使っているフィールド(3-2で設定したもの)は、URLの登録先に指定できません。別のフィールドを用意してください。
3-5. 工程グループ割当(任意)
次の項目を設定します。使わない場合はすべて空にしてください。
| 項目 | 設定内容 |
|---|---|
| 工程グループID格納先フィールドコード | 2-1で用意した工程グループIDのフィールドを選びます。 |
| 選択欄を表示するスペースの要素ID | 2-1で用意したスペースの要素IDを入力します。 |
| 工程グループ名の格納先フィールドコード(任意) | 一覧画面などで選んだ工程グループ名を確認したい場合に、2-1で用意した工程グループ名のフィールドを選びます。空欄にすると名称は保存されません。 |
上の2項目(ID格納先とスペースの要素ID)の両方を設定すると有効になります。片方だけの設定は保存できません。
設定を保存したら、kintone アプリの「アプリを更新」を実行してください。
値が書き込まれるフィールドの指定にご注意ください
3-3〜3-5で指定する ID・名称の格納先とURLの登録先は、プラグインが kintone レコードに値を書き込む先です。元の値があっても上書きされます。業務で使っているフィールドを指定すると、入力されていた内容が失われますので、プラグイン専用のフィールドを指定してください。
誤ったフィールドを指定して値が上書きされてしまった場合は、kintone のレコードの変更履歴から上書き前の状態に戻せます。
- 対象のレコードを開く
- 「変更履歴」タブを開く
- 戻したい時点のバージョンで「このバージョンに戻す」をクリック
詳しい操作は kintone のヘルプ(レコードの変更履歴を確認する/レコードを以前のバージョンに戻す)をご覧ください。
- 戻す操作はレコード1件ずつです。多数のレコードを一括で作成した後に気づいた場合、レコードの件数だけ操作が必要になります。
- アプリの設定でレコードの変更履歴を無効にしている場合、この方法では戻せません。
- 変更履歴から戻せるのは、ご自身に編集権限があるフィールドのみです。
4. 実行手順
4-1. レコードで部署・メンバー・工程グループを選ぶ(割り当てを使う場合)
- レコードの追加(または編集)画面を開くと、スペースの位置に部署・メンバー・工程グループの選択欄が表示されます。
- 選択欄に名称やコードの一部を入力すると候補が絞り込まれます。候補をクリックすると選ばれます。部署・メンバーは続けて別の候補を選べます(工程グループは1つだけです)。
- 候補は上位100件まで表示されます。100件を超えるときは、候補の末尾に「上位 100 件を表示しています。検索で絞り込んでください。」と表示されます。
- メンバーは姓または名・ユーザーコードで検索できます。姓と名を空白でつなげた検索(例:「山田 太郎」)は一致しません。メールアドレスでは検索できません。
- クラウドログ側で退職済み(勤務終了日が当日より前)のユーザーと、無効にした部署は候補に表示されません。
- 選択を外す場合は、選んだ名前の横の「×」を押してください。
- レコードを保存します。選んだ部署・メンバー・工程グループのIDが ID 格納先に、名称が名称の格納先(設定した場合)に保存されます。部署・メンバーは複数の場合カンマ区切りで保存されます。
4-2. プロジェクトをまとめて作成する
- アプリのレコード一覧画面を開きます。画面上部に「クラウドログにプロジェクト作成」ボタンが表示されます。
- 対象を限定したい場合は、先に一覧の絞り込み条件を設定します。絞り込み結果のレコードだけが作成対象になります。
- ボタンを押すと、「絞り込み結果の N 件のレコードを対象にクラウドログでプロジェクトを作成します」という確認画面が出ます。絞り込みをしていない場合は「⚠️ 一覧が絞り込まれていません。アプリ内の全 N 件のレコードを対象にクラウドログでプロジェクトを作成します」と表示されます。
- 内容を確認して「実行」を押します。
- 完了すると、結果が次のように表示されます。
- 成功:作成できた件数
- スキップ:同じコードのプロジェクトが既にあり、作成しなかった件数。プロジェクトURLの登録(3-4)を設定している場合は「スキップ(既存・URLのみ登録)」と表示され、既存プロジェクトのURLがレコードに登録されます。
- 失敗:作成できなかった件数と理由
- 警告:プロジェクト自体は作れたが、一部の処理ができなかったもの(例:選んだ部署・メンバーがクラウドログ側で削除されていて割り当てられなかった、URLをレコードに登録できなかった等)
割り当ての失敗はプロジェクト作成を取り消しません。例えば選んだメンバーのうち1人だけ割り当てられなかった場合でも、プロジェクト本体は作成され、その1人だけが「警告」として表示されます。部署・メンバー・工程グループを選んでいないレコードは、プロジェクトのみ作成されます。
- 割り当ては新しく作成されたプロジェクトに対してのみ行われます。作成済み(スキップ)のプロジェクトには割り当てません(クラウドログ画面で調整した内容を上書きしないためです)。
- 割り当てた部署・メンバーの権限は、クラウドログの初期設定(デフォルト権限)になります。変える場合はクラウドログ画面で調整してください。
5. 制限事項
- 対象は一覧の絞り込み結果の全レコードです。行を1件ずつ選んで作成することはできません。対象を限定する場合は、実行前に一覧の絞り込み条件を設定してください。絞り込みをしていない場合は、アプリ内の全レコードが対象になります。
- 1回に処理できる対象レコードは 10,000 件未満です。超えるとエラーになり処理は行われません。一覧の絞り込み条件で対象を分割し、複数回に分けて実行してください。
- 既存プロジェクトの更新・削除はできません。本プラグインは新規作成のみです。同じコードのものはスキップされます。部署・メンバー・工程グループの割り当ても、新しく作成したプロジェクトだけが対象です。
- 部署・メンバー・工程グループの選択欄の候補は上位100件までです。それ以上は検索で絞り込んでください。
- 工程は工程グループの割り当てのみ対応しています。工程リストの内容を kintone から作成・同期することはできません。
- プラグイン設定のマッピングにない設定項目(取引先、プロジェクト項目等)は未対応です。本プラグインでプロジェクト作成後に、クラウドログ画面上で設定をお願いします。
- プロジェクト項目には対応していないため、クラウドログ上で必須のプロジェクト項目が設定されている場合は本プラグインを利用いただけません。
6. うまくいかないときは
| 項目 | 対処 |
|---|---|
| 「クラウドログAPIトークンを入力してください」と表示される | 設定画面でトークンを入力してから保存してください。 |
| 「認証エラー: APIトークンを確認してください」と表示される | トークンが間違っている/無効です。設定画面で正しいトークンを入れ直してください。クラウドログでIPアドレス制限を使っている場合は、共通ガイドの「IPアドレス制限を利用している場合の設定」もご確認ください。 |
| 設定画面で「保存済みのフィールド(コード: …)が見つからないか、この項目では使用できない型です」と表示される | 以前に設定したフィールドが、アプリから削除されたか、フィールドコードが変更されています。ドロップダウンから正しいフィールドを選び直してください。選び直すまで設定は保存できませんが、保存しなければ以前の設定はそのまま残ります。 |
| 設定画面で「フィールドの読み込みに失敗しました」と表示され、選択できない | 画面を再読み込みしてください。繰り返す場合は、ご自身に kintone アプリを設定する権限があるかをご確認ください。この状態では設定を保存できません。 |
| 設定画面で「該当する型のフィールドがありません」と表示される | アプリに文字列1行・文字列(複数行)のフィールドがありません。フィールドを追加して「アプリを更新」してから、設定画面を開き直してください。 |
| 「必須項目「○○」が空です。レコードID … をスキップしました」と表示される | そのレコードの必須フィールド(案件名など)が空です。埋めてから再実行してください。 |
| 「マッピング設定の「○○」がアプリに存在しません」と表示される | 設定したフィールドがアプリから削除された/フィールドコードが変更された可能性があります。プラグイン設定画面でフィールドを選び直してください。 |
| レコード画面に部署・メンバー・工程グループの選択欄が表示されない | プラグイン設定で ID 格納先とスペースの要素IDが両方設定されているか、スペースの要素IDがフォームと一致しているか、部署・メンバー・工程グループで同じスペースを指定していないかをご確認ください。 |
| 選択欄に「部署一覧(ユーザー一覧・工程グループ一覧)を取得できませんでした」と表示される | APIトークンが正しいかをご確認ください。「管理権限があるかも確認してください」と続いている場合は、トークンを発行したユーザーにクラウドログの「管理者」権限があるかをご確認ください(2-2参照)。 |
| 選択欄に「設定された格納先フィールド「…」がアプリに存在しません」と表示される | プラグイン設定で選んだフィールドがアプリから削除されています。プラグイン設定画面でフィールドを選び直してください。 |
| 候補に目的の部署・メンバー・工程グループが出ない | 候補は上位100件だけ表示されます。名称やコードの一部を入力して絞り込んでください。それでも出ない場合、メンバーは退職済み(勤務終了日が当日より前)になっていないか、部署は無効になっていないかをクラウドログでご確認ください。 |
| 選択欄に「不明な部署(メンバー・工程グループ) (ID: …)」と表示される | 保存されているIDの部署・メンバー・工程グループが、クラウドログ側で削除・無効化・退職済みになったか、手入力で不正な値が入っています。表示された時点ではフィールドの値は変わりません。部署・メンバーは、別の候補を追加するか「×」で外すと、そのIDは保存値から外れます。工程グループは選び直すか「×」で外してください。 |
| 実行結果に「…の ID 格納先に正の整数でない値(…)が含まれるため、…の割当をスキップしました」「工程グループID「…」が正の整数ではないため、割当をスキップしました」と表示される | ID 格納先に手入力で不正な値が入っています。レコードの編集画面で選択欄から選び直してください(4-3参照)。 |
| 実行結果に「部署(ID: …)の割当に失敗しました」と表示される(メンバー・工程グループも同様) | レコードで選んだ後に、クラウドログ側で部署・ユーザー・工程グループが削除・無効化された可能性があります。レコードの編集画面で選び直すか、クラウドログ画面から割り当ててください。 |
| 作成済みのプロジェクトに部署・メンバー・工程グループが割り当てられない | 割り当ては新しく作成したプロジェクトだけが対象です。作成済みのプロジェクトにはクラウドログ画面で割り当ててください。 |
| 「対象レコードが多すぎるため、取得できませんでした」と表示される | 対象が 10,000 件以上あります。一覧の絞り込み条件を追加して、対象を 10,000 件よりも少なくしてから実行してください。 |
| 「クラウドログとの通信に失敗しました。時間をおいて再実行してください」と表示される | 一時的な通信エラーやサーバー側の問題の可能性があります。少し待ってからもう一度実行してください。解決しない場合はお問い合わせください。 |