【自定义指令】编码版使用说明

编码版如何调用自定义指令

调用通过Python模块实现的指令

调用方法

import xbotextensions.**指令集编码**.引用的编码模块名_

注意事项

• 必须引用至指令集中的具体模块
• 引用指令集时使用的是指令集编码而不是指令名称
• 指令集编码可在编码版左侧的API文档中查询

例如：从自定义指令集python_sdk_test中调用python_test编码模块

import xbot_extensions.python_sdk_test.python_test as web_ex

调用示例

调用python_test模块中的get_web_element_text_list方法

import xbot
from xbot import print, sleep,web
from .import package
import xbot_extensions.python_sdk_test.python_test as web_ex
def main(args):
    broswer = web.get_active("cef")
    selector = package.selector("元素名称")
    print(web_ex.get_web_element_text_list(broswer,selector)) 
    #调用python_test模块中的 get_web_element_text_list方法
    pass

调用通过可视化流程实现的指令

调用方法

import xbotextensions.**指令集编码**.引用的可视化模块名_

编码板如何调用流程参数

https://www.yuque.com/docs/share/6d6e1c74-e304-4f69-9f77-d0eb05832122?#

注意事项

• 必须引用至指令集中的具体流程
• 引用指令集时使用的是指令集编码而不是指令名称
• 模块名与指令名称的对应关系可在左侧API帮助文档中查询

例如：从自定义指令集shadowbot_taobao_common中调用process1

import xbot_extensions.shadowbot_taobao_common.process1 as tb

调用示例

import xbot
from xbot import print, sleep
from .import package
import xbot_extensions.shadowbot_taobao_common.process1 as tb
def main(args):'
    args['浏览器类型'] = '影刀浏览器'   #传入参数 浏览器类型
    args['登录账号'] = 'testid'   #传入参数 登录账号
    args['登录密码'] = 'testpassword'  #传入 参数登录密码
    tb(args)
    web_page = args['web_page']    #获取输出参数 web_page

Python模块中的方法如何编写指令说明

• 在函数首行用”””插入文本块
• 文本块中使用*@param 代表输入参数，

*@return 代表输出参数。

指令说明撰写示例

def get_web_element_text_list(web_page,selector) -> list:
    """
    获取网页相似元素文本的列表
    * @param web_page,网页对象
    * @param selector,元素对象
    * @return `web_element_text_list` , 返回网页相似元素文本信息的列表
    """
    web_element_list = web_page.find_all(selector)
    web_element_text_list = []
    for i in web_element_list:
        web_element_text_list.append(i.get_text())
    return web_element_text_list

指令说明效果图