Yingdao RPA

https://www.yingdao.com/yddoc/
Admin
Yingdao RPA is a robotic process automation platform that enables users to build and automate...
Tokens:409,578
Snippets:3,624
Trust Score:8.1
Update:2 months ago
Show doc for...
Tokens:
Raw
### Start and Enable Docker Service on CentOS

Source: https://www.yingdao.com/yddoc/rpa/710400213407707136

Start the Docker service and configure it to start automatically on system boot.

```bash
sudo systemctl start docker
sudo systemctl start docker
```

```bash
sudo systemctl enable docker
sudo systemctl enable docker
```

--------------------------------

### Install Robot Application with Docker

Source: https://www.yingdao.com/yddoc/rpa/710401115938041856

Run this command to download and execute the installation script for the robot application. Ensure Docker and curl are installed locally.

```bash
curl https://gitee.com/shuai_luther/robot.io/raw/master2/install.sh | bash
```

```bash
curl https://gitee.com/shuai_luther/robot.io/raw/master2/install.sh | bash
```

--------------------------------

### Install Docker Engine on Ubuntu

Source: https://www.yingdao.com/yddoc/rpa/710400213407707136

Install Docker Engine, CLI, containerd, and Docker Compose plugin using apt.

```bash
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```

--------------------------------

### Verify Docker Engine Installation on Ubuntu

Source: https://www.yingdao.com/yddoc/rpa/710400213407707136

Run the 'hello-world' Docker image to confirm that the Docker Engine installation was successful.

```bash
sudo docker run hello-world
sudo docker run hello-world
```

--------------------------------

### Start and Enable Docker Service on CentOS 7

Source: https://www.yingdao.com/yddoc/rpa/710407574932291584

Starts the Docker service and configures it to launch automatically on system boot for CentOS 7. This command ensures Docker is running and persistent across reboots.

```bash
systemctl start docker ; systemctl enable docker
systemctl start docker ; systemctl enable docker
```

--------------------------------

### Install Docker Engine on CentOS

Source: https://www.yingdao.com/yddoc/rpa/710400213407707136

Install Docker Engine, CLI, containerd, and Docker Compose plugin using yum.

```bash
yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```

--------------------------------

### Install yum-utils on CentOS

Source: https://www.yingdao.com/yddoc/rpa/710400213407707136

Install the 'yum-utils' package, which provides the 'yum-config-manager' utility for managing repositories.

```bash
yum install -y yum-utils
yum install -y yum-utils
```

--------------------------------

### Java 9+ Plugin Manual Installation Command

Source: https://www.yingdao.com/yddoc/rpa/710777410891939840

Use this command to manually install the Java plugin for versions 9 and above. Ensure the path to BridgeLib V2 is correct for your system's architecture (x86 or x64).

```bash
java.exe -cp "C:\Program Files (x86)\ShadowBot\shadowbot-5.18.5\support_x86\java\BridgeLib\V2\*" -Djavax.Accessibility.Assistive_technologies=ShadowBotJavaServiceProvider App
```

--------------------------------

### Set up Docker Repository GPG Key and Source List on Ubuntu

Source: https://www.yingdao.com/yddoc/rpa/710400213407707136

Install the Docker GPG key and add the Docker repository to your apt sources list for Ubuntu.

```bash
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
```

```bash
echo \
  "deb [arch=\"`dpkg --print-architecture\" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
echo \
  "deb [arch=\"`dpkg --print-architecture\" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

--------------------------------

### 修改配置文件内容

Source: https://www.yingdao.com/yddoc/rpa/710403486730629120

使用'cat > config.py'命令并粘贴以下内容来修改'config.py'文件。根据实际需求修改'Port'、'App_Key'、'APP_SECRET'、Redis相关配置、Vika相关配置以及Ding相关配置。

