11.4. 连接到 Google 表

流程

1. 在 Fuse Online 中，在左侧面板中，单击 Connections 以显示任何可用的连接。
2. 单击 Create Connection 以显示可用的连接器。连接器是用来创建一个或多个连接的模板。
3. 点 Google Sheets 连接器。

4. 在 Configure Connection 页面中，点 Connect Google Sheets，它进入 Google 登录页面。

   如果没有显示 Google Sheets，则您的 Fuse Online 环境不会作为 Google 客户端应用程序注册，并启用了 Google Sheets API。请参阅 将 Fuse Online 注册为 Google 客户端应用程序。当您的环境没有使用 Google 注册时，当您尝试创建 Google Sheets 连接时，Fuse Online 会显示多个提示授权信息的字段。虽然您可以通过在这些字段中输入值来创建 Google Sheets 连接，但不建议这样做。

5. 在 Google 登录页面中，选择您希望此连接从 Fuse Online 访问的 Google 帐户，然后点 Next。
6. 为了响应 openshiftapps.com 希望访问您的 Google 帐户 提示，点 Allow 返回 Fuse Online。
7. 在 Fuse Online Name 字段中输入您的名称选择，帮助您将这个连接与其他连接区分开。例如，输入 Google Sheets Work Connection。
8. 在 Description 字段中输入任何有助于了解这个连接的信息。例如，输入 使用我的 Google 工作帐户的 Sample Google Sheets 连接。
9. 点 Save 以查看您创建的连接现在可用。如果您输入了示例名称，您会看到 Google Sheets Work Connection 显示为可选择添加到集成的连接。

流程

1. 点您要使用的 Google Sheets 连接。
2. 在 Choose a action 页面上的开始连接中，选择 Get sheet values 操作或中间连接，选择 Retrieve sheet 值 操作。

3. 配置操作：

   1. 在 SpreadsheetId 字段中输入可从 Google Sheets 连接被授权访问的 Google 表格的 ID。

      要获得电子表格 ID，请在浏览器中显示电子表格。ID 是 d/ 和 /edit 之间的 URL 的一部分。

   2. 在 Range 字段中，输入 Google A1 表示法来标识您要获取的数据。默认值为 A:A。

      例如，假设您想知道来自一个表格（含 4 列）的所有数据。指定 A:D。或者，若要从行 5 到 15 获得数据，请指定 A5:D15。

      如果您在获取数据的电子表格中有多个表，请指定表格名称以及开始单元格协调和最终单元格协调。如果有多个表，并且您没有指定表名称，则连接从电子表格中的第一个表中获取数据。例如，为 2019!A1:D5 规格，指定您想要从名为 2019 的表中获取数据。在该表中，您想要在第 A 到第 1 行到第 5 行列的数据。

   3. 在 Majormen sion 字段中，接受 Rows （默认值），或选择 Columns。

      行 配置该操作可返回一行对象的集合，每个行对象包含每个所需列的值。当 主维度 为行时，Fuse Online 可将有意义的列标题显示为数据映射器中的字段名称，而不是 A、B、C 等。

      列 将操作配置为返回一系列列对象，每个列对象包含每个所需行的值。

   4. 在 Header 行 字段中，如果 Major di mens 设为 Rows，则可以输入包含连接获取数据中列标题的一行数量。一个标题行的规格可让 Fuse Online 从电子表格中获取标题。如果您没有指定标题行，则列标题默认为连接获取的数据范围内每个列的字母标题。您可以在随后的页面中编辑获得的标题或字母标题。

      注意

      如果您要配置 Google Sheets 中间连接，则不需要剩余的配置选项，Fuse Online 不会提示它们。跳至第 4 步。

   5. 在 Split results 字段中，接受 No （默认值）或选择 Yes。设置 No 配置操作以将数据返回为值集合。也就是说，连接会将一组行对象或一列对象集合传递到网络流中的下一步。选择 Yes 启用根据 Major mension 的设置将返回的数据的连接分割。例如，如果 Majormen s 设为 Rows，则连接返回行对象。每行对象触发一个单独的流程执行。也就是说，Fuse Online 对每个返回的行对象执行一次流。例如，如果轮询返回 5 行，则 Fuse Online 执行流 5 次。

      Fuse Online 还提供了离散的分割和聚合步骤，您可将其添加到一个流中。如果要在一个或多个步骤中处理单个对象，然后聚合行或列对象，请不要分割 Google Sheets 连接结果。相反，接受默认的 否，然后在此连接后向流添加一个拆分步骤。如果您希望流程中的聚合步骤，则需要分割步骤。

   6. 在 Delay 字段中，接受 30 秒的默认值，或指定希望连接获取电子表格数据的频率。

   7. 在 Max results 字段中，如果您不想限制可以返回多少个行或列轮询，接受 0 默认值。Max 结果的设置适用于结果 列表中主要维度的设置。要限制连接为主要维度返回的数据，请指定整数。

      例如，假设主要维度为行，最大结果 设置为 25。轮询返回值不超过 25 行。

      when Range 指定主要维度，并且指定了 Max 结果，轮询将使用较低数字来确定要返回的数据量。因此，当您只指定 范围 的次度时，为 Max 结果 设置值会很有用。例如，假设一行中有 30 行，每个行中有三列的值。假设 Majormension 是 Rows，Range 为 A:C。如果将 Max 结果 设置为 10，则轮询会返回 10 行数据。如果您接受 0 作为 Max 结果的设置，则 轮询会返回 30 行。但是，如果您将 Range 指定为 A1:C15，并且您还将 Max 结果 指定为 25，则轮询返回 15 行。如果您将 Range 指定为 A1:C30，并且您同时将 Max 结果 指定为 25，则轮询返回 25 行。

