Import File Use Cases

These sample file snippets show how to use the import file for several typical use cases.

This topic describes:

This page discusses:

Business Unit Use Cases

Case 1: Moving an existing business unit from one organization to another.

The original file created this company and the associated business units.

*COMPANY Company Name
*BUSINESSUNIT BU1;Company Name
*BUSINESSUNIT BU2;BU1
*BUSINESSUNIT BU3;Company Name

The *BUSINESSUNIT BU2;BU1 defines BU1 as the parent business unit for BU2. You could include this line in the import file to move BU2 from BU1 to BU3:

*BUSINESSUNIT BU2;BU3

Case 2: Inserting a new business unit into an existing hierarchy.

The original file created this company and the associated business units.

*COMPANY Company Name
*BUSINESSUNIT BU1;Company Name
*BUSINESSUNIT BU2;Company Name
*BUSINESSUNIT BU3;Company Name

These commands create BU4, and changes BU1 and BU2 to use BU4 as their parent business unit:

*BUSINESSUNIT BU4;Company Name
*BUSINESSUNIT BU1;BU4
*BUSINESSUNIT BU2;BU4

Case 3: Renaming an existing business unit.

The original file created this business unit:

*BUSINESSUNIT BU1;Company Name

These commands rename BU1 to BU2:

*BUSINESSUNIT BU1;Company Name
+NAME BU2

Collaborative Space Use Cases

Case 1: Moving an existing collaborative space from one collaborative space to another.

The original file created these collaborative spaces (the keyword Project defines a collaborative space):

*PROJECT PRJ1
*PROJECT PRJ2
*PROJECT PRJ3;PRJ1

The *PROJECT PRJ3;PRJ1 defines PRJ1 as the parent collaborative space for PRJ3. You could include this line in the import file to move PRJ3 from PRJ1 to PRJ2:

*PROJECT PRJ3;PRJ2

Case 2: Inserting a new collaborative space into an existing hierarchy.

The original file created these collaborative spaces:

*PROJECT PRJ1
*PROJECT PRJ2;PRJ1
*PROJECT PRJ3;PRJ1
*PROJECT PRJ4;PRJ1

You could use these commands to create a new collaborative space, PRJ5, and insert it between PRJ1 and above PRJ2/PRJ3:

*PROJECT PRJ5;PRJ1
*PROJECT PRJ2;PRJ5
*PROJECT PRJ3;PRJ5

Case 3: Renaming an existing collaborative space.

The original import defined the collaborative space name:

*PROJECT PRJ1

You could use these commands to rename the collaborative space:

*PROJECT PRJ1
+NAME PRJ2

Credentials Use Cases

Case 1: Creating credentials for a person.

This sample includes the global commands, and defines a business unit and collaborative space, then defines credentials, and finally creates a person and assigns credentials to that person:

*VERSION V6R2014
*NULL $
*SEPARATOR ;

//organization definition (optional, if not created through GUI)
*BUSINESSUNIT TstOrg;CompanyName;TestOrganization

//collaborative space definition (optional, if not created through GUI)
*PROJECT TstPrj;$;TestProject;Team;DesignTeam
+VISIBILITY Protected

//credentials definition (Mandatory)
*CTX Creator;CompanyName;TstPrj
*CTX ReadPublicAccessGranter;TstOrg;TstPrj

//credentials assignment (optional, if not created through GUI)
*PERSON TstUsr;CompanyName
+CTX Creator.CompanyName.TstPrj
+CTX ReadPublicAccessGranter.TstOrg.TstPrj
+PASSWORD TstUsr

Case 2: Setting the preferred credentials of a person.

*PERSON John
+CONTEXT Designer.Company Name.Engineering
+CONTEXT Reviewer.Company Name.Engineering
+PREFERREDCONTEXT Designer.Company Name.Engineering

User Group Use Case

This sample shows the creation of a user group and adds two users and a set of credentials to the group.

*Group uuid:66eb2e06-1f60-4229-8918-980fc328b400; ENG Group; Group of ENG department Person
+MEMBER JohnSmith
+Member MarieBlanc
+CONTEXT VPLMProjectLeader.MyCompany.MyCollabSpace