kintoneプラグイン工数実績取り込み – クラウドログヘルプセンター

はじめて使う方は、先に共通ガイドをご覧ください。

1. 本プラグインでできること

kintone一覧画面に表示されるボタンをクリックすることで、クラウドログに記録された日次の工数実績をkintoneアプリに取り込みます。

取り込みはクラウドログ →kintoneの一方向です。kintone を編集してもクラウドログには影響しません。

本プラグインは、取り込み先のフィールドを自動では作りません。先にアプリ側で次のフィールドを作っておく必要があります。

作るフィールド	フィールドの種類	必須	何が入るか
軸1の名称	文字列（1行）	◯	例：プロジェクト名「OO社案件」
軸1のコード	文字列（1行）	◯	例：プロジェクトのコード「PRJ-001」
軸2の名称	文字列（1行）	△	軸2を使う場合は必須
軸2のコード	文字列（1行）	△	軸2を使う場合は必須
作業日	日付	◯	その工数が記録された日
作業時間	数値	◯	その日の作業時間（分単位）

選択可能な集計軸：

※ 「プロジェクトカテゴリ」「プロジェクト部署」「メンバー部署」の階層（親子関係）の選択には対応していません。

プラグイン設定画面を開き、以下の通り設定してください。

項目	入力内容
APIトークン	クラウドログのAPIトークン

保存後はトークンの値が画面に表示されません（安全のため伏せ字になります）。トークンを変えるときだけ入力し直してください。空欄のまま保存すると、前のトークンがそのまま保持されます。

⚠️ 集計軸を変更するときのご注意：設定後に集計軸（軸1・軸2）を変えてから取り込むと、同じ期間にある「前の軸で取り込んだレコード」も削除されます。軸を切り替える運用をする場合はご注意ください。

実行すると、指定した期間内の既存レコードを全て削除した後、取り込んだ最新データを登録し直します。このため、同じ期間で何度実行してもレコードが二重に増えることはありません。ただし、取り込み結果が0件だった場合は既存レコードを削除しません。

項目	対処
ブラウザの動作が重い	数万件を超えるとブラウザが固まる場合があります。期間を分割してください。
最新の工数が反映されない	工数レポートは１日１回早朝に事前集計しています。当日に入れた工数が反映されていない場合は、クラウドログの工数レポート画面で「更新」を行ってください。
「認証エラー: APIトークンを確認してください」と表示される	APIトークンが間違っているか、期限切れ・無効です。設定画面で正しいトークンを入れ直してください。
「マッピング設定の『○○』がアプリに存在しません」と表示される	設定したフィールドコードが、アプリにありません。フィールドコードを確認してください。
「処理に失敗しました。時間をおいて再実行してください」と表示される	一時的な通信エラーの可能性があります。少し待ってからもう一度実行してください。