community.general.office_365_connector_card 模块 – 使用 Webhook 在 Office 365 群组中创建连接器卡片消息

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您使用的是 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在剧本中使用它，请指定：community.general.office_365_connector_card。

概要

参数

参数

注释

actions

列表 / 元素=字典

此对象数组将为卡片底部的操作链接提供支持。

显示在卡片底部。

color

字符串

用于品牌推广或指示卡片状态的强调色。

sections

列表 / 元素=字典

包含要在卡片中显示的部分列表。

有关更多信息，请参阅 https://learn.microsoft.com/zh-cn/outlook/actionable-messages/message-card-reference#section-fields。

summary

字符串

用于概括卡片内容的字符串。

这将显示为消息主题。

如果未填充 text 参数，则此参数为必需。

text

字符串

卡片的主要文本。

这将呈现在发件人信息和可选标题下方，

以及任何部分或操作上方。

title

字符串

连接器消息的标题。显示在消息的顶部。

webhook

字符串 / 必需

当您创建新的连接器时，会为您提供 Webhook URL。

属性

属性

支持

描述

check_mode

支持：完全

可以在 check_mode 中运行，并返回已更改的状态预测，而无需修改目标。

diff_mode

支持：无

当处于差异模式时，将返回有关已更改内容（或在 check_mode 中可能需要更改的内容）的详细信息。

备注

注意

  • 此模块不是幂等的，因此如果同一任务运行两次，将创建两个连接器卡片

示例

- name: Create a simple Connector Card
  community.general.office_365_connector_card:
    webhook: https://outlook.office.com/webhook/GUID/IncomingWebhook/GUID/GUID
    text: 'Hello, World!'

- name: Create a Connector Card with the full format
  community.general.office_365_connector_card:
    webhook: https://outlook.office.com/webhook/GUID/IncomingWebhook/GUID/GUID
    summary: This is the summary property
    title: This is the **card's title** property
    text: This is the **card's text** property. Lorem ipsum dolor sit amet, consectetur
      adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
    color: E81123
    sections:
    - title: This is the **section's title** property
      activity_image: http://connectorsdemo.azurewebsites.net/images/MSC12_Oscar_002.jpg
      activity_title: This is the section's **activityTitle** property
      activity_subtitle: This is the section's **activitySubtitle** property
      activity_text: This is the section's **activityText** property.
      hero_image:
        image: http://connectorsdemo.azurewebsites.net/images/WIN12_Scene_01.jpg
        title: This is the image's alternate text
      text: This is the section's text property. Lorem ipsum dolor sit amet, consectetur
        adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
      facts:
      - name: This is a fact name
        value: This is a fact value
      - name: This is a fact name
        value: This is a fact value
      - name: This is a fact name
        value: This is a fact value
      images:
      - image: http://connectorsdemo.azurewebsites.net/images/MicrosoftSurface_024_Cafe_OH-06315_VS_R1c.jpg
        title: This is the image's alternate text
      - image: http://connectorsdemo.azurewebsites.net/images/WIN12_Scene_01.jpg
        title: This is the image's alternate text
      - image: http://connectorsdemo.azurewebsites.net/images/WIN12_Anthony_02.jpg
        title: This is the image's alternate text
      actions:
      - "@type": ActionCard
        name: Comment
        inputs:
        - "@type": TextInput
          id: comment
          is_multiline: true
          title: Input's title property
        actions:
        - "@type": HttpPOST
          name: Save
          target: http://...
      - "@type": ActionCard
        name: Due Date
        inputs:
        - "@type": DateInput
          id: dueDate
          title: Input's title property
        actions:
        - "@type": HttpPOST
          name: Save
          target: http://...
      - "@type": HttpPOST
        name: Action's name prop.
        target: http://...
      - "@type": OpenUri
        name: Action's name prop
        targets:
        - os: default
          uri: http://...
    - start_group: true
      title: This is the title of a **second section**
      text: This second section is visually separated from the first one by setting its
        **startGroup** property to true.

作者

  • Marc Sensenich (@marc-sensenich)