建立 AE Script

您可以找到與 AE Script 相關的資訊。

Script

您可以建立自訂範本及其 Script。這暗指建立範本後，範本即具有自訂 Script，可執行您已在範本中建立的新規則。您可在範本設定的 scriptsDirectory 中，定義 Script 的位置。如果您想將特定區段鏈結至在您的區段中 AE 必須執行的 Script，則必須將 Script 放置在 scriptsDirectory 所定義的位置。

由「啟動引擎」執行的所有已建立的 Script，預期都必須遵守某些準則集。重要的需求是所建立的 Script 必須接受由「啟動引擎」傳遞給它們的引數集，如同鏈結至這些 Script 的範本檔中的 RuleSet 區段所定義。例如，範本檔的網路區段包含：

<section name="network" script="ae_network.sh">
        <ruleset>
          <address>9.3.148.163</address>
          <mask>255.255.254.0</mask>
          <gateway>9.3.148.0</gateway>
          <routes>default:0:9.3.149.1</routes>
        </ruleset>
</section>

Script ae_network.sh 預期會接受這三個引數（如併入的 RuleSet 中所定義）：address、mask 及 gateway。Script 同時必須提供適當的回覆碼給「啟動引擎」。若是成功，它必須傳回 0，若是失敗，則必須傳回 1。

回覆碼 2 則保留給 SUCCESS_WITH_WARNINGS，讓 AE 知道 Script 已順利執行，但有不重要的警告，而 AE 必須將它記載在執行日誌中。同時不預期 Script 將其輸出以管線方式傳至任何的外部檔案。必須將任何詳細/錯誤訊息傳送至 STDOUT 或 STDERR，其中 AE 會將它們以管線方式傳至適當目的地日誌檔（如範本設定區段中所定義的）。如需詳細資料，請參閱範本設定。

Script 會要求您所建立的範本符合某些條件。第一，任何自訂的範本檔都必須遵循「綱目」中所定義的定義結構。如需相關資訊，請參閱建立 AE 範本檔。範本必須包含「設定」區段及「規則」區段。可以填寫或不填寫「設定」區段。如果範本未填寫「設定」區段中的任一或所有規則，則會使用其母項規則。（母項範本是 ae_template.xml 範本檔）。請注意，如果自訂範本檔中沒有 scriptsDirectory 設定，則 AE 將無法呼叫在母項範本中未定義的任何 Script。

必須填寫 XML 檔的規則區段，且其必須遵循嚴格的規則結構：

<rules>
      <section name="SECTION_NAME" script="SCRIPT">
          <ruleset>
              <argument1>value1</argument1>
              <argument2>value2</argument2>
          </ruleset>
      </section>
</rules>

在上述範例中，SCRIPT 是可命名註標的自訂字串位置保留元。只要在 scriptsDirectory 元素中定義其位置，SCRIPT 可以是任何系統可執行檔 Script 的檔名。上述 Script 將會以下列方式執行：

PATH/SCRIPT argument1=value1 argument2=value2

會處理所有引數及值配對，並以上述方式將它們傳遞至 Script。PATH 代表設定區段中定義的 scriptsDirectory 路徑。如需詳細資料，請參閱範本設定。