11.4. 连接到 Google Sheets

流程

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

4. 在 Configure Connection 页面中，单击 Connect Google Sheets，这将进入 Google 登录页面。

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

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

流程

1. 点您要使用的 Google Sheets 连接。
2. 在 Choose an action 页面上，对于启动连接，选择 Get sheet 值 操作或中间连接，选择 Retrieve sheet 值 操作。

3. 配置操作：

   1. 在 SpreadsheetId 字段中，输入 Google 电子表格的 ID，该表可从此 Google Sheets 连接被授权访问的 Google 帐户访问。

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

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

      例如，假设您想获得电子表格中的所有数据，其中有一个表格，包含 4 列。指定 A:D。或者，若要从行 5 到 15 中获取数据，请指定 A5:D15。

      如果您要获取数据的电子表格具有多个表，请指定表格名称以及启动单元协调以及结束单元协调。如果有多个表格，并且您没有指定表格名称，则连接会从电子表格的第一个表格中获取数据。例如，2019!A1:D5 规格指定您要从名称为 2019 的表中获取数据。在该表格中，您希望通过 D （第 1 行到第 1 行到第 5 行）列入 A 中的数据。

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

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

      列 配置操作，以返回列对象集合，其中每个列对象包含每个所需行的值。

   4. 在 Header row number 字段中，如果将 Major dimension 设置为 Rows，可以选择在连接获取的数据中输入包含列标题的行数。标题行的规格使 Fuse Online 从电子表格中获取标题。如果您没有指定标头行，则列标题默认为连接获取的数据范围内的每个列的字母标题。您可以在后续页面中编辑获取的标题或字母标题。

      注意

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

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

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

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

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

      例如，假设主要维度为行，并且 Max results 设置为 25。轮询返回不超过 25 行的值。

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

4. 点 Next 查看当 Major dimension 设置为 Rows 时连接获取的数据中的列名称。如果 Major dimension 是 Columns，则此字段中的内容将被忽略，您可以点 Next 来完成此流程。

   Column names 字段中出现的值成为数据映射程序步骤显示的字段名称。如果您指定了标头行号，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 电子表格的 ID，该表可从此 Google Sheets 连接被授权访问的 Google 帐户访问。

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

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

流程

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

4. 配置 Create spreadsheet 操作：

   1. 在 Title 字段中，输入新电子表格的标题。
   2. 在 Time Zone 字段中，输入新电子表格应使用的时区，例如，印度标准时间，即 India Standard Time，或 netobserv。
   3. 在 Locale 字段中，输入新电子表格的区域设置，如 Canada、或 香港。
5. 点 Next 将连接添加到流。连接会出现在您添加它的集成视觉化中。

流程

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

4. 配置 Update sheet 值 操作：

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

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

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

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

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

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

      • 未指定 的默认值是 Google Sheets API 设置，它默认为 User 输入。
      • raw 会导致 Google Sheets 插入输入数据。
      • 输入的用户 启用了自动转换可识别的数据。
   5. 点 Next 将连接添加到流。连接会出现在您添加它的位置的集成视觉化中。
5. 如果要向流中添加任何其他连接，请立即添加它们，然后返回到这些指令。
6. 在流都有所有所需的连接后，在集成视觉化中点加号，该符号仅在更新表值的 Google Sheets 连接之前。
7. 点 Data Mapper 卡将数据映射步骤添加到流中。

8. 在数据映射程序中：

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

   2. 指定您要用来更新表的数据，方法是将源步骤中的字段映射到目标电子表格。例如，您可以映射其他电子表格或数据库中的字段。

      如果需要，您可以编辑 Google Sheets 连接，该更新表值并更改 Range 或 Major 的维度 设置。更改这些设置会导致数据映射器根据您的更改显示不同的目标字段。

   3. 在右上角，点 Done 添加数据映射程序步骤。

流程

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

