---
schema_version: "1"
id: ae7928570c5426de60506e5f9acebfe0427604d1a32795f6100db46678b802ac
title: Web-data-connector-settings 實體
collection: tableau
version: next
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/next/zh-tw/server-linux/entity_wdc.md
canonical_url: https://help.tableau.com/v0.0/server-linux/zh-tw/entity_wdc.htm
source_site: help.tableau.com
content_type: documentation
content_hash: dc653a0ebe9d174a822c84af7b4284659b10626b513e789c2ebb5995045cf76f
description: Reference for the web-data-connector-settings entity to manage WDC settings via JSON.
---
[跳至主要內容](#main-content)

# Web-data-connector-settings 實體

此實體用於管理 Web 資料連接器 (WDC) 設定。若要瞭解有關在 Tableau Server 中使用 WDC 詳情，請參閱 [Tableau Server 中的 Web 資料連接器](https://help.tableau.com/v0.0/server-linux/zh-tw/datasource_wdc.htm)和[tsm data-access](https://help.tableau.com/v0.0/server-linux/zh-tw/cli_data-access.htm)。

使用下面的組態檔範本建立一個 .json 檔案。在使用適當的值填充選項後，請使用以下命令傳遞 .json 檔案並應用設定：

`tsm settings import -f /path/to/file.json`

`tsm pending-changes apply`

如果擱置組態需要重新啟動伺服器，`pending-changes apply` 命令將顯示提示，讓您知道即將重新啟動。即使伺服器已停止，也會顯示提示，但在這種情況下不會重新啟動。您可以使用 `--ignore-prompt` 選項隱藏提示，但這樣做不會改變重新啟動行為。如果變更不需要重新啟動，則不會出現提示即可套用變更。有關詳情，請參閱 [tsm pending-changes apply](https://help.tableau.com/v0.0/server-linux/zh-tw/cli_pending-changes.htm#pending-changes-apply)。

### Web 資料連接器設定

下面範本中的 Web 資料連接器 (WDC) 設定指定是否啟用 WDC、是否啟用 WDC 重新整理，以及主安全清單和輔助安全清單。安全清單指明哪些 WDC URL 已獲批准可在 Tableau Server 安裝中使用，以及連接器可向其傳送請求和從中接收請求的網域或 URL。

### 組態範本

使用此範本設定 WDC 設定。

**重要事項**所有實體選項均大小寫視為相異。

有關組態檔、實體和金鑰的更多說明，請參閱[組態檔範例](https://help.tableau.com/v0.0/server-linux/zh-tw/config_file_example.htm)。

{
  "configEntities": {
    "web-data-connector-settings": {
      "\_type": "webDataConnectorSettingsType",
      "refreshEnabled": true,
      "whitelist": {
        "https://www.example.com:443/wdc/": {
          "secondaryWhitelist": \[
          "https://www.example.com/.\*",
          "https://www.coolapi.com/.\*"
          \]
        }
      },
      "enabled": true
    }
  }
}

{
  "configEntities": {
    "web-data-connector-settings": {
      "\_type": "webDataConnectorSettingsType",
      "refreshEnabled": true,
      "whitelist": {
        "https://www.example.com:443/wdc/": {
          "secondaryWhitelist": \[
          "https://www.example.com/.\*"
          \]
        },
        "https://www.mysite.com:443/coolwdc/": {
          "secondaryWhitelist": \[
          "https://www.mysite.com/.\*",
          "https://www.coolapi.com/.\*"
          \]
        }
      },
      "enabled": true
    }
  }
}

### 組態檔參考

此表包括可隨 `web-data-connector-settings` 實體集一起包括的所有選項。

\_type

必要。

值：`webDataConnectorSettingsType`

請不要變更。

refreshEnabled

設定為 `false` 以停用WDC 重新整理。預設為 `true`。

whitelist

必要。

可包含一個或多個相符的安全清單和輔助安全清單集（每個 WDC 一個集）。提供的第一個 URL 是安全清單，您可以在其中指定 WDC URL 和埠，格式如下：

`<scheme>://<host>:<port>/<path>`

對於許多 WDC，`<port>` 的值為 443，這是 HTTPS 的預設連接埠，但是可以透過在 Tableau Server 或 Tableau Cloud 上查看資料來源詳細資訊來檢查適用於連接器的值。

secondaryWhitelist

必要。

指定連接器可以向哪些網域或 URL 傳送請求或從中接收請求，例如，外部 JavaScript 程式庫、REST API 或本機檔案。若要將整個網域新增到此次要安全清單，可以在 URL 的末尾使用萬用字元運算式 `.*`，如以下範例中所示：

`https://www.example.com/.*`  

enabled

設定為 `false` 以停用使用 WDC。預設為 `true`。