> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Industry Fields (Education)

> YiDA provides 9 education components for K-12 education scenarios, supporting school, campus, and subject selection. These components are available only to users whose DingTalk organization industry type is Education.

This topic introduces the 9 education components provided by YiDA, including their use cases, selectable data scope, and supported features, to help you connect your YiDA apps with foundational education industry data.

**All YiDA editions (Free plan, Basic edition, and Professional edition) can use these components as long as the DingTalk organization industry type is Education. Organizations outside the education industry are not supported.**

**Path to view the industry type:** As the **Super Admin (Created by)**, go to **DingTalk mobile** > **Contacts** > **Manage** > **Other** (at the bottom) > **More** > **Industry**.

## 1. Use Cases

| **Component name**   | **Scenario**                                                                                                               |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Select school        | Used in K-12 business scenarios that require school selection. Commonly used in applications on the education bureau side. |
| Select campus        | Used in K-12 school scenarios that require campus selection.                                                               |
| Select subject       | Used in K-12 school scenarios that require subject selection, such as subject interest class registration.                 |
| Select stage         | Used in K-12 school scenarios that require academic stage selection.                                                       |
| Select academic year | Used in K-12 school scenarios that require academic year selection.                                                        |
| Select semester      | Used in K-12 school scenarios that require semester selection.                                                             |
| Select grade         | Used in K-12 school scenarios that require grade selection.                                                                |
| Select class         | Used in K-12 school scenarios that require class selection, such as class moral education evaluation.                      |
| Select student       | Used in K-12 school scenarios that require student selection, such as student excellence evaluation.                       |

## 2. Selectable Scope

| **Component name** | **Selectable scope**                                                                                                                                                                                                                                             |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Select school      | Associated organization: multiple schools can be selected.<br />Non-associated organization: other schools cannot be selected.<br />Education bureau: all schools can be selected.<br />Current school organization: only the user's own school can be selected. |
| Select student     | Super Admin / Sub Admin: all student information.<br />Homeroom teacher / teacher: all student information.<br />Parent: student information associated in Home-School Contacts.                                                                                 |
| Select class       | Super Admin / Sub Admin: all classes.<br />Homeroom teacher / teacher: all classes.                                                                                                                                                                              |

## 3. Supported Features

