工数を登録する

このピースでできること

  • freee工数管理で、指定した従業員・プロジェクト・日付に工数(分単位)を登録します。
  • 工数タグを付与することもできます。

freee工数管理 の接続方法

workrun と freee工数管理 を接続するには、freee工数管理 の OAuth クライアント(クライアントID・クライアントシークレット) が必要です。

ステップ 1:workrun のリダイレクト URL を確認する

  1. workrun で freee工数管理 のアクション/トリガーをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。

ステップ 2:freee工数管理 で OAuth クライアントを作成する

  1. freeeアプリストア を開き、アプリケーションを新規登録します。
  1. コールバックURL の欄に、ステップ 1 でコピーした リダイレクト URL を貼り付けます。
  1. 権限設定 で、以下の項目にチェックを入れます。
      • [工数管理] 従業員: 参照(従業員の選択肢取得に使用)
      • [工数管理] チーム: 参照(チームの選択肢取得に使用)
      • [工数管理] プロジェクト: 参照(プロジェクトの選択肢取得に使用)
      • [工数管理] 工数: 参照・更新
      • ※「カスタムAPI呼び出し」アクションを利用する場合は、そのエンドポイントに対応する権限も追加してください
  1. 設定を保存し、クライアントIDクライアントシークレット をコピーします。

ステップ 3:workrun に接続を追加する

  1. ステップ 1 の接続画面に戻り、クライアントIDクライアントシークレット をそれぞれ貼り付けます。
  1. 「接続」 をクリックすると、freee の認証画面が開きます。
  1. freee にログインし、workrun に対するアクセスを 「許可」 します。
  1. 画面が自動で閉じ、接続が完了します。

ピースの設定項目

1. 事業所(必須)

  • 工数を登録する対象の事業所を選択してください。接続したfreeeアカウントに紐づく事業所が一覧表示されます。

2. 対象プロジェクト(必須)

  • 工数を登録するプロジェクトを選択してください。事業所を選択するとプロジェクトの選択肢が表示されます(300件超の場合は一部表示されません)。

3. 対象日(必須)

  • 工数を登録する日付を「YYYY-MM-DD」形式で入力してください。

4. 記録時間(分)(必須)

  • 記録する工数を分単位で入力してください。最小値は1分です。

5. 対象従業員(任意)

  • 工数を登録する従業員を選択します。管理者またはチームリーダーでログインしている場合のみ指定可能です。未指定の場合はログインユーザーに登録されます(300件超の場合は一部表示されません)。

6. 業務内容(任意)

  • 登録する工数の業務内容を255文字以内で入力してください。

7. 工数タグ(任意)

  • プロジェクトの工数タグに設定されているタグを指定できます。タグのIDはfreee工数管理の 設定 → 工数タグ から工数タグの設定画面に遷移し、「エクスポート」で出力したファイル内で確認できます。
    • 工数タググループID: 工数タグが属するグループのID(必須)
    • 工数タグID: 工数タグのID(必須)