> ## 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.
# Official Data Integration
> The data preparation feature of the YiDA platform provides powerful data integration capabilities, supporting data processing from internal sources, Excel, and various databases. This feature seamlessly connects with DingTalk's official services, covering core data sources such as employee roster, OA approvals, and smart HR, helping enterprises efficiently carry out low-code development and data analysis.
| Feature | Free plan | Basic edition | Professional edition | Dedicated edition |
| ------------------------ | ------------- | ------------- | -------------------- | ----------------- |
| Connect to DingTalk data | Not supported | Not supported | Partially supported | Supported |
## Overview
This section explains the data sources available through official data integration, the entitlements required for each YiDA edition, and how to request the necessary permissions.
With this capability, enterprises can efficiently drive deep integration between low-code development and their full range of enterprise data resources on the YiDA platform, significantly improving the efficiency and effectiveness of data-driven decision-making.
The supported data source entitlements are as follows.
Before
| | General metrics
Business online overview | Employee Roster
Organization online details | OA Approval
Approval instance data | Smart HR
Onboarding + Offboarding + Confirmation + Transfer | Attendance
On-site information |
| --------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------ | --------------------------------------- | ---------------------------------------------------------------- | ----------------------------------- |
| Data freshness | Updated next day | Updated next day | Real-time data | Updated next day | Real-time data |
| YiDA Professional edition | ✅ | ✅ | ❌ | ❌ | ❌ |
| DingTalk Professional edition + YiDA Professional edition | ✅ | ✅ | ✅ | ✅ | ✅ |
| YiDA Dedicated edition | ✅ | ✅ | ✅ | ✅ | ✅ |
After
| | General metrics
Business online overview | Employee Roster
Organization online details | OA Approval
Approval instance data | Smart HR
Onboarding + Offboarding + Confirmation + Transfer | Attendance
On-site information |
| --------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------ | --------------------------------------- | ---------------------------------------------------------------- | ----------------------------------- |
| Data freshness | Updated next day | Updated next day | Real-time data | Updated next day | Real-time data |
| YiDA Free plan | ❌ | ❌ | ❌ | ❌ | ❌ |
| YiDA Basic edition | ❌ | ❌ | ❌ | ❌ | ❌ |
| YiDA Professional edition | ✅ | ✅ | ❌ | ❌ | ❌ |
| DingTalk Professional edition + YiDA Professional edition | ✅ | ✅ | ✅ | ✅ | ✅ |
| DingTalk Dedicated edition + YiDA Professional edition | ✅ | ✅ | ✅ | ✅ | ❌ |
| YiDA Dedicated edition | ✅ | ✅ | ✅ | ✅ | ❌ |
The fields supported by each data source are as follows.
| Data Source | Data freshness | Fields |
| ---------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| General metrics | Updated next day | Contacts count, log Submitter count, log submission rate, total DINGs sent, total Group Chats, expense report count, Documents created in the last day, and more. |
| Employee Roster | Updated next day | Employee Name, Job Title, Employee ID, Department name, probation Type, onboarding date, confirmation date, and more. |
| OA Approval | Real-time updates | Form Custom business Fields, Submitter, Submission time, approver, Approval status, Approval completion time, Approval Records, and more. |
| Smart HR | Updated next day | Onboarding date, position level, confirmation date, post-confirmation level, offboarding date, offboarding reason, and more. |
| Attendance (past six months) | Real-time updates | User Name, Department, check-in time, overtime flag, expected attendance flag, attendance group name, field work flag, missed check-in flag, and more. |
## Request Permission
To use official data integration, the app's Super Admin must first obtain management permissions for the corresponding data.
For example, to use Employee Roster data, obtain Sub Admin permissions for Smart HR. Follow these steps:
Sign in to the OA Admin Console as the DingTalk Super Admin.
Click Security & Permissions > Manage permissions > Sub Admin > Add Sub Admin.
Select the users to add, then Configure the required permissions.
After configuration, click Save.
## Dataset Permissions
YiDA now supports independent permission control for all datasets. When a dataset with permissions configured is consumed, its data is filtered and controlled in real time by user (who can view), row permissions (rule configuration), and column permissions (field scope).
As YiDA is used in richer scenarios, Data permissions control becomes essential for consumption scenarios such as reports and dashboards.
Go to Data Factory > Dataset list, Select a specific dataset, and Configure its permissions.