経路をCSVファイルからインポートする
kickflowではExcelやGoogleスプレッドシートで管理している経路を、CSVファイルの形式でインポートすることが可能です。
経路をインポートするには
-
「管理センター」＞「ワークフロー」＞「経路」を開きます。
-
「CSVインポート」をクリックします。
- 事前に用意したCSVファイルを選択し、「インポート」をクリックします。
経路のCSVファイルの仕様
経路のCSVファイルに含まれるカラムには、経路全体の属性に関するカラムと、経路内の各ステップに関するカラムがあります。
経路全体の属性に関するカラム
| カラム | 必須 | 説明 | 入力例 |
| code | 必須 | 経路コード | route123 |
| name | 必須 | 経路の名前 | 課長承認経路 |
| description | 経路の説明文 | これは課長承認用の経路です | |
| folder_code | この経路が所属するフォルダのフォルダコード | folder123 |
経路内の各ステップに関するカラム
以下のカラムは経路内のステップの数だけ繰り返してください。カラム名の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_fallback_type | 承認者タイプがmanagerのときのみ必須 | 承認者が見つからないとき、誰を代わりの承認者とするか | direct_manager, higher_manager, skipのいずれか |
| stepN_allow_self_approval | 必須 |
自己承認を許可するか |
TRUEまたはFALSE |
| stepN_required_approvals_number | 必須 |
必要な承認人数 承認割合 (%)を使うときは、0を入力してください |
0以上の整数 |
| stepN_required_approvals_percent | 必須 |
必要な承認割合 (%) 承認人数を使うときは、0を入力してください |
0以上100以下の整数 |
| stepN_grade_code | 承認者の役職コード | 文字列 | |
| stepN_grade_symbol | 役職の比較条件 | equal, greater_than, greater_than_or_equal, less_than, less_than_or_equalのいずれか | |
| stepN_team_code | 承認者タイプがteamのときのみ必須 | 承認者のチームコード | 文字列 |
|
stepN_users |
承認者タイプがuserのときのみ必須 | 承認者のメールアドレス（改行を区切り文字として複数指定可能） |
文字列 |
|
stepN_descendants |
下位のチームを対象に含むか（「申請者が指名」ステップでのみ有効） |
TRUEまたはFALSE |
|
|
stepN_skip_condition_team_code |
スキップ条件で使用するチームのコード |
文字列 |
|
|
stepN_skip_condition_team_symbol |
スキップ条件で使用するチームの比較条件 |
equal, not_equal, descendants_or_equal, not_descendants_or_equal のいずれか |
|
|
stepN_skip_condition_grade_code |
スキップ条件で使用する役職のコード |
文字列 |
|
|
stepN_skip_condition_grade_symbol |
スキップ条件で使用する役職の比較条件 |
equal, not_equal, greater_than, greater_than_or_equal, less_than, less_than_or_equal のいずれか |
注意1: 承認者タイプによっては使用しないカラムがある場合でも、CSVファイルのフォーマット上は省略しないようにしてください。
注意2: 承認者タイプがauthorのとき、stepN_allow_self_approval, stepN_required_approvals_number, stepN_required_approvals_percentのカラムは無視され既定値がセットされます。
その他の注意事項
- 経路のCSVインポートは1行ずつデータベースに対してコミットします。途中でエラーが発生した場合、その直前の行までがコミットされた状態で終了します。