# 电子表格 V2 (Spreadsheet V2)
节点电子表格是节点电子表格的版本 2。使用此 V2，您可以比使用电子表格节点更轻松地读取 excel 文件和 google sheet文件。
## 本地文件
* 文件链接：选择您要读取的文件。
* 范围：Excel 文件中的一组单元格。例如，如果要从单元格 A1至单元格 E5 读取数据，我们将在“范围”字段中输入 A1:E5。您也可以将此字段留空。范围必须以大写字母输入。
* 工作表名称：Excel 工作表的名称。如果将此框留空，第一个工作表名称将默认为默认值。
* 第一行作为标题（列名称）：选中此复选框时，我们将认为 Excel 的第一行作为数据列的名称（标题）。当未选中该复选框时，各行是相等的。
* 读取带有停止条件的行：当不选中此复选框时，节点将默认从第一行获取数据。当您选择此复选框时，您必须输入两个字段：Column to compare 和 Value to compare。Column to compare：在此字段中，您将输入要对比的列。Value to compare：在此字段中，您将输入要对比的值。当未选中此复选框时，使用多个资料运行时，所有资料都将获取第一行的数据。
* 行匹配条件：选择一个变量。该字段将返回与节点正在读取的行匹配的行号，并将其存储在您选择的变量中。您可以在 WriteSheet 节点上使用此变量将数据写入与正在读取的数据行对应的行。 例如我们有如下数据表：
对于此数据表：例如，正在读取第 4 行的数据，节点会将值 4 存储在您选择的变量中。
* 最后一行数据：显示文件中包含数据的最后一行。在 Excel 文件中，您还可以通过按 Ctrl + End 检查最后一行是否包含数据，例如，我们有以下数据表：
通过此数据表，我们将获取文件中包含最后数据的行号。这里我们有 10 行，节点将存储值 10，该值将存储在您选择的变量中。该字段不依赖于您输入的范围，这意味着当您输入范围 A1:B3 时，该字段仍会将该表中包含数据的最后一行的行号视为 10。
* 存储：包括2个字段：列名和保存到。在“列”字段中，我们必须输入数据列的正确名称。对于“保存到”字段，我们将从“列名称”读取的值保存到变量中。
* 预览：显示节点已读取的数据。
## Google sheet
* Google 电子表格 ID：输入 Google sheet ID，您可以在此处获取 ID：
* Credentials文件：选择下载的Json文件
获取Credentials文件的说明：
1. 访问链接 并登录
2. 登录成功后，我们新创建一个项目
\- 选择“选择一个项目”
\- 选择新项目
\- 输入项目名称并选择创建
3. 启用Google表格API
\- 在搜索栏中输入 Google Sheets API。出现搜索结果，然后在 Marketplace 中选择 Google Sheet API
\- 启用 Google 表格 API
4. 创建Credentials
\- 成功启用Google Sheets API后，继续选择Credentials
\- 选择创建Credentials，然后选择服务帐户
\- 输入服务帐户名称，然后选择“完成”
\- 新创建的帐户将出现在此处：
\- 单击该帐户并选择“密钥”标签页：
\- 选择添加密钥 -> 选择创建新密钥
\- 选择 JSON -> 选择创建
创建后，JSON 文件将自动下载，并将该文件添加到 Spreadsheet V2 节点的Credencial字段中。
5. 与上述步骤中创建的帐户共享工作表
\- 复制在上述步骤中创建的电子邮件：
\- 与上面的帐户共享工作表页面：
这样我们就成功地执行了设置 Google Sheet 来提供 Google Sheet 上的阅读文件。下面的字段与本地文件类似。
## 详细说明
**如果选择第一行作为标题（列名称）复选框：**
我们有一个数据表如下：
在电子表格节点中，输入以下内容：
在这种情况下，当选择“第一行作为标题（列名称）”复选框时，我们会将您输入的范围的第一行作为列标题。在“要比较的列”、“列名称”字段中，我们必须输入正确的列标题，例如在本例中，列名称将是电子邮件和密码。当在节点中输入如上所示的字段时，我们得到的数据如预览所示。如果我们不选中“读取带有停止条件的行”复选框，则默认情况下将读取文件的第一行（标题行除外）。
**如果未选中第一行作为标题（列名称）复选框：**
在这种情况下，当选择第一行作为标题（列名称）复选框时，第一行将不会被视为列标题。在“要比较的列”和“列名称”字段中，我们必须输入表的正确列名称，例如在本例中，列名称将为 A、B、C...。
**依次读取与每个运行配置文件匹配的 Excel 文件的每一行的示例：**
要运行每个配置文件以匹配 Excel 文件的每个数据行，我们必须输入“要比较的列”和“要比较的值”字段。在“列”字段中，我们将输入包含每个配置文件的 uuid 的列的标题。在本例中，标题将为 uuid，在“要比较的值”字段中，我们将选择 ${PROFILE\_ID} 变量。如上输入，在运行profile时，我们可以将profile\_id与excel文件的uuid列的数据行匹配的正在运行的profile进行比较，并与对应的profile读取该行的正确数据。
在“列名称”字段中，我们只需输入要从 Excel 文件中读取的列的正确标题并将其保存到变量中即可。
您可以将下面的 Excel 文件替换为您将运行的配置文件的 uuid。
{% file src="/files/6GItX52ze2D9LRtNSpxS" %}
{% file src="/files/G5eud69J4YN8qiCXaIqS" %}
**随机读取每个配置文件的 Excel 文件的每一行的示例：**
如果您想将 Excel 文件的行读取到每个配置文件中而不需要任何顺序。然后，您可以使用 Spreadsheet V2 节点前面的 Random 节点来随机化列索引。
在这种情况下，我们将从 1 到 10 进行随机化。然后在电子表格节点的范围字段中，我们将输入以下 A${index}:B10 在这种随机情况下，我们不应选择“读取带有停止条件的行”复选框。 。
然后，当使用多个运行中资料时，Excel 文件中的数据将随机获取，而不按任何顺序。
下面是一个不按顺序读取每个资料的随机行的脚本：
{% file src="/files/Z7jReBVdSMJaW4xCr8V5" %}
{% file src="/files/Bh8wujPBKCgY6etKM2P7" %}
**读取列的所有数据并写入变量的示例**
例如我们有如下数据表：
当我们想要将 A 列（电子邮件）的所有数据读取到一个变量中时，我们有以下脚本：
在变量节点，我们创建一个变量，即索引变量，其值为2（因为excel表格中的数据是从第2行开始的，但如果有数据是从第一行开始的，则输入1）。
在电子表格 v2 节点中，输入以下内容：
在第一个设置变量节点，您需要输入以下内容：
每次循环，索引的值都会增加 1。每次循环，都会读取 Excel 中 1 行的值。
在第二个设置变量节点，需要输入以下内容：
第二个节点集变量用于将值连接在一起。在“变量名称”字段中，您选择一个新变量，以便在执行数据串联时，串联的数据将保存在该变量中（此处为变量 b）。在变量或值字段中，如图所示输入，并带有 | 符号用于分隔值，也可以使用其他字符分隔；这里的变量 ${email} 将从节点电子表格 v2 中检索到各值。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.hidemium.io/zi-dong-hua-yong-hu-shou-ce/shu-ju-data/dian-zi-biao-ge-v2-spreadsheet-v2.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.