使用 BAC

由於 BAC 是受保護的，並提供根據使用者角色使用功能的許可，因此存取應用程式的第一步是自行驗證。在驗證步驟之後，系統會將您重新導向至首頁。首頁會顯示 Blusam 儲存中找到的資料集分頁清單：

Blusam Administration Console showing configuration settings and a table of data sets.

若要返回含有資料集清單的首頁，請選擇應用程式任何頁面左上角的 Blu Age 標誌。下圖顯示標誌。

可摺疊標頭，標示為「BluSam 組態」，包含使用之 BluSam 儲存組態的相關資訊：

Persistence：持久性儲存引擎 (PostgreSQL)
Cache Enabled：是否啟用儲存快取

在標頭的右側，有兩個下拉式清單，每個清單都會列出與資料集相關的操作：

大量動作
建立動作

若要了解這些清單的詳細內容，請參閱現有的資料集操作。

未進行任何資料集選取時，會停用大量動作按鈕。

您可以使用搜尋欄位，根據資料集名稱將清單存檔：

Search field and table showing KSDS data sets with details like keys, records, and dates.

以下分頁清單顯示每個資料表資料列一個資料集，其中包含下列資料欄：

選取核取方塊：選取目前資料集的核取方塊。
名稱：資料集的名稱。
類型：資料集的類型，下列其中一項：
- KSDS
- ESDS
- RRDS
金鑰：顯示或隱藏金鑰詳細資訊的連結（如果有的話）。例如，指定的 KSDS 具有強制性主索引鍵和一個替代索引鍵。

每個金鑰有一個資料列，其中包含下列資料欄。所有欄位都無法編輯。
- 金鑰本質：主金鑰或其他金鑰
- 名稱：金鑰的名稱
- 唯一：金鑰是否接受重複的項目
- 位移：記錄中索引鍵開始的位移
- 長度：記錄中金鑰部分的位元組長度
記錄：資料集中的記錄總數。
記錄大小上限：記錄的大小上限，以位元組表示。
固定記錄長度：指出記錄為固定長度（已選取）或可變長度（未選取）的核取方塊。
壓縮：指出壓縮是否套用（選取）至已儲存索引的核取方塊。
建立日期：在 Blusam 儲存中建立資料集的日期。
上次修改日期：在 Blusam 儲存中上次更新資料集的日期。
快取：顯示或隱藏套用至此資料集之快取策略詳細資訊的連結。
- 在啟動時啟用快取：指定此資料集啟動快取策略的核取方塊。如果選取，資料集將在啟動時載入快取。
- 暖機快取：將指定資料集載入快取的按鈕，立即開始（但補充快取需要一些時間，取決於資料集大小和金鑰數量）。將資料集載入快取後，會出現類似下列的通知。
動作：可能資料集操作的下拉式清單。如需詳細資訊，請參閱現有的資料集操作。

在頁面底部，有一個一般分頁導覽小工具，用於瀏覽資料集清單的頁面。

現有的資料集操作

對於分頁清單中的每個資料集，有一個動作下拉式清單，其中包含下列內容：

Dropdown menu showing options: Read, Load, Export, Clear, and Delete.

清單中的每個項目都是作用中連結，可讓您對資料集執行指定的動作：

讀取：瀏覽資料集中的記錄
載入：從舊版資料集檔案匯入記錄
匯出：將記錄匯出至一般檔案（與舊版系統相容）
清除：從資料集移除所有記錄
刪除：從儲存體移除資料集

以下各節提供每個動作的詳細資訊。

從資料集瀏覽記錄

當您為指定的資料集選擇讀取動作時，您會看到以下頁面。

Blusam Administration Console interface for dataset management with search and filter options.

頁面是由以下項目組成：

標頭，具有：
- 資料集：資料集名稱
- 記錄大小：固定記錄長度，以位元組表示
- 總記錄：為此資料集存放的記錄總數
- 顯示組態按鈕（右側）：顯示/隱藏資料集組態的切換按鈕。一開始，組態會隱藏。使用按鈕時，您會看到組態的組態，如下圖所示。
  
  顯示組態時，兩個新按鈕：儲存和重設，分別用於：
  - 儲存此資料集和目前工作工作階段的組態
  - 將所有欄位的組態重設為預設值。
- 可設定的屬性清單，可量身打造指定資料集的瀏覽體驗。

可設定的屬性符合中所述的組態屬性BAC 專用組態檔案。請參閱該區段以了解每個資料欄和適用值的意義。您可以在這裡為資料集重新定義每個值，並為工作工作階段儲存（使用儲存按鈕）。儲存組態後，會出現類似下圖所示的橫幅。

