服务器数据共享

1 功能简介

1.1 服务器-变量

• 提供服务器端变量管理功能，查看变量列表。

• 服务器变量可以在 web 界面上进行编辑操作，支持服务器变量搜索，支持增删改操作。

• 支持设置一般变量，有一个名称（key），一个值。

• 支持设置账号密码变量，有一个名称（key），一个密码（password），密码加密保存。

• 支持在一般变量中设置 Python 表达式，例如值为：{"key1": "value1", "key2": "value2"}用于一次传递多值或者多个参数。

• 支持设置变量权限，可以指定所属部门，可以指定是否允许客户端修改。

1.2 服务器-数据

• 任务数据主要用于多个任务分布式并发情况下，轮流获取数据并维持数据状态的一套共享机制，也可以用这套共享机制实现其他场景下的数据共享。

• 任务数据可以定义多个队列，并对多个队列进行增删改查。

• 队列支持设定队列名称、失败尝试次数、所属部门和允许访问的机器人。

• 队列内容不能从服务端定义，只能通过 studio 或者机器人创建。

• 队列可以由服务端查询到具体数据内容。

• 队列中数据状态包括：pending、waittimeout、running、successed、failed、retried、deleted。

• 队列中数据一旦加入，会进入 pending 状态，数据有过期时间（deadline），过期后转为 waittimeout；只有 pending、retry 未达上限的数据会被弹出（pop），弹出后则进入 running；任务成功，数据进入 succ；任务失败，原来是 pending 的数据如果有设置重试次数则进入 retry 状态，如果没有重试数据进入 failed，原来是 retry 的数据则会尝试次数 +1，如果尝试次数到达上限，则会进入 failed 状态；如果客户端删除数据，进入 delete 状态。

• 具体数据处理和状态转换方法可以见组件相关说明。

• 可以设置优先级（priority）为 high、normal、low，弹出（pop）数据时，会首先获取 high 的数据，high 全部弹出（pop）完毕才弹出（pop）normal 的数据，最后是 low 的数据。同一优先级的数据，依据先进先出的原则，进行弹出（pop）。

1.3 服务器-文件

• 文件主要是实现本地文件在服务器端的上传、下载、删除及获取列表等操作。文件的上传、下载及删除可以通过对应组件实现，也可以在服务器端操作实现，并且成功操作的前提是设计器或机器人配置服务器IP地址。

2 服务器共享变量

在 8.0 以前，机器人和服务器之间的主要关系是调度、管理，在 9.0 及以后，我们增加了服务器对机器人的辅助能力——服务器变量。 共享变量是存储在服务器，而非存储在机器人里面，是持久化的变量。通过在服务端设置申明变量，可以指定机器人访问该变量，对变量进行获取、调用及设置。

2.1 新增服务器变量

服务器变量存储在服务器中，因此只能在服务端定义，不能在客户端定义和声明。

1 ）登录服务端

2） 新增变量

在"自动化"—“变量”中，点击“新增”。

3)参数设置

(1) 变量类型

服务器变量分为普通和密码两种类型，当设置为“密码类型”时，保存后密码以“*****”形式保存，即密码加密保存。

(2)变量值

支持整型、字符串、数组类型，也可以定义一个 “key-value”，将变量值写成{"key1": "value1", "key2": "value2"}形式，用一个变量保存一堆变量，即字典型。

(3)权限

金蝶云苍穹RPA机器人使用服务器变量受限于所属部门和机器人，即限定谁能访问这个变量，以及谁可以修改变量。

（1）当设置为“特定机器人”，那么所属部门就无关紧要了，此时只有特定机器人可以获取、调用和设置该变量；

（2）当设置为“动态分配”，则此部门下的和没有部门的机器人可以获取、调用和设置该变量；

（3）当设置为“所属部门”，则只有所属部门下的机器人可以获取、调用和设置该变量。

（4）权限所属部门配置 在权限设置时，可以在服务端“系统”——“部门管理”中对所属部门进行配置，以便选择。

(4)客户端修改

设置修改变量的权限，勾选时则允许机器人客户端修改服务器变量。

(5)Python表达式

适用于字典型的服务器变量，即{"key1": "value1, "key2": "value2}型，勾选“ Python 表达式”，可以获取字典中任意“key”的值，但对于字符串类型变量需要去掉勾选Python表达式，否则报错。

(6)新增成功

2.2 获取服务器变量

可以使用设计器和机器人获取到服务器变量。

1) 使用设计器获取服务器变量

(1) 配置访问服务器地址

在设计器“账号”-“切换账号”中，登录“企业服务器”，配置访问服务端地址：

(2) 组件设置

在画布中选择“获取变量”组件并填入要获取的服务器变量名称：

注： 变量名为服务端设置的名称。 超时时间指接口超时时间。

(3) 服务器变量设置

服务器变量值为：

(4) 运行结果

• 若为一般变量，则返回原变量值。

• 若为密码变量，则返回加密后的变量值。

2） 使用机器人获取服务器变量

（1） 配置访问服务器地址

