チケット作成時にkintoneのデータを取得してフィールドに自動入力する(エンタープライズプランのみ)
この機能はエンタープライズプラン限定です。
kintoneと連携することで、チケットの作成・編集時にkintoneのデータを取得してフィールドに自動入力できます。
データの取得は、チケット作成・編集画面のフォーム内に配置された 「kintoneから取得」 ボタンをユーザーが押したときに実行されます。
事前準備
本機能を使用するにあたり、事前にテナントにkintoneアプリの情報を登録する必要があります(操作には、外部連携の管理権限が必要です)。
テナントにkintoneアプリの情報を登録するには、「kintoneと連携する」のヘルプページをご参照ください。
チケット作成時にkintoneのデータを取得してフィールドに自動入力するには
- 「管理センター」 > 「ワークフロー」 > 「ワークフロー」 を開き、 「新規作成」 をクリック、または、既存のワークフローを開き 「新しいバージョンを作成」 をクリックし、ワークフローの 「フォームの設定」 画面に進みます。
- kintoneから取得したデータの入力先となるフィールドを作成しておきます。kintoneから取得したデータは、以下の型のフィールドに自動入力できます。
- テキスト(短文)
- テキスト(長文)
- 整数
- 数値
-
「フィールドを追加」 をクリックし、以下のとおりkintoneから取得するデータと入力先フィールドを設定します。
-
基本設定
-
型: 「kintone連携(ボタン)」 を選択します。
-
型: 「kintone連携(ボタン)」 を選択します。
-
kintone連携(ボタン)設定
- 参照するアプリ:テナントに登録したkintoneアプリが候補に表示されるので、参照するデータの含まれるkintoneアプリを選択します。
-
フィールドへの自動入力:kintoneから取得したデータを、どのフィールドに自動入力するか設定します。自動入力したいデータが複数ある場合は、 「行を追加」 をクリックして追加できます(複数行ある場合は、行をドラッグ&ドロップして並べ替えできます)。
- kintoneの項目:kintoneアプリに含まれる項目名の一覧が表示されるので、データを取得したいものを選択します。
- レコードの選択時に表示:チェック状態だと、ユーザーがチケット作成・編集画面で取得するレコードを選択する画面にその項目が表示されます。1つ以上の項目がチェック状態である必要があります。
-
入力先のフィールド:kintoneから取得したデータの入力先となるフィールドを選択します。
-
基本設定
- そのままワークフローの作成を進め、ワークフローを保存します。
本機能は、明細セクションでは利用できません。汎用セクションに含まれるフィールドで設定してください。
- フィールドの型「kintone連携(ボタン)」が選択できるのは、汎用セクションに含まれるフィールドのみです。
- kintoneから取得したデータの入力先フィールドとして選択できるのは、汎用セクションに含まれるフィールドのみです。
kintoneのデータ種別による利用可否
| kintoneの データ種別 |
該当するkintone側のフィールド | 利用 可否 |
入力される値 |
|---|---|---|---|
| 単一の文字列・数値 | 他の種類に該当しないすべてのフィールド | 可 | そのままの値が入力されます。 |
| 複数の文字列・数値 | ・チェックボックス ・複数選択 ・カテゴリー ・ユーザー選択 ・組織選択 ・グループ選択 ・作業者 |
可 | 複数の場合、半角スペースで区切られて入力されます。 |
| その他 | ・添付ファイル ・テーブル ・関連レコード一覧 ・値の無い装飾フィールド(ラベル、スペース、罫線、グループ) |
不可 | ― |
※ 「カテゴリー」を取得するには、kintone側のカテゴリー機能を有効にする必要があります。
※ 「ステータス」「作業者」を取得するには、kintone側のプロセス管理機能を有効にする必要があります。
開発者向け
{name: 文字列, code: 文字列}オブジェクトの場合、 value.name を返します。
補足事項
「kintoneの項目」の選択肢にデータを取得したい項目が表示されない場合は、以下をご確認ください。
- 「kintone連携(ボタン)設定」 > 「参照するアプリ」 で指定したkintoneアプリに、該当する項目が存在するかご確認ください。
- ワークフローの作成画面を表示した後にkintoneアプリに追加した項目は選択肢に表示されません。ワークフローを下書き保存し、再度設定してください。
- ワークフローを作成後にkintoneアプリに含まれる既存の項目のコードを書き換えた場合、ワークフローを新しいバージョンで作成し、保存しなおす必要があります。