特定管理 > 分析系統與企業資訊 > 報告與查詢 > 管理報告範本 > 查詢建構器維護圖標板 > 在 Windchill 11.0 之前編寫之查詢建構器報告範本的升級模式
  
Windchill 11.0 之前編寫之查詢建構器報告範本的升級模式
QML (查詢標示語言) 結構已針對 Windchill 11.0 修改。當使用者執行報告時,更新的 QML (查詢標示語言) 格式可更順暢地與「報告建構器」使用者介面整合,並為未來的強化功能奠定基礎。
如果報告最初在 Windchill 11.0 之前的發行版本中建立,則它是使用舊 QML 格式編寫的。在 11.0 中,第一次於「報告建構器」中執行報告或「查詢建構器」中編輯報告時,會在標準模式下,自動將其升級至目前 QML 格式。不需要使用者執行其他動作。
如果您有 Windchill 11.0 之前發行版本中的報告,且想要其以引進「報告建構器」之前相同的顯示方式呈現給使用者,您可以選擇使用一或兩個其他升級模式,來升級報告:舊有模式單一日期模式
標準模式
在標準模式下升級報告會使報告範本發生下列變更:
如 11.0 之前「查詢建構器」「條件」標籤所指定
升級至目前 QML 之後的結果
criteria 子句中的欄與 select 子句中的欄相符的參數。
例外:
參數用於函數或子選取查詢
參數多次用於 criteria 子句
這些參數會與 select 子句中的相符欄組合 (包括任何指定預設值或常數值),並會採用 select 子句欄的顯示名稱。也就是說,參數現在會作為「欄」項目顯示在報告範本的「選取或限制」標籤中,且會使用如在「選取或限制」標籤中所指定之項目的「顯示名稱」。針對「編輯欄」視窗中的欄,會將在舊 QML 中指定的任何常數或預設值填入「值」屬性 (作為「恆定值」「預設值」)。
criteria 子句中的參數參考會取代為「條件」標籤中的「報告屬性參考」項目,進而參考「選取或限制」標籤中的項目。
針對相同日期欄的任何兩個日期參數 (一個使用 < 或 <= 運算子,一個使用 > 或 >= 運算子)。
例外:
參數多次用於 where 子句
參數用於函數或子選取查詢
參數會顯示在 criteria 子句中的「非」「或」布林條件下
在 select 子句中,兩個日期參數會使用在 criteria 子句中指定之參數的欄合併為一個日期欄。
亦即,日期參數在報告範本的「選取或限制」標籤中有單一「欄」可報告項目。針對「編輯欄」視窗中的欄,會將在舊 QML 中指定的任何常數或預設值填入「開始日期」「結束日期」內容 (作為「恆定值」「預設值」)。
日期會在「報告建構器」條件窗格中顯示為具有開始日期與結束日期輸入欄位的單一項目。
其他任何參數:
與 select 子句中的項目不相符的參數
在函數或子選取查詢中使用的參數
在 criteria 子句中多次使用的參數
顯示在 criteria 子句中的「非」「或」布林條件下的參數
這些參數會移至 select 子句。亦即,每個參數現在都是報告範本的「選取或限制」標籤中的「參數值」項目。
這些新項目會置於「選取或限制」標籤頂部,並會顯示在「報告建構器」條件窗格的頂部。這讓您可以輕鬆在報告範本內找到這些項目,以視需要移動或編輯。
criteria 子句中的參數參考會取代為「條件」標籤中的「報告屬性參考」項目,進而參考「選取或限制」標籤中的項目。
現在位於「選取或限制」標籤中的每個項目的「報告建構器選項」如下所示:
會選取「允許使用者指定條件」 (讓使用者輸入條件的輸入方塊會顯示在「報告建構器」的條件窗格中)
會選取「允許使用者決定」 (該核取方塊顯示在「報告建構器」的條件窗格中的項目旁,可讓使用者選取是否將該項目包括在報告結果中)
因此,當檢視報告時,現在位於報告範本的「選取或限制」標籤中的所有項目都會顯示在「報告建構器」的條件窗格中,並可由使用者選取或指定。
當報告第一次在「報告建構器」中執行或開啟以供在「查詢建構器」中編輯時,報告會自動在標準模式下升級。
舊有模式
在舊有模式下升級報告會為「查詢建構器」「選取或限制」標籤中的每個項目設定「報告建構器選項」,以使「報告建構器」的條件窗格以與引進「報告建構器」之前相同的方式顯示。
對於之前在舊有「查詢建構器」「條件」標籤中為參數,且在 select 子句中有對應欄的項目,「報告建構器選項」設定如下:
會選取「允許使用者指定條件」 (讓使用者輸入條件的輸入方塊會顯示在「報告建構器」的條件窗格中)
會選取「總是包括」
(項目會始終顯示在報告結果中)
對於之前在舊有「查詢建構器」「條件」標籤中為參數,但在 select 子句中沒有對應欄的項目,在「報告建構器」的條件窗格中,會發生下列情況:
會始終顯示輸入方塊,讓使用者輸入條件。
不會顯示核取方塊讓使用者在報告結果中選取欄位。參數值永遠不會包括在報告結果中。
不會為參數值顯示運算子。會在查詢中使用運算子指定的「條件」標籤。
對於報告範本的「選取或限制」標籤中的其他所有項目,「報告建構器選項」設定如下:
不會選取「允許使用者指定條件」
會選取「總是包括」
針對標準模式描述的其他所有變更都適用於舊有模式。
單一日期模式
在單一日期模式下升級報告表示,日期參數日期範圍的開始日期與終止日期不會合併到「選取或限制」標籤中的單一參數值,但會保留作為個別參數值。在「報告建構器」的條件窗格中,它們會顯示為個別條件欄位,而不是針對日期範圍具有使用中左值與右值的單一列。
針對標準模式描述的其他所有變更都適用於單一日期模式。
舊有模式與單一日期模式
如果「舊有模式」「單一日期模式」都選取,會套用這兩種升級模式。在「報告建構器」中顯示為「舊有模式」設定之結果的日期參數會保留作為個別參數值,如針對「單一日期模式」所描述。