> For the complete documentation index, see [llms.txt](https://docs.hidemium.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hidemium.io/zi-dong-hua-yong-hu-shou-ce/shu-ju-data/shu-xie-biao-writesheet.md).

# 书写表 (WriteSheet)

## 节点字段说明

当你想将数据写入excel文件时，可以使用WriteSheet节点

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FTNTDZdeZhFOVqWd2GYYo%2Fimage.png?alt=media&amp;token=42d85bd4-959d-4c46-bc11-785e5904ac5d" alt=""><figcaption></figcaption></figure>

## 本地文件

* 文件链接：输入链接或选择包含 Excel 文件链接的变量。
* 工作表名称：输入 Excel 文件的工作表名称。如果将此字段留空，节点将自动取第一个sheet写入数据。
* Checkbox Append last row：选中该复选框时，节点将自动写入最后一行数据的下一行。例如，如果您的 Excel 文件中的数据到达第 20 行，则当您选此复选框时，该节点将自动写入下一行，即第 21 行。
* 单元位置：输入要记录数据的位置。当您不选择Append Last row复选框时，您必须输入需要写入数据的单元格，例如A1、B1、A2......，如果这些单元格有数据，则节点将覆盖数据。当你选中复选框时，你只需要输入列名A、B、C...，节点就会自动理解并写入包含数据的最后一行的下一行。
* 变量：输入要写入单元格的值。

## Google sheet

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FMKe1YWXblq1TMRL3pu8Z%2Fimage.png?alt=media&amp;token=94a14fb1-75d8-43d2-b63d-e5b6f163dd4b" alt=""><figcaption></figcaption></figure>

* Google Spreadsheet ID：输入 GoogleSheet 文件的 ID

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FSMpUsEVJTTatE5WjKc28%2Fimage.png?alt=media&amp;token=fa73566a-57f7-4f57-b383-b4021307a72a" alt=""><figcaption></figcaption></figure>

* Credentical文件：选择下载的Json文件

**获取Credentical文件的说明：**

1. 访问链接 <https://console.cloud.google.com/> 并登录
2. 登录成功后，我们新建一个项目：

\- 选择“选择一个项目”

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FZcg8yWIsScIGa1FoKnUy%2Fimage.png?alt=media&amp;token=d677259d-c244-4945-992d-bc36b15fbc4f" alt=""><figcaption></figcaption></figure>

\- 选择新项目

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FY4qPMMdpjp8yZxw7aDKM%2Fimage.png?alt=media&amp;token=a18a0d37-38c0-4095-a4c9-f8c3abea8131" alt=""><figcaption></figcaption></figure>

\- 输入项目名称并选择创建

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FJXh2lEl0WpLOslNw1iPI%2Fimage.png?alt=media&amp;token=b79e5452-dc86-4cd5-a0ac-b35d9105d452" alt=""><figcaption></figcaption></figure>

3. 启用Google sheet API

\- 在搜索栏中输入 Google Sheets API。出现搜索结果，然后在 Marketplace 中选择 Google Sheet API

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FN5kjAJtajj8y9aQceCi9%2Fimage.png?alt=media&amp;token=8848d757-ca7f-438c-88e0-36cd200db054" alt=""><figcaption></figcaption></figure>

\- 启用 Google 表格 API

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FsmJmgfPTRr4rhYyJraPA%2Fimage.png?alt=media&amp;token=f8d9dc4b-d6cc-497f-a94a-74397f2dfb81" alt=""><figcaption></figcaption></figure>

4. 创建Credentical

\- 成功启用Google Sheets API后，继续选择Credentials

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2Fj6N8BqL4pMfOqwpyaG3N%2Fimage.png?alt=media&amp;token=70bed373-15d3-48bb-bd19-5099cc5dd6b4" alt=""><figcaption></figcaption></figure>

\- 选择创建Credentical，然后选择服务帐户

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FmKX4X8RdkYXRkSpPGSxu%2Fimage.png?alt=media&amp;token=68c6be56-2520-4f02-b504-8c674aa9bd8a" alt=""><figcaption></figcaption></figure>

\- 输入服务帐户名称，然后选择“完成”

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FhfrsEkcN9kKLKTkRXLzj%2Fimage.png?alt=media&amp;token=370cb3c1-8278-4d59-b917-71ad97ef1a28" alt=""><figcaption></figcaption></figure>

\- 新创建的帐户将出现在此处：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2F2N9cPV2lyxYlm1sLTUDR%2Fimage.png?alt=media&amp;token=7fe52297-4269-4b16-8b76-fccecc271b0e" alt=""><figcaption></figcaption></figure>

\- 单击该帐户并选择“密钥”标签页：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2Fd8iwLEiAWiQqyH2Jitz2%2Fimage.png?alt=media&amp;token=1142ed38-5fe8-454b-904d-41019a35d04b" alt=""><figcaption></figcaption></figure>

\- 选择添加密钥 -> 选择创建新密钥：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FONkIcnUAC7iurvk94Q9v%2Fimage.png?alt=media&amp;token=efb0d4bf-5916-4b5c-ae9a-9f20b02d4128" alt=""><figcaption></figcaption></figure>

\- 选择 JSON -> 选择创建

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FclzmQI1gbqR9e8cIkgjC%2Fimage.png?alt=media&amp;token=b1425c60-06df-4b0e-a58e-afee3e84607c" alt=""><figcaption></figcaption></figure>

创建后，JSON 文件将自动下载，并将该文件添加到 WriteSheet 节点的 Credencial 字段中。

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2F2qv7B8yzoQnMwru2ynNO%2Fimage.png?alt=media&amp;token=0402cd5f-5d4d-4faa-86d3-3cadbca6c745" alt=""><figcaption></figcaption></figure>

5. 与上述步骤中创建的帐户共享工作表

\- 复制在上述步骤中创建的电子邮件：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FjAEDNjpaN5v9OuBCOXRy%2Fimage.png?alt=media&amp;token=494d4f20-5981-4185-8ba6-aeef47440cb0" alt=""><figcaption></figcaption></figure>

\- 与上面的帐户共享工作表页面：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FWp3F2zkWX2VhQpFYUod5%2Fimage.png?alt=media&amp;token=36bceae2-d2ab-4b5b-b07b-f5bb49fccfad" alt=""><figcaption></figcaption></figure>

这样我们就成功地执行了设置 Google Sheet 来提供 Google Sheet 上的阅读文件。下面的字段与本地文件类似。

## **详细说明**

假设我们有如下数据表：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FpILjpunOx7F0AUW640to%2Fimage.png?alt=media&amp;token=8fbf4adc-667e-493a-b2b8-2e546604ea80" alt=""><figcaption></figcaption></figure>

* 如果要自动串行写入包含数据的最后一行的下一行，则填写以下内容：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2Frm4ECBpngWejt3fYKJ59%2Fimage.png?alt=media&amp;token=8c37bbfe-3add-4f56-aa56-791d0685cf18" alt=""><figcaption></figcaption></figure>

当我们输入这个时，节点会自动将数据写入第7行

* 或者，如果您不想串行写入，但想指定要写入数据的单元格，则可以输入以下内容：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2F2LcdsJUzfjr1LYqF7CuB%2Fimage.png?alt=media&amp;token=a308f168-cbd3-43bb-bf46-b80a0de2f69f" alt=""><figcaption></figcaption></figure>

这样你就可以将数据写入你想要的单元格中。或者您可以输入已有数据的单元格，节点将覆盖您输入的单元格中的数据。

如果您想在读取数据后立即将数据写入 Excel 文件，并且想要准确写入每个相应的行，则可以使用 Spreadsheet V2 节点的行数据编号和总行数据字段。

假设我们有如下数据表：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2Fhl2lDX9mDSEY1o5Xny4w%2Fimage.png?alt=media&amp;token=b800d94a-6399-4339-aa9a-2c5654d77f23" alt=""><figcaption></figcaption></figure>

你想根据uuid读取每个对应的资料匹配的文件的每一行，那么进入Spreadsheet V2节点如下：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2FOE92FnVLK66bBO6SvLpN%2Fimage.png?alt=media&amp;token=802c639a-85a4-4420-925a-07cd7fa234c5" alt=""><figcaption></figcaption></figure>

您想要成功读取每一行并将其记录在相应的行中以了解该资料是否已成功读取您将使用 writeSheet 节点来记录：

<figure><img src="https://699023340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiEhmc20xmuwcG5ThYMWS%2Fuploads%2F2TSRuVu8VrxZJc3yIiM6%2Fimage.png?alt=media&amp;token=8dbba23a-2b60-4e52-8a92-0587e7e300c7" alt=""><figcaption></figcaption></figure>

所以当我们成功读取一行时，在对应的行中我们会写上“成功”。

下面是成功读取文件后写入文件的示例脚本，请将要运行的资料的 uuid 更改为 excel 文件。

{% file src="/files/l8vpklfed5omelapyN6A" %}

{% file src="/files/9hULBgynLIwSTxG0IgZR" %}
