Contents
- Functional architecture
Organizational structures can be imported and exported:
Synchronization of the organizational structure of the Platform with the data on the organizational and staff structure of the organization is produced in two stages:
Data import to the organizational structure is performed by adding and updating data.
You can import an organizational structure in two ways:
In the window that opens, you must specify the name of the update job, the import type, the site and the path to the file to import. You can also enable or disable the task using the check box.
There is an import with full update employee information (only new objects are added and existing organizational objects are updated) and an import with full update employee information with the movement between units. (only new ones are added and existing organizational structure objects are updated. At the same time, employees are removed from roles and divisions which is not listed in the “DepartmentUniqueNames” and “RoleUniqueNames” items of the import file). With both methods of import, divisions and roles are not removed from the organizational structure. In the case of importing an organizational structure file to an already existing hierarchy, data is merged (supplemented). If merging data is unacceptable, delete the existing organizational structure before importing. If the file for import does not contain any division that is in the organizational structure, then only employees will be removed from this division, the division will remain empty in the organizational structure. When you add roles and divisions on the site, corresponding SharePoint groups are created. When a role or division is completely removed from the organizational structure, the groups created from the site are also deleted. Information about deleted departments and roles from the document forms will also be deleted and the fields in which this information was displayed are cleared.
Described in document import organizational structure may be either an initial loading means organizational structure and adjusting means. In the settings you can specify any frequency of data import. The frequency of updating the organizational structure can be configured in the “Platform: Updating organization structure” task menu in the task settings in the Administration Center:
You can also adjust the organizational structure manually, by highlighting the required attribute and clicking the «Edit» button on the top panel:
The organizational structure should be described in four data formats:
Each organizational structure element has its own UniqueName, which can be generated in two ways: either by the system automatically (32x-digit number – guid is formed during creation), or you can manually specify the desired name.
Table 1. The list of attributes of the organizational structure
№ | Attribute | Tag | Description | Required |
---|---|---|---|---|
1. | Department | DepartmentDto | ||
2. | Login Name | UniqueName | Unit login name. Unique parameter |
Yes |
3. | Code | Code | Department code | Yes |
4. | Title | Title | Department name | Yes |
5. | Abbreviation | ShortName | Department abbreviation | No |
6. | Description | Description | Department description | No |
7. | Manager Role | HeadRoleUniqueName | Head role login name. Indicates the head of a department or company | No |
8. | Parent Department | ParentDepartmentUniqueName | Master unit login name. For companies (top-level deartments) the attribute is not filled | Yes |
9. | Role | RoleDto | ||
10. | Login Name | UniqueName | Role login name. Unique parameter |
Yes |
11. | Code | Code | Role code | Yes |
12. | Title | Title | Role name | Yes |
13. | Description | Description | Role description | No |
14. | Department | DepartmentUniqueName | Login name of the department to which the role belongs | No |
15. | Manager Role | HeadRoleUniqueName | Account management role. The parameter is needed to build a hierarchy of “head- subordinate”. | No |
16. | Assistant Role | AssistantRoleUniqueName | Assistant role login name. Assistant roles are indicated. Each role must be in < string > string > tags |
No |
17. | Delegate Roles | DeputyRoleUniqueNames | Delegate roles login name. Each role must be in < string > string > tags | No |
18. | Employee | Employee | ||
19. | Login Name | LoginName | Employee login name | Yes |
20. | Registration ID | RegNo | Employee number | Yes |
21. | Display Name | Title | Username Display Name | Yes |
22. | Primary Department | MainDepartmentUniqueName | The main unit of the employee. The value of this parameter affects the demarcation of access rights and the numbering of documents in the context of divisions. An employee may relate to several units, but the Primary Department is only one. | Yes |
23. | Primary Role | MainRoleUniqueName | The main role of the employee. The value of this parameter affects the differentiation of access rights. An employee may have multiple roles, but only one Primary Role. | Yes |
24. | Company | MainCompanyUniqueName | The company in which the employee is listed | Yes |
25. | Email address of the employee to which the system notifications are sent | Yes | ||
26. | Departments | DepartmentUniqueNames | The list of units in which the employee is listed. Contains department login names, each of which should be in the tags < string > < / string > | No1 |
27. | Roles | RoleUniqueNames | The list of roles in which the employee is listed. Contains role login names, each of which should be in the tags < string > < / string > | No2 |
28. | Position | JobTitle | Name of the position of the employee | No |
29. | IsFired | IsFired | The sign “IsFired” for the employee: “true” – dismissed, otherwise – “false”. The default value is “false”. Dismissed employees are excluded from the “All Employees” group upon import. |
No |
All employees you would like to see in the organizational structure should be in the unloading. All departments are imported in accordance with the import file. If a department has its parent department, then it will be within the specified parent department.