```python
#服务器后台开启的安全组端口号
Port = 8111


#微应用的key和密钥，直接复制进来
App_Key = 'dingjscafpn9ta6fgesk'
APP_SECRET = "YJ1RygHwhJS6VdxboH4FD-dMN_O0xC5W9m84GGulW0UvYiY0PEGy4hdGw34_Cwhq"


#redis数据库的ip地址和密码，10号仓库默认收集信息，如有冲突可自行更改
Redis_ = False
Redis_Host = '116.62.11.57' # IP
Redis_password = ''
Redis_DB = 10  # Default warehouse is 10
Redis_Port = 6379 


#是否回传到维格表，打开为True
#传入toekn和 sheet的id
Vika_ = False
Vika_token = 'uskbHxfHPTRZxThzLfpUWDD'  # Vika_ 为True时 生效
Vika_dst = 'dstEorRaECyY7e5WH0'


#是否记录聊天信息到钉钉在线表格，打开为True
#传入userid和表格id
Ding_ =False   #钉钉开发
User_id  = 'manager8121'
Workbook_id = "v1GXn4g93gMGlDQ4"
#服务器后台开启的安全组端口号
Port = 8111


#微应用的key和密钥，直接复制进来
App_Key = 'dingjscafpn9ta6fgesk'
APP_SECRET = "YJ1RygHwhJS6VdxboH4FD-dMN_O0xC5W9m84GGulW0UvYiY0PEGy4hdGw34_Cwhq"


#redis数据库的ip地址和密码，10号仓库默认收集信息，如有冲突可自行更改
Redis_ = False
Redis_Host = '116.62.11.57' # IP
Redis_password = ''
Redis_DB = 10  # Default warehouse is 10
Redis_Port = 6379 


#是否回传到维格表，打开为True
#传入toekn和 sheet的id
Vika_ = False
Vika_token = 'uskbHxfHPTRZxThzLfpUWDD'  # Vika_ 为True时 生效
Vika_dst = 'dstEorRaECyY7e5WH0'


#是否记录聊天信息到钉钉在线表格，打开为True
#传入userid和表格id
Ding_ =False   #钉钉开发
User_id  = 'manager8121'
Workbook_id = "v1GXn4g93gMGlDQ4"

```

--------------------------------

### Write data to a table range

Source: https://www.yingdao.com/yddoc/rpa/711191261314269184

Writes a 2D array of values starting at the specified row and column. The row index starts at 1 and the column identifier starts at 'A'.

```python
from xbot import app
def main(args):
    app.databook.set_range(1, 'A', [['1','2','3'],['a','b','c']])
```

--------------------------------

### Install Required Packages for Docker on CentOS 7

Source: https://www.yingdao.com/yddoc/rpa/710407574932291584

Installs `yum-utils` and other necessary packages for Docker installation on CentOS 7. These utilities are required for managing yum repositories and for the devicemapper storage driver.

```bash
yum install -y yum-utils device-mapper-persistent-data lvm2
yum install -y yum-utils device-mapper-persistent-data lvm2
```

--------------------------------

### 创建配置文件

Source: https://www.yingdao.com/yddoc/rpa/710403486730629120

在服务器上创建名为'config.py'的配置文件，用于存储机器人相关的配置信息。

```bash
cd /home && touch config.py
cd /home && touch config.py
```

--------------------------------

### Automated RDP and ShadowBot Startup Script

Source: https://www.yingdao.com/yddoc/rpa/816184111428984832

A batch script to initialize the RDP launcher and ShadowBot application, including logging and workstation locking.

```batch
cd /d %~dp0

start rdp\launcher.exe

timeout  7
start  "rdp start "  /d  "C:\Program Files (x86)\ShadowBot" "C:\Program Files (x86)\ShadowBot\ShadowBot.exe"
timeout  7

set && echo %time% > log.txt

rundll32.exe user32.dll,LockWorkStationcd /d %~dp0

start rdp\launcher.exe

timeout  7
start  "rdp start "  /d  "C:\Program Files (x86)\ShadowBot" "C:\Program Files (x86)\ShadowBot\ShadowBot.exe"
timeout  7

set && echo %time% > log.txt

rundll32.exe user32.dll,LockWorkStation
```