Success message indicating configuration has been saved for the current dataset view session.

橫幅指出當您離開目前頁面時，工作工作階段會結束。

有一個額外的可設定屬性，未記錄在組態區段中：記錄大小。這用於指定指定的記錄大小，以位元組表示，這會篩選此資料集適用的遮罩：只有總長度符合指定記錄大小的遮罩才會列在資料遮罩下拉式清單中。

從資料集擷取記錄是由搜尋按鈕觸發，使用附近的所有選項和篩選條件。

第一行選項：

資料遮罩下拉式清單會顯示適用的遮罩（遵守記錄大小）。請注意，比對記錄大小不足以成為有效的適用遮罩。遮罩定義也必須與記錄內容相容。此處選擇的資料遮罩具有
最大結果：限制搜尋擷取的記錄數。將資料集的無限制（分頁）結果設為 0。
搜尋按鈕：使用篩選條件和選項啟動記錄擷取
清除遮罩按鈕：如果有的話，會清除已使用的遮罩，並將結果頁面切換回原始金鑰/資料呈現。
清除篩選條件按鈕：將清除使用過的篩選條件（如果有的話），並相應地更新結果頁面。
所有欄位切換：選取時，無論如何skip = true都會顯示以定義的遮罩項目，否則skip = true會隱藏以遮罩項目。

下一行篩選條件：可以根據從指定遮罩套用至欄位（資料欄）的篩選條件使用情況來定義篩選條件清單，如下圖所示。

篩選遮罩：要從中挑選篩選資料欄的遮罩名稱。當您選擇欄位時，會顯示適用的遮罩清單。您可以從該清單中選擇您想要的遮罩。
篩選條件欄：遮罩中的欄位名稱（資料欄），用於篩選記錄。當您選擇欄位時，會出現遮罩資料欄清單。若要填入篩選條件資料欄欄位，請選擇所需的儲存格。
篩選條件運算子：要套用至所選資料欄的運算子。下列運算子可供使用。
- 等於：記錄的資料欄值必須等於篩選條件值
- 開頭為：記錄的資料欄值必須以篩選條件值開頭
- 結尾為：記錄的資料欄值必須以篩選條件值結尾
- 包含：記錄的資料欄值必須包含篩選條件值
篩選條件選項：
- 反向：套用篩選條件運算子的反向條件；例如，「等於」被「不等於」取代；
- 忽略大小寫：忽略篩選條件運算子的英數字元比較大小寫
篩選條件值：篩選條件運算子與篩選條件資料欄比較所使用的值。

設定最少數量的篩選條件項目後（至少必須設定篩選條件遮罩、篩選條件欄、篩選條件運算子和篩選條件值），即會啟用新增篩選條件按鈕，然後按一下該按鈕，在擷取的記錄上建立新的篩選條件。頂部會新增另一個空白篩選條件列，而新增的篩選條件具有移除篩選條件按鈕，可用於隱藏指定的篩選條件：

Filter configuration interface with options for mask, column, operator, and value.

當您啟動搜尋時，篩選的結果會出現在分頁資料表中。

注意

和或會連結後續篩選條件。每個新的篩選條件定義都從設定連結運算子開始，如下圖所示。
可能沒有任何記錄符合指定的篩選條件。

否則，結果表看起來會與下圖中的結果表類似。

Data table showing transaction records with account IDs, types, and numerical data.

標頭表示符合篩選條件的記錄總數。在標頭之後，您會看到以下內容。

提醒已使用的資料遮罩（如果有的話）和篩選條件。
重新整理按鈕，可用來觸發整個結果資料表的重新整理，其中包含來自 Blusam 儲存體的最新值（因為可能已由其他使用者更新，例如）。

對於每個擷取的記錄，資料表都有一列，顯示將資料遮罩套用至記錄內容的結果。每個資料欄都是根據資料欄類型（以及使用選取的編碼）對記錄子部分的解釋。每一列左側有三個按鈕：

放大鏡按鈕：會導向顯示詳細記錄內容的專用頁面
筆按鈕：會導向記錄內容的專用編輯頁面：
垃圾桶按鈕：用於從 blusam 儲存中刪除指定的記錄

檢視記錄內容的詳細資訊：

Data mask table showing fields for a transaction record with name, type, options, and value columns.

