Microsoft Power Automate自定义连接器如何隐藏响应多余输出项

问题描述 #

我正在Microsoft Power Platform中开发自定义连接器，目前我的连接器包含一个操作，对应的定义代码如下：

paths:
  /Array_Find-Differences:
    post:
      description: Find items from one array that is not present in the second array
      operationId: post-array-find-differences
      summary: Array - Find Difference Between Two Arrays
      tags:
        - Array
      parameters:
        - name: array_Find-Difference-Definition
          in: body
          schema:
            $ref: '#/definitions/Array_Find-Difference-Definition'
          description: Provide an input array as well as an array to compare against.
          required: true
          x-ms-visibility: important
      consumes:
        - application/json
      produces:
        - application/json
      responses:
        '200':
          description: >-
            Returns a new array containing the values that are not present in
            the original array.
          examples:
            application/json: []
          schema:
            type: object
            properties:
              array:
                type: array
                items:
                  type: string
                  description: The new array containing different values.
                  title: Difference Array
                  x-ms-visibility: important
                description: array
definitions:
  Array_Find-Difference-Definition:
    type: object
    x-ms-visibility: important
    properties:
      array:
        type: string
      compare:
        type: string
    example:
      array:
        - 1
        - 2
        - 3
      compare:
        - 1
        - 2
        - 3
        - 4

从上述响应定义可以看到，我仅将“Difference Array”设置为需要展示的输出项，但在Power Automate工作流设计器中，仍显示了array、body等其他输出选项，该如何配置才能隐藏这些多余选项？

解决步骤 #

• 先修正现有定义的类型错误
  当前输入定义里的array和compare字段被错误定义为string类型，但示例中传入的是数组，这会导致参数校验异常，先将这两个字段的类型改为array并配置对应项类型：

definitions:
  Array_Find-Difference-Definition:
    type: object
    x-ms-visibility: important
    properties:
      array:
        type: array
        items:
          type: integer # 可根据实际支持的类型调整，支持多类型可配置oneOf
      compare:
        type: array
        items:
          type: integer

• 正确配置可见性规则
  x-ms-visibility属性仅对当前标注的字段生效，不会自动隐藏父级/同级未标注的字段：
  • 平台默认保留的body根节点是系统内置节点，无法隐藏。
  • 对于其他不需要在动态内容面板显示的自定义字段，给对应字段加上x-ms-visibility: internal标记即可完全隐藏；标记为advanced的字段会被收进「显示高级选项」折叠区，不会默认展示。
  • 如果不需要外层嵌套的array包装对象，可以直接将200响应的schema根节点设为数组类型，从结构上消除多余嵌套字段：

responses:
  '200':
    description: >-
      Returns a new array containing the values that are not present in
      the original array.
    examples:
      application/json: []
    schema:
      type: array
      items:
        type: string
        description: The new array containing different values.
        title: Difference Array
        x-ms-visibility: important

• 清除本地缓存
  配置修改完成后，需要重新发布自定义连接器，再在流中删除旧的连接器操作、重新添加，否则设计器会缓存旧的schema配置，修改不会立即生效。

内容的提问来源于stack exchange，提问作者oliverbj