「プロジェクト」プロパティーの変更
プロジェクト・レベルのプロパティーを変更するには、「プロジェクト」を選択してから、
対象プロジェクト名の横にある「編集」アイコン をクリックします。
- プロジェクト名
- プロジェクトの名前。システムは、リスト内およびデータベース内にあるプロジェクトを参照する際に、この名前を使用します。
プロジェクトを実行した場合、プロジェクト・ディレクトリーの構成にはプロジェクト名が使用されます。 プロジェクトには、さまざまなオペレーティング・システムで実行される可能性のあるステップが含まれるため、 プロジェクト名には、特殊な文字や記号は使用しないでください。 無効なディレクトリー名を生成する文字をプロジェクト名に使用しなければならない場合は、「無効な相対ディレクトリー文字」システム構成設定にそれらの文字を追加してください。この設定にリストされた文字は、プロジェクト・ディレクトリーの作成時に下線 (_) に変換されます。 アンパーサンド (&) を使用すると、意図せずにプロジェクト名の一部として HTML エンティティーを生成してしまう可能性があります。
- アクセス
- プロジェクトの表示と使用が許可されたアクセス・グループ。 このプロパティーは、アクセスできる対象を決定する権限とともに使用できます。 例えば、ジョブを起動する場合は、 プロジェクトに対して指定されたアクセス・グループのメンバーであると同時に、「ジョブの実行 (Execute Jobs)」 権限を持つ グループのメンバーでもなければなりません。 アクセス・グループについて詳しくは、アクセスの概説を参照してください。
- タグ形式
- プレーン・テキストとタグ変数参照を使用して、プロジェクトのタグを定義するストリング。 タグ形式について詳しくは、ジョブ中のビルド・タグの変更を参照してください。
- タグ同期
- 2 つのプロジェクトのタグ変数を同期化します。現行プロジェクトと同期化するタグ変数を持つプロジェクトを選択します。2 つのプロジェクトが同期している場合は、 それらの変数は同じプールから取得されます。したがって、順番に実行される場合は、1 つのプロジェクトが値 1 を取得すると、次のプロジェクトは値 2 を取得し、以下同様に実行されます。 詳しくは、タグの同期化を参照してください。
- 最大スレッド
- プロジェクトが起動を許される並列プロセスの最大数。
このフィールドを使用して、プロジェクトがシステム・リソースを使いすぎないようにします。
スレッド対応の各ステップと任意のインライン・プロジェクト (それ自体、スレッド対応のステップを起動できる) は、並列プロセスになることができるが、
これらのプロセスはすべて、親プロジェクトの最大数に対してカウントされます。
スレッド数の最大値に到達すると、新規並行プロセスの起動は停止され、
プロジェクトの並列プロセス数がスレッド数の最大値を下回るまで待機した後、システムは続行されます。
スレッド化について詳しくは、スレッド: ステップの並列実行を参照してください。
注: 「最大スレッド」プロパティーは、Java エンジン上ではサポートされません。
- 実行上限数
- 「実行上限数」プロパティーは、同時に許可されるプロジェクト・ジョブの最大数を設定するものです。
- プロジェクトを起動したときに、アクティブなジョブ数が「実行上限数」に等しい場合、新規ジョブは、少なくとも 1 つのジョブが完了するまで待機キュー にとどまります。
- スケジュールによってプロジェクトの起動が試みられたときに、アクティブなジョブの数が「実行上限数」に等しく、「ハード実行上限数」システム構成が「はい」に設定されている場合、システムは新規ジョブを起動しません。 「ハード実行上限数」が「いいえ」に設定されている場合、システムは、スケジュールされたビルドに関する「実行上限数」設定を無視します。
- インラインで起動されたプロジェクトは、オリジナル・プロジェクトのインスタンスとは見なされず、その「実行上限数」には算入されません。
- クラス
- 各プロジェクトはクラスに割り当てる必要があり、クラスはグローバル・プロパティーをプロジェクトのグループに割り当てます。 詳しくは、クラスを参照してください。
- セレクター
- プロジェクトのサーバーを選択するときのセレクターの名前。 システムでは、このセレクターが、独自のセレクターを指定していない、プロジェクト内のすべてのステップのデフォルトとして使用されます。 セレクターを参照してください。セレクターが指定されない場合、プロジェクトはプロジェクト・パネル ではなくライブラリー・パネル に追加されます。ライブラリーは、 呼び出し元のステップのセレクターを使用します。 このステップにセレクターがない場合、ライブラリーは呼び出し元のプロジェクトのセレクターを使用します。
- 成功チェーン、失敗チェーン
- プロジェクト・ビルドが成功または失敗したときに実行するプロジェクトを選択します。 成功チェーンまたは失敗チェーンをプロジェクト・レベルで設定しておくと、 プロジェクトの成功状況または失敗状況に基づいて、別の成功アクションまたは失敗アクションを呼び出すことができます。 この機能は、成功または失敗アクションをプロジェクト内でステップ・レベルで設定することに似ています。プロジェクト・レベルの場合は、成功または失敗アクションは、ステップ状況ではなくプロジェクト実行状況によってトリガーされます。
- 環境変数
- サーバー環境変数の後、ステップ環境変数の前に、適用される環境変数。 環境変数を一緒に機能させる方法について詳しくは、変数についてを参照してください。
- スティッキー
- デフォルトのプロジェクト・セレクターを使用するプロジェクトのすべてのステップを強制的に同一サーバー上にとどまらせるには、 「スティッキー」チェック・ボックスを有効にします。 その際、サーバーがビジーな場合はサーバーが使用可能になるまで待機する必要があります。 このオプションについて詳しくは、ステップをサーバーにスティックさせるを参照してください。
- 開始通知 (Start Notify)、成功通知 (Pass Notify)、失敗通知 (Fail Notify)
- これらのフィールドは、プロジェクトの開始、成功、または失敗のときに通知 E メールを送信するようにシステムに指示する場合に使用します。 それには、これらのフィールドの 1 つまたはすべてでアクセス・グループを選択します。