経路をCSVファイルからインポートする
kickflowではExcelやGoogleスプレッドシートで管理している経路を、CSVファイルの形式でインポートすることが可能です。
経路をインポートするには
-
「管理センター」＞「ワークフロー」＞「経路」 を開きます。
-
「CSVインポート」 をクリックします。
-
事前に用意したCSVファイルを選択し、 「インポート」 をクリックします。
経路のCSVファイルの仕様
経路のCSVファイルに含まれるカラムには、 経路全体の属性に関するカラム と、 経路内の各ステップに関するカラム があります。
経路全体の属性に関するカラム
入力必須ではないカラムでも列ごと省略することはできませんのでご注意ください。
| カラム | 入力必須 | 説明 | 入力例 |
|---|---|---|---|
| code | 既存経路の更新時のみ必須 | 経路コード 入力しない場合、ランダムな英数字が採番されます。 |
route123 |
| name | 必須 | 経路の名前 | 課長承認経路 |
| description | 経路の説明文 | これは課長承認用の経路です | |
| folder_code | この経路が所属するフォルダのフォルダコード | folder123 | |
| notes | 経路バージョンの管理用メモ | 役職を修正しました |
経路内の各ステップに関するカラム
以下のカラムは経路内のステップの数だけ繰り返してください。カラム名のstepNは、実際にはstep1, step2, ...となります。
| カラム | 必須 | 説明 | 入力可能な値 |
|---|---|---|---|
| stepN_step_order | 必須 | ステップの順序。1が最初のステップを表します。複数のステップを並列実行したい場合、同じ値を入力してください。 | 整数（1~20） |
| stepN_step_type | 必須 | 承認者タイプ | author, manager, team, user, author_customizable, assignee_customizable のいずれか |
| stepN_title | 必須 | ステップ名 | 文字列 |
| stepN_action_type | 必須 | アクションタイプ | approve, confirm, noneのいずれか |
| stepN_instruction | 承認者への指示 | 文字列 | |
| stepN_required_approvals_number | 必須 | 必要な承認人数 承認割合 (%)を使うときは、0を入力してください |
0以上の整数 |
| stepN_required_approvals_percent | 必須 | 必要な承認割合 (%) 承認人数を使うときは、0を入力してください |
0以上100以下の整数 |
| stepN_fallback_type | 承認者タイプがmanagerのときのみ必須 | 承認者が見つからないとき、誰を代わりの承認者とするか | direct_manager, higher_manager, skipのいずれか |
| stepN_manager_selection_type | 承認者タイプがmanagerのときのみ必須 | 条件に合う上長が複数いる場合の動作を指定できます | closest（条件に合致する、申請者に最も近い上長のみを承認者とする）, all（条件に合致する、すべての上長を承認者とする）のいずれか |
| stepN_allow_self_approval | 必須 | 自己承認を許可するか | TRUEまたはFALSE |
| stepN_allow_raising | 必須 | このステップの承認者に引き上げを許可するか | TRUEまたはFALSE |
| stepN_targetM_grade_code | 承認者の役職コード | 文字列 | |
| stepN_targetM_grade_symbol | 役職の比較条件 | equal, greater_than, greater_than_or_equal, less_than, less_than_or_equal,any_ofのいずれか | |
| stepN_targetM_team_code | 承認者タイプがteamのときのみ必須 | 承認者のチームコード | 文字列 |
| stepN_users | 承認者タイプがuserのときのみ必須 | 承認者のメールアドレス（改行を区切り文字として複数指定可能） | 文字列 |
| stepN_targetM_descendants | 下位のチームを対象に含むか（「申請者が指名」「前ステップの承認者が指名」ステップでのみ有効） | TRUEまたはFALSE | |
| stepN_min_custom_assignees | 承認者タイプがauthor_customizableまたはassignee_customizableのときのみ必須 | 最小指名人数 | 0以上の整数 |
| stepN_sub_status_code | サブステータス | 設定したサブステータスのコード | |
| stepN_condition_type | 経路ステップの条件タイプ | always,conditional,conditional_skip のいずれか | |
| stepN_combination_type | 条件の組み合わせタイプ | all, any のいずれか | |
| stepN_conditionM_field_key | stepN_condition_typeがalways以外のとき必須 | 条件のフィールド | author_grade, author_team, text_variable, number_variable, checkbox_variable, general_master_variable, other_variable のいずれか |
| stepN_conditionM_variable | 変数名 | 「$」で始まる文字列 | |
| stepN_conditionM_symbol | 比較条件 | equal, not_equal, greater_than, greater_than_or_equal, less_than, less_than_or_equal, include, exclude, is_empty, is_not_empty, descendants_or_equal, not_descendants_or_equal のいずれか | |
| stepN_conditionM_value | 比較値 | 文字列 | |
| stepN_conditionM_general_master_id | 経路ステップの条件で使用する汎用マスタのID | 文字列 | |
| stepN_conditionM_general_master_code | stepN_conditionM_field_key が general_master_variableのとき必須 | 経路ステップの条件で使用する汎用マスタのコード | 文字列 |
| stepN_conditionM_general_master_item_code | stepN_conditionM_field_key が general_master_variableのとき必須 | 経路ステップの条件で使用する汎用マスタアイテムのコード | 文字列 |
| stepN_conditionM_team_id | stepN_conditionM_field_key が author_teamのとき必須 | 経路ステップの条件で使用するチームのID | 文字列 |
| stepN_conditionM_team_code | stepN_conditionM_field_key が author_teamのとき必須 | 経路ステップの条件で使用するチームのコード | 文字列 |
| stepN_conditionM_grade_id | stepN_conditionM_field_key が author_gradeのとき必須 | 経路ステップの条件で使用する役職のID | 文字列 |
| stepN_conditionM_grade_code | stepN_conditionM_field_key が author_gradeのとき必須 | 経路ステップの条件で使用する役職のコード | 文字列 |
承認者タイプによっては使用しないカラムがある場合でも、CSVファイルのフォーマット上は省略しないようにしてください。
承認者タイプがauthorのとき、stepN_allow_self_approval, stepN_required_approvals_number, stepN_required_approvals_percentのカラムは無視され既定値がセットされます。
2024年4月2日以前にエクスポートされた経路のCSVに出力されている、stepN_team_code、stepN_descendants、stepN_grade_code、stepN_grade_symbolのカラムもインポート可能です。
その他の注意事項
- CSVでインポート可能な行数は最大1,000行までです。
- もし1,000行を越えるCSV取り込みを行いたい場合、複数ファイルに分割してインポートしてください。
- 経路のCSVインポートは差分更新のため、CSVに含まれない経路がインポート後に削除されることはございません。
- 経路のCSVインポートは1件ずつデータベースに対してコミットします。途中でエラーが発生した場合、その直前までがコミットされた状態で終了します。