フォームやフォーム フィールドでスマート値にアクセス
送信されたフォームやフォーム フィールドのスマート値にアクセスすることで、Jira Service Management でデータを取得して操作するだけでなく、自動化やレポート機能を強化することもできます。
アクセスできるスマート値は、送信されたフォームのトリガーに使用されたフォームのものに限られます。
スマート値でフォームを取得する
フローのセットアップ時に {{forms}} を使用してリスト内のフォームの値をフォーマットすることで、「フォームの送信時」自動化トリガーを使用する際に、作業項目について送信されたフォームにアクセスできます。リストの特定のフォームにアクセスするには、「自動化スマート値 - リスト」を使用して目的のフォームを取得します。
スマート値でフォーム フィールドを取得する
フォーム フィールドの特定のスマート値にアクセスするには、フィールド タイプと、フォーム内のフィールドの一意の識別子として機能するフィールド キーの両方を把握している必要があります。各フィールドのフィールド キーは、サイド パネルからフォームでフィールドを設定する際にカスタマイズできます。
なお、フィールド キーは大文字と小文字を正しく区別して入力する必要があります。スペースも同様に認識されます。
自動化フローの例
John は、「従業員オンボーディング」フォームが送信されるたびに、オンボーディング メモ付きのコメントを追加する自動化フローを作成したいと考えています。
このフローを作成する前に、「従業員オンボーディング」フォームの「メモ」フィールドにフィールド キーがあることを確認する必要があります。
彼はこれを「onboarding-notes」にします。
[自動化] に移動してこのフローを作成し、フォームとして「従業員オンボーディング」を選択した状態でトリガー [フォームの送信時] を使用します。
次に、「作業項目にコメントする」アクションを追加し、コメントとして {{forms.last.onboarding-notes}} を入力します。
これで、「従業員オンボーディング」が送信されるたびに、「メモ」フィールドの値が作業項目にコメントとして追加されるようになります。
テキスト フィールド
次のフィールド タイプでは、フローのセットアップ時に「自動化スマート値 - テキスト フィールド」を使用して、値をテキスト文字列としてフォーマットします。
短いテキスト
長いテキスト
段落
メール
URL
例
テキスト フィールド キーが "要約" で、テキスト フィールドの値が "Taro Yamada" の場合、{{forms.last.Summary}} は "Taro Yamada" を返します。
選択肢フィールド
次のフィールド タイプでは、フローのセットアップ時に「自動化スマート値 - リスト」を使用して、リスト内の項目の値をフォーマットします。選択した項目の ID を取得するには {{id}} を使用し、選択した項目のラベルを取得するには {{label}} を使用します。
ラジオ ボタン
チェックボックス
ドロップダウン
複数選択ドロップダウン
カスケード ドロップダウン
Assets
例
フィールド キーが "所在地" で、選択肢フィールドの選択値が "シドニー" の場合、{{forms.last.Location.label}} は "シドニー" を返します。
日付フィールド
次のフィールド タイプでは、フローのセットアップ時に「自動化スマート値 - 日時」を使用して、テキスト値としてフォーマットします。
日付
日時
時間
例
日付フィールド キーが "期限" で、選択フィールドの選択値が "10/01/24" の場合、{{forms.last.Due date.fullDate}} は "2024 年 10 月 1 日水曜日" を返します。
数値フィールド
次のフィールド タイプでは、フローのセットアップ時に、「自動化スマート値 - 数式」を使用して、数値としてフォーマットします。
数値
例
数値フィールド キーが "インボイス" で、フィールドの値が "100" の場合、{{forms.last.Invoice.asCurrency}} は "$100" を返します。
ユーザー フィールド
次のフィールド タイプでは、フローのセットアップ時に、「自動化スマート値 - ユーザー」を使用して、ユーザー データとしてフォーマットします。
単一ユーザー
複数のユーザー
例
ユーザー フィールド キーが "マネージャー" で、ユーザー フィールドの値が "Taro Yamada" の場合、{{forms.last.Manager.displayName}} は "Taro Yamada" を返します。
添付ファイル フィールド
次のフィールド タイプでは、フローのセットアップ時に「自動化スマート値 - リスト」を使用して、リスト内の項目の値をフォーマットします。添付ファイルの ID を取得するには {{id}} を使用し、添付ファイルの名前を取得するには {{name}} を使用します。
添付ファイル
例
添付ファイル フィールド キーが "履歴書アップロード" で、フィールドの値が "Taro Yamada CV" の場合、{{forms.last.Upload resume.name}} は "Taro Yamada CV" を返します。
[フォームの送信時] トリガーを使用せずにスマート値にアクセスする
また、{{issue.forms.<UUID>}} を使用して「自動化スマート値 - リスト」を参照することによって、作業項目の任意のフォームにアクセスできます。これらはユニバーサル ユニーク識別子 (UUID) でグループ化され、リストとして返されます。Forms REST API の「Get project form index」から UUID を取得することも、[フォーム] ランディング ページの要素を調べて [ネットワーク] タブから UUID にアクセスすることもできます。
自動化フローの例
John は、従業員の最新の給与を記載したコメントを作業項目に追加する自動化フローを作成したいと考えています。
このフローを作成する前に、「給与設定」フォームの「給与」フィールドにフィールド キーがあることを確認する必要があります。
彼はこれを「payroll-salary」にします。
次に、[自動化] に移動してこのフローを作成し、トリガーとして [作業項目から手動でトリガーする] を選択します。
次に、「作業項目にコメントする」アクションを追加し、コメントとして {{issue.forms.f7142b07-d3a4-4522-a7e4-8799d526e0a6.payroll-salary}} を入力します。
これで、作業項目に複数の「給与設定」フォームにある場合は、最新の「給与設定」フォームの「給与」フィールドの値が作業項目でコメントとして追加されるようになります。
この内容はお役に立ちましたか?