建立 XML 驅動程式的 HTTP 參數

  1. 在 [HTTP 參數] 畫面上,按一下 [加入屬性]
  2. 在 [編輯屬性值] 畫面上的 [屬性] 欄位中,輸入參數的名稱。
  3. [值] 欄位中,以 @Prompt 函式的形式輸入參數公式。

    如需關於 @Prompt 函式語法的詳細資訊,請參閱參數公式

參數公式

參數公式要使用 @Prompt 函式來建立。如果您想要在 XML 資料流中強加限制,但又不想預設條件的值,此時這個函式會很有用。

函式的語法如下:

@Prompt('message','type',[lov],[MONO|MULTI],[FREE|CONSTRAINED])

語法 說明

'message'

這個參數是提示訊息的文字。文字必須括在單引號中 (例如,'請選擇地區'、'請挑選期間' 或 '請選擇陳列室')。當連線完成時,這項文字就會出現在提示方塊中。

'type'

這個參數會描述函式傳回的資料類型。它可以是下列其中一項︰

  • 'A' 表示英數字串
  • 'N' 表示數字
  • 'D' 表示日期

指定的資料類型必須括在單引號中。

lov

這個參數會提供值清單 (lov)。清單是固定的;也就是,您是藉由輸入個別值來建立清單。每個值都必須括在單引號中,並且以逗號分隔,整個清單則要括在大括號中。例如,{'Australia', 'France', 'Japan', 'United Kingdom', 'USA'}。這是一個選擇性的參數。

MONO

使用者在值清單中只能選取一個值。MONO 是 MONO|MULTI 這一對參數的預設值。這是一個選擇性的參數。

MULTI

使用者可以從值清單中選取多個值。MONO 是 MONO|MULTI 這一對參數的預設值。這是一個選擇性的參數。

FREE

使用者可以輸入自己想要的值,或是從值清單中選取值。FREE 是 FREE|CONSTRAINED 這一對參數的預設值。這是一個選擇性的參數。

CONSTRAINED

使用者必須從值清單中選取值。FREE 是 FREE|CONSTRAINED 這一對參數的預設值。這是一個選擇性的參數。

注意    對每一個選擇性參數而言,如果省略引數,仍然必須輸入逗號做為分隔符號。

連線到 XML 資料來源

選擇 XML 做為資料來源
  1. 在 Crystal Reports 的 [檔案] 功能表上,按一下 [新增]
  2. 按一下 [使用報表精靈]
  3. [選擇精靈] 清單中按一下 [標準],然後按一下 [確定]
  4. 在報表建立精靈的 [資料] 畫面上,按兩下 [建立新連線]
  5. 按兩下 [XML]

    會出現 [XML] 對話方塊。

  6. 選擇 XML 資料來源存取類型:
  7. 依照下列其中一節的步驟,可識別要連線的 XML 檔案:
連線到本機資料來源
  1. 如果選擇 [使用本機資料來源],請輸入 XML 檔案的完整路徑和名稱,或使用欄位旁邊的按鈕以搜尋檔案。
  2. 如果要套用結構描述至選取的 XML 檔案,請選擇 [指定結構描述檔案]

    除非 XML 檔案包含內嵌的結構描述資訊,否則您必須選取這個選項並指定結構描述。

    注意    結構描述位置和名稱的定義,是在下一個畫面中完成。

  3. 按一下 [Next]

    根據上一個步驟的選擇,會顯示可以指定結構描述的畫面;若不指定,就按一下 [完成] 按鈕。

  4. 如果要指定結構描述檔案,請選擇 [使用本機結構描述][使用 HTTP(S) 結構描述],然後完成旁邊的欄位。
  5. 按一下 [下一步],然後按一下 [完成]
連線到 HTTP(S) 資料來源
  1. 如果選擇 [使用 HTTP(S) 資料來源],請輸入指向 XML 檔案的 URL。

    您可以使用 HTTP 或 HTTPS 來定義 URL。

  2. 如果要套用結構描述至選取的 XML 檔案,請選擇 [指定結構描述檔案]

    除非 XML 檔案包含內嵌的結構描述資訊,否則您必須選取這個選項並指定結構描述。

    注意    結構描述位置和名稱的定義,是在接下來的畫面中完成。

  3. 按一下 [Next]
  4. 如有必要,請輸入驗證資訊,然後再次按一下 [下一步]

    根據步驟 2 的選擇,會顯示可以指定結構描述的畫面或定義 HTTP 參數的畫面。如果您看到 [HTTP 參數] 畫面,請跳到步驟 6。

  5. 如果要指定結構描述檔案,請選擇 [使用本機結構描述][使用 HTTP(S) 結構描述],然後完成旁邊的欄位。
  6. 在 [HTTP 參數] 畫面上,建立適合加入 URL 的參數,以限制 XML 檔案內傳回的結果。
  7. 在 [HTTP 參數] 畫面中輸入完畢時,請按一下 [完成]