4. 点 Next，在将 Major mens 设置为 Rows 时查看连接获取的数据中的列名称。如果 Major mension 是 Columns，则此字段的内容会被忽略，您可以点 Next now 完成这个过程。

   Column name 字段中显示的值成为数据映射步骤显示的字段名称。如果您指定了标题行号，Fuse Online 会在您从中获取数据的表中显示该行中的标题。如果您将标题行号留空，Fuse Online 会为您获取的数据范围内的每个列显示字母（A、B、C 等等）。

5. （可选）编辑 Column name 字段，使其包含您要在数据映射程序步骤中看到 的字段名称。字段必须包含不含空格的逗号分隔列表，如 Name、Address、City、State、Zip。
6. 点 Next 将这个 Google Sheets 连接添加到流中。

流程

1. 在左侧的 Fuse Online 面板中，单击 Integrations。
2. 点 Create Integration。
3. 在 Choose a connection 页面中，点您要用来开始集成的 Google Sheets 连接。
4. 在 Choose an action 页面中，选择 Get spreadsheet 属性 操作。

5. 配置 Get spreadsheet 属性 操作：

   1. 在 SpreadsheetId 字段中输入可从 Google Sheets 连接被授权访问的 Google 表格的 ID。

      要获得电子表格 ID，请在浏览器中显示电子表格。ID 是 d/ 和 /edit 之间的 URL 的一部分。

   2. 在 Delay 字段中，接受 30 秒的默认值，或者指定希望连接获取属性的频率。
6. 点 Next 将这个 Google Sheets 连接添加为集成的启动连接。

流程

1. 在 Add to Integration 页面中，点您要添加连接的加号。如果 Fuse Online 提示您选择完成连接，请跳过这一步。
2. 点击有权访问您要用于创建电子表格的 Google 帐户的 Google Sheets 连接。
3. 在 Choose an action 页面中，选择 Create spreadsheet。

4. 配置 Create spreadsheet 操作：

   1. 在 title 字段中输入新电子表格的标题。
   2. 在 Time Zone 字段中输入新电子表格应使用的时区，如 印度标准时间 或 东京。
   3. 在 Locale 字段中，输入新电子表格的区域设置，例如： Canada 或 Kong。
5. 点 Next 将连接添加到流。这个连接会出现在您添加的集成视觉化中。

流程

1. 在 Add to Integration 页面中，点您要添加连接的加号。如果 Fuse Online 提示您选择完成连接，请跳过这一步。
2. 点击有权访问您要更新的电子表格的 Google Sheets 连接。
3. 在 Choose a action 页面中，选择 Update sheet values。

