參照︰文件存取器 Helper 物件

名稱	引數	傳回值類型	附註
getData	整數索引	來源	擷取指定從零開始的索引處的文件。與 message.setMessage 輔助函數，以節省記憶體的方式將擷取的資料填入目前的訊息。範例︰以下代碼會使用從第一個附件擷取的 UTF-8 XML 訊息填入目前的訊息︰ message.setMessage(da.getData(0), ‘text/xml’) 如果沒有具有指定索引的整合附件，則會導致錯誤。
	字串檔案名稱	來源	擷取具有指定檔案名稱的文件。與 message.setMessage 輔助函數，以節省記憶體的方式將擷取的資料填入目前的訊息。範例︰以下代碼會在目前的訊息中填入名稱為 input.xml 的 UTF-8 XML 訊息附件︰ message.setMessage(da.getData(‘input.xml’), ‘text/xml’) 如果沒有指定檔案名稱的整合附件，則會發生錯誤。
getDocumentIndexes	List<String> 標籤	List<Integer>	傳回一個 Java 整數清單，列出標有所有指定標籤的文件索引。請注意，如果其中一個標籤為「*」，則表示比對任何標籤，且函數會傳回至少包含 1 個標籤的文件的所有索引。
getDocsMatching	List<String>	List<Source>	擷取標有所有指定標籤的文件。 Workday 會將小於 100 KB 的文件儲存在記憶體中，將較大的文件儲存在磁碟中。請注意執行階段記憶體和磁碟空間限制。
	字串標籤	來源	擷取標有指定標籤的文件。此處的「標籤」是指整合附件標籤。與文件標記同義。
	String[] 標籤	來源	擷取字串陣列中標有所有標籤的文件。
getFileName	整數索引	String	擷取具有指定索引的檔案名稱。
	字串標籤	List<String>	擷取標有指定標籤的所有文件名的 Java 清單。
	List<String> 標籤	List<String>	擷取標有指定標籤的所有文件名的 Java 清單。
	字串標籤，整數索引	String	擷取所有標有指定標籤的文件中的第 n 個檔案名稱。功能上與以下代碼相同︰ da.getFileNames(label).get(index) 在大多數情況下，您必須使用 da.getFileNames(label) ，找出相符檔案名的數目後才能使用索引。唯一的例外是您需要第一個 (零索引) 值的有限情況。
	List<String> 標籤，整數索引	String	從所有標有指定標籤的文件中擷取第 n 個檔案名稱。功能上與以下代碼相同︰ da.getFileNames(labels).get(index) 在大多數情況下，您必須使用 da.getFileNames(labels) ，找出相符檔案名的數目後才能使用索引。唯一的例外是您需要第一個 (零索引) 值的有限情況。
	String[] 標籤，整數索引		從所有標有指定標籤的文件中擷取第 n 個檔案名稱。功能上與以下代碼相同︰ da.getFileNames(java.util.Arrays.asList(labels)).get(index) 在大多數情況下，您必須使用 da.getFileNames(labels) ，找出相符檔案名的數目後才能使用索引。唯一的例外是您需要第一個 (零索引) 值的有限情況。
hasFile	字串檔案名稱	布林運算子	判斷是否有指定檔案名稱的整合附件。
	字串標籤、字串檔案名稱	布林運算子	判斷是否有指定檔案名稱且標有指定標籤的整合附件。
	List<String> 標籤，字串檔案名稱	布林運算子	判斷是否有具有指定檔案名稱且標有清單中所有標籤的整合附件。
sort	字串順序	無	依檔案名稱將附加的文件排序。有效的順序值為︰ "FILENAME_ASCENDING" "FILENAME_DESCENDING" 沒有檔案名稱的附件放在最後。
size	無	整數	傳回附加文件的數目。
	List<String> 標籤	整數	傳回標記有所有指定標籤的文件數。
	字串標籤	整數	傳回標記有指定標籤的文件數。
	String[] 標籤	整數	傳回字串陣列中標有所有標籤的文件數。
toVar	整數索引、字串 var_name	MessageVariable	擷取指定索引處的文件，並以節省記憶體的方式放入指定的程序集變數中。範例︰ da.toVar(0, ‘myInputDocument’)
	String filename, String var_name	MessageVariable	擷取具有指定檔案名稱的文件，並以節省記憶體的方式將其放入指定的程序集變數中。範例︰ da.toVar(‘WorkerData.xml’, ‘myInputDocument’)

