• 使用を開始する
  • 関連ドキュメント

フォームやフォーム フィールドでスマート値にアクセス

送信されたフォームやフォーム フィールドのスマート値にアクセスすることで、Jira Service Management でデータを取得して操作するだけでなく、自動化やレポート機能を強化することもできます。

アクセスできるスマート値は、送信されたフォームのトリガーに使用されたフォームのものに限られます。

スマート値でフォームを取得する

ルールの設定時に {{forms}} を使用してリスト内のフォームの値をフォーマットすることで、「フォームの送信時」自動化トリガーを使用する際に、課題について送信されたフォームにアクセスできます。リストから特定のフォームにアクセスするには、自動化リストのスマート値を使用して、対象のフォームを取得します。


ある課題について提出されたフォームのリストの最後のフォームが "オンボーディング チェックリスト" の場合、{{forms.last}} は "オンボーディング チェックリスト" を返します。

スマート値でフォーム フィールドを取得する

フォーム フィールドの特定のスマート値にアクセスするには、フィールド タイプと、フォーム内のフィールドの一意の識別子として機能するフィールド キーの両方を把握している必要があります。各フィールドのフィールド キーは、サイド パネルからフォームでフィールドを設定する際にカスタマイズできます。

なお、フィールド キーは大文字と小文字を正しく区別して入力する必要があります。スペースも同様に認識されます。

自動化ルールの例

ジョンは、「従業員オンボーディング」フォームが送信されるたびに、オンボーディング メモ付きのコメントを追加する自動化ルールを作成したいと考えています。

このルールを作成する前に、「従業員オンボーディング」フォームの「メモ」フィールドにフィールド キーがあることを確認する必要があります。

彼はこれを「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}} を使用してください。

  • 添付ファイル