Skip to main content

​
1. Use Case

This connector automates announcement publishing so admins no longer need to manually create announcements in the DingTalk admin console each time.

​
2. Steps

​
2.1 Step 1: Design the Form

Create a form and fill in the announcement content and settings. Steps:
  1. Create a form named “Create Announcement”.
  2. Add a member component, name it “Publisher”, and set it as required. (See Figure 2.1-1.)
Figure 2.1-1 Add and configure the member component
  1. Add a Select dropdown component named “Send DING Notification”. Add two custom options: “Display value: Yes, Option value: true” and “Display value: No, Option value: false”. Set it as required. (See Figure 2.1-2.)
Figure 2.1-2 Add and configure the Select dropdown component
  1. Add a department component, name it “Recipient Departments”, enable Multiselect mode, and set it as required. (See Figure 2.1-3.)
Figure 2.1-3 Add and configure the department component
  1. Add a member component, name it “Recipient Users”, enable Multiselect mode, and set it as required. (See Figure 2.1-4.)
Figure 2.1-4 Add and configure the member component
  1. Add a Single-line text component, name it “Announcement Title”, and set it as required. (See Figure 2.1-5.)
Figure 2.1-5 Add and configure the Single-line text component
  1. Add a Multi-line text component, name it “Announcement Content”, and set it as required. (See Figure 2.1-6.)
Figure 2.1-6 Add and configure the Multi-line text component
  1. Click Save in the upper-right corner of the page.

​
2.2 Step 2: Configure the Connector

For a detailed introduction to YiDA connectors, see Integration & Automation - Connectors.
Add and configure a connector for the “Create Announcement” form to integrate the YiDA form with the DingTalk Announcement app. Steps:
  1. Go to the admin console >> “Create Announcement” form >> Integration & Automation >> Create Integration & Automation. (See Figure 2.2-1.)
Figure 2.2-1 Connector entry point
  1. Name the connector “Create Announcement”, set Trigger type to “Form event trigger”, and click Save. (See Figure 2.2-2.)
Figure 2.2-2 Create the connector
  1. Configure the form event trigger: set the trigger event to Create success, set the data filter to All data, and click Save. (See Figure 2.2-3.)
Figure 2.2-3 Configure the form event trigger
  1. Select the connector app: choose the “Announcement” app and click Next. (See Figure 2.2-4.)
Figure 2.2-4 Select the connector app
  1. Select the connector action: choose the “Publish announcement” action and click Next. (See Figure 2.2-5.)
Figure 2.2-5 Select the connector action
  1. Configure the connector action and click Save. (See Figure 2.2-6.)
Figure 2.2-6 Configure the connector action
  1. Click Save in the upper-right corner of the page, and then click Publish.

​
2.3 Step 3: Submit the Form

Submit the “Create Announcement” form data to trigger the connector. (See Figure 2.3-1.)
Figure 2.3-1 Submit the form data

​
3. Result

Path to view: DingTalk Chats >> Work >> Work Notifications >> Announcements >> View details
Figure 3.1-1 Connector result