--------------------------------

### 检查Docker容器运行状态

Source: https://www.yingdao.com/yddoc/rpa/710403486730629120

使用'docker ps'命令查看正在运行的Docker容器，以确认机器人容器是否已成功启动。

```bash
[root@VM-16-17-centos robot_ding]# docker ps
CONTAINER ID        IMAGE                     COMMAND                  CREATED             STATUS              PORTS                    NAMES
7b5dbcbc3e8a        hexia666/robot_ding:1.0   "nohup python3 main.…"   15 minutes ago      Up 55 seconds       0.0.0.0:8111->8111/tcp   my-robot
[root@VM-16-17-centos robot_ding]# docker ps
CONTAINER ID        IMAGE                     COMMAND                  CREATED             STATUS              PORTS                    NAMES
7b5dbcbc3e8a        hexia666/robot_ding:1.0   "nohup python3 main.…"   15 minutes ago      Up 55 seconds       0.0.0.0:8111->8111/tcp   my-robot
```

--------------------------------

### set_range(row_num, col_name, values)

Source: https://www.yingdao.com/yddoc/rpa/711191261314269184

Writes content to a specified area of a data table. The row_num starts from 1 and col_name starts from 'A'.

```APIDOC
## set_range(row_num, col_name, values)

### Description
Writes content to a specified area of a data table.

### Parameters
- **row_num** (int) - Required - The starting row number for the content, starting from 1.
- **col_name** (string) - Required - The starting column name for the content, starting from 'A'.
- **values** (array) - Required - A two-dimensional array containing the content to be set.

### Example
```python
from xbot import app
def main(args):
    app.databook.set_range(1, 'A', [['1','2','3'],['a','b','c']])
```
```

--------------------------------

### get() - Get Window by Title or Class Name

Source: https://www.yingdao.com/yddoc/language/zh-cn/%E6%8E%A5%E5%8F%A3%E6%96%87%E6%A1%A3/xbot%C2%B7win32/xbot%C2%B7win32.html

Retrieves a window object by its title, class name, or using wildcard matching.

```APIDOC
## get()

### Description
Through the title or class name, get the window object.

### Method Signature
`get(title, class_name=None, use_wildcard=False)`

### Parameters
- **title** (string) - Required - The specified window title.
- **class_name** (string) - Optional - The specified window class name, defaults to None.
- **use_wildcard** (boolean) - Optional - Whether to use wildcard matching, defaults to False (fuzzy matching).

### Returns
- **Win32Window** - The obtained window object.

### Examples
#### Example 1: Get window by title
```python
from xbot import win32

def main(args):
    wnd = win32.get('钉钉')
    print(wnd)
```
**Logic:** Get the window object with the title '钉钉' and print it.

#### Example 2: Get window using wildcard matching
```python
from xbot import win32

def main(args):
    wnd = win32.get('hello*', class_name=None, use_wildcard=True)
    print(wnd)
```
**Logic:** Use wildcard matching to get the window object with a title starting with 'hello' and print it.
```

--------------------------------

### activate()

Source: https://www.yingdao.com/yddoc/rpa/711170945169735680

Brings the specified window to the foreground and activates it.

```APIDOC
## activate()

### Description
Activates the window, bringing it to the foreground.
```

--------------------------------

### 连接数据库 open()

Source: https://www.yingdao.com/yddoc/rpa/711190445287260160

使用数据库连接字符串初始化并打开数据库连接。

```python
from xbot import ado
def main(args):
    db = ado.Database()
    db.open('数据库连接字符串')
```

--------------------------------

### get() - Get webpage by title or URL

Source: https://www.yingdao.com/yddoc/language/zh-cn/%E6%8E%A5%E5%8F%A3%E6%96%87%E6%A1%A3/xbot%C2%B7web/xbot%C2%B7web.html