在机器人“注册”中配置服务端地址：

（2） 组件设置

在画布中选择“获取变量”组件并填入要获取的服务器变量名称：

注： 变量名为服务端设置的名称。 超时时间指接口超时时间。

（3） 发布流程到本地机器人

在“工具”-“发布为流程”将此流程发布到本地机器人：

执行流程：

（4 ）执行结果

机器人运行结束后可在日志中查看服务器变量的值：

（5） 勾选python表达式

如果一般变量中值为字典型，例如值为：{"aa": 11", "bb": "22"}，并勾选“ Python 表达式”，则可以获取变量中某一个“key”的值：

示例，服务器设置变量值为：

返回值为指定“key”的值：

如果没有勾选“Python 表达式”，则报错：

2.3 设置服务器变量

对服务端的变量进行设置可以通过设计器，也可以通过运行机器人设置。

注：前提条件必须在服务器变量编辑页面勾选客户端修改选项

1）通过设计器设置

（1）设计器中“设置变量”组件如下，即将变量“text1”的值设置为“55”：

变量名：共享变量菜单中的“变量名”。 值：要变更的值。 超时时间：接口超时时间。

（2）运行组件，返回值为True,变量设置成功：

（3）在服务端查看更改结果成功：

（4）若流程变量失败，则返回提示，并输出为空：

2）通过机器人设置

（1）创建“设置变量”流程：

（2）在“工具”-"发布为流程将流程发布到本地机器人"：

（3）成功执行流程，查看运行日志，返回值为True:

（4）服务器端查看，变量设置成功：

（5）若失败，则运行日志提示，并返回为空：

3 服务器任务数据

3.1 服务器数据

1）功能说明

实现在服务器共享空间中新增数据的操作。

2）基本使用说明

（1） 新增数据空间

1 在服务器的“自动化-数据”栏，新增空间以便存放数据。

注： 空间名：设置存储空间的名称。 空间项最大数：向该空间发送数据的最大条数。

2 新增成功

3 数据空间

• 支持服务器数据共享，所有机器人均可按权限访问。

• 支持一个空间保存多条数据。

• 支持数据状态定义，以保证机器人有条不紊地分配和共享数据。

（2） 新增数据

空间里的数据不能在服务器端定义的，只能使用“新增数据”组件定义。

Ⅰ 通过设计器新增

1 组件设计 在“服务器-新增数据”组件中填入数据如下：

2 参数设置 空间名称：任务数据菜单中的“空间名”； 数据：需要上传至空间的数据，格式为{"aa":"11","bb":"22"}，即字典类型； 级别：分为normal、high、low三个级别，优先级高的数据会被优先处理； DeadLine：数据到期时间，过期后转为 waittimeout 状态； 超时时间：接口超时时间。

3 IP地址配置 成功向服务器端上传数据的前提是设计器配置了服务器IP地址，因此需要将设计器登录指定IP。

4 运行结果 运行组件，结果如下，若成功返回值为“True”,失败则为“False”。

5

Ⅱ  通过机器人新增

1 组件设计和参数设置同“2.2.1”，这里我们将数据改为{'a':'2','b':'9'}

2 发布流程：将流程推送给本地机器人。

3 机器人IP地址配置 成功向服务器端上传数据的前提是机器人配置了服务器IP地址，因此需要将机器人登录指定IP。

4 运行机器人：执行成功后新增数据成功存储于服务器空间中。 运行日志如下，返回值为true，执行成功：

在ES端查看新增数据，看到机器人通过project12新增一个数据：

3）权限问题

对于服务器的数据共享，所有设计器或机器人必须按照设定权限访问。

• （1）当设置为“特定机器人”，那么所属部门就无关紧要了，此时只有特定机器人可以访问空间数

• （2）当设置为“动态分配”，则此部门下的和没有部门的机器人或设计器可以访问空间数据；

• （3）当设置为“所属部门”，则只有所属部门下的机器人和设计器可以访问空间数据。

• （4）权限所属部门配置 在权限设置时，可以在服务端“系统”——“部门管理”中对所属部门进行配置，以便选择。

3.2 查询服务器数据

1）功能说明

根据查询条件，查询某个空间下的相应数据。

2）基本使用说明

1 组件设置

2 参数设置：设置待查询数据的条件。

开始时间：数据pop时间。 结束时间：数据状态设置时间。 级别：normal、high、low，未选择默认全部。 状态：等待运行（pending）、等待超时（waittimeout）、正在运行（running）、运行成功（succ）、运行失败（failed）、已删除（delete）、重试运行（retry），未选择默认全部。 表达式：格式示例'status:pening' 超时时间：接口超时时间。

3 运行组件，结果如下,输出值为所查询空间中数据组成的字典。

3.3 POP服务器数据

1）功能说明

即使用数据，只有状态为pending和retry的数据可以POP，数据一旦被POP，状态变为running ，且每次只POP一条数据。

2）基本使用说明

（1）组件设置如下：

（2）参数设置：设置待查询数据的条件。

空间名称：要查询的数据所在空