获取数据

获取数据分类下包含“获取URL”、“获取粘贴板内容”、“元素数据”、“当前焦点元素”、“存到文件”、“存到Excel”、“下载文件”、“导入Excel素材”、“Google Sheet”、“导入txt”、“获取邮件”、“身份验证器码”、“监听请求触发”、“监听请求结果”、“停止页面监听”、“获取页面Cookies”、“清除页面Cookies”，共17个操作选项。

获取URL

场景举例：获取网页链接的相关信息，将相关信息存到某个变量，供其他操作使用。假设打开的一个网址是： https://www.amazon.com/s?k=nike&ref=nb_sb_noss

参数	说明
提取类型——完整地址	提取： https://www.amazon.com/s?k=nike&ref=nb_sb_noss
提取类型——根地址	提取： https://www.amazon.com
提取类型——参数值	输入“k”，提取“nike”保存至变量； 输入“ref”，提取“nb_sb_noss”保存至变量；
保存至	将提取的元素保存为一个变量，输入变量名。例如上图，提取了k的参数“nike”，保存至名为“var”的变量，那么在其他流程的 使用变量* 中使用变量“var”，则可以读取“var”的值“nike”。

获取粘贴板内容

场景举例：该功能用来获取粘贴板中的文本。例如，我们需要将复制的文本粘贴到另一个地方，就可以用到此功能。将文本从粘贴板中提取出来保存到一个变量里，以便在后续操作中使用。

元素数据

获取元素数据是使用最频繁的操作选项之一，经常被用于获取网页元素，然后将其保存为变量。保存的变量可以在支持【使用变量*】的操作选项中使用。

参数	说明
选择器	输入元素选择器，如#email_input、input[type="password"] 、.button_search等。选择器使用可参考： 点击查看
储存的元素对象	选择一个已保存为对象的变量。
元素顺序	固定值：选择网页里面的第几个元素。 区间随机：在设定的区间内随机选择一个元素。
提取类型	参考以下说明。
保存至	将提取的数据保存为一个变量，输入变量名，方便在其它流程中使用该变量。数据的具体类型，要看【提取类型】是什么

提取类型

提取类型选项的使用，请参考以下说明使用。

示例代码：

提取类型：文本

用选择器：.a-cardui-header 定位这个区块（网页元素），提取 <div class="a-cardui-header"> 区块内的所有文本，如“AdsPower”、"RPA is excellent"。

提取类型：对象

用选择器：.a-cardui-header 定位蓝框内的网页元素，将其提取为“对象”，并保存至变量。

提取类型：iFrame框架

跟提取对象类似，将一个网页元素保存为iframe框架类型的对象，其本质也是一个元素对象。其他RPA操作选项可对该元素对象操作，可以从iframe对象里继续提取其他类型的数据（文本、对象等）。

例如，从一个my_iframe的iframe对象里， 提取里面的文本

提取类型：源码

用选择器：.a-cardui-header 定位这个区块（网页元素），提取 <div class="a-cardui-header">区块内的所有子元素代码，即蓝框内的代码。

假设我们将变量命名为“button”，在后续操作中我们可对变量“button”（即元素对象“button”）进行其他操作。比如：

从元素对象“button”中里提取文本：

提取类型：属性

提取属性的值。用选择器 trans定位 trans元素，填写属性名：data-src。则提取的属性值为adspower。

提取类型：子元素

用选择器 h2 定位h2区块，子元素名填trans，则会将trans元素保存为一个元素对象。其他操作类型，可对该元素对象操作。

当前焦点元素

场景举例： 将聚焦状态下的元素存为某个变量。例如下图，amazon的搜索框，现在处于聚焦状态。

存到文件

场景举例：把获取到的变量，存到txt文件。txt文件保存位置在：【RPA】——【任务详情】——【日志详情】——【目录查看】。

参数	说明
文件名	填写要输出的txt文件名，文件名可以使用已保存的变量（使用变量*)
保存模板	如下图所示，可输入文字，以及使用已保存的变量（使用变量*)

存到Excel

场景举例：将网页获取的数据存到Excel里面，如商品的标题，价格等。

参数	说明
文件名	填写要输出的Excel文件名，文件名可以使用已保存的变量（使用变量*）
选择保存列	选择变量作为Excel的列名称，变量数据会存到对应的列。效果如下图所示：

下载文件

场景举例：下载网络某个文件到本地。

参数	说明
下载地址	填写文件的URL地址，下载地址可以使用已保存的变量（使用变量*)
保存路径	选择要存到本地的文件夹

导入Excel素材

场景举例：使用Excel的内容作为变量，供其他步骤调用。例如，要指定不同的2个浏览器，访问亚马逊，在搜索框输入不同的关键词。在序号802的浏览器中，要输入“Apple iPhone 13”；在序号803的浏览器中，要输入“Nike T-shirt”

使用说明：

• Excel示例