4. 配置 更新表值 操作：

   1. 在 SpreadsheetId 字段中，进行以下操作之一：

      • 输入您要更新的电子表格的 ID。
      • 将字段留空。在这种情况下，在将这个连接添加到流后，您必须在这个连接前添加 data mapper 步骤。在 data mapper 步骤中，将前一连接中的电子表格 ID 映射到此连接。前面的连接必须访问您在此连接中要更新的电子表格。

   2. 在 Range 字段中，使用 Google A1 表示法指定您要更新的电子表格单元。指定 start 和 end 协调，例如 A1:D4 更新电子表格中的第一个 4 行中的前 4 列。

      默认为 A:A，它会更新电子表格中的第一个表中的第一列。

   3. 在 Majormen sion 字段中，接受 Rows （默认值），或选择 Columns。行 将操作配置为使用行对象来更新表。每行对象包含您要更新的每个列的值。列 将操作配置为使用列对象来更新表。每个列对象包含您要更新的每个行的值。

   4. 在 Value 输入选项 字段中，指定您希望 Google 表来解释它在更新表时接收的数据。Unspecified （默认）可让 Google Sheets 自动转换它识别的数据。例如，如果输入数据为日期，Google Sheets 则将其格式化为日期。如果输入数据是十进制的，则 Google Sheets 会将它格式化为十进制数。

      • Unified 默认为 Google Sheets API 设置，默认为 User 输入。
      • raw 可使 Google Sheets 插入输入数据，如下所示。
      • 用户输入 可自动转换可识别的数据。
   5. 点 Next 将连接添加到流。这个连接会出现在您添加的位置进行集成视觉化中。
5. 如果要向流添加任何其他连接，现在添加它们，然后返回到这些指令。
6. 在流程均需要的所有连接（集成视觉化中）后，点与更新表值的 Google Sheets 连接前的加号。
7. 点 Data Mapper 卡将数据映射步骤添加到流中。

8. 在 data mapper 中：

   1. 如果在配置 Update sheet 值 操作时没有指定电子表格 ID，请将源 spreadsheetId 映射到目标 电子表格Id。

   2. 通过从源步骤中将字段映射到目标电子表格，指定您要用来更新表的数据。例如，您可以映射来自另一个电子表格或数据库的字段。

      如果需要，您可以编辑 Google Sheets 连接，更新表值并更改 Range 或 Majormension 的设置。更改这些设置会导致 data mapper 会根据您的更改显示不同的目标字段。

   3. 在右上角，单击 Done 以添加 data mapper 步骤。

流程

1. 在 Add to Integration 页面中，点您要添加连接的加号。如果 Fuse Online 提示您选择完成连接，请跳过这一步。
2. 点一个 Google Sheets 连接，该连接有权访问您要附加数据的电子表格。
3. 在 Choose a action 页面中，选择 Append values to asheet。

4. 将 Append 值配置为一个sheet 操作：

   1. 在 SpreadsheetId 字段中，进行以下操作之一：

      • 输入您要附加值的电子表格 ID。
      • 将字段留空。在这种情况下，在将这个连接添加到流后，您必须在这个连接前添加 data mapper 步骤。在 data mapper 步骤中，将前一连接中的电子表格 ID 映射到此连接。前面的连接必须访问您要在此连接中附加数据的电子表格。

   2. 在 Range 字段中，使用 Google A1 表示法指定您要在其中附加数据的电子表格范围。指定开始和结束协调，例如 A3:D3 在 4 列的第三行后将数据附加到第一个表。默认为 A:A，它将数据附加到电子表格中的第一个表的第一列中。

      连接不会覆盖数据。连接在指定范围后附加数据，然后总是将数据附加到当前所在的内容中。

   3. 在 Majormen sion 字段中，接受 Rows （默认值），或选择 Columns。行 配置操作以使用行对象来附加数据。每行对象包含您要在其中附加数据的每列的值。列 将操作配置为使用列对象来附加数据。每个列对象包含您要附加的每行的值。

   4. 在 Value 输入选项 字段中，指定您想要 Google 表来解释它收到的数据，以附加到表。Unspecified （默认）可让 Google Sheets 自动转换它识别的数据。例如，如果输入数据为日期，Google Sheets 则将其格式化为日期。如果输入数据是十进制的，则 Google Sheets 会将它格式化为十进制数。

      • Unified 默认为 Google Sheets API 设置，默认为 User 输入。
      • Raw 不做任何作用。Google Sheets 按照原样插入输入数据。
      • 用户输入 可自动转换可识别的数据。

   5. 点 Next 将连接添加到流。这个连接会出现在您添加的集成视觉化中。

      您指定的值将 Append 值配置为表操作， 决定 data mapper 显示至此连接或从这个连接显示的字段。