4. 将 Append 值配置为表格操作 ：

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

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

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

      连接永远不会覆盖数据。连接会在您指定的范围后开始附加数据，然后始终将数据附加到现有内容中。

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

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

      • 未指定 的默认值是 Google Sheets API 设置，它默认为 User 输入。
      • raw 什么都不做。Google Sheets 会按照以下方式插入输入数据。
      • 输入的用户 启用了自动转换可识别的数据。

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

      您指定的值将 Append 值配置为表操作， 决定数据映射器显示的字段，以便从此连接中映射或从中映射的字段。

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

8. 在数据映射程序中：

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

   2. 通过将源步骤中的字段映射到目标电子表格中指定要附加到表的数据。例如，您可以映射其他电子表格或数据库中的字段。

      如果需要，您可以编辑 Google Sheets 连接，该连接附加表格值并更改 Range 或 Major 的维度 设置。更改这些设置会导致数据映射器根据您的更改显示不同的目标字段。

   3. 在右上角，点 Done 添加数据映射程序步骤。

流程

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

4. 配置 Update spreadsheet 属性 操作：

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

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

6. 在流都有所有所需的连接后，您可能需要使用数据映射程序步骤来更新电子表格属性：

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

流程

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

4. 配置 Add chart 操作：

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

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

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

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

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

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

5. 点 Next 将连接添加到流。连接会出现在您添加它的集成视觉化中。
6. 如果要向流中添加任何其他连接，请立即添加它们。然后返回到这些指令。
7. 在集成视觉化中，单击刚刚在添加 chart 的连接之前的加号。

8. 单击 Data Mapper。

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

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

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

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

   1. 通过将 A1 表示法值（用于标识单元格）映射到 overlayPosition 目标字段来设置 chart 的位置。不需要结束位置，如果存在，则忽略该位置。映射的值标识 Google Sheets 放置 chart 的单元。此单元是图表显示的左上角。

      如果您没有将值映射到 overlayPosition 字段，并且您也没有将值映射到 sheetId 字段，它标识您要将图表添加到的表，则默认行为是 Google Sheets 会创建一个新的表，并将 chart 放在 A1 中。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

流程

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

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

   • 输入您要将 pivot 表添加到的电子表格的 ID。
   • 将字段留空。在连接前添加的数据映射程序步骤中，您要将上一连接中的电子表格 ID 映射到此连接。以上连接必须访问您要在此连接中添加 pivot 表的电子表格。
5. 点 Next 将连接添加到流。连接会出现在您添加它的集成视觉化中。
6. 如果要在此流中添加任何其他连接，请立即添加它们。然后返回到这些指令。
7. 在集成视觉化中，单击刚刚在连接添加 pivot 表到表的加号。

8. 单击 Data Mapper。

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

   如果没有所需值的源，点 Properties 文件夹右侧的 + 符号在 data mapper 中创建一个 source 属性。在 Create Property 对话框中，为属性指定一个名称，以便可以轻松地映射到正确的目标字段，例如，指定 valueLayout 作为属性名称。指定您希望连接用于创建 pivot 表的值。pivot 表的值布局字段需要 HORIZONTAL 或 VERTICAL 值，以便您可以指定 VERTICAL 作为 valueLayout 属性的值。保存新属性。

9. 在数据映射程序中，配置一个新的 pivot 表，如下所示：

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

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

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

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

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

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

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

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

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

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

      1. 将列 pivot 组名称映射到目标 标签 字段。
      2. 将您要应用到列的 pivot 组的排序顺序映射到目标 sortOrder 字段。该值必须是 ASCENDING 或 DESCENDING。默认值为 ASCENDING。
      3. 将 true 或 false 映射到目标 showTotals 字段。默认值为 true，它启用列 pivot 组的总总数。
      4. 将构建列名称（构建列 pivot 组）映射到 target sourceColumn 字段。
   10. 在右上角，点 Done 添加数据映射程序步骤。