三個切換按鈕，用於隱藏或顯示一些資料欄：
- 隱藏/顯示類型
- 隱藏/顯示顯示旗標
- 隱藏/顯示範圍
若要離開此專用頁面並返回結果資料表，請選擇關閉。
每一列代表資料遮罩中的資料欄，其中包含下列資料欄：
- 名稱：資料欄的名稱
- 類型：資料欄的類型
- 顯示：顯示指示器；如果使用定義相符的遮罩項目，則會顯示綠色檢查skip = false，否則會顯示紅色交叉
- 從 & To：記錄子部分的 0 型範圍
- 值：記錄子部分的解譯值，使用類型和編碼

編輯記錄的內容：

Data record editor showing fields for transaction account details and data.

編輯頁面類似於上述檢視頁面，但遮罩項目值可編輯。三個按鈕控制更新程序：

重設：將可編輯的值重設為初始記錄值（在任何版本之前）；
驗證：驗證遮罩項目類型的輸入。對於每個遮罩項目，將使用視覺化標籤列印驗證結果 (OK如果驗證成功，則為核取方塊，如果驗證失敗，則為ERROR紅色交叉，以及提供驗證失敗提示的錯誤訊息）。如果驗證成功，則會顯示兩個新按鈕：
- 儲存：嘗試將現有記錄更新為 Blusam 儲存
- 儲存副本：嘗試在 Blusam 儲存中建立新的記錄
- 如果成功將記錄儲存至儲存體，則會顯示訊息，且頁面會切換至唯讀模式（無法再編輯遮罩項目值）：
- 如果記錄因任何原因持續儲存失敗，則會顯示紅色錯誤訊息，並提供失敗原因。最常見的失敗案例是，儲存記錄會導致金鑰損毀（無效或重複的金鑰）。如需圖例，請參閱下列備註。
- 若要結束，請選擇關閉按鈕。
取消：結束編輯工作階段、關閉頁面，並帶您返回記錄清單頁面。

請注意：

驗證機制只會檢查遮罩項目值是否與遮罩項目類型正式相容。例如，請參閱對數值遮罩項目的失敗驗證：
驗證機制可能會嘗試自動更正無效輸入，以藍色顯示資訊訊息，指出已根據其類型自動更正值。例如，輸入 7XX0 做為數值fd_trncat_cd遮罩項目中的數值：

呼叫驗證會導致下列情況：
驗證機制不會檢查指定值在金鑰完整性方面是否有效（如果指定資料集涉及任何唯一金鑰）。例如，儘管驗證成功，如果提供的值導致無效或重複的金鑰情況，持久性將會失敗，並顯示錯誤訊息：

刪除記錄：

若要刪除記錄，請選擇垃圾桶按鈕：

將記錄載入資料集

若要將記錄載入資料集，請選擇動作，然後選擇載入。

隨即出現具有載入選項的視窗。

一開始，伺服器負載和藍上負載按鈕都會停用。

讀取參數：

記錄長度類型：
- 固定或可變記錄長度：使用選項按鈕指定舊版資料集匯出是否使用固定長度記錄或可變長度記錄（記錄預期以 RDW 位元組開頭）。如果您選擇固定，則必須在輸入欄位中將記錄長度指定為正整數值（以位元組為單位）。值應該由來自資料集的資訊預先填入。如果您選擇變數，則指定的輸入欄位會消失。
- 檔案選擇：
  - 本機：從本機電腦選擇資料集檔案，使用下面的檔案選擇器（注意：檔案選擇器使用瀏覽器的地區設定來列印其訊息 -- 此處為法文，但在您這方面可能看起來不同，這是預期的）。進行選取後，視窗會更新為資料檔案名稱，並啟用伺服器上載入按鈕：
    
    選擇在伺服器上載入。進度列到達結尾後，Load on Blusam 按鈕就會啟用：
    
    若要完成 Blusam 儲存的載入程序，請選擇 Load on Blusam。否則，請選擇 Cancel (取消)。如果您選擇繼續載入程序，載入程序完成後，右下角會顯示通知：
  - 伺服器：選擇此選項會在伺服器上載入按鈕消失時顯示輸入欄位。輸入欄位是您必須在 Blusam 伺服器上指定資料集檔案的路徑（假設您已先將指定檔案傳輸至 Blusam 伺服器）。指定路徑後，Load on Blusam 會啟用：
    
    若要完成載入程序，請選擇載入藍本。否則，請選擇 Cancel (取消)。如果您選擇繼續載入，載入程序完成後就會顯示通知。通知與瀏覽器的負載不同，因為它會顯示資料檔案伺服器路徑，後面接著伺服器的字詞：

從資料集匯出記錄

若要匯出資料集記錄，請選擇目前資料集列中的動作，然後選擇匯出：

出現下列快顯視窗。

選項：

若要：選項按鈕選擇，以選擇匯出目的地，無論是在瀏覽器 (本機（在瀏覽器上）) 中下載，或是託管 BAC 應用程式之伺服器上的特定資料夾。如果您選擇使用伺服器選擇匯出，則會顯示新的輸入欄位：

Radio button for selecting Server as the export destination, with an input field for target folder.

如輸入欄位右側的紅色星號所示，您必須在伺服器上提供有效的資料夾位置（傾印按鈕會在未提供資料夾位置時處於非作用中狀態）。

若要匯出至伺服器，如果您計劃在匯出後操作匯出的資料集檔案，您必須擁有足夠的伺服器檔案系統存取權。

壓縮傾印：產生壓縮封存而非原始檔案的核取方塊。

選項：若要在可變長度記錄資料集的情況下，在匯出的資料集的每個記錄開頭包含記錄描述項字詞 (RDW)，請選擇包含 RDW 欄位。

若要啟動資料集匯出程序，請選擇傾印。如果您選擇匯出至瀏覽器，請檢查匯出資料集檔案的下載資料夾。檔案的名稱將與資料集相同：

File name AWS.M2.CARDDEMO.CARDXREF.VSAM.KSDS with details on size and type.

請注意：

對於 KSDS，記錄將按照主索引鍵順序匯出。
對於 ESDS 和 RRDS，記錄將按照 RBA （相對位元組地址）順序匯出。
對於所有資料集類型，記錄都會匯出為原始二進位陣列（不會進行任何種類的轉換），以確保與舊版平台的直接相容性。

從資料集清除記錄

若要清除資料集中的所有記錄，請選擇動作，然後選擇清除：

從資料集移除所有記錄後，會出現下列通知。

Green success notification showing "Succeeded" with a checkmark and data set details.

刪除資料集

若要刪除資料集，請選擇動作，然後選擇刪除：

刪除資料集後，會出現下列通知：

Green success notification with checkmark indicating data set deletion completed.

大量操作

資料集有三種大量操作可用：

匯出
Clear
Delete

大量操作只能套用至資料集的選擇（至少需要選取一個資料集）；選取資料集是透過資料集清單資料表左側的勾選選擇核取方塊來完成。選取至少一個資料集將啟用大量動作下拉式清單：

Dropdown menu showing Bulk Actions options: Export, Clear, and Delete.

除了特定動作適用於資料集的選擇，而不是單一資料集之外，這些動作與上述動作類似，因此請參閱專用動作文件以取得詳細資訊。快顯視窗文字內容將略有不同，以反映大量性質。例如，嘗試刪除數個資料集時，快顯視窗會如下所示：

建立操作

建立單一資料集

選擇動作，然後選擇建立單一資料集：

Dropdown menu showing "Bulk Actions" and "Create Actions" buttons with options.

然後，資料集建立表單會顯示為快顯視窗：

Data set creation form with fields for name, record size, type, and other configuration options.

您可以為資料集定義指定下列屬性：

啟用和停用命名規則：使用「停用命名規則/啟用命名規則」切換小工具來停用和啟用資料集命名慣例。建議您將切換保留在預設值上，並啟用資料集命名規則（切換小工具應顯示「停用命名規則」)：
資料集名稱：資料集的名稱。如果您指定的名稱已在使用中，則會出現下列錯誤訊息。