5. 如果要向流添加任何其他连接，现在添加它们，然后返回到这些指令。
6. 在流程均需要的所有连接（集成视觉化中）后，点只在 Google Sheets 连接之前将数据附加到表前的加号。
7. 点 Data Mapper 将数据映射步骤添加到流中。

8. 在 data mapper 中：

   1. 如果您在将 Append 值配置为电子表格操作时没有指定电子表格 ID，然后将源电子 ID 映射到目标 电子表格Id。

   2. 通过从源步骤中将字段映射到目标电子表格，指定要在表中添加的数据。例如，您可以映射来自另一个电子表格或数据库的字段。

      如果需要，您可以编辑 Google Sheets 连接，该连接附加了表值并更改 Range 或 Majormension 的设置。更改这些设置会导致 data mapper 会根据您的更改显示不同的目标字段。

   3. 在右上角，单击 Done 以添加 data mapper 步骤。

流程

1. 在 Add to Integration 页面中，点您要添加连接的加号。如果 Fuse Online 提示您选择完成连接，请跳过这一步。
2. 点一个 Google Sheets 连接，该连接有权访问您要更新的属性的电子表格。
3. 在 Choose an action 页面中，选择 Update spreadsheet 属性。

4. 配置 更新电子表格属性 操作：

   1. 在 SpreadsheetId 字段中，进行以下操作之一：

      • 输入您要更新的属性的电子表格 ID。
      • 将字段留空。在这种情况下，在将这个连接添加到流后，您必须添加在这个连接前的 data mapper 步骤。在 data mapper 步骤中，将前一连接中的电子表格 ID 映射到此连接。前面的连接必须访问您在此连接中要更新的电子表格。
   2. 在其他字段中，仅在您要更改属性时输入一个值。或者，您可以将字段留空。如果您这样做，在稍后添加的数据映射程序步骤中，只需在此连接之前，您可以映射您要更改的字段。
   3. 点 Next 将连接添加到流。这个连接会出现在您添加的集成视觉化中。
5. 如果要向流添加任何其他连接，现在添加它们，然后返回到这些指令。

6. 在流程具有所有必需的连接后，您可能需要使用 data mapper 步骤来更新电子表格属性：

   1. 在集成视觉化中，点仅在 Google Sheets 连接更新属性前的加号。
   2. 点 Data Mapper 将数据映射步骤添加到流中。
   3. 在数据映射器中，如果您在配置 Update spreadsheet 属性操作时没有指定电子表格 ID，请将源 spreadsheetId 映射到目标 电子表格Id。
   4. 对于您要更改的每个电子表格属性，并在配置 Update spreadsheet 属性 操作时不指定更新的值，将源步骤中的字段映射到您要更改的目标电子表格属性。
   5. 在右上角，单击 Done 以添加 data mapper 步骤。

流程

1. 在 Add to Integration 页面中，点您要添加连接的加号。如果 Fuse Online 提示您选择完成连接，请跳过这一步。
2. 点击授权访问您要添加 chart 的电子表格的 Google Sheets 连接。
3. 在 Choose an action 页面中，选择 Add charts。

4. 配置 Add charts 操作：

   1. 在 SpreadsheetId 字段中，进行以下操作之一：

      • 输入您要向其添加 chart 的电子表格 ID。
      • 将字段留空。在此连接之前，在数据映射程序步骤中，将上一连接中的电子表格 ID 映射到此连接。前面的连接必须访问您要在此连接中添加 chart 的电子表格。

   2. 在 Chart 标题字段 中，输入标题。

      或者，将该字段留空。在此连接前，在数据映射程序步骤中，将 Chart 标题从源字段或属性映射到 标题 目标字段。

   3. 在 Subtitle 字段中，输入子标题。

      或者，将该字段留空。在此连接前，在数据映射程序步骤中，将 source 字段或属性的 chart 子标题映射到子 标题 目标字段中。

