指定輸入檔案資訊

在裝置套件配置 XML 檔案中指定了基本資訊的值之後，請在裝置套件配置 XML 檔案的適當區段中指定輸入檔案資訊的值。

導覽至下列區段中的每個區段。在每個區段中，為您要產生之裝置套件指定值：

類型

<Type></Type>

指定要提供給這個應用程式的資料檔案類型。

目前支援的類型只有 CSV (不區分大小寫)。

預設值：CSV

範例：

Compression

<Compression></Compression>

指定在建立輸入檔案時用於裝置或 EMS 的壓縮類型 (如果有的話)。

下列資訊說明支援的壓縮類型：

TEXT: 如果建立輸入檔案時完全未使用壓縮功能，則會使用此類型。
ZIP: 如果以 zip 格式壓縮輸入檔案，則會使用此類型。
GZIP: 如果以 gzip 格式壓縮輸入檔案，則會使用此類型。

如果此值不是 TEXT，則裝置套件會先將下載的檔案解壓縮 (unzip)，再進行處理。

附註：由於僅支援單層解壓縮，因此來自裝置或 EMS 的輸入檔案只能壓縮一次。

範例：

Paths

<Paths>

	<Path deltaTime="900"></Path>

	<Path deltaTime="300"></Path>

</Paths>

指定此應用程式的範例輸入 CSV 資料檔案所在目錄的絕對路徑。

應用程式會使用 <Path> 中的檔案來產生裝置套件。應用程式的輸入檔案必須與裝置或 EMS 所建立的輸入檔案完全相同。您必須將輸入檔案從裝置或 EMS 複製到安裝應用程式所在的系統。

附註：在複製後，請勿修改檔案名稱或檔案內容。請將檔案名稱與檔案內容保持為您先前在裝置或 EMS 上建立時的原貌。修改這些檔案，將導致產生的裝置套件在進行安裝及下載實際檔案時無法正常運作。

如果 CSV 資料檔案位於多個目錄中，請視需要新增 <Path></Path>，數量不限。

此值不可空白。

資料檔案的預設副檔名為 *.csv，例如：

/opt/data/one (選取此目錄中的所有 *.csv 檔案)

/opt/data/two/*.sts (選取副檔名為 *.sts 的所有 CSV 檔案)

屬性 deltaTime 會指定據以產生輸入檔案的時間 (以秒為單位)。

若要建立可依據不同時間間隔對產生的檔案進行輪詢的單一裝置套件，請為不同 <Path> 中的每一組檔案提供其 deltaTime。在安裝產生的裝置套件期間，系統會提示您為提供的每個 deltaTime 屬性指定目標目錄。

目標目錄是指位於裝置或 EMS 上，在此裝置套件完成安裝後供其持續下載 CSV 檔案的實際目錄。

此值必須是正整數。

此值不可空白。

預設值：900

附註：產生的裝置套件完成部署後，會自動連線至裝置或 EMS，並下載檔案。

範例：

<Paths>

<Path deltaTime="900">/opt/dataFor15mins/InputCSVFiles</Path>

<Path deltaTime="300">/opt/dataFor5mins/InputCSVFiles</Path>

</Paths>

分隔符號

<Delimiter></Delimiter>

指定 CSV 檔案中的分隔符號。

分隔符號可以是任何字元，且不限長度。

此值不可空白。

預設值：逗號 (,)

範例：

CSVFile

<CSVFile>

<Header fileNamePattern=”” isHeaderInFile="true" dataStartsFrom=""></Header>

<Header fileNamePattern=”” isHeaderInFile="true" dataStartsFrom=""></Header>

</CSVFile>

附註：這個區段是重要的配置資訊，可供應用程式成功地將資料值對應到名稱。

指定用來識別 CSV 檔案之標頭的規則運算式。 CSV 檔案中第一個符合 <Header> 值的字行，會被視為 CSV 檔案的標頭。

屬性 fileNamePattern 會指定檔案名稱識別碼。

如果提供了 fileNamePattern 屬性，則 <Header> 的值將只會用於名稱符合此 fileNamePattern 的檔案。

如果 fileNamePattern 屬性空白，則會將 <Header> 的值用於所有不符合任何 fileNamePattern 的檔案。

如果檔案中沒有 <Header>，請執行下列動作：

將 isHeaderInFile 屬性設為 false。 False 會指定 <Header> 元素的值不會被視為實際標頭，也不會視為規則運算式。
使用 dataStartsFrom 屬性，可指定檔案中的資料起始行。如果資料始於第一行，請將此屬性保留為空白。
範例 1：

<Header fileNamePattern=”.*ethernet.*” isHeaderInFile="true" dataStartsFrom="">System Name,System IP,Date,BitsIn,BitsOut</Header>

在這個範例中，應用程式檢查名稱符合 fileNamePattern=.*ethernet.* 的檔案。對於所有符合的檔案，應用程式會讀取 isHeaderInFile 的值，以決定 <Header> 在檔案中。接著，應用程式會嘗試對檔案中的每一行比對 <Header> 的值，即 System Name,System IP,Date,BitsIn,BitsOut。符合此值的字行，即為檔案的標頭。

此標頭前面的所有字行，都會被視為註解。此標頭後面的所有字行則視為資料。

範例 2：

<Header fileNamePattern=”.*ethernet.*” isHeaderInFile="false" dataStartsFrom="">System Name,System IP,Date,BitsIn,BitsOut</Header>

在這個範例中，應用程式檢查名稱符合 fileNamePattern=.*ethernet.* 的檔案。對於所有符合的檔案，應用程式會讀取 isHeaderInFile 的值，以決定 <Header> 不在檔案中。為取得此 CSV 檔案的標頭，應用程式會使用 <Header> 的值，即 System Name,System IP,Date,BitsIn,BitsOut。

如果 dataStartsFrom 屬性的值空白，則檔案中第一個非空白的字行即為資料。

範例 3：

<Header fileNamePattern=”.*ethernet.*” isHeaderInFile="false" dataStartsFrom="3">System Name,System IP,Date,BitsIn,BitsOut</Header>

在此範例中，應用程式的動作與範例 2 中的大致相同，差別在於應用程式會讀取前兩行視為註解。將後續的所有欄都視為資料。

如果 CSV 檔案有標頭，建議您將完整的標頭作為 <Header> 元素的值貼上。貼上時不要刪除任何字元，否則應用程式無法比對。

如果 CSV 檔案沒有標頭，建議您參考該裝置 (或 EMS) 的廠商說明文件，或任何提供有關裝置或 EMS 所產生資料之格式的資訊的指南。

附註：若沒有任何標頭資訊，將不會產生任何裝置套件。

MaxFileCount

<MaxFileCount></MaxFileCount>

限制應用程式，使其從 <Paths> 中讀取的檔案數不會超出指定數目。

附註：此限制不適用於產生的裝置套件。若要對產生的裝置套件限制檔案數，請在部署裝置套件時提供其值。

MaxFileCount 必須是正整數或空白。

指定空值將會處理所有檔案。

預設值：空白

MaxFileSize

<MaxFileSize></MaxFileSize>

限制應用程式，使得超出此限制的檔案不會受處理。

附註：此限制不適用於會處理各種大小檔案之產生的裝置套件。建議您將大於 10 MB 的輸入檔案分割為多個檔案。

MaxFileSize 必須是正整數或空白。

MaxFileSize 的單位為 KB。

指定空值將會處理各種大小的檔案。

預設值：空白

在指定輸入檔案資訊後，請指定裝置套件元素資訊。