如果已啟用，名稱也必須遵守命名慣例：
記錄大小上限：這必須是正整數，代表具有固定長度記錄之資料集的記錄大小。對於具有可變長度記錄的資料集，您可以將其保留空白。
固定長度記錄：指定記錄長度是固定的還是變數的核取方塊。如果選取，資料集將具有固定長度的記錄，否則記錄長度將是可變的。

當您將舊版資料匯入變數長度記錄資料集時，提供的舊版記錄必須包含記錄描述項 (RDW)，以提供每個記錄的長度。
資料集類型：用於指定目前資料集類型的下拉式清單。支援下列類型。
- ESDS
- LargeESDS
- KSDS
對於 KSDS，您必須指定主索引鍵：

針對主索引鍵，指定下列項目：
- 名稱：此欄位為選用。預設值為 PK。
- 位移：記錄中主索引鍵的 0 型位移。位移必須是正整數。此欄位為必填。
- 長度：主索引鍵的長度。此長度必須是正整數。此欄位為必填。
對於 KSDS 和 ESDS，您可以選擇選擇備用金鑰標籤前面的加號按鈕來定義備用金鑰的集合。每次選擇該按鈕時，新的備用金鑰定義區段會出現在資料集建立表單中：

對於每個備用金鑰，您需要提供：
- 名稱：此欄位為選用。預設值為 ALTK_#，其中 # 代表從 0 開始的自動遞增計數器。
- 位移：記錄中替代索引鍵的 0 型位移。必須是正整數。此欄位為必填。
- 長度：備用金鑰的長度。此長度必須是正整數。此欄位為必填。
- 唯一：核取方塊，指出替代索引鍵是否接受重複的項目。如果選取，備用金鑰將定義為唯一（不接受重複的金鑰項目）。此欄位為必填。
若要移除備用金鑰定義，請使用左側的垃圾桶按鈕。
壓縮：指定是否使用壓縮來存放資料集的核取方塊。
啟動時啟用快取：核取方塊，指定是否應在應用程式啟動時將資料集載入快取。

