Cool application high frequency FAQ and typical scenario Design Guide

DingTalk one-click call to use cool applications

Q1: HowDingTalk use cool applications for all domain calls

• Cool apps also have their ownCool app exclusive link(You need to change the coolappcode of the cool application), you can call it in the whole field on DingTalk with one click, and then start the cool application is not limited to [Cool application center square, main application details page]], it can also be fully spread within DingTalk, suchService Window, short video, live broadcast, and various resource bitsEtc.
• ISV can replace coolapp code with its own cool application code. It can distribute the cool applications to customers in various fields to enhance communication. The effect is as follows: [Currently, the link only supports mobile phone access]]
• Special note: If the group list is empty, check whether there is a new internal group in the enterprise organization that is currently logged on to the mobile phone. If not, create a new group before using it in the group.

Cool app entry

Q1: What is the relationship between YIDA applications and cool applications? Where can I create a cool app?

A: Currently, cool applications are not A separate application of YIDA. Cool application capabilities are mainly divided into cool messages, cool dynamic cards, cool top cards, cool Kanban, cool robots, etc, these cool application capabilities are embedded in various forms of YIDA functions, making applications built on YIDA have cool application capabilities by default.Learn More, you can build cool capabilities in the corresponding configuration Portal according to the desired effect.

Card

Q1: where can I quickly create a card and send/update it?

A: You can add send/update card nodes in the integrated automation/new simple process designer. You can select official card templates or custom interaction/group top cards, customize card design.

Q2:The card sending/Updating node has been configured in the integration automation. After the log is executed successfully, the card is sent successfully, but still not received?

A: Currently, there are three common reasons for card sending failure:

1. The cool application has not been put on the enterprise self-built application center. You need to publish the application to the enterprise self-built application center first.

2. The cool application is not enabled in the group shortcut column "More> cool application market" of the internal group/department Group of the organization. You need to enable the self-built cool application first.

3. No form is initiated from the group (no group context), for example, using "scheduled trigger + card to send to the current group", this case scenario is not supported." The scheduled trigger + card is sent to the specified group. "initiate a form within the specified group to obtain the form context, and the card can be sent successfully.

Q3:After the card style is redesigned in the custom card designer, the card sent by DingTalk has not taken effect in time?

After the card is updated, you need to trigger the sending or updating of the card again to send or update the new card. However, due to the impact of the internal cache, the card style may not be updated after the new trigger. If this occurs, you canSettings>Storage space>Cache data>Go to clean up, SelectMessage card, Web cacheOK.

Q4: How to achieve at-person effect in the card?

A: introduce personnel variables when designing cards to map member data within the integrated automation card node

1. In the card designer> data source, add a common variable of "variable type is user information". At the same time, you can define mock data, drag it into the rich text component, and add @ named variable in the component setter panel.

2. You can add send/update card nodes in the integrated automation/new simple process designer, and bind card data sources in the configuration card content, map the member field to the user information variable to achieve at-person effect

Q5:How to display statistical indicators such as indicator card/progress bar on the card to achieve the effect similar to cool Kanban

1. The specific configuration link can be accessed to view2022.08.16 版本更新-宜搭酷看板（数据服务+酷数据卡片）Learn More
2. Rendering report and chart components on cards is not supported.
3. Note that for different business scenarios, if the number of indicators displayed varies, there are different suggested design schemes:

1. If you need to display ≥ 3 loop indicator cards, use card designer> Component Library> loop rendering container for function configuration
2. If you need to display ≤ 3 loop indicator cards, you can use card designer> block Component Library> loop indicator card for function configuration.

Q6:Data Statistics indicators are displayed on the card. The displayed indicator data is decimal by default. How can I change it to% percent?

In the data factory> Data Services> Create Formula field, use the formula for percentage processing. For more information, see the following configuration. For more information, see2022.08.16 版本更新-宜搭酷看板（数据服务+酷数据卡片）

Q7:How to show or hide elements such as buttons on a card according to conditions

Take the "group order" scenario as an example. When the number of orders has been sold out, the "sold out" button is displayed and the "reservation" button is hidden.

1. Define common variables based on conditions in the card designer, such as "sold out", variable type is "boolean", and mock data is configured at the same time

2. Drag all buttons that need to be displayed or hidden into the canvas designer, and configure the "show or not" attribute in the setter configuration panel of the button, define a condition and bind the variable defined by Step 1. When the boolean value is true, the component is displayed. Otherwise, the component is hidden.

3. Configure card nodes in the integration automation to map the process context data with card data source variables.

Q8: Can multiple pages of an application be placed as multiple portals on the group shortcut bar?

Supported, nowA cool appCan be placedMultiple shortcutsToGroup shortcut barAbove, supports expanded forms, and does not support collapsed forms.

Q9: How do I pass the group id parameter of the current group on the custom page jump form page?

By default, cool applications are only opened in the group shortcut bar.Group id(conversationId) is included on the first page by default 」, if you need to pass parameters, you can use the url with parameters.

Assume that the entry address of the group shortcut bar is configuredA custom page, and thenClick a button or link on the custom page to jump to a form page, at this time, you need to obtain the group id on the form page, and submit it before sending the card to the corresponding group.

!!! PS: This case is not suitable for custom page jump Data Management page

Operation method:

On the custom page, you can use the link block to jump to the form page. If the link block is configured as an internal page, the group id parameter is automatically taken over.

If the link block is configured with an external link, you need to manually pass the group id parameter.

The code is as follows:

(this.state.urlParams || {}).conversationId

Add a new one to the formSingle-line text component,TitleNameGroup id", and thenStatusSetHide,Data SubmissionSetAlways submit".

!!! IMPORTANT: bind a variable by default, and enter the group id parameter by obtaining the parameters above the url.

The code is as follows:

decodeURIComponent((this.state.urlParams || {}).conversationId)

Finally, when sending to a group, you can select either the current group or the group where the group id is located.