資料發布功能
============

.. _adding_a_new_dataset:

新增資料集
----------

.. note::

   您必須擁有使用者帳號方能新增資料集。

**步驟 1**. 透過下列兩種方式可以連結至「新增資料集」頁面：

a) 點選於頁面上方的「資料集」連結，於接下來顯示的資料搜尋頁面上方即可看見「新增資料集」連結。

b) 點選頁面上方的「專案」連結，接下來請選擇您所要發布資料集所隸屬的專案，若您的使用者帳號屬於該專案的成員，則您可以點選在資料集搜尋顯示頁面上的「新增資料集」進行發布。

**步驟 2**. 建立資料集後設資料，可包含附錄 :ref:`dataset_fields` 之欄位：

.. image:: /images/add_dataset_1.png

.. note::

   上述所介紹的欄位，實務上仍建議至少填寫資料描述與授權欄位。請您需確認「專案」欄位所選擇的專案為正確，因為在後續完成資料發布的過程中，本欄的資訊將無法被修改（需後續使用編輯資料集功能）。

**步驟 3**. 當您填寫本頁之後設資料完畢後，請選取「下一步：新增資料」按鈕。或者您可選擇「取消」按鈕，放棄本頁所編輯之內容。

.. _add_resource:

**步驟 4**. 平台介面接著將顯示「新增資料」頁面。

  .. image:: /images/add_dataset_2.png

本頁面將引導您進行新增一個或多個屬於該筆資料集的「資源」。在「檔案」項目上，您可以選擇上傳一個檔案或是新增該筆檔案的連結。

* 若您所要新增的資料為線上資源或 API，請在「檔案」項目上點選「連結」鈕，並將線上資源的連結位址填入。

* 若您所要新增的資料位於本機，請在「檔案」項目上點選「上傳」連結，並選擇欲上傳的資料。

**步驟 5**. 新增關於「資源」的描述（請參閱附錄 :ref:`resource_fields` ），本平台並不強制要求您輸入這些資訊，但實務上仍建議您填寫。

**步驟 6**. 若您有其他多筆資源欲新增，請點選「儲存並新增其他項目」按鈕，來新增一筆新的資源。

**步驟 7**. 若您已完成資源的新增，點選「結束」按鈕，本平台將建立該筆資料集並顯示結果。至此步驟您已成功完成資料集的建立。

您現在應該可以於本平台的搜尋框中，透過輸入資料集的標題、或是其描述欄位內的相關文字來搜尋得到您所建立的資料集。關於搜尋資料的相關參考資訊請參考 :doc:`finding-data` 部分。

.. _adding_a_dataset_to_topic:

本平台補充功能——將資料集加入選定的主題
--------------------------------------

「主題」與「專案」主要之差別在於，「主題」機制之劃分不具有資料權屬之特性（詳細可參考 :ref:`creating_an_organization` ），亦即在本平台內一份資料集僅可屬於單一「專案」內，且該專案可以決定該資料集公開與否或專案內成員編輯權限；相較之下，「主題」僅將資料集進行分類，且一個資料集不限定僅屬於單一主題。

本平台參考 `英文維基百科 <https://en.wikipedia.org/wiki/Portal:Contents/Categories>`_ 之分類，建立下列主題：

* 一般性參考資料
* 文化與藝術
* 地理與地方
* 健康與健身
* 歷史與事件
* 人類活動
* 數學與邏輯
* 自然與物理科學
* 人群與個人
* 哲學與思想
* 宗教與信仰
* 社會與社會科學
* 技術與應用科學

您亦可以選用 `ISO19115 <https://www2.usgs.gov/science/about/thesaurus-full.php?thcode=15>`_ 後設資料標準之主題類別：

