构建可重复使用 软件包

查看指南,了解如何建立 软件包 的可重用性。

了解您的传入数据
在设置操作 软件包 需要用户填写的字段时,请详细说明设置属性类型以限制您 软件包 收到数据的类型。
  • 限制输入,以减少收到包时必须完成的检查的负担。
  • Javadoc 包括 34 个定义的属性类型,因此请在构建 软件包 时查看这些属性类型,以选择适当的字段类型。
  • 设置 软件包,使其取一个存储值。 例如,软件包 正在代表 机器人 执行 API 调用,请验证 API 密钥或令牌的操作输入字段的 AttributeType 已设置为凭据。 这样,鼓励用户使用存储在 凭据保管库 中的值来获得 软件包 所需的敏感输入数据。
妥善使用标签
CommandPkg 注释中,妥善使用不同的标签、node_label 和相应的描述。
  • 使用这些标签作为行动的简短描述,仅使用几个词语来描述行动。
  • 复制与默认操作 软件包 中显示相同的命名样式。
  • 每个操作都是 软件包 的子元素,并且操作标签与操作窗格中的 软件包 图标一起显示。 使用简称来描述每个操作。
  • 记录特定字段的预期输入格式。 对 @Pkg 注释使用参数描述。 这允许 软件包 开发人员查看特定输入字段必须使用的格式、要求或数据。 例如:
    @Pkg(label = "开始日期", description="日期格式为 MM/DD/YYYY"
单元测试您的组件
软件包 开发期间,创建单元测试以验证 软件包 的每个组件和操作是否按预期工作。
  • 验证单个测试单元、单个类或单个操作的行为,以确保其按预期运行。
  • 在开发流程的早期阶段审查并记录任何特性或功能缺陷。
错误处理
机器人 逻辑中包含错误处理,以确保所有错误都得到妥善处理。 如果未处理错误,可能会阻止 机器人 运行程序执行其他任务。
  • 创建有意义的错误消息,以帮助 机器人 使用者解决错误。
  • 作为 软件包 开发人员,请记住以下建议:
    • 使用 Try/Catch 块以容纳错误。
    • 使用多捕捉块查找特定错误,并使用 BotCommandException 返回自定义错误消息。 例如:
      //create array of 3 items int[] myIntArray = new int[]{1, 0, 7}; try { //print 4th item in array System.out.println(myIntArray[3]); //Perform operation on first and second items in array int result = myIntArray[0] / myIntArray[1]; } catch (ArrayIndexOutOfBoundsException e) { //Throw custom message for IndexOutofBounds throw new BotCommandException("The array does have the number of expected items."); } catch (ArithmeticException e) { //Throw custom message on Atithmetic Exception throw new BotCommandException("Math Operation Error with " + Integer.toString(myIntArray[0]) + " and " + Integer.toString(myIntArray[1])); }
单一责任原则
软件包 是一系列操作。 在 软件包 中,每个操作都必须有单一的责任,并且该行动必须涵盖该责任。
  • 遵循单一责任原则有助于您的 软件包 使用者轻松实施,简化测试,并避免不必要的修改。
  • 您提供的操作使 软件包 使用者能够自定义他们在其 机器人 内使用 软件包 的方式,并帮助他们的 机器人 尽可能地高效。
提供示例
提交 软件包Bot Store 时,包括演示 机器人,演示如何使用 软件包
  • 使用 Automation 360 操作并允许 软件包 使用者使用这些操作来履行他们的 机器人 功能。
  • 务必提供示例 机器人 和描述,以帮助 软件包 使用者了解正确使用所需的知识。