Retrieves an existing webpage based on its title or URL. Can optionally open a new page if not found.

```APIDOC
## get()

### Description
Retrieves an existing webpage based on its title or URL. If not found, it can optionally open a new page.

### Method
get(title=None, url=None, mode='cef', load_timeout=20, use_wildcard=False, stop_if_timeout=False, open_page=False, page_url=None, silent_running=False)

### Parameters
#### Path Parameters
- **title** (string) - Optional - The title of the webpage to find.
- **url** (string) - Optional - The URL of the webpage to find.
- **mode** (string) - Optional - The browser type. Supported values include 'cef', 'chrome', 'ie', 'edge', '360se', or a custom browser name from `ChromiumBrowser.config`.
- **load_timeout** (integer) - Optional - Timeout in seconds for the page to load. Defaults to 20 seconds.
- **use_wildcard** (boolean) - Optional - Whether to use wildcard matching for title or URL. Defaults to False.
- **stop_if_timeout** (boolean) - Optional - Whether to stop loading the page if the timeout is reached. Defaults to False.
- **open_page** (boolean) - Optional - Whether to open a new page if no match is found. Defaults to False.
- **page_url** (string) - Optional - The URL to open if `open_page` is True and no match is found.
- **silent_running** (boolean) - Optional - Whether to run without抢占 mouse and keyboard input. Defaults to False.

### Return Value
- **WebBrowser** - An object representing the found or opened webpage.

### Request Example 1
```python
from xbot import web

def main(args):
    web_object = web.get('百度', None, 'chrome', load_timeout=20, use_wildcard=False)
```

### Example Usage 1
This example demonstrates finding a webpage with a title starting with '百度' in a Chrome browser without using wildcards.
```

```APIDOC
### Request Example 2
```python
from xbot import web

def main(args):
    web_object = web.get('百度*', None, 'chrome', load_timeout=20, use_wildcard=True)
```

### Example Usage 2
This example demonstrates finding a webpage with a title starting with '百度' in a Chrome browser using wildcard matching.
```

--------------------------------

### 启动机器人Docker容器

Source: https://www.yingdao.com/yddoc/rpa/710403486730629120

使用Docker命令拉取并启动机器人容器。此命令将容器命名为'my-robot'，并将本地的'config.py'文件挂载到容器内的'/app/config.py'，同时将服务器的8111端口映射到容器的8111端口。

```bash
docker run -d --name my-robot -v /home/config.py:/app/config.py -p 8111:8111 hexia666/robot_ding:2.0
docker run -d --name my-robot -v /home/config.py:/app/config.py -p 8111:8111 hexia666/robot_ding:2.0
```

--------------------------------

### Update apt and Install HTTPS Transport on Ubuntu

Source: https://www.yingdao.com/yddoc/rpa/710400213407707136

Update the apt package index and install necessary packages to allow apt to use repositories over HTTPS.

```bash
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
```

--------------------------------

### Get Active Webpage in Chrome

Source: https://www.yingdao.com/yddoc/language/zh-cn/%E6%8E%A5%E5%8F%A3%E6%96%87%E6%A1%A3/xbot%C2%B7web/xbot%C2%B7web.html

Gets the currently active or selected web page within the Chrome browser. Useful for interacting with the page the user is currently viewing.

```python
from xbot import web
def main(args):
    web_object = web.get_active('chrome', load_timeout=20)
```

--------------------------------

### 检查ADB设备连接状态

Source: https://www.yingdao.com/yddoc/rpa/816946091888648192

通过命令行工具验证ADB是否能识别到连接的手机设备。

```powershell
.\adb.exe devices
```

--------------------------------

### 下载cmd.exe修复工具

Source: https://www.yingdao.com/yddoc/rpa/710905324435652608

当系统缺失cmd.exe导致浏览器自动化失败时，可下载并恢复该文件。

```html
<a href="/cmd.exe" target="_blank">cmd.exe</a>
<a href="/cmd.exe" target="_blank">cmd.exe</a>
```