<table>
  <tr>
    <td>**Module**</td>
    <td>**Supported scope**</td>
    <td>**Screenshot example**</td>
  </tr>

  <tr>
    <td>**Manage permissions**</td>
    <td>Set data filter conditions based on form content.<br />Custom permission fields.</td>

    <td />
  </tr>

  <tr>
    <td>**Data management page**</td>
    <td>Set display columns.<br />Associated list - custom columns.<br />List / associated form list display.<br />Subform display.<br />Sort.<br />Filter.<br />Add filter conditions > fields excluded from search.</td>

    <td />
  </tr>

  <tr>
    <td>**Print**</td>
    <td>Print template name settings.<br />Print PDF content design.</td>

    <td />
  </tr>

  <tr>
    <td rowSpan={8}>**Form design**</td>
    <td>Form designer - Default value formula.</td>

    <td />
  </tr>

  <tr>
    <td>Form designer - Data linkage.<br />Only supported as a deduplication field.</td>

    <td />
  </tr>

  <tr>
    <td>Form designer - Association with data from other forms (form data selection).<br />**Association with data from other forms can only be assigned to Single-line text for association.**</td>

    <td />
  </tr>

  <tr>
    <td>Form designer - Associated form display settings.<br />**Only supported as secondary information.**</td>

    <td />
  </tr>

  <tr>
    <td>Form designer - Associated form component population.</td>

    <td />
  </tr>

  <tr>
    <td>Form designer - Associated form filter conditions.</td>

    <td />
  </tr>

  <tr>
    <td>Form designer - Association options.</td>

    <td />
  </tr>

  <tr>
    <td>Form settings > Form validation > Formula validation.</td>

    <td />
  </tr>

  <tr>
    <td>**Message notifications**</td>
    <td>Message template variable replacement.<br />Notification by user / student (notify parents).<br />Note: When Message notifications is set to notify by components on the page, a regular component of the user type appears in a dropdown list. For non-regular components, display depends on whether the component has a Data Source.</td>

    <td />
  </tr>

  <tr>
    <td>**Page settings**</td>
    <td>Redirect link settings.</td>

    <td />
  </tr>

  <tr>
    <td>**Report**</td>
    <td>Currently, **newly created regular forms / workflow forms** are supported directly. To display historical form data directly on the report side, perform the following actions:<br /><ol><li>For legacy forms, go to the form designer and **click "Save" directly**. This triggers the synchronization of metadata such as datasets and fields from the form side to the report side. Instance data submitted afterward will be read by the report side.</li><li>For instance data of legacy forms, go to the data management page, click Details to enter the form edit state, and **click "Save" directly**. This triggers the synchronization of metadata such as datasets and fields from the form side to the report side. Instance data submitted afterward will be read by the report side.</li></ol><br />There are currently 2 ways to push education components to reports:<br /><ol><li>Main table fields are pushed directly to the report for display only.</li><li>Pushed to the report as an independent dataset:</li></ol><br /><ul><li>Multi-table association is required. Use the [**view table**](/yida/app-admin/oim554) for configuration.</li><li>If the view table limit cannot meet your requirements, use the [**data preparation**](/yida/app-admin/rgaipwu0l1c9dw3t) feature, which currently has no limit.</li></ul><br />**Note: Data preparation is only available in the Exclusive edition (YiDA education edition is the Exclusive edition).**<br />**Example scenario: University math olympiad scores**<br />(1) Create a regular form to record student scores. Use components such as student, class, school, and Numerical on the form, and enter the corresponding student scores.<br />(2) Create a report and display score statistics through the following 2 methods:<br /><ul><li>**Main table field format**</li></ul><br /><ul /><br /><ul><li>**Independent data format**</li></ul><br /><ul /></td>
    <td>**Create the form and enter data**<br />**Main table field format display**<br />Configuration path: Create report > Report edit page > Select data display component > Configure dataset > Select data fields to display.<br />**Independent data format display**<br />Configuration path: Enter the app and first create a view table / data preparation. For specific configuration, refer to the [**view table documentation**](/yida/app-admin/oim554) and [**data preparation documentation**](/yida/app-admin/rgaipwu0l1c9dw3t).<br />Create report > Select data display component > Configure dataset > Select view table or created data preparation as the dataset > Select data fields to display.</td>
  </tr>
</table>

**Notes:**

* The 9 new education industry components will progressively support features such as workflow / student filtering with dropdown selection.
* Education components do not support OpenAPI calls.
* Education components do not support bulk export on the data management page. To export data, display the fields as a table in a report and export from there.
* Education components do not support bulk import or bulk data modification.

## 4. FAQ

### 4.1 Why Can't the Student Component Search by Student Name?

Currently, only exact-match search is supported, and dropdown selection of students is not supported. This will be optimized later. Please stay tuned.

Example:

<AccordionGroup>
  <Accordion id="q1" title="4.3 Why does selecting a student in message notifications automatically notify the parents?">
    This is caused by the special logic of the education industry. Currently, the education industry only has Home-School groups (containing only teachers and parents) and Teacher-Student groups (containing only teachers and students). Since the three roles cannot be clearly confirmed in the same group within core education scenarios, notifications are currently sent to both students and parents. The parent-student relationship can be maintained in the DingTalk Home-School Contacts.
  </Accordion>

  <Accordion id="q2" title="4.4 How do I remove the [''] symbols that appear in the data displayed by education components in reports?">
    This is a known issue. Data submitted from newly created forms has been fixed and no longer contains \[""]. For legacy form data, use string functions to process it. Configure a formula field in the report. Refer to the screenshots below for configuration:
  </Accordion>
</AccordionGroup>