第一个表头： serial_number 为固定名称，即账号管理界面的浏览器环境的序号。如下图，指定序号802,803的两个浏览器。（ 注意：如果不指定浏览器，可删除 serial_number 这一列 ）

其它表头名称只能是字母、数字、下划线，且不能以数字开头参数名。如下图，使用【导入Excel素材】之后，可以使用serial_number，brand，series 这3个变量的数据。

• 步骤示例

Google Sheet

对Google表格进行读取、写入、清除操作

在使用此操作选项之前，您需要首先授予 AdsPower 对电子表格的访问权限。 有两种方法可以做到这一点：

1.与公众共享电子表格。

2.与 AdsPower 服务帐户共享电子表格。

当您与公众共享电子表格时，AdsPower 仅具有读取权限。

如果您计划更新电子表格的单元格值，则需要与 AdsPower 服务帐户共享电子表格。 为此，请打开要共享的电子表格，单击右上角的共享按钮，然后输入 [email protected]。

参数	说明
表格ID	电子表格 ID 包含字母、数字、连字符或下划线。 您可以在 Google 表格 URL 中找到它。 https://docs.google.com/spreadsheets/d/ 1uFuLlXMtcgyILDw_iBupPD5xyrbYvdUcgnkRnKm5_rk /edit#gid=0
工作表名称	您需要操作的工作表的名称
范围	您想要获取或更新的单元格值的范围，您可以使用 A1 表示法（如A1:B2）或 R1C1 表示法（如R1C1:R2C2）来定义单元格范围。选填，为空时将获取整个工作表的信息。

如何获取Google Cloud的服务账号密钥

1. 您需要在您的google cloud console开启Google Sheet API服务， https://console.cloud.google.com/

2. 开启服务之后，您需要创建凭据，请按照以下步骤进行创建凭据

3. 点击Service account之后，按照提示创建凭据，就会得到一个Account，然后点击编辑

4. 之后点击KEYS，选择创建一个新的key，记住一定要创建一个JSON格式的密钥，他会自动下载一个JSON文件

5. 然后把JSON文件里面的内容复制出来，放进RPA的Google Sheet设置里面即可。

6. 如果您的Google Sheet不是共享的，就需要将您生成的私钥账号邮箱添加授权，步骤3中有私钥邮箱的截图，每个私钥的邮箱都应该是不一样的

导入txt

场景举例：将txt文件的内容保存为变量，在其他操作选项中进行使用。举例如下：

txt文件格式如下：

获取邮件

场景举例：需要获取整封邮件或提取邮件里的部分信息 。

注意： 获取的邮件为设定规则内的最新的一封。

参数	说明
使用变量	使用已保存的变量
邮箱	输入邮箱账号
密码/授权码	连接邮箱需要开启IMAP访问，同时要生成邮箱专用授权码登录，如Gmail可查看【 专用授权码 】如何生成 ，其它邮箱请自行Google如何生成授权码，大部分连接不通的原因都是因为这里的问题，需仔细确认
邮箱服务器	请输入邮箱服务器，一般为imap.xxx.com，如gmail的邮箱服务器为imap.gmail.com 。 【暂不支持POP3协议】
端口	邮箱服务器端口
状态	从收件箱中选择提取指定状态的邮件。 勾选“标为已读”，则会将已提取的邮件状态标记为“已读”。 勾选“从垃圾邮件获取”，则将从收件箱、垃圾箱中进行提取邮件。该功能仅支持outlook邮箱。
邮件时间	提取指定时间内的邮件内容
发件人	发件人关键字，留空即全部
邮件标题	标题关键字，留空即全部
提取规则	可输入提取规则，提取邮件内的相关信息，如FB邮件中验证码为' FB-26362 '，输入' FB-(\d*) '，意思为匹配 FB- 后面的数字，即可提取到FB邮件中的验证码， 更多提取规则学习请 点击 如不输入提取规则，则默认提取整封邮件

身份验证器码

参数	说明
密钥	输入身份验证器密钥，例如，开启Facebook的二次验证，会提供一串代码，将此代码复制到密钥
保存至	将获取到的密钥保存为某个变量

监听请求触发

参数	说明
请求URL	例子： https://www.adspower.net/download?type=test ，这是一个get请求。
提取类型	分别获取以下类型，能得到的内容如下： 完整URL： https://www.adspower.net/download?type=test ； 请求头：请求头的内容； Get参数：参数名 type ，获取到的内容为 test ； Post数据：Post接口请求的参数；
保存至	输入变量名，将提取的内容保存为一个变量。

监听请求结果

参数	说明
请求URL	例子： https://www.adspower.net/download 。
保存至	输入变量名，将返回的请求结果保存为一个变量。

停止页面监听

描述： 可以在适当的时候，停止以上监听事件。

获取页面Cookies

描述：获取页面的cookies并保存为变量使用。

清除页面Cookies

描述：清除页面的cookies，清除后登录的账号将需要重新登录。