.load [-o] [-e] [-v] [-j] [<relative_path>/]<filename>
.load -r|-p <registername>
.load -s `<command name>`
O comando .load carrega um projeto de um arquivo XML e inclui as etapas do projeto carregado no projeto atual após a etapa que executou o comando .load, permitindo que um projeto crie dinamicamente e carregue as etapas no tempo de execução. Utilizando as opções, é possível fazer com que o comando .load retire seus dados de um registro ou da saída de um comando.
Para gravar um arquivo XML de um comando .load, comece exportando o arquivo de um projeto existente para ter a estrutura básica apropriada. É possível também criar um projeto no sistema e, em seguida, exportá-lo para usar em um comando .load. Esse tópico inclui o código XML de amostra.
As etapas carregadas por um comando .load podem conter referências aos projetos embutidos ou em cadeia. Por padrão, o sistema procura definições dos projetos embutidos no arquivo XML e carrega suas etapas; consulte a opção -e posteriormente neste tópico para obter uma maneira de fazer com que o sistema adquira a definição do projeto embutido do banco de dados. Para projetos em cadeia transmitidos ou com falha, o sistema sempre procura a definição de projeto no banco de dados.
Em razão de o sistema exportar os projetos embutidos juntamente com seus projetos em chamada, um arquivo XML pode conter vários projetos. O comando .load executa o projeto que é rotulado como principal no arquivo. Esse projeto tem o atributo primary="1" em seu elemento <project>.
.load ../../project.xml
carrega o arquivo project.xml do diretório do servidor (o diretório que contém o projeto e os diretórios da tarefa), assumindo que a propriedade do caminho da etapa é "/" (o padrão).
.load -r|-p <registername>
A opção
-r carrega as etapas de um registro comum, enquanto que a opção -p carrega as
etapas de um registro de projeto. É possível construir dados em um registro
nas etapas anteriores em seu projeto e, em seguida, carregar as etapas do
registro com esse comando..load -s `<command name>`
O exemplo a seguir mostra um arquivo XML a ser utilizado com o comando .load. O XML foi criado ao exportar um projeto chamado 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>