--------------------------------

### GET /oapi/token/v2/token/create

Source: https://www.yingdao.com/yddoc/language/zh-cn/%E7%AE%A1%E7%90%86%E6%96%87%E6%A1%A3/%E5%BC%80%E6%94%BEapi/api%E6%8E%A5%E5%8F%A3/%E9%89%B4%E6%9D%83.html

获取用于后续API调用的accessToken。该接口通过accessKeyId和accessKeySecret进行身份验证，返回的accessToken有效期为2小时。

```APIDOC
## GET /oapi/token/v2/token/create

### Description
获取用于后续API调用的accessToken。该接口通过accessKeyId和accessKeySecret进行身份验证，返回的accessToken有效期为2小时。

### Method
GET

### Endpoint
https://api.yingdao.com/oapi/token/v2/token/create

### Parameters
#### Query Parameters
- **accessKeyId** (string) - Required - 企业管理员在控制台创建的accessKeyId
- **accessKeySecret** (string) - Required - 企业管理员在控制台创建的accessKeySecret

### Request Example
http://xxx/oapi/token/v2/token/create?accessKeyId=MerC5cKPSa7BTG1A@platform&accessKeySecret=mqTxhk4aK1v7PpDtfQU6dCMgnrR50HFc

### Response
#### Success Response (200)
- **code** (int) - 状态码
- **success** (boolean) - 是否成功
- **msg** (string) - 提示信息
- **data** (object) - 响应数据
- **accessToken** (string) - 访问令牌
- **expiresIn** (int) - 有效期（秒）

#### Response Example
{
    "data": {
        "accessToken": "520da9c9-694d-4b40-9332-0c179243c88e",
        "expiresIn": 7199
    },
    "code": 200,
    "success": true,
    "requestId": "601cf6274032e2cc335c97d2"
}
```

--------------------------------

### 使用 dblclick_on_window 执行窗口内双击

Source: https://www.yingdao.com/yddoc/rpa/711120169041866752

在指定窗口句柄内查找图像并执行双击操作。

```python
from xbot import win32
def main(args):
    hWnd = win32.get('新建文件').hWnd
    win32.image.dblclick_on_window(hWnd, '图像1', anchor=('middleCenter', 100, 100),
                                   move_mouse=True)
```

--------------------------------

### Single Trigger Example Data - IPAAS

Source: https://www.yingdao.com/yddoc/ipaas/761124316615204864

Example JSON data structure for a single queue item triggered by the Webhook Trigger. This shows the format of the '队列项信息' (queue item information) output.

```json
{
    "队列项信息":{
        "ID":"q748107450832273408_R750971623220600833",
        "名称":"子鱼的队列项",
        "业务信息":"{\"hello\":\"你好\"}",
        "结果注释":"None",
        "过期时间":"1731067275",
        "状态":"processing"
    }
}
```

```json
{
    "队列项信息":{
        "ID":"q748107450832273408_R750971623220600833",
        "名称":"子鱼的队列项",
        "业务信息":"{\"hello\":\"你好\"}",
        "结果注释":"None",
        "过期时间":"1731067275",
        "状态":"processing"
    }
}
```

--------------------------------

### Activate Window

Source: https://www.yingdao.com/yddoc/rpa/711170945169735680

Brings the specified window to the foreground.

```python
from xbot import win32


def main(args):
    wnd = win32.get_by_handle(0x01402c)
    wnd.activate()
```

--------------------------------

### Install Specific Docker CE Version on CentOS 7

Source: https://www.yingdao.com/yddoc/rpa/710407574932291584

Installs a specific version of Docker CE (e.g., 18.03.1.ce) on CentOS 7 using yum. Replace '版本号' with the desired version number.

```bash
yum -y install docker-ce-18.03.1.ce
yum -y install docker-ce-18.03.1.ce
```

--------------------------------

### 通用文字识别