連線到 Web 服務資料來源
  1. 如果選擇 [使用 Web 服務資料來源],請按一下 [下一步] 以繼續執行步驟。
  2. 如果要指定 Web 服務檔案位置,請選擇 [使用本機 WSDL][使用 HTTP(S) WSDL],然後完成旁邊的欄位。
  3. 按一下 [Next]

    根據上一個步驟的選擇,會顯示可以指定 Web 服務、連接埠和方法的畫面,或顯示可以定義 Web 服務 URL 驗證的畫面。如果您看到 [Web 服務、連接埠和方法] 畫面,請跳到步驟 5。

  4. 如有必要,請輸入驗證資訊,然後按一下 [下一步]
  5. 在 [Web 服務、連接埠和方法] 畫面上,從清單中選擇服務、連接埠和方法。
  6. 按一下 [Finish]

當您看到從 XML 資料來源建立的資料表時,就可以用它來建立 Crystal 報表;建立方式如同您使用任何其他資料來源一樣。如需關於建立 Crystal 報表的詳細資訊,請參閱《Crystal Reports 使用指南》。

CRDB_JavaServer.ini 參數參考

如需 CRDB_JavaServer.ini 檔案的位置,請參閱必要元件

顯示在 CRDB_JavaServer.ini 中的參數是依據您所安裝的驅動程式而定。例如,如果沒有安裝原生 XML 驅動程式,[CRDB_XML] 參數就不會顯示。在最佳狀況下,CRDB_JavaServer.ini 檔案會包含所有這些參數:

參數名稱 說明

Path

Path 參數值包含 Java 可執行檔的目錄。如果安裝了多個 Java Runtime Environment 版本,則這個參數會指向您要使用的版本,例如:

PATH=C:\apps\j2sdk1.4.2\bin

或者,也可以將路徑資訊設定為使用者或系統環境變數。在這種狀況下,如果 JAVA_HOME 是定義為變數,則可以依照以下範例使用 ${JAVA_HOME}

PATH=${JAVA_HOME}\bin

Classpath

Classpath 參數值包含以下 .jar 檔案的類別路徑清單:

  • CRDBJavaServer.jar
  • 所有資料庫專屬的 JDBC 驅動程式 .jar 檔案

    例如,對於 Oracle JDBC 驅動程式而言,ojdbc14.jar 的類別路徑就是必要的。

或者,也可以將類別路徑資訊設定為使用者或系統環境變數。如果沒有定義這個變數,則它會等同於 CLASSPATH=${CLASSPATH}

環境變數還可以包含在混合路徑中,如以下範例所示:

classpath=c:\java\lib\xerces.jar;${CommonProgramFiles}"/Crystal Decisions/2.5/bin/CRDBJavaServer.jar";${CLASSPATH}

注意    使用具有長資料夾的類別路徑和 (或) 包含空格的檔案名稱時,請確定它們都括在引號內。例如,"C:\Program Files\Common Files\Crystal Decisions\2.5\bin\CRDBJavaServer.jar"

IORFileLocation

IORFileLocation 參數值提供暫存目錄,供 JDBC 驅動程式使用。這個位置必須存在,且可由系統存取,否則驅動程式便無法運作。

JavaServerTimeout

JavaServerTimeout 參數指定 Java 伺服器在自行關閉之前,會持續處理要求多久的時間量上限。預設值為 1800 秒 (30 分鐘)。

JVMMaxHeap

JVMMaxHeap 參數指定 JVM 可以為 Java 伺服器的執行所配置的最大堆疊空間量。根據預設,這個參數是設定為 64 MB 的堆疊。如果需要處理大量資料,請將這個數字變更為較大的值。

JVMMinHeap

JVMMinHeap 參數指定 JVM 可以為 Java 伺服器的執行所配置的最小堆疊空間量。根據預設,這個參數是設定為 32 MB 的堆疊。