5. 点 Next 将连接添加到流。这个连接会出现在您添加的集成视觉化中。
6. 如果要向流添加任何其他连接，请现在添加它们。然后返回到这些说明。
7. 在集成视觉化中，点只添加 chart 的连接前的加号。

8. 点 Data Mapper。

   在 datamapper 中，将源属性、源字段或源常映射到目标 Google Sheets 连接，该连接将添加一个 chart。以下说明假设有一个 source 字段、源属性或源常，其中包含您要映射到每个目标字段的值。

   如果没有所需值的源，则在 data mapper 中创建一个源属性，方法是点击 Properties 文件夹右侧的 + 符号。在 Create Property 对话框中，为属性指定名称，使其易于映射到正确的目标字段，例如，将 overlayPosition 指定为属性名称。对于属性值，请指定您希望连接用于创建 chart 的值。图表的 overlay 位置字段需要 A1 表示法来标识一个单元。也就是说，它会指定一个起始位置，但不需要结束位置规格，并在存在时忽略它。例如，将 D4 等内容指定为 overlayPosition 源属性的值。保存新属性。

   当您配置了 Add charts 操作时，可能会为电子表格 ID、图表标题和/或 chart 子标题指定一个值。如果您这样做，则不会将值映射到那个字段。

9. 将 chart 添加到表，映射源属性、源字段或源常到目标字段，如下所示：

   1. 通过将 A1 表示法值映射到 overlayPosition target 字段，设置 chart 的位置。不需要结束位置，并在存在时忽略它。映射的值标识 Google Sheets 放置 chart 的单元。此单元是显示图表的左上角。

      如果您没有将值映射到 overlayPosition 字段，您也不要将值映射到 sheetId 字段，它标识您要将 chart 添加到的表，然后 Google Sheets 会创建一个新的表，并将 chart 放置到 A1 中。

      如果您计划将值映射到 overlayPosition 字段，则必须将值映射到 sheetId 字段。

   2. 将源 spreadsheetId 字段映射到目标 电子表格Id 字段。该连接使用电子表格中的源数据将图表添加到同一电子表格的表中。源数据和图表可以是同一电子表格的两个不同表，但它们不能采用两个不同的电子表格。
   3. 通过映射到目标标题字段来设置图表 标题。连接将这个字符串作为 chart 的标题插入。
   4. 通过映射到目标子标题字段来设置 chart 子 标题。连接将这个字符串作为 Chart 子标题插入。

   5. 通过将整数映射到 sheetId 字段来识别添加 chart 的表。

      如果将值映射到 sheetId 字段，那么您还必须将值映射到 overlayPosition 字段。

      如果您没有将值映射到 sheetId 字段，您也不要将值映射到 overlayPosition 字段，则连接会创建一个新的表，并将 chart 添加到新的表。

      如果您没有将值映射到 sheetId 字段，但您可以将值映射到 overlayPosition 字段，则连接会将图表放在 sourceSheetId 字段标识的表上。这是为 chart 提供数据的表。

      0 标识电子表格中的第一个表。对于后续表，当浏览器中看到表格 ID 时，位于 URL 的末尾。例如，在以下 URL 的末尾，您可以看到 gid=206589330 ：

      https://docs.google.com/spreadsheets/d/1pa…​ngQbKkM/edit#gid=206589330

      这表示 sheet ID 是 206589330，这是您要映射到 sheetId 的值。

   6. 通过将其整数表 ID 映射到目标 sourceSheetId 字段来识别提供 chart 的数据的表。默认值为 0， 它标识电子表格中的第一个表。

      您可以添加基本 chart 或 pie chart。根据您要添加的 chart 类型，根据以下一组说明进行操作。

   7. 要添加基本 chart，在目标面板中，展开 basicChart 文件夹，并将源字段映射到 basicChart 文件夹中的目标字段：

      1. 通过映射到目标类型字段来设置图表类型（BAR、LINE、AREA 或 COLUMN）。默认为 COLUMN。
      2. 通过映射到目标 axisTitleBottom 字段来设置图表底部标题。
      3. 通过映射到目标 axitle Left 字段来设置图表的左侧标题。
      4. 通过映射到目标 domainRange 字段，设置图表显示的信息的高级信息。此字段使用 Google Sheets A1 表示法。例如，假设源表中的第一列在 A2 到 A6 中提供 5 个产品列表，并且您希望图表为每个产品提供一些数据。在此列中，第一单元格(1)必须包含一个标签，如 产品。domainRange 的设置将是 A1:A6。Chart 将包含 A2 到 A6 中的数据。Chart 不显示标签。
      5. 通过映射到 target dataRange 字段来标识图表显示的源数据的位置。此字段使用 Google Sheets A1 表示法。Chart 只能提供一个一系列数据。继续进行 domainRange 示例，假设源表中的第二列显示了在第一列中列出的每个 5 产品所出售的数字，这是您希望 chart 显示的数据。在这个列中，第一单元单元(B1)必须包含一个标签，如 Number Sold。dataRange 的设置将是 B1:B6。Chart 将包含 B2 到 B6 中的数据。Chart 不显示标签。

   8. 要添加 pie chart，在目标面板中，展开 pieChart 文件夹，并将源字段映射到 pieChart 文件夹中的目标字段：

      1. 通过映射到目标legend Position 字段来设置 pie Chart 委派的位置。默认值为 LEFT_LEGEND。该值必须是 BOTTOM_LEGEND、LEFT_LEGEND、RIGHT_LEGEND、TOP_LEGEND 或 NO_LEGEND。
      2. 通过映射到 target domainRange 字段来设置 pie Chart 显示的高级信息。此字段使用 Google Sheets A1 表示法。例如，假设源表中的第一列在 A2 到 A6 中提供 5 个产品列表，并且您希望图表为每个产品提供一些数据。在此列中，第一单元格(1)必须包含一个标签，如 产品。domainRange 的设置将是 A1:A6。Chart 将包含 A2 到 A6 中的数据。Chart 不显示标签。
      3. 通过映射到 target dataRange 字段来标识图表显示的源数据的位置。此字段使用 Google Sheets A1 表示法。Chart 只能提供一个一系列数据。继续进行 domainRange 示例，假设源表中的第二列显示了在第一列中列出的每个 5 产品所出售的数字，这是您希望 chart 显示的数据。在这个列中，第一单元单元(B1)必须包含一个标签，如 Number Sold。dataRange 的设置将是 B1:B6。Chart 将包含 B2 到 B6 中的数据。Chart 不显示标签。
   9. 在右上角，单击 Done 以添加 data mapper 步骤。