Source: https://www.yingdao.com/yddoc/rpa/711184153751568384

使用 general 方法对 XbotImage 对象进行通用印刷文字识别。

```python
import xbot
from xbot import print, sleep
from . import package


def main(args):
    ocr_engine = xbot.ai.AliyunAI(app_code="xxxx")
    ocr_image = xbot.ai.XbotImage.from_screen()
    ocr_result = ocr_engine.general(ocr_image)
    for word in ocr_result['words']:
        print(word)
```

--------------------------------

### 修复chrome-sandbox权限问题

Source: https://www.yingdao.com/yddoc/rpa/816206635990552576

修改chrome-sandbox文件的所有者并设置SUID权限以解决启动报错。

```bash
sudo chown root /opt/ShadowBot/chrome-sandbox && sudo chmod 4755 /opt/ShadowBot/chrome-sandbox
```

--------------------------------

### List Available Docker CE Versions on CentOS 7

Source: https://www.yingdao.com/yddoc/rpa/710407574932291584

Displays all available versions of Docker CE that can be installed on CentOS 7, sorted in reverse order. This helps in selecting a specific version for installation.

```bash
yum list docker-ce --showduplicates | sort -r
yum list docker-ce --showduplicates | sort -r
```

--------------------------------

### GET https://api.yingdao.com/oapi/rpa/user/v1/list

Source: https://www.yingdao.com/yddoc/rpa/710498885910380544

查询符合条件的RPA企业账号列表。一次调用最多返回100个账号，支持通过分页参数获取完整列表。

```APIDOC
## GET https://api.yingdao.com/oapi/rpa/user/v1/list

### Description
获取企业下符合条件的所有RPA企业账号数据。调用需具备调度管理员权限。

### Method
GET

### Endpoint
https://api.yingdao.com/oapi/rpa/user/v1/list

### Parameters
#### Query Parameters
- **phone** (String) - Optional - 完整的手机号
- **accountKeyword** (String) - Optional - 账号关键词
- **latestLoginTimeBegin** (Long) - Optional - 最后登录时间左边界，秒级时间戳
- **latestLoginTimeEnd** (Long) - Optional - 最近登录时间右边界，秒级时间戳
- **expiredTimeBegin** (Long) - Optional - 过期时间左边界，秒级时间戳
- **expiredTimeEnd** (Long) - Optional - 过期时间右边界，秒级时间戳
- **accountTypes** (List<String>) - Optional - 账号类型列表，基础账号-basic，高级账号-senior
- **page** (int) - Optional - 页码
- **size** (int) - Optional - 一页默认20条，最大支持100

### Response
#### Success Response (200)
- **data** (array) - 结果数据列表
- **page** (object) - 分页数据
- **code** (integer) - 返回结果编码，200表示成功
- **success** (boolean) - 调用是否成功
- **requestId** (string) - 请求id

#### Response Example
{
    "data": [
        {
            "userUuid": "xxxuuid",
            "loginAccount": "xxxacc@abbr",
            "name": "xxxname",
            "phone": "13312345678",
            "role": "e_user",
            "roleName": "员工",
            "accountType": "basic",
            "accountTypeName": "基础账号",
            "latestLoginTime": "2024-02-28 15:21:51",
            "expiredTime": "2025-01-19 23:59:59"
        }
    ],
    "page": {
        "total": 1,
        "size": 20,
        "page": 1,
        "pages": 1,
        "offset": 0,
        "order": "desc"
    },
    "code": 200,
    "success": true,
    "requestId": "44265d53-842b-4a7f-9174-6bd900ebaa91"
}
```

--------------------------------

### GET https://api.yingdao.com/oapi/dispatch/v2/job/log/query

Source: https://www.yingdao.com/yddoc/rpa/710479934544805888

轮询获取应用运行日志。建议每隔100ms轮询一次，若返回80204002则表示日志处理中，需继续轮询。

