DCam使用者指南──附錄C-匯入資料夾，取自試算表

2024年3月17日

DCam 匯入資料夾功能讓你可以用試算表中的資料，在一個步驟中建立許多資料夾。 此匯入過程如下所示：

  1. 從檔案館中獲取描述要成像文件的中繼資料。
  2. 這些資料在試算表中被整理成一排排 的表格。
  3. 該表格已儲存至 .csv 檔。
  4. .csv 檔會匯入 DCam，以建立資料夾。

部分：

著手開始
Dcam目錄與資料夾
建立匯入資料夾範本檔案
匯入資料夾
時發生錯誤處理錯誤記錄
欄位ID（欄位標題）
建立Dcam目錄
開啟和儲存。Csv檔案與 OpenOffice
匯入影像後匯入資料夾

null

著手開始

試算表軟體

建議的電子表格軟體是OpenOffice Calc。這項工具可以以保存Unicode（UTF-8）延伸字元的.csv表格來儲存電子錶格數據。

注意： Microsoft Excel不會保存延伸字元。 如果資料中沒有長字元，那麼Excel可能就適合。 其他能保存擴充字元的試算表軟體也能使用。

資料組織

這些資料是以行列和欄位的表格來編排的。 每一行都代表一個資料夾。 每個欄位代表資料夾的數據欄位。

表格的第一行包含每個欄位的欄位識別碼。 欄位 ID 能辨識欄位中的資料，也會被稱為欄位標題。 表格中的欄位順序是任意的。

以下是一個範例表格：

Dcam目錄與資料夾

DCam 資料夾屬於目錄。 例如，在使用 DCam 建立選項建立資料夾時，該資料夾最初會繼承與其相關的目錄中的值。 你可以修改這些值，使每個資料夾都是獨一無二的。 （見建立包含DCam螢幕快照的DCam目錄。）

使用匯入資料夾功能，新的資料夾會匯入目錄，屬於該目錄。

建立匯入資料夾範本檔案

若要建立.csv檔案範本，請從更多目錄選項中選取新的匯入資料夾範本選項。

儲存為對話框讓.csv檔可以儲存在慣用的地點，並有慣用名稱。

默認檔名是：FoldersForImport_ProjectID_ListingID.csv

ProjectID——是一個縮短的專案ID.ListingID——是目錄ID

（號碼）。

可以變更檔名。 然而，專案ID_ListingID和the.csv檔的擴展應保存下來。 以下是可接受的名字：

Xyz-Archive_ProjectID_ListingID_part1.csv

當你建立範本.csv時，會產生一個空白的.csv檔案，第一行包含欄位-ID。

填寫表格

可以用資料來填充表格，以識別每個資料夾。 不需要提供每個欄位 ID。 以下是一個簡單的例子：

如需填寫表格的更多詳細資料，請見欄位ID（欄位標題）。 使用 OpenOffice Calc 開啟和儲存.csv檔案的步驟，可在開啟和儲存.csv檔與 OpenOffice 中找到。

匯入資料夾

若要開始匯入資料夾的程式，請選取匯入資料夾選項──這是更多目錄選項之一。

選取含有匯入資料夾的檔案對話框，會允許選取.csv檔案。

當你點選開啟時，匯入資料夾的程式就會開始。

匯入程式如下：

  • 請檢查. csv 檔的正確性。
  • 驗證資料：
    • 請確定有必要欄位。
    • 請確認欄位是有效的。
  • 確保要匯入的資料夾不會與其他資料夾相衝突。 見獨特的欄位驗證中的獨特性限制。
  • 如果沒有錯誤，請建立資料夾。

在匯入過程中會顯示進度對話框。 如果沒有錯誤，就會顯示匯入資料夾結果對話框，而資料夾會出現在管理專案、目錄和資料夾畫面的資料夾部分。

欄位-ID

註：欄位ID清單（欄位標題）及其使用說明可在欄位ID（欄位標題）中找到。

表格的第一個部分列出了每個資料夾的基本欄位。 其中有些欄位是必填的，有些則是選填的。

第二部分列出了目錄中常出現的自選欄位。 自選欄位不保證從目錄到目錄都是一樣的。

