フォームやフォーム フィールドでスマート値にアクセス
送信されたフォームやフォーム フィールドのスマート値にアクセスすることで、Jira Service Management でデータを取得して操作するだけでなく、自動化やレポート機能を強化することもできます。
アクセスできるスマート値は、送信されたフォームのトリガーに使用されたフォームのものに限られます。
スマート値でフォームを取得する
You can access submitted forms on issues when using the Forms submitted automation trigger by using {{forms}}
to format the value of forms in a list when setting up a rule. To access a specific form from a list, use the automation lists smart values to retrive the form you’re after.
Example
If the last form in a list of submitted forms on an issue is ‘Onboarding checklist'; {{forms.last}}
will return ‘Onboarding checklist’
スマート値でフォーム フィールドを取得する
フォーム フィールドの特定のスマート値にアクセスするには、フィールド タイプと、フォーム内のフィールドの一意の識別子として機能するフィールド キーの両方を把握している必要があります。各フィールドのフィールド キーは、サイド パネルからフォームでフィールドを設定する際にカスタマイズできます。
なお、フィールド キーは大文字と小文字を正しく区別して入力する必要があります。スペースも同様に認識されます。
自動化ルールの例
ジョンは、「従業員オンボーディング」フォームが送信されるたびに、オンボーディング メモ付きのコメントを追加する自動化ルールを作成したいと考えています。
このルールを作成する前に、「従業員オンボーディング」フォームの「メモ」フィールドにフィールド キーがあることを確認する必要があります。
彼はこれを「onboarding-notes」にします。
[自動化] に移動してこのルールを作成し、フォームとして「従業員オンボーディング」を選択した状態でトリガー [フォームの送信時] を使用します。
He then adds the action Comment on issue and enters {{forms.last.onboarding-notes}}
as the comment.
これで、「従業員オンボーディング」が送信されるたびに、「メモ」フィールドの値が課題でコメントとして追加されるようになります。
テキスト フィールド
次のフィールド タイプでは、ルールの設定時に「自動化スマート値 - テキスト フィールド」を使用し、値をテキスト文字列としてフォーマットします。
短いテキスト
長いテキスト
段落
メール
URL
Example
If the value in a text field with the field key Summary is ‘Jane Doe’; {{forms.last.Summary}}
will return ‘Jane Doe’
選択肢フィールド
The following field types use the automation lists smart values and format the value of items in a list when setting up a rule. To retrieve the id of a selected choice use {{id}}
and to retrieve the label of a selected choice use {{label}}
.
ラジオ ボタン
チェックボックス
ドロップダウン
複数選択ドロップダウン
カスケード ドロップダウン
Assets
Example
If the selected value in a choice field with the field key Location is ‘Sydney’; {{forms.last.Location.label}}
will return ‘Sydney’
日付フィールド
次のフィールド タイプでは、ルールの設定時に、「自動化スマート値 - 日時」を使用し、テキスト値としてフォーマットします。
日付
日時
時間
Example
If the selected value in a date field with the field key Due date is ‘10/01/24’; {{forms.last.Due date.fullDate}}
will return ‘Wednesday, October 1, 2024’
数値フィールド
次のフィールド タイプでは、ルールの設定時に、「自動化スマート値 - 数式」を使用し、数値としてフォーマットします。
数値
Example
If the value in a number field with the field key Invoice is ‘100’; {{forms.last.Invoice.asCurrency}}
will return ‘$100’
ユーザー フィールド
次のフィールド タイプでは、ルールの設定時に、「自動化スマート値 - ユーザー」を使用し、ユーザー データとしてフォーマットします。
単一ユーザー
複数のユーザー
Example
If the value in a user field with the field key Manager is ‘John Doe’; {{forms.last.Manager.displayName}}
will return ‘John Doe’
添付ファイル フィールド
The following field types use the automation lists smart values and format the value of items in a list when setting up a rule. To retrieve the id of an attachment use {{id}}
and to retrieve name of an attachment use {{name}}
.
添付ファイル
Example
If the value in an attachment field with the field key Upload resume is named ‘Jane Doe CV’; {{forms.last.Upload resume.name}}
will return ‘Jane Doe CV’
[フォームの送信時] トリガーを使用せずにスマート値にアクセスする
また、{{issue.forms.<UUID>}}
を使用して自動化リストのスマート値を参照することによって、課題のどのフォームにもアクセスできます。これらはユニバーサル ユニーク識別子 (UUID) でグループ化され、リストとして返されます。UUID は、Forms REST API の「Get project form index」から取得することも、[フォーム] ランディング ページの要素を調べて [ネットワーク] タブから UUID にアクセスすることもできます。
自動化ルールの例
ジョンは、従業員の最新の給与を記載したコメントを課題に追加する自動化ルールを作成したいと考えています。
このルールを作成する前に、「給与設定」フォームの「給与」フィールドにフィールド キーがあることを確認する必要があります。
彼はこれを「payroll-salary」にします。
次に、[自動化] に移動してこのルールを作成し、トリガーとして [課題から手動でトリガーする] を選択します。
He then adds the action Comment on issue and enters {{issue.forms.f7142b07-d3a4-4522-a7e4-8799d526e0a6.payroll-salary}}
as the comment.
これで、課題に複数の「給与設定」フォームにある場合は、最新の「給与設定」フォームの「給与」フィールドの値が課題でコメントとして追加されるようになります。
この内容はお役に立ちましたか?