getData

整數索引

來源

擷取指定從零開始的索引處的文件。與

message.setMessage

輔助函數，以節省記憶體的方式將擷取的資料填入目前的訊息。

範例︰以下代碼會使用從第一個附件擷取的 UTF-8 XML 訊息填入目前的訊息︰

message.setMessage(da.getData(0), ‘text/xml’)

如果沒有具有指定索引的整合附件，則會導致錯誤。

字串檔案名稱

來源

擷取具有指定檔案名稱的文件。與

message.setMessage

輔助函數，以節省記憶體的方式將擷取的資料填入目前的訊息。

範例︰以下代碼會在目前的訊息中填入名稱為 input.xml 的 UTF-8 XML 訊息附件︰

message.setMessage(da.getData(‘input.xml’), ‘text/xml’)

如果沒有指定檔案名稱的整合附件，則會發生錯誤。

getDocumentIndexes

List<String> 標籤

List<Integer>

傳回一個 Java 整數清單，列出標有所有指定標籤的文件索引。

請注意，如果其中一個標籤為「*」，則表示比對任何標籤，且函數會傳回至少包含 1 個標籤的文件的所有索引。

getDocsMatching

List<String>

List<Source>

擷取標有所有指定標籤的文件。

Workday 會將小於 100 KB 的文件儲存在記憶體中，將較大的文件儲存在磁碟中。請注意執行階段記憶體和磁碟空間限制。

字串標籤

來源

擷取標有指定標籤的文件。

此處的「標籤」是指整合附件標籤。與文件標記同義。

String[] 標籤

來源

擷取字串陣列中標有所有標籤的文件。

getFileName

整數索引

String

擷取具有指定索引的檔案名稱。

字串標籤

List<String>

擷取標有指定標籤的所有文件名的 Java 清單。

List<String> 標籤

List<String>

擷取標有指定標籤的所有文件名的 Java 清單。

字串標籤，整數索引

String

擷取所有標有指定標籤的文件中的第 n 個檔案名稱。

功能上與以下代碼相同︰

da.getFileNames(label).get(index)

在大多數情況下，您必須使用

da.getFileNames(label)

，找出相符檔案名的數目後才能使用索引。唯一的例外是您需要第一個 (零索引) 值的有限情況。

List<String> 標籤，整數索引

String

從所有標有指定標籤的文件中擷取第 n 個檔案名稱。

功能上與以下代碼相同︰

da.getFileNames(labels).get(index)

在大多數情況下，您必須使用

da.getFileNames(labels)

，找出相符檔案名的數目後才能使用索引。唯一的例外是您需要第一個 (零索引) 值的有限情況。

String[] 標籤，整數索引

從所有標有指定標籤的文件中擷取第 n 個檔案名稱。

功能上與以下代碼相同︰

da.getFileNames(java.util.Arrays.asList(labels)).get(index)

在大多數情況下，您必須使用

da.getFileNames(labels)

，找出相符檔案名的數目後才能使用索引。唯一的例外是您需要第一個 (零索引) 值的有限情況。

hasFile

字串檔案名稱

布林運算子

判斷是否有指定檔案名稱的整合附件。

字串標籤、字串檔案名稱

布林運算子

判斷是否有指定檔案名稱且標有指定標籤的整合附件。

List<String> 標籤，字串檔案名稱

布林運算子

判斷是否有具有指定檔案名稱且標有清單中所有標籤的整合附件。

sort

字串順序

無

依檔案名稱將附加的文件排序。有效的順序值為︰

"FILENAME_ASCENDING"

"FILENAME_DESCENDING"

沒有檔案名稱的附件放在最後。

size

無

整數

傳回附加文件的數目。

List<String> 標籤

整數

傳回標記有所有指定標籤的文件數。

字串標籤

整數

傳回標記有指定標籤的文件數。

String[] 標籤

整數

傳回字串陣列中標有所有標籤的文件數。

toVar

整數索引、字串 var_name

MessageVariable

擷取指定索引處的文件，並以節省記憶體的方式放入指定的程序集變數中。

範例︰

da.toVar(0, ‘myInputDocument’)

String filename, String var_name

MessageVariable

擷取具有指定檔案名稱的文件，並以節省記憶體的方式將其放入指定的程序集變數中。

範例︰

da.toVar(‘WorkerData.xml’, ‘myInputDocument’)

參照︰文件存取器 Helper 物件

實用函數