注：在紀錄描述部分的DCam中會顯示自選欄位（請參照建立DCam目錄中的圖4）。

關於欄位-ID

  • 每個欄位 ID 都是獨一無二的。
  • 只會匯入目錄的 FEX 範本所定義的欄位-ID。
  • 欄位 ID 必須只出現在表格中。
  • 並非所有的欄位 ID 皆為必填。

未知 的欄位會被忽略。 未 命名的欄位會被標示為錯誤。 不支援使用者定義的欄位ID。

處理錯誤日誌時發生錯誤

錯誤發生時，會顯示在對話框中。 例如，下表中有數個遺漏的必要欄位：

嘗試匯入此檔案會導致下列錯誤：

此錯誤資料也會儲存在 .log 檔中。 日誌檔案的名字與.csv匯入檔案的名字相同，名字附有_nn，.log為擴展名。

注：nn是一個數位，隨著每次匯入的嘗試而持續增加。

欄位ID（欄位標題）

注： 為了方便起見，在出現欄位 ID 的字詞之間可能會有空格，也可能沒有空格。 例如，開始日期也可能顯示為開始日期：這有助於讀取和包裝欄位標題，使試算表中的欄位變窄。

日期欄位

日期欄位為： BeginDate、EndDate、BeginCirca 和 EndCirca

  • 只有 BeginDate 為必填。
  • 當指定結束日期時，就會形成 日期範圍 。

  • 開始日期和結束日期必須是 文字 欄位，而非電子表格 日期 欄位。

    注： 有些電子表格應用程式將日期欄位限制在1900年以上。

  • BeginDate 和 EndDate 的 精度 和 格式 須遵循 ISO 8601 的標準：
    • YYYY—年份
    • YYYY-MM—年份和月份
    • YYYY-MM-DD—年份、月份和日期

    注： YYYY、MM 和 DD 必須是數字。 （請勿使用語言依賴的月份名稱。）

  • BeginCirca 和 EndCirca 指出日期是否為 確切 或 大約 日期。 是或Y表示 大約。 「No」或「N」 代表確切日期。 如果日期是確切日期，這些欄位可以留白或完全省略。

地點

若是地點，請輸入DCam中地點右上角所列之地點的重新ID號碼。 若要判定正確的 RepID，請使用現有的DCam、搜尋地點，並使用所要位置的識別碼。 例如：

RepID=392685是蒙哥馬利，印第安那，美國

電子表格會支援一個臨時地點，意思是列在已列出的 RepID 中尚未建立的地點。 如果你需要使用臨時地點，請在 csv 檔案中使用下列標題：

  • 臨時場所
  • 臨時職業語言
  • 臨時居所

紀錄類型

對於紀錄類型，請輸入 CVRecordTypeConceptID 的號碼--CV 代表控制詞彙。 此ID會列在DCam中紀錄類型方塊的右上角。

若要判定正確的CVRecordTypeConceptID，請使用DCam，搜尋紀錄類型，並使用ID。

在上述範例中，紀錄類型下拉式清單會顯示一份選擇清單：

如有需要，可以加入其他的紀錄類型，也可以在CVRecordTypeConcept2透過CVRecordTypeConcept9指定。

初級會語言或其他語言

這些欄位會指定與資料夾內容相關的語言。 初級會語言只能指定1種語言，例如：西班牙文。 次要語言可以是以逗號分開的語言為零或更多，例如英語、義大利語、葡萄牙語。

有效的語言可在DCam資料夾建立畫面的初級會語言下拉式選單中找到。 

表格驗證

  • 必須存在必填欄位的欄目。
    • RecordTitle
    • VolumeID
    • BeginDate
    • EndDate
    • 檔案庫/會議號碼
    • CVRecordTypeConceptID1
    • RepID
    • PrimaryLanguage
  • 沒有重複的欄位-ID

