経路をCSVファイルからインポートする

kickflowではExcelやGoogleスプレッドシートで管理している経路を、CSVファイルの形式でインポートすることが可能です。

経路をインポートするには

1. 「管理センター」＞「ワークフロー」＞「経路」 を開きます。

2. 「CSVインポート」 をクリックします。

   

3. 事前に用意したCSVファイルを選択し、 「インポート」 をクリックします。

   

経路のCSVファイルの仕様

経路のCSVファイルに含まれるカラムには、 経路全体の属性に関するカラム と、 経路内の各ステップに関するカラム があります。

経路全体の属性に関するカラム

入力必須ではないカラムでも列ごと省略することはできませんのでご注意ください。

経路内の各ステップに関するカラム

以下のカラムは経路内のステップの数だけ繰り返してください。カラム名のstepNは、実際にはstep1, step2, ...となります。

• stepN_step_order（必須）
  ステップの順序。1が最初のステップを表します。複数のステップを並列実行したい場合、同じ値を入力してください。
  入力可能な値：整数（1~20）

• stepN_step_type（必須）
  承認者タイプ
  入力可能な値：manager, team, user, author, author_customizable, assignee_customizable, dynamic_team, dynamic_user のいずれか

• 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 または team または dynamic_team のときのみ必須）
  承認者が見つからないときの対応方法
  入力可能な値

  • 承認者タイプが manager のとき：direct_manager, higher_manager, skip のいずれか（空の場合は、自動的に direct_manager が入力されます）
  • 承認者タイプが team または dynamic_team のとき：no_fallback, higher_team, skip のいずれか（空の場合は、自動的に no_fallback が入力されます）

• stepN_manager_selection_type（承認者タイプが manager のときのみ必須）
  条件に合う上長が複数いる場合の動作を指定できます
  入力可能な値：closest（条件に合致する、申請者に最も近い上長のみを承認者とする）, all（条件に合致する、すべての上長を承認者とする）のいずれか

• stepN_allow_self_approval（必須）
  自己承認を許可するか
  入力可能な値：TRUE または FALSE

• stepN_allow_raising（必須）
  このステップの承認者に引き上げを許可するか
  入力可能な値：TRUE または FALSE

• stepN_users（承認者タイプが user のときのみ必須）
  承認者のメールアドレス（改行を区切り文字として複数指定可能）
  入力可能な値：文字列

• stepN_min_custom_assignees（承認者タイプが author_customizable または assignee_customizable のときのみ必須）
  最小指名人数
  入力可能な値：0以上の整数

• stepN_approver_assignment_instruction
  承認者の選び方（承認者タイプが「申請者が指名」「前ステップの承認者が指名」のみで有効）
  入力可能な値：文字列

• stepN_code 経路ステップのコードを設定する。空の場合はランダムなコードを設定される
  入力可能な値：半角英数字、ハイフン、アンダーバーのみ入力可能

• stepN_sub_status_code サブステータス
  入力可能な値：設定したサブステータスのコード

• stepN_targetM_team_code（承認者タイプが team のときのみ必須）
  承認者のチームコード
  入力可能な値：文字列

• stepN_targetM_descendants 下位のチームを対象に含むか（「申請者が指名」「前ステップの承認者が指名」ステップでのみ有効）
  入力可能な値：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_variable チームを表す変数名
  入力可能な値：フィールドの変数を設定可能 ※設定可能な変数のデータ型は以下 テキスト（短文）、テキスト（長文）、自動計算

• 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_id（stepN_conditionM_field_key が general_master_variable かつ stepN_conditionM_symbol が equal もしくは not_equal のときに必須）
  経路ステップの条件で使用する汎用マスタアイテムの ID
  入力可能な値：文字列

• stepN_conditionM_general_master_item_code（stepN_conditionM_field_key が general_master_variable かつ stepN_conditionM_symbol が equal もしくは not_equal のときに必須）
  経路ステップの条件で使用する汎用マスタアイテムのコード
  入力可能な値：文字列

• 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でインポート可能な行数は最大1,000行までです。
  • もし1,000行を越えるCSV取り込みを行いたい場合、複数ファイルに分割してインポートしてください。
  • 経路のCSVインポートは差分更新のため、CSVに含まれない経路がインポート後に削除されることはございません。
• 経路のCSVインポートは1件ずつデータベースに対してコミットします。途中でエラーが発生した場合、その直前までがコミットされた状態で終了します。