流程

1. 在 Add to Integration 页面中，点您要添加连接的加号。如果 Fuse Online 提示您选择完成连接，请跳过这一步。
2. 点击授权访问您要添加 pivot 表的电子表格的 Google Sheets 连接。
3. 在 Choose a action 页面上，选择 Add pivot tables。

4. 要配置 Add pivot table 操作（在 SpreadsheetId 字段中），请执行以下操作之一：

   • 输入您要向其添加 pivot 表的电子表格 ID。
   • 将字段留空。在您要在此连接前添加的数据映射程序步骤中，您要将之前连接的电子表格 ID 映射到此连接。前面的连接必须访问您要在此连接中添加 pivot 表的电子表格。
5. 点 Next 将连接添加到流。这个连接会出现在您添加的集成视觉化中。
6. 如果要向这个流添加任何其他连接，请现在添加它们。然后返回到这些说明。
7. 在集成视觉化中，点仅在将 pivot 表添加到表的连接前的加号符号。

8. 点 Data Mapper。

   在 datamapper 中，将源属性、源字段或源常映射到目标 Google Sheets 连接，该连接将添加 pivot 表。以下说明假设有一个源字段、源属性或源常，其中包含您要映射到每个目标字段的值。

   如果没有所需值的源，则在 data mapper 中创建一个源属性，方法是点击 Properties 文件夹右侧的 + 符号。在 Create Property 对话框中，为属性指定一个名称，使其易于映射到正确的目标字段，例如，将 valueLayout 指定为属性名称。指定您要用来创建 pivot 表的连接值。pivot 表的值布局字段要求值为 HORIZONTAL 或 VERTICAL，以便您指定 VERTICAL 作为 valueLayout 属性的值。保存新属性。