欄位驗證

  • 必填欄位不能為空（或空白）。
    • RecordTitle
    • VolumeID
    • BeginDate
    • EndDate
    • 檔案庫/會議號碼
    • CVRecordTypeConceptID1
    • PrimaryLanguage
  • 日期欄位必須有效。
    • BeginDate and EndDate必須能被比喻為 ISO-8601 日期。
    • 必須是有效的日期。 例如，1950-14和1950-02-31都是不正確日期。
    • EndDate必須晚于或與開始日期相同，不能在未來。
    • BeginCirca和 EndCirca必須是空白的，或是其中一項定義值。
  • PrimaryLanguage 或 AdditionalLanguages 必須是有效的值。

唯一欄位驗證

  • RecordTitle、VolumeID 和日期欄位的組合必須是獨一無二的。 在DCam資料庫中，所有屬於專案的資料夾都會測試其獨特性。

    注：針對獨特的測試會與（a）所有即將匯入的資料夾相違背，（b）資料庫中已存在的所有資料夾。

  • 檔案庫/會議號碼
    • 如果有提供，則必須是獨一無二的。
    • 如果沒有提供或沒有參考編號，請點選文本欄位下方 的沒有檔案庫參考編號 複選框。
    • 在 DCam 資料庫中，所有屬於該專案的資料夾中都有經過唯一性測試。

建立Dcam目錄

紀錄標題、冊次指定和日期是必要欄位。 檔案庫參考編號、地點、語言和紀錄類型欄位（如下所示）亦為必填。

紀錄類型和紀錄限定下拉式選單是與紀錄類別相關的專案。

可斟酌顯示的欄位如下。

 

開啟及儲存。有 OpenOffice 的 Csv 檔案

儲存 OpenOffice Calc 工作單作為 csv 檔（UTF8 中的編碼）

  1. 建立工作單。
  2. 在檔案選單中，按一下 另存為。
  3. 在儲存檔案對話框中，請確保您已設定下列選項。
    1. 儲存類型 = Text CSV (.csv) (*.csv)
    2. 編輯篩選器設定 = 已勾選
  4. 如果出現下列對話方塊，請選取 保留目前的格式 ，將檔案儲存為 csv 檔。
  5. 在匯出文字檔的對話框中，請確定您已設定下列選項：
    1. 字元集 = Unicode （UTF-8）
    2. 欄位分隔符號 = ， （逗號）
    3. 文字劃界者= 「 （雙引言）
    4. 儲存所示之儲存格內容 = 已勾選

使用 OpenOffice Calc 開啟或編輯現有的 csv 檔（UTF8 中的編碼）

  1. 在檔案選單中，按一下 開啟。
  2. 選取 csv 檔。
  3. 在匯入文字對話框中，請確保您已設定下列選項。
    • 字元集 = Unicode （UTF-8）
    • 起始橫列 = 1
    • 分隔方式 = 已選取
      • 逗號 =已勾選
      • 文字劃界者= 「 （雙引言）
      • 引述欄位為文字 = 已勾選
  4. 按一下 確定。
  5. 進行編輯。
  6. 在檔案選單中，按一下 儲存。
  7. 如果出現下列對話方塊，請選取 保留目前的格式 ，將檔案儲存為 csv 檔。

匯入資料夾後匯入影像

匯入資料夾後，若要匯入影像，請從試算表中建立許多資料夾，然後將影像匯入已建立的資料夾中。

概覽

匯入資料夾的功能可讓你使用試算表中的資料，在單一步驟中建立多個資料夾。 這項功能已增強，讓你可以為每個資料夾指定一個包含影像的名錄。 建立資料夾後，DCam 會開始將影像匯入新建立的資料夾中。

指定影像來源

以下是一個範例表格，代表匯入資料夾 .csv 檔的內容。 ImageImportSource 欄位指出包含與資料夾有關聯的影像名錄。 此名錄必須存在，且必須包含影像。

匯入此表格時，會建立各個資料夾。 之後，每個有 ImageImportSource 名錄的資料夾都會建立匯入行動，並放在DCam匯入佇列中。

建立資料夾和匯入行動後，匯入資料夾結果對話方塊就會出現。

影像匯入

在第一個匯入行動被置入匯入佇列之後，DCam 匯入程式就會立即開始匯入影像到資料夾中。 各個匯入行動會一一處理，直到所有的資料都處理好為止。

欄位標題和選項

下表描述與匯入影像相關的欄位標題和選項：

例如：