<run> 元素在 <interface> 元素內用來
指定要執行的具名指令。稍後在相同的 XML 檔中定義此指令。<run> 元素是一
個空元素。
屬性:
- condition
- 選用,形式如下所示:condition="function"。function 的值是一個會求值為 true 或 false 的表示式。如果求值為 true,指令就會執行。如果求值為 false,就不會執行。請參閱條件函數。
- command
- (必要)。指定定義要執行之指令的名稱。指令是在 <command> 元素中命名和定義。
- dir
- (必要)。指定要在其中執行指令的目錄。dir 會解譯成指令執行所在之伺服器資源中所設定的路徑副檔名。
- mode
- 選用。指定 run 指令的執行模式。可以是下列其中一項:
- conjoined:所有對該指令發出的呼叫,都會組合成一個呼叫,來進行伺服器處理程序。
- parallel:在伺服器介面槽可供使用時,個別處理呼叫。
- exec:指令是由伺服器啟動並且立即處理。
- params
- (必要)。指定要傳遞給指令的參數。請使用空格來區隔各參數。
- 伺服器 (server)
- (必要)。指定指令執行所在的伺服器資源。如果設為空值,則指令會在執行配接器之步驟所用的伺服器上執行。使用 server="",表示將伺服器設為空值。
- timeout
- (必要)。它指定在經過多少秒之後,指令即會逾時。
顯示所需屬性的範例:
<run command="UpdateEnv" params="" server="" dir="/" timeout="360"/>
範例:
<run command="p4_changes" params="$LAST_RUN $FILESPEC $LAST_VER"
server="$P4CLIENT" dir="/" timeout="360"/>