Create organizational structure

This application automatically builds an organizational structure based on asset property values, so that the Object rules feature can later move asset objects into the appropriate locations. It is available starting from version 26.4.

• Manual download: CreateOrganizationalStructure.xml

For example, consider the following object structure:

• Organization: Contoso
  • Printer: HP, LaserJet Pro M404dn
  • Computer/server: SERVER324
  • Computer/desktop: PC5671

The asset objects have the following property values:

Object type: object name	Building	Floor
Printer: HP, LaserJet Pro M404dn	A	5
Computer/server: SERVER324	A	7
Computer/desktop: PC5671	B	3

Based on these property values, the application creates the required building and floor objects:

• Organization: Contoso
  • Building: A
    • Floor: 5
    • Floor: 7
  • Building: B
    • Floor: 3

Asset objects are not moved by this application and remain in the source folder.

Requirements

• ALVAO Asset Management

Configuration

1. Go to Objects and select the folder containing the asset objects on which you want to build the organizational structure. Ensure that the asset objects have properties containing values that describe their position within the desired organizational structure, such as Building, Floor, Room, or Department.
2. Open the folder object in a new tab by clicking the icon in the upper-right corner. Note the folder object ID displayed in the page URL.
3. Go to Administration - Applications and select the Create organizational structure application.
4. Enter the folder object ID from the previous step into the AM.OrganizationalStructure.SourceFolderId application setting.
5. Prepare the organizational structure JSON definition. For example:

   {
   "Building": "Building",
   "Floor": "Floor"
   }

   Each key-value pair represents a level in the organizational structure. The first pair defines the top level. The key specifies the object type of the organizational structure objects that will be created automatically. The value specifies the asset object property that determines the placement of assets within that level. This property must also be included in the organizational structure object type.
6. Enter the JSON definition into the AM.OrganizationalStructure.Definition application setting.
7. Enable the application.

Using this app

1. In Objects, select the folder object specified in the configuration.
2. Run the Import AM objects into organizational structure command. This command creates the organizational structure in the selected folder object.
3. Use the Object rules feature to move assets into their corresponding locations.