CacheRowSetSize

CacheRowSetSize 參數指定快取於記憶體的資料列數。根據預設,此參數會設定為 100 列。

JDBCURL

JDBCURL 參數值是預設的 JDBC 連線 URL,會在您建立新的 JDBC 資料連線時顯示於 Crystal Reports。連線 URL 的確切格式與資料庫驅動程式有關,而且是由資料庫驅動程式廠商所提供。

例如,Oracle JDBC 驅動程式的連線 URL 為:

jdbc:oracle:thin:@<hostname>:<port>:<sid>

其中:

  • <hostname> 是您要連接到的伺服器 TCP/IP 位址或 TCP/IP 主機名稱。
  • <port> 是 TCP/IP 連接埠的號碼。
  • <sid> 是 Oracle 資料庫 ID。

JNDIURL

JNDIURL 參數值是預設的 JNDI 連線 URL,會在您建立新的 JNDI 資料連線時顯示於 Crystal Reports。連線 URL 的確切格式與資料庫驅動程式有關,而且是由資料庫驅動程式廠商所提供。

JDBCUserName

JDBCUserName 是預設的使用者 ID,會在您建立新的 JDBC 資料連線時顯示於 Crystal Reports。JDBC 驅動程式會使用使用者 ID 連接到資料庫。

JDBCDriverName

JDBCDriverName 是 JDBC 驅動程式的預設完整類別名稱,會在您建立新的 JDBC 資料連線時顯示於 Crystal Reports。

例如,Oracle JDBC 驅動程式的完整類別名稱為:

oracle.jdbc.driver.OracleDriver

JNDIUserName

JNDIUserName 是預設的使用者 ID,會在您建立新的 JNDI 資料連線時顯示於 Crystal Reports。JDBC 驅動程式會使用使用者 ID 連接到資料庫。

JNDIConnectionFactory

JNDIConnectionFactory 參數是 JNDI 伺服器連線供應商的名稱。若是 WebLogic,則為 weblogic.jndi.WLInitialContextFactory。若是 WebSphere,則為 com.ibm.websphere.naming.WsnInitialContextFactory

JNDIInitContext

JNDIInitContext 參數是在 JNDI 伺服器上尋找 JNDI 內容的起點。例如,您可以針對 WebLogic 設定 JNDIInitContext=/。參數會從樹狀結構的頂端開始搜尋。如果已在這個節點中建立連線,可以針對 WebSphere 將這個參數設定為 cell/nodes/localhost/servers/server1/jdbc。

GenericJDBCDriverBehavior

如果所使用的是泛用 JDBC 驅動程式,而非特定的驅動程式,則 GenericJDBCDriverBehavior 參數會指定要模擬其行為的驅動程式。根據預設,會設定模擬 DB2 JDBC 驅動程式的行為。如果保留這個設定,代表您想要將類似 DB2 JDBC 驅動程式的功能開放給使用者使用。有效值為 DB2SQLServerOracle

PREREADNBYTE

PREREADNBYTE 參數是用來決定在每次進行邏輯讀取時,從 XML 文件讀取多少位元組。這個參數可用來改善效率並避免一次讀取一個位元組;這與區塊讀取大小相同。大小不能太小 (至少為 4096)。設定過高的值會影響記憶體的用法。根據預設,這個參數是設定為 5000。

XMLLOCALURL

XMLLOCALURL 參數值是本機 XML 檔案的預設連線 URL。這個預設值會在您建立新的 XML 資料連線時,顯示於 Crystal Reports。

SCHEMALOCALURL

SCHEMALOCALURL 參數值是本機結構描述檔案的預設連線 URL。這個預設值會在您建立新的 XML 資料連線時,顯示於 Crystal Reports。

XMLHTTPURL

XMLHTTPURL 參數值是 HTTP XML 檔案的預設連線 URL。這個預設值會在您建立使用 HTTP(S) 的新 XML 資料連線時,顯示於 Crystal Reports。

SCHEMAHTTPURL

SCHEMAHTTPURL 參數值是 HTTP 結構描述檔的預設連線 URL。這個預設值會在您建立使用 HTTP(S) 的新 XML 資料連線時,顯示於 Crystal Reports。


Business Objects
http://www.china.businessobjects.com
Support services
http://www.china.businessobjects.com