```APIDOC
## GET https://api.yingdao.com/oapi/dispatch/v2/job/log/query

### Description
该接口用于轮询获取应用运行的日志。调用前需先通过通知查询应用运行日志接口获取requestId。建议每隔100ms轮询一次，若返回状态码80204002，表示日志正在处理中，需继续轮询。

### Method
GET

### Endpoint
https://api.yingdao.com/oapi/dispatch/v2/job/log/query

### Parameters
#### Query Parameters
- **requestId** (string) - Required - 应用运行uuid，通过启动应用接口获取

### Request Example
https://api.yingdao.com/oapi/dispatch/v2/job/log/query?requestId=xxx

### Response
#### Success Response (200)
- **code** (int) - 状态码 (200: 成功, 500: 失败, 80204002: 处理中)
- **success** (boolean) - 调用是否成功
- **msg** (string) - 状态码描述
- **data** (object) - 包含requestId及日志分页信息
- **logs** (object) - 日志列表，包含time, level, text, logId

#### Response Example
{
    "requestId": "xxxxx",
    "page": {
        "total": 18,
        "size": 10,
        "page": 1
    },
    "logs": [
        {
            "level": "信息",
            "logId": 1,
            "text": "开始执行...",
            "time": "03/20/2024 15:35:23"
        }
    ]
}
```

--------------------------------

### 触发媒体扫描ADB命令

Source: https://www.yingdao.com/yddoc/rpa/816948983343276032

执行此命令以强制Android系统扫描指定路径，从而刷新相册显示新传输的文件。

```bash
adb shell am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///storage/emulated/0
adb shell am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///storage/emulated/0
```

--------------------------------

### 添加Windows凭据

Source: https://www.yingdao.com/yddoc/rpa/712239278215565312

根据提供的凭据信息创建Windows凭据，包括凭据名、用户名、密码及凭据类型。

```APIDOC
## 添加Windows凭据

### 描述
根据提供的凭据信息创建Windows凭据。

### 参数配置
#### 指令输入
- **凭据名** (string) - Required - 用于唯一标识和引用该凭据的名称
- **用户名** (string) - Required - Windows账户的用户名
- **密码** (string) - Required - Windows账户的密码
- **凭据类型** (string) - Required - 凭据的类型（如Generic、Domain等）

### 指令输出
- 无
```

--------------------------------

### start_monitor_network()

Source: https://www.yingdao.com/yddoc/rpa/711156972382830592

Starts monitoring network requests on the current page.

```APIDOC
## start_monitor_network()

### Description
Begins capturing network requests. Note: Not supported in Chrome or IE.

### Parameters
None

### Returns
None
```

--------------------------------

### 诊断录屏文件访问权限

Source: https://www.yingdao.com/yddoc/rpa/816198350092398592

在ShadowBot安装目录下运行此命令以检查FFmpeg是否因权限问题无法写入录像文件。若提示拒绝访问，需以管理员身份运行影刀。

```bash
.\ffmpeg.exe -v error -f gdigrab -framerate 3 -i desktop -c:v libx264 -pix_fmt yuv420p -vf scale=1400:786 -f segment -segment_time 1800 -reset_timestamps 1 "D:\Shadowbot\screencast\c7ebb807-856a-48fe-8256-f4989fb7da22\113419_%01d.mp4"
```

--------------------------------

### Get all select items

Source: https://www.yingdao.com/yddoc/rpa/711162930699644928

Retrieves all options from a dropdown element.

```python
from xbot import web


def main(args):
    browser = web.get_active()
    element = browser.find('下拉框')
    values = element.get_all_select_items()
```

--------------------------------

### 使用 click_on_window 执行窗口内点击

Source: https://www.yingdao.com/yddoc/rpa/711120169041866752

在指定窗口句柄内查找图像并执行带辅助键的点击操作。

```python
from xbot import win32
from .package import *


def main(args):
    hWnd = win32.get('新建文本').hWnd
    win32.image.click_on_window(hWnd, '图像1', anchor=('middleCenter', 100, 100),
                                button='left', keys='alt', move_mouse=True)
```