9. 在 data mapper 中，按如下所示配置一个新的 pivot 表：

   1. 将源 spreadsheetId 字段映射到目标 电子表格Id 字段。连接使用这个电子表格中的源数据将 pivot 表添加到同一电子表格的表中。源数据和 pivot 表可以位于同一电子表格的两个不同表，但它们不能采用两个不同的电子表格。

   2. 通过将整数映射到 sheetId 字段来识别添加 pivot 表的表。默认值为 0， 它标识电子表格中的第一个表。对于后续表，当浏览器中看到表格 ID 时，位于 URL 的末尾。例如，在以下 URL 的末尾，您可以 gid=206589330 ：

      https://docs.google.com/spreadsheets/d/1pa…​ngQbKkM/edit#gid=206589330.

      这表示 sheet ID 是 206589330，这是您要映射到 sheetId 的值。

   3. 通过将其整数表 ID 映射到目标 sourceSheetId 字段，识别提供生成 pivot 表数据的表。如果您没有将值映射到 sourceSheetId，则连接将使用 sheetId 值，如果没有将值映射到 sheetId。0 标识电子表格中的第一个表。
   4. 通过将 A1 表示法值映射到目标 sourceRange 字段，设置用于生成 pivot 表的源数据范围。例如，A2:D5。
   5. 通过映射到目标 valueLayout 字段，设置在 pivot 表中使用的值布局。该值必须是 VERTICAL 或 HORIZONTAL，这是默认值。HORIZONTAL 指定这些值标记为列。
   6. 通过映射 A1 表示法单元格到 target start 字段来设置 pivot 表的顶级单元。当连接将 pivot 表添加到包含源数据的表中时，如果您不将值映射到 start 字段，则默认设置是 pivot 表格的顶级单元，位于源数据范围的第一行中，在源数据范围的第一行中。当源数据位于一个表中时，pivot 表将位于另一个表中，默认值为 A1。

   7. 要添加值组，请在目标面板中展开 valueGroups，并将值映射到 valueGroups 下的字段：

      1. 将值组名映射到目标 名称字段。
      2. 将您要应用到 value 组的功能映射到 target 功能 字段。该值必须是 SUM、COUNT、AVERAGE、MAX、MIN 或 CUSTOM。默认为 SUM。在定义公式时，将自定义映射到 功能。
      3. 将 CUSTOM 值映射到 功能 字段，将您要应用到 value 组的自定义 公式 字段映射到目标公式字段。
      4. 将列名称（即协调构建值组）映射到目标 sourceColumn 字段。

   8. 要添加一个行 pivot 组，在目标面板中展开 columnGroups，并将值映射到 columnGroups 下的字段：

      1. 将行 pivot 组名称映射到目标 标签 字段。
      2. 将您要应用到行的排序顺序映射到目标 sortOrder 字段。该值必须是 ASCENDING 或 DESCENDING。默认为 ASCENDING。
      3. 将 true 或 false 映射到 target showTotals 字段。默认为 true，它启用行 pivot 组的总计显示。
      4. 将一列名称（即协调构成行 pivot group）映射到目标 sourceColumn 字段。

   9. 要添加列 pivot 组，在目标面板中展开 rowGroups，并将值映射到 rowGroups 下的字段：

      1. 将一列 pivot 组名称映射到目标 标签 字段。
      2. 将您要应用到列的排序顺序映射到目标 sortOrder 字段。该值必须是 ASCENDING 或 DESCENDING。默认为 ASCENDING。
      3. 将 true 或 false 映射到 target showTotals 字段。默认为 true，它启用列 pivot 组的总计显示。
      4. 将列名称映射到目标 sourceColumn 字段，后者与构建列 pivot group 的协调映射到目标 sourceColumn 字段。
   10. 在右上角，单击 Done 以添加 data mapper 步骤。