* **農業相關類 (Farming)**：與動物飼養和/或植物種植有關之主題，例如農耕、灌溉、水栽法、農園、畜牧、病蟲害和家畜。
* **生物生態類 (Biota)**：與自然環境中植物群和/或動物群有關之主題，例如野生動物、植被、生物科學、生態學、荒漠、海洋生活、溼地、棲息地。
* **土地邊界類 (Boundaries)**： 與土地權利描述有關之主題，例如行政邊界界線。
* **氣候氣象類 (Climatology Meteorology Atmosphere)**：與大氣的處理過程與現象有關之主題，例如雲、天氣、氣候、大氣條件、氣候改變、降雨量。
* **經濟活動類 (Economy)**：與經濟活動和狀態有關的主題，例如生產、勞動、稅收、貿易、工業、觀光和生態旅遊、林業、漁業、商業或補狩業、 探測和資源開發，如礦物、石油或天然氣。
* **高程資訊類 (Elevation)**：高於或低於海平面的高程資訊，例如高度、海洋探測、數值高程模型、坡度。
* **環境活動類 (Environment)**：與環境資源、保護和保存有關的主題，例如環境汙染、資源浪費、環境衝擊評估、環境監控風險、天然保育區、景觀。
* **地球科學相關類 (Geoscientific Information)**：與地球科學有關之主題，例如地球物理學的地物特徵、地質學、 礦產資源、組合科學、地球岩盤的組成起源、地震危機、火山活動、山崩、重力資訊、土壤、永久凍土、水文地質學、侵蝕。
* **健康衛生類 (Health)**：與健康、健康服務、人文生態學與環境安全有關之主題，例如疾病與身體不適、影響健康的因素、保健法、藥物濫用、身心健康、健康服務。
* **地表覆蓋資訊類 (Imagery Base Maps Earth Cover)**：與底圖有關之主題，例如地表、地形圖、影像、未分類的影像、文字註記。
* **軍事情報類 (Intelligence Military)**：與軍事基地、結構、活動有關之主題，例如兵營、訓練場、軍事運輸、情報搜集。
* **水文資訊類 (Inland Waters)**：與內陸地區的水特徵物、排水系統和其特性有關之主題，例如河流與冰河、鹽水湖、水資源利用計畫、水壩、水流、水災、水質、水道圖。
* **位置資訊類 (Location)**：與位置資訊和服務有關之主題，例如地址、控制網、控制點、郵遞區號及服務。
* **海洋資訊類 (Oceans)**：與鹽水水體的特徵物和其特性（包含內陸地區）有關之主題，例如潮汐、受潮汐影響的浪潮、海岸資訊、暗礁。
* **土地使用與規劃類 (Planning Cadastre)**：與土地未來之使用資訊有關之主題，例如土地使用圖、都市計畫圖、地籍調查、土地所有權。
* **社會文化類 (Society)**：與社會文化特性有關之主題，例如社會福利、人類學、考古學、教育、傳統信仰、禮俗習慣、人口統計資料、娛樂活動、社會影響的評價、犯罪、司法審判、人口普查情報。
* **人工設施類 (Structure)**：與人工設施有關之主題，例如建築物、博物館、教堂、工廠、住家、紀念碑、商店、塔樓。
* **交通資訊類 (Transportation)**：與運輸有關之主題，例如道路、機場/航線、運輸路線、隧道、航海圖、飛機或船之位置、航圖、鐵路。
* **公共設施類 (Utilities Communication)**： 與能源、廢棄物系統和公共通訊服務有關之主題，例如水利發電、地熱發電、太陽能與核能、水質淨化與供給、污水收集處理、電力和天然氣供給、數據交換、長途電信、無線電、通信網路。

將資料集加入相關主題群組前，您必須先完成資料集的完整發布（即完成 :ref:`adding_a_new_dataset` 內容所述步驟），接著執行下列步驟：

* 前往資料集頁面（可藉由輸入關鍵字來找到您想修改的資料集）。

* 在資料集顯示頁面切換至「主題」頁籤。

    .. image:: /images/add_topic_1.png

+ 選擇欲加入至該資料集的主題，點選「加入主題」鈕，即可加該主題於資料集內。

    .. image:: /images/add_topic_2.png

.. _UI_editing_extend:

本平台補充功能——填寫輔助功能介紹
--------------------------------