--------------------------------

### xbot.win32.get_desktop()

Source: https://www.yingdao.com/yddoc/rpa/711891547003535360

Retrieves the desktop window object.

```APIDOC
## xbot.win32.get_desktop()

### Description
Retrieves the desktop window object.

### Method Signature
`get_desktop()`

### Parameters
None

### Returns
- **Win32Window** - The desktop window object.

### Examples
#### Example 1: Get the desktop object
```python
from xbot import win32

def main(args):
    wnd = win32.get_desktop()
```
**Logic:** Gets the computer's desktop window object.
```

--------------------------------

### Get Worksheet Name

Source: https://www.yingdao.com/yddoc/rpa/711141551752855552

Retrieves the name of the current worksheet.

```python
from xbot import excel

def main(args):
    workbook = excel.open('D:\\test.xlsx', kind = 'office', visible = True)
    worksheet = workbook.get_active_sheet()
    count = worksheet.get_name()
```

--------------------------------

### create() - Open a webpage

Source: https://www.yingdao.com/yddoc/language/zh-cn/%E6%8E%A5%E5%8F%A3%E6%96%87%E6%A1%A3/xbot%C2%B7web/xbot%C2%B7web.html

Opens a new webpage in a specified browser. Supports various browser types and custom configurations.

```APIDOC
## create()

### Description
Opens a new webpage in a specified browser.

### Method
create(url, mode='cef', load_timeout=20, stop_if_timeout=False, silent_running=False, executable_path=None, arguments=None)

### Parameters
#### Path Parameters
- **url** (string) - Required - The target URL to open.
- **mode** (string) - Optional - The browser type. Supported values include 'cef', 'chrome', 'ie', 'edge', '360se', or a custom browser name from `ChromiumBrowser.config`.
- **load_timeout** (integer) - Optional - Timeout in seconds for the page to load. Defaults to 20 seconds.
- **stop_if_timeout** (boolean) - Optional - Whether to stop loading the page if the timeout is reached. Defaults to False.
- **silent_running** (boolean) - Optional - Whether to run without抢占 mouse and keyboard input. Defaults to False.
- **executable_path** (string) - Optional - The path to the browser executable. Defaults to None.
- **arguments** (list) - Optional - Command-line arguments for the browser. Defaults to None.

### Return Value
- **WebBrowser** - An object representing the opened webpage.

### Request Example
```python
from xbot import web

def main(args):
    web_object = web.create('www.baidu.com', 'chrome', load_timeout=20)
```

### Example Usage
This example demonstrates opening the Baidu official website using the Chrome browser.
```

--------------------------------

### Get Title

Source: https://www.yingdao.com/yddoc/rpa/711156972382830592

Retrieves the title of the active browser page.

```python
from xbot import web


def main(args):
    browser = web.get_active()
    title = browser.get_title()
```

--------------------------------

### Get URL

Source: https://www.yingdao.com/yddoc/rpa/711156972382830592

Retrieves the current URL of the active browser.

```python
from xbot import web


def main(args):
    browser = web.get_active()
    url = browser.get_url()
```

--------------------------------

### 创建并启动Redis容器

Source: https://www.yingdao.com/yddoc/rpa/710403486730629120

创建并启动一个Redis容器，用于存储数据。请将'yourpassword'替换为您的Redis密码。数据将持久化到'/root/redis_data'目录。

```bash
mkdir /root/redis_data
mkdir /root/redis_data
```

```bash
docker run -d --name redis-server -p 6379:6379 -v /root/redis_data:/data redis:7.0.4 redis-server --protected-mode yes --slaveof no one --appendonly yes --requirepass "yourpassword"
docker run -d --name redis-server -p 6379:6379 -v /root/redis_data:/data redis:7.0.4 redis-server --protected-mode yes --slaveof no one --appendonly yes --requirepass "yourpassword"
```
Tokens:
Raw