自動化スマート値 - 開発

以下のスマート バリューを利用して、接続されたソース コード管理ツールから開発情報にアクセスして、それらを書式設定できます。

Check out some common DevOps automation rules where you can use these smart values in our Jira automation template library.

{branch}

ブランチとは独立した開発ラインです。

These smart values are only available for the Branch created development trigger.

• {{branch.name}} はブランチの名前を返します。例:TEST-123-some-feature

• {{branch.url}} はブランチの URL を返します。例:https://bitbucket.org/account/repo/TEST-123-some-feature

• {{branch.repository}} returns information related to the repository the branch belongs to. Note that repository contains additional nested smart values.

  • {{branch.repository.name}} は、リポジトリの名前を返します。

  • {{branch.repository.url}} は、URL を返します。例:https://bitbucket.org/account/repo/TEST-123-some-feature。エンコードされている URL が返されることにご注意ください。bitbucket.org/ 以降のすべては、ここに記載されている例とは異なります。

{createdBranch}

• 併用: ブランチを Bitbucket で作成、ブランチを GitHub で作成、ブランチを GitLab で作成の各アクション

最後に作成されたブランチに関連する情報にアクセスします。たとえば、ルールに「ブランチを GitHub で作成」と「ブランチを GitLab で作成」の両アクションがある場合は、最新のブランチの詳細が返されます。

• {{createdBranch.name}} - ブランチの名前を返します。

• {{createdBranch.url}} - ブランチの URL を返します。

• {{createdBranch.product}} - ブランチが作成された製品 (Bitbucket など) を返します。

• {{createdBranch.repository}} - ブランチのリポジトリの詳細にアクセスします。

  • {{createdBranch.repository.id}} - リポジトリの ID を返します。

  • {{createdBranch.repository.name}} - リポジトリの名前を返します。

  • {{createdBranch.repository.url}} - リポジトリの URL を返します。

{createdBranches}

• 併用: ブランチを Bitbucket で作成、ブランチを GitHub で作成、ブランチを GitLab で作成の各アクション

Access information related to all branches created in the rule, as a list. Learn more about list smart values.

たとえば、ルールに「GitHub でブランチを作成」と「GitLab でブランチを作成」の両アクションがある場合は、{{createdBranches}} は両ブランチの値をリストとして返します。

• {{createdBranches.name}} - ブランチの名前を返します。

• {{createdBranches.url}} - ブランチの URL を返します。

• {{createdBranches.product}} - ブランチが作成された製品を返します。

• {{createdBranches.repository}} - ブランチのリポジトリの詳細にアクセスします。

  • {{createdBranches.repository.id}} - 各リポジトリの ID を返します

  • {{createdBranches.repository.name}} - 各リポジトリの名前を返します。

  • {{createdBranches.repository.url}} - 各リポジトリの URL を返します。

{commit}

コミットとは、ファイル (またはファイル一式) への個別の変更のことです。

These smart values are only available for the Commit created development trigger.

• {{commit.hash}} は、コミットの SHA1 ハッシュを返します。例: 4877576951f3eda43625d3345058e702dad3df0d

• {{commit.shortHash}} は、コミットの切り捨てられた SHA1 ハッシュを返します。例:4877576。

• {{commit.message}} は、コミット メッセージを返します。例:awesome commit handles everything

• {{commit.url}} は、コミットの絶対 URL を返します。例:https://bitbucket.org/commit/121212

• {{commit.isMergeCommit}} は、コミットがマージ コミットの場合に True を返します。

• {{commit.timestamp}} returns the timestamp (UTC) the commit was created. This value supports Date and Time functions, e.g. 2020-07-20T07:00:00.0+0000

• {{commit.repository}} returns the information related to the repository. Note that repository contains additional nested smart values.

  • {{commit.repository.name}} は、リポジトリの名前を返します。例:my-awesome-repository。

  • {{commit.repository.url}} は、リポジトリの URL を返します。

{flag}

• 使用目的: LaunchDarkly アクションに機能フラグを作成。

作成された機能フラグの関連情報を返します。ルール全体で複数のフラグが作成された場合、{flag} は直近に作成されたフラグを返します。

• {{flag.key}} は、機能フラグのキーを返します。

• {{flag.name}} は、機能フラグの名前を返します。

{flags}

• 使用目的: LaunchDarkly アクションに機能フラグを作成。