.. _UI_editing_extend_time:

* **時間資訊（資料內容時間）**

本平台所定義之時間資訊為指資料內容所描述之時間範疇，並非資料產生或完成之日期。相關後設資料項目包含：

  * *時間解析度* -- 時間解析度為表示資料內容對應時間所能精確描述之程度。可以指「相鄰兩次觀測的最小時間間隔」，或「在不確定開始與結束的明確時間時，最大的誤差範圍」。候選項目包含：年、月、日。

  * *起始、結束時間* -- 為資料集之起始、結束時間點，接受的格式為 YYYY、YYYY-MM、YYYY-MM-DD。

.. image:: /images/temporal_info.png

.. _UI_editing_extend_spatial:

* **空間資訊**

本平台所定義之空間範圍為指資料集內容所約略對應之真實世界空間範圍，設計主要考量為用於空間索引，後續可進行空間搜尋操作，其內容須符合 GeoJSON 格式標準，但對一般使用者而言直接產出 GeoJSON 格式內容並不容易，因此在介面上，本平台設計以下兩種方式：

   * *使用圖台填寫* -- 本平台提供地圖介面，讓使用者自行描繪資料集對應之空間範圍，並自動產生描繪範圍之 GeoJSON 內容。

   * *使用四至範圍填寫* -- 若使用者已具有代表資料集空間範圍之四至經緯度坐標（即東西經度、南北緯度），則可填寫於對應之空間範圍欄位內，填寫完畢後點選「使用上述四至範圍填寫空間範圍」按鈕，系統將根據四至經緯度坐標自動產生對應之 GeoJSON 內容。

您亦可於此填寫資料集之空間解析度。

.. image:: /images/spatial_info.png

* **使用快捷方式代入帳號資訊**

若使用者即為資料集之聯絡人，本平台提供一便捷的方式自動代入使用者帳號的個人資訊，點選「使用您的帳號資訊填入聯絡人與電子郵件」鈕，系統將自動填寫聯絡人及聯絡人的電子郵件欄位（帳號個人資訊請參考 :ref:`managing_profile` 內容）。

.. image:: /images/profile_input.png

.. _editing-a-dataset:

編輯資料集
----------

您可以編輯您所建立的資料集或是您所屬於的專案內的資料集。若一個資料集不屬於任一專案，則可被任何使用者帳號編修。

#. 前往欲編輯資料集其所屬頁面（可藉由輸入關鍵字來找到您想修改的資料集）。

#. 點選頁面右上方的「管理」功能鈕。

#. 顯示資料集編輯的頁面，在「編輯中繼資料」頁籤中，您可以編輯頁面中任何的欄位內容（如：標題、摘要等）、變更資料集是否為公開。關於欄位的介紹可請參考 :ref:`adding_a_new_dataset` 部分。

#. 當您完成編輯後，點選「更新」以儲存您剛才所編輯的內容。

.. image:: /images/edit_dataset.png

.. _dataset_collaborators:

資料集協作者
------------

除傳統以專案作為權限管理的方式，本站亦提供「資料集協作者」功能，可針對單一資料集進行權限控制。
您可以使用此功能修改專案成員存取資料集的權限，或賦予不屬於專案之成員存取個別資料集的權限。

欲進入協作者管理頁面，請點選資料集編輯頁面上方的「協作者」頁籤。

預設情況下，只有資料集所屬專案的管理者可以新增協作者。協作者有以下兩種身份：

**成員** 可以：

* 瀏覽設定為非公開的資料集。

**編輯** 擁有 **成員** 的所有權限，加上：

* 將資料集設定為公開或非公開。
* 編輯或刪除資料集（包括將資料集加入專案）。

新增、刪除及修改資源
--------------------

#. 前往欲編輯資料集其所屬頁面（參考上述步驟 1-2）。

#. 在「資料」頁籤中，您可以進行該資料的編輯，您可以選擇一筆資料進行編輯或刪除，若您想為該筆資料集新增一筆資源，可點選「加入新資源」功能鈕。

