.load [-o] [-e] [-v] [-j] [<relative_path>/]<filename>
.load -r|-p <registername>
.load -s `<command name>`
.load コマンドは XML ファイルからプロジェクトをロードし、ロードしたプロジェクトの ステップを現行プロジェクトに追加します。 ロードしたプロジェクト のステップは、.load コマンドを実行したステップの次 に追加され、これによ り、プロジェクトは実行時に 動的にステップを作成およびロードすることができます。オプションを使用し、.load コマンドで、 レジスターまたはコマンドの出力からデータを引き出すことができます。
.load コマンド用の XML ファイルを作成する場合は、既存プロジェ クトのエクスポート・ファイルを雛形として使用することをお勧めします。システム内で プロジェクトを作成してから、エクスポートして .load コマンドで使用することもできます。 このトピックには、サンプル XML コードが含まれます。
.load コマンドでロードされたステップは、インライン化または チェーニングされたプロジェクトへの参照を含むことができます。デフォルトでは、システムは XML ファイル内にあるインライン化されたプロジェクトの定義を検索し、そのステップをロードします。インライン化されたプロジェクト定義をデータベースから取得する方法については、このトピックで後述する -e オプションを参照してください。 成功チェーンまたは失敗チェーンのプロジェクトの場合、システムは常に、 データベースでプロジェクト定義を検索します。
システムは インライン化されたプロジェクトをそれらの呼び出しプロジェクトとともにエクスポートするため、XML ファイルには いくつかのプロジェクトが含まれる場合があります。 .load コマンドは、ファイル内で primary とラベルが付けられたプロジェクトを実行します。このプロジェクトには、 <project> エレメント上に属性 primary="1" があります。
.load ../../project.xml
サーバー・ディレクトリー (そのプロジェクトとジョブ・ディレクトリーが含まれるディレクトリー) から ファイル project.xml をロードし、ステップのパス・プロパティーが "/" (デフォルト) であると想定します。
.load -r|-p <registername>
-r
オプションは通常のレジスターからステップをロードしますが、-p オプションはプロジェクト・レジスターから
ステップをロードします。プロジェクトの以前のステップでレジスターに日付を作成してから、
このコマンドを使用して、そのレジスターからステップをロードすることができます。.load -s `<command name>`
以下の例に、 .load コマンドとともに使用する XML ファイルを示します。XML は、 HelloWorldPlusInline というプロジェクトをエクスポートすることによって作成されます。
bfexport -l
<?xml version="1.0" encoding="UTF-8"?>
<buildforge schema="7.115014" comment="">
<project access="6" active="Y" name="HelloWorldPlusInline" primary="1"
selectorId="Choose_local" maxthread="0" increment="Y" tagsync="0"
buildclass="Production" sticky="N" envId="0" tag="BUILD_$B" id="19" exclusive="0">
<tagvar autoincrement="Y" name="B" id="1">2</tagvar>
<step absolute="N" failwait="N" selectorId="" dir="/" broadcast="N"
timeout="300" id="1" passwait="N" inline="N" threadable="N" chainId="2"
access="6" active="Y" passnotify="0" description="EchoHelloWorld" onfail=" "
failnotify="0" envId="0" commandStore="echo Hello World">
<command>echo Hello World</command>
</step>
<step absolute="N" failwait="N" selectorId="" dir="/" broadcast="N"
timeout="300" id="2" passwait="N" inline="N" threadable="N" access="6"
active="Y" passnotify="0" description="export proj to build and server folders"
onfail=" " failnotify="0" envId="0"
commandStore=".export $BF_PROJECTNAME_PHYS.xml copy /Y $BF_PROJECTNAME_PHYS.xml ..¥..">
<command>.export $BF_PROJECTNAME_PHYS.xml
copy /Y $BF_PROJECTNAME_PHYS.xml ..¥..</command>
</step>
</project>
<project access="6" active="Y" name="Sleepytime" primary="0"
selectorId="Choose_local" maxthread="0" increment="Y" tagsync="0"
buildclass="Production" sticky="N" envId="0" tag="SLEEP_$B" id="2" exclusive="0">
<tagvar autoincrement="Y" name="B" id="1">21</tagvar>
<step absolute="N" failwait="N" selectorId="" dir="/" broadcast="N"
timeout="300" id="1" passwait="N" inline="N" threadable="N" access="6"
active="Y" passnotify="0" description="Sleep, perchance to dream" onfail=" "
failnotify="0" envId="0" commandStore=".sleep 0">
<command>.sleep 0</command>
</step>
</project>
<class maxdays="0" access="1" entranceprojectId="1" name="Production" keepfiles="B"
deletechangedata="N" purgeprojectId="2" exitProjectId="5" candidates="AnyBuild "
maxbuilds="0"></class>
<selector operator="" required="" access="6" value="" name="Choose_local"
selectorId="" property=""></selector>
</buildforge>