Returns information related to all feature flags created in throughout the rule or branch, as a list. For example, if a rule uses the Create feature flag in LaunchDarkly action multiple times, {{flags} will return the information for all feature flags created, as a list. Learn more about list smart values

• {{flags.key}} は、機能フラグのキーを返します。

• {{flags.name}} は、機能フラグの名前を返します。

{Pull request}

プル リクエストとは、公式のプロジェクトに組み込む前に提案された変更のことです。

These smart values are only available for the Pull request created, Pull request declined and Pull request merged triggers. Learn more about automation triggers.

• {{pullRequest.title}} は、プル リクエストのタイトルを返します。例:ISSUE-12: Fix bugs

• {{pullRequest.url}} は、プル リクエストの絶対 URL を返します。例: https://bitbucket.org/pull-request/182

• {{pullRequest.state}} は、プル リクエストのステータス (オープン、マージ、または却下) を返します。

• {{pullRequest.createdDate}} returns the time (UTC) when the pull request was created, e.g. 2020-07-20T07:00:00.0+0000. This value supports Date and Time functions. Available only for the pull request created trigger.

• {{pullRequest.updatedDate}} returns the time (UTC) when the pull request was last updated (created, declined or merged), e.g. 2020-07-20T07:00:00.0+0000. This value supports Date and Time functions

• {{pullRequest.sourceBranch}} は、プル リクエストのソース ブランチに関連する情報を返します。

  • {{pullRequest.sourceBranch}} は、ソース ブランチの名前を返します。例:TEST-123-some-feature

  • {{pullRequest.sourceBranch.url}} は、ソース ブランチの URL を返します。例: https://bitbucket.org/account/repo/TEST-123-some-feature

• {{pullRequest.destinationBranch}} は、プル リクエストの宛先ブランチに関連する情報を返します。

  • {{pullRequest.destinationBranch}} は、宛先ブランチの名前を返します。例:master

  • {{pullRequest.destinationBranch.url}} は、宛先ブランチの URL を返します。例:https://bitbucket.org/account/repo/TEST-123-some-feature

  • {{pullRequest.destinationBranch.repository}} returns information related to the destination branch’s repository. Note that repository contains additional nested smart values.

{build}

ビルドとは、ファイルが最終的な利用形態に変換されるプロセスのことです。

These smart values are only available for the Build successful, Build failed and Build status changed development triggers. Learn more about automation triggers.

• {{build.name}} は、ビルドの名前を返します。例:build#123

• {{build.url}} は、ビルドの絶対 URL を返します。例:https://bitbucket.org/{7faf7dee-a29b-4faa-bbc2-d7128a6d3278}/{315a3ecb-1f18-4953-98ae-5890f93073b5}/addon/pipelines/home#!/results/7

• {{build.state}} は、ビルドのステータスを返します。考えられるステータスは pending、in_progress、successful、failed、cancelled、または unknown です。

• {{build.refs}} は、ビルドの参照を返します。例:[feature/ISSUE-123-some-work, feature/ISSUE-456-more-work]。これは、ビルドに関連付けられるメタデータのリストです。たとえば、ブランチとタグの名前を含んでいる場合があります。
  この値はオプションで、空のリストになる場合もあります。

{deployment}

デプロイとは、環境にプロダクトがリリースされるプロセスのことです。

These smart values are only available for the Deployment successful, Deployment failed and Deployment status changed development triggers. Learn more about automation triggers.

• {{deployment.name}} は、人にわかりやすいデプロイ名を返します。例: 7

• {{deployment.url}} は、デプロイの絶対 URL を返します。例:https://bitbucket.org/{6d6d87be-bdc2-42b5-ad8f-85cb915abc38}/{80c30dd6-2d2f-401c-ac33-8317adbc509d}/addon/pipelines/deployments#!/deployments/{888ba48c-0011-5a46-9d59-8da313851383}

• {{deployment.state}} は、デプロイのステータスを返します。考えられるステータスは pending、in_progress、successful、failed、cancelled、rolled_back、または unknown です。

• {{deployment.environment}} returns information related to the deployment environment. Note that environment contains additional nested smart values.

  • {{deployment.environment}} は、my-custom-prod-env を返します。

  • {{deployment.environment.type}} は、production を返します。

{repository}

リポジトリとは、ファイルと関連するメタデータのコレクションのことです。これらのスマート バリューは他のルート キー (例:{{branch.repository}}) を通じてのみアクセスできます。

• {{repository.name}} は、リポジトリの名前を返します。例:TEST-123-some-feature

• {{repository.url}} は、リポジトリの絶対 URL を返します。例:https://bitbucket.org/account/repo。エンコードされている URL が返されることにご注意ください。bitbucket.org/ 以降のすべては、ここに記載されている例とは異なります。

{environment}

環境とは、プロダクトがデプロイされる独立したエコシステムのことです。他のルート キーを介してのみ、これらのスマート値にアクセスできます (例: {{deployment.environment}})。

• {{environment.name}} は、ユーザーが指定した環境の名前を返します。例:my-custom-prod-env

• {{environment.type}} は環境タイプを返します。考えられるステータスは production、staging、testing、development、または unknown です。

{sprint}

• Used with: the Sprint created, Sprint started and Sprint completed triggers

ルールをトリガーしたスプリントに関連する情報にアクセスします。

• {{sprint.id}} - スプリント ID を返します。

• {{sprint.name}} - スプリント名を返します。

• {{sprint.isStarted}} - スプリントが開始した場合は true を返し、そうでない場合は false を返します。

• {{sprint.isClosed}} - スプリントが終了した場合は true を返し、そうでない場合は false を返します。

• {{sprint.startDate}} - スプリントの開始日を返します。

• {{sprint.endDate}} - スプリントの終了日を返します。

• {{sprint.completeDate}} - スプリントが完了済みとマークされた日付を返します。

• {{sprint.originBoardId}} - スプリントが属するボードの ID を返します。

• {{sprint.goal}} - スプリントのゴールを返します。

{createdSprint}

• Used with: The Create sprint action

ルールで作成された最新のスプリントに関連する情報にアクセスします。

• {{createdsprint.id}} - Returns the sprint ID.

• {{createdsprint.name}} - Returns the sprint name.

• {{createdsprint.isStarted}} - Returns true if the sprint has started, and false if not.

• {{createdsprint.isClosed}} - Returns true if the sprint has closed, and false if not.

• {{createdsprint.startDate}} - Returns the start date of the sprint.

• {{createdsprint.endDate}} - Returns the end date of the sprint.

• {{createdsprint.completeDate}} - Returns date the sprint was marked as complete.

• {{createdsprint.originBoardId}} - Returns the ID of the board the sprint belongs to.

• {{createdsprint.goal}} - Returns the sprint goal.

{createdSprints}

• Used with: The Create sprint action

Access information related to all sprints created in an automation rule, as a list. Learn more about list smart values

これは、「スプリントの作成」アクションを複数回使用する場合にのみ役立ちます。

• {{createdsprints.id}} - Returns the sprint IDs.

• {{createdsprints.name}} - Returns the sprint names.

• {{createdsprints.isStarted}} - Returns true if the sprint has started, and false if not.

• {{createdsprints.isClosed}} - Returns true if the sprint has closed, and false if not.

• {{createdsprints.startDate}} - Returns the start date of each sprint.

• {{createdsprints.endDate}} - Returns the end date of each sprint.

• {{createdsprints.completeDate}} - Returns date eac sprint was marked as complete.

• {{createdsprints.originBoardId}} - Returns the ID of the board each sprint belongs to.

• {{createdsprints.goal}} - Returns the each sprint goal.

{version}

• Used with the Version created, Version updated, and Version released triggers.

ルールをトリガーしたバージョンの情報にアクセスします。

• {{version.name}} -バージョンの名前を返します。

• {{version.id}} - バージョンの ID を返します。

• {{version.description}} - バージョンの説明を返します。

• {{version.archived}} - バージョンがアーカイブされている場合は true を返し、そうでない場合は false を返します。

• {{version.startDate}} - バージョンの開始日を返します。

• {{version.released}} - バージョンがリリースされている場合は true を返し、そうでない場合は false を返します。

• {{version.releaseDate}} - バージョンのリリース日を返します。

• {{version.project.key}} - バージョンが属するプロジェクトのプロジェクト キーを返します。

{コンポーネント}

• 使用方法: Compass トリガーで作成されたコンポーネント

Access component details created by the Component created in Compass trigger.

• {{component.ownerId}} - コンポーネントを所有するチームの ID（ARI）を印刷します。

• {{component.name}}: Compass コンポーネントの名前を表示します。

• {{component.id}} - Compass コンポーネントの ID（ARI）を印刷します。

• {{component.url}}: Compass コンポーネントの URL を表示します。

• {{component.cloudId}} - Compass コンポーネントの Cloud ID を印刷します。

• {{component.type}}: コンポーネント タイプを表示します。

• {{component.lastUserModificationAt}} - コンポーネントが最後に変更されたときのタイムスタンプを印刷します。

• {{component.lastUserModificationBy}} - コンポーネントを最後に変更したユーザーの ID（ARI）を印刷します。

{{scorecard}}

• 使用方法: Compass トリガーでのスコアカード ステータス変更

Access scorecard details created by the Scorecard status change in Compass trigger.

• {{scorecard.id}} - Compass スコアカード ID（ARI）を印刷します。

• {{scorecard.name}} - Compass スコアカードの名前を印刷します。

• {{scorecard.type}} - Compass スコアカードのタイプを印刷します。

• {{scorecard.ownerId}}-Compass スコアカードを所有するユーザーの ID（ARI）を印刷します。

• {{scorecard.applicationType}} - Compass スコアカードのアプリケーション タイプを印刷します。

• {{scorecard.status}} - Compass スコアカードの新しいステータスを印刷します。例えば、FAILING

• {{scorecard.previousStatus}} - Compass スコアカードの新しいステータスを印刷します。最初のステータスの場合は "null"。

• {{scorecard.lastUserModificationAt}} - スコアカードが最後に変更されたときのタイムスタンプを印刷します。

• {{scorecard.lastUserModificationBy}} - スコアカードを最後に変更したユーザーの ID（ARI）を印刷します。