#. 點選一筆資源進行編輯後，您可以修改該筆資源的描述資訊、變更資源的連結或上傳新的檔案（詳細請參考上述 「新增資源」步驟 4-5）。

#. 當編輯完成後，點選「更新資源」鈕即可完成更新；若您想刪除該筆資源，則點擊「刪除」按鈕。

刪除資料集
----------

#. 前往欲編輯資料集其所屬頁面（參考上述「編輯資料集」）。

#. 點選「刪除」按鈕。

#. 頁面將顯示確認刪除資料集對話框，點選「確定」即可刪除該筆資料集內容（後設資料與資源）。

.. note::

   上述「刪除資料集」功能並非真正將資料集自本平台移除，而是將該筆資料集隱藏。因此刪除的資料集將無法透過介面被搜尋或查找得到。但若是於網址列上直接輸入該筆資料集之網址，您仍能看到該筆資料集的資訊（需具對應之權限）。若您需要「完整」自本平台移除該筆資料集，請聯繫系統管理員為您執行。

.. _creating_an_organization:

建立專案
--------

一般而言，每筆資料集都有其所屬的「專案」，而每個專案由不同的成員所組成，專案內的成員可以編輯專案內的資料集或發布新的資料集，而在本平台中，專案管理者可以設定不同權限予不同的專案成員，例如：有些成員僅允許他有瀏覽專案內資料集的權限，特定使用者則具備發布與編輯資料集的權限。每一個專案都有其所屬頁面，使用者可以在專案頁面內查看該專案的資訊並搜尋專案內的資料。因此，本平台的專案機制提供特定單位控管其內部發布政策。

建立專案流程：

#. 點選頁面上方的「專案」頁籤。

#. 點選搜尋列下方的「建立專案」功能鈕。

#. 將顯示建立專案的頁面。

#. 您必須輸入專案的名稱，您可以選擇是否建立專案描述或為專案加入一張代表圖片。

#. 點擊「建立專案」按鈕，將建立該專案並顯示該專案的首頁內容（該專案內目前應無任何資料集）。

.. image:: /images/create_project.png

您現在可以設定專案內其他成員之使用權限，請參考下段 :ref:`managing_an_organization` 內容；您也可以建立專案內的資料集，請參考上述 :ref:`adding_a_new_dataset` 內容。

.. note::

   您可以參考 :site_url:`既有專案 <organization>` 填寫您的專案資訊。另外，根據管理員的設定，並非每個帳號都有建立新專案的權限，當您想建立新專案但不具權限時，您可以聯繫系統管理員。

.. _managing_an_organization:

管理專案
--------

當您建立一個新專案時，本平台會自動將您設定為該專案之「管理者」。在專案首頁內您可以看到搜尋框上方之「管理」功能鍵，當您點選該功能鍵即可進入專案管理介面。專案管理介面包含下列兩頁籤功能：

* *資訊* -- 本頁籤內您可以編輯專案的資訊（名稱、描述、專案圖片）。

* *成員* -- 本頁籤內您可以新增、移除專案成員或變更專案成員之權限（您需要事先知道欲加入專案成員者於本平台之使用者帳號）。

.. image:: /images/manage_project.png

本平台包含下列三種專案權限：

* *成員* -- 可以瀏覽專案內之非公開資料集。

* *編輯者* -- 可以編輯或新增專案內資料集。

* *管理者* -- 可以新增、刪除專案成員，或變更成員權限。

邀請專案成員（共同協作者）
--------------------------

若您需要與他人共同協作編修資料集，可由您的專案頁面右上的「管理」按鈕進入專案管理頁面，並點選「成員」頁籤進入成員管理頁面，如下圖所示：

.. image:: /images/invite_user.png

您可於「已存在的使用者」欄位，以帳號搜尋並選取欲加入專案之本平台使用者，或輸入其電子郵件位址以邀請其加入本平台。您並可設定該使用者於專案之角色，按下右下「新增成員」按鈕後，系統即會將該使用者加入您的專案。