指定屬性定義之後，請選擇建立以繼續：

Data set creation form with fields for name, size, type, keys, and other settings.

建立視窗將會關閉，並顯示顯示資料集清單的首頁。您可以檢視新建立資料集的詳細資訊。

Data set details showing primary and alternative keys with their properties.

在多結構描述模式中建立單一資料集

資料集可以在多結構描述模式中建立，方法是在資料集名稱前面加上結構描述名稱，後面接著管道 (|) 符號（例如，schema1|AWS.M2.CARDDEMO.ACCTDATA.VSAM.KSDS)。

注意

用於建立資料集的結構描述應在application-main.yml組態中指定。如需詳細資訊，請參閱多結構描述組態屬性。

Data set creation form with fields for name, size, type, and other configuration options.

如果未提供結構描述字首，則會在 Blusam 資料來源組態中 Blusam 資料來源 URL 中指定的預設結構描述中建立資料集。如果 Blusam 資料來源 URL 中未指定結構描述，則預設會使用「公有」結構描述。

注意

在多結構描述模式中，BAC 主控台會在第一欄中顯示資料集的結構描述資訊。

Blusam Administration Console showing configuration details and dataset information.

從 LISTCAT 建立資料集

此功能可讓您利用使用 BluInsights Transformation Center 在 BluAge 轉換程序期間建立的 LISTCAT JSON 檔案，因為剖析了舊版平台的 LISTCAT 匯出：LISTCAT 匯出會剖析並轉換為包含資料集定義的 JSON 檔案（名稱、資料集類型、金鑰定義，以及記錄長度是固定的還是可變的）。

擁有 LISTCAT JSON 檔案可讓您直接建立資料集，而無需手動輸入資料集所需的所有資訊。您也可以直接建立資料集的集合，而不必逐一建立資料集。

如果您的專案沒有可用的 LISTCAT JON 檔案（例如，因為轉換時沒有可用的 LISTCAT 匯出檔案），只要您遵守附錄中詳述的 LISTCAT JSON 格式，您一律可以手動建立一個。

從建立動作下拉式清單中，選擇從 LISTCAT 建立資料集。

將顯示以下專用頁面：

Interface for creating datasets from LISTCAT files, with options for file source and folder path.

在此階段，載入按鈕會停用，這是預期的。

使用選項按鈕指定您要提供 LISTCAT JSON 檔案的方式。有兩個選項：

您可以使用瀏覽器上傳 JSON 檔案。
您可以從伺服器上的資料夾位置選取 JSON 檔案。若要選擇此選項，您必須先將 JSON 檔案複製到伺服器上具有適當存取權限的指定資料夾路徑。

在伺服器上使用 JSON 檔案

在伺服器上設定資料夾路徑，指向包含 LISTCAT JSON 檔案的資料夾：
選擇載入按鈕。所有已辨識的資料集定義都會列在表格中：

每一列代表資料集定義。您可以使用垃圾桶按鈕從清單中移除資料集定義。

重要
從清單中移除是立即的，沒有警告訊息。
左側的名稱是連結。您可以選擇它來顯示或隱藏資料集定義的詳細資訊，這是可編輯的。您可以自由修改定義，從剖析的 JSON 檔案開始。
若要建立所有資料集，請選擇建立。所有資料集都會建立，並顯示在資料集結果頁面上。新建立的資料集都會有 0 筆記錄。