create_project

Creates or updates projects or programs in the database based on command line input or input from a text file. For example, you can use this utility to: Create a project using either a command line (shown below) or an input file. create_project [-u=user-id {-p=password | -pf=password-file} -g=group] [{-id=project-id -name=project-name [-desc=project-description -status=A | I] -teams=group1role1user1group2role2user2... [-privileged=group1role1user1group2role2user2... ] [–teamadmin=grouproleuser]} [-projectcategory=project-category] Update a project using either a command line (shown below) or an input file. create_project [-u=user-id {-p=password | -pf=password-file} -g=group] {-update {-updateproject=project-id[-id=new-id][ -name=new-name] [-desc=new-description][ -status=A | I] [-addmember=grouproleuser][-removemember=grouproleuser] [-setprivuser=grouproleuser][-unsetprivuser=grouproleuser] [-setteamadmin=grouproleuser] [-unsetteamadmin=grouproleuser] [-changeprojectadmin=user1][-defaultprojforuser=grouproleuser]} [-projectcategory= project-category] [-collabcategory= comma-delimited-string-of-collaboration-categories] Create a program using either a command line (shown below) or an input file. create_project [-u=user-id {-p=password | -pf=password-file} -g=group] [{-id=project-id -name=project-name [-desc=project-description -status=A | I] -teams=group1role1user1group2role2user2... [-privileged=group1role1user1group2role2user2... ] [–teamadmin=grouproleuser]} [-projectcategory=project-category] [-program=y] Update a project to a program using either a command line (shown below) or an input file. create_project [-u=user-id {-p=password | -pf=password-file} -g=group] -update -updateproject=project-id -program=y Syntax create_project [-u=user-id {-p=password | -pf=password-file} -g=group] arguments [-h arguments can include one or more of the following: -addmember=grouproleuser-id -changeprojectadmin=user1 -collabcategory=comma-delimited-string-of-collaboration-categories -defaultprojforuser=grouproleuser -delimiter=delimiter-character -desc=project-description -id=project-id -input=text-input-file -name=project-name -privileged=group1role1user1... -program=y|n -projectcategory=project-category -removemember=grouproleuser -setprivuser=grouproleuser -setteamadmin=grouproleuser -status=A|I -teamadmin=grouproleuser -teams=group1role1user1group2role2user2... -unsetprivuser=grouproleuser -unsetteamadmin=grouprole~user -update -updateproject=project-id Arguments -u Specifies the user ID. This must be a user with Project Administrator or Project Team Administrator privileges. Note If Security Services single sign-on (SSO) is enabled for your server, the user and password arguments are authenticated externally through SSO rather than being authenticated against the Teamcenter database. If you do not supply these arguments, the utility attempts to join an existing SSO session. If no session is found, you are prompted to enter a user ID and password. -p Specifies the user's password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. If used without a value, the system assumes a null value. If this argument is not used, the system assumes the user-id value to be the password. This argument is mutually exclusive with the -p argument. -g Specifies the group associated with the user. If used without a value, the user's default group is assumed. -h Displays help for this utility. arguments Specifies one or more arguments. -addmember Specifies adding a group member object. -changeprojectadmin Specifies changing the administrator rights on a project. -collabcategory Note This field is used by Mechatronics Process Management. Refer to the Mechatronics Process Management online documentation for more information. Specifies collaboration category. -defaultprojforuser Specifies setting the selected project as the default project. -delimiter Specifies the delimiting character between fields in the text file, which has to be one character. The default character is |. Note The project and collaboration categories are validated against their respective LOV values, as defined in the Fnd0ProjectCategories and Fnd0CollaborationCategories LOVs in the Business Modeler IDE. Format of the text file assuming default delimiter (|): Copy delimiter- id|name|desc|status|teams|privileged|team-admin| project-category|collabcategory1,collabcategory2 Format of the text file with an empty description: Copy description- id|name| |status|teams|privileged|team-admin| project-category|comma-delimited-string-of-collaboration-categories> -desc Specifies the project description. -id Specifies the ID of the project. -input Specifies a text file containing multiple entries of project id, project name, active (A) or inactive (I) indicator, project description, teams, privileged members, and optional team administrator. When using the create option to create multiple projects, the syntax of the input file is as follows: Copy create_project -u=Tc-admin-user -p=password -g=group -input=file_name_4_create The syntax of the file_name_4_create file is as follows: Copy

id|name|desc|AorI|teams|priv|teamdmin|projectcategory|collabcategory|Program

proj_LCS-74838_1|proj_LCS-74838_1|proj_LCS-74838_1|A|dbaDBAed_admin| dbaDBAed_admin|dbaDBAed_admin|Partner|SI proj_LCS-74838_2|proj_LCS-74838_2|proj_LCS-74838_2|A|dbaDBAed_admin| dbaDBAed_admin|dbaDBAed_admin| |SI proj_LCS-74838_3|proj_LCS-74838_3| |A|dbaDBAed_admin| dbaDBAed_admin|dbaDBAed_admin| |SI When using the update option to update properties of existing projects, the syntax of the input file is as follows: Copy create_project -u=Tc-admin-user -p=password -g=group -update -input=file_name_4_update The syntax of the file_name_4_update file is as follows: Copy -updateproject=proj_LCS-74838_1|-id=proj_LCS-74838_1|-name=proj_LCS-74838_1|-desc=updated for proj_LCS-74838_1|-collabcategory=SI -updateproject=proj_LCS-74838_2|-id=proj_LCS-74838_2|-name=proj_LCS-74838_2|-desc=updated for proj_LCS-74838_2|-projectcategory=Partner When using this option to add members to projects, the syntax of the input file is as follows: Copy -updateproject=proj_id1>|-addmember=GroupRoleuser_id -updateproject=proj_id2|-addmember=GroupRoleuser_id -name Specifies the name of the project. -privileged Defines privileged group members. -program Specifies whether a program is being created. -projectcategory Specifies project category. Default values are Internal, Partner, and Supplier. If you want to change the listed project categories, you can change the values in the list of values (LOV). Project categories are defined in the Fnd0ProjectCategories LOV found in the Business Modeler IDE. -removemember Specifies removing a group member object. -setprivuser Specifies setting privileged access to users in a given project. -setteamadmin Specifies granting administrator rights to a user in a project. -status Specifies the status, either active (A) or inactive (I). -teamadmin Specifies the team administrator. If not specified, the default team administrator is the logged-on user who is running the utility. -teams Specifies group members to be on the project team. This argument accepts valid user, role, and group names. Use the tilde character () as a delimiter when specifying group, role, and user, as follows: Copy -teams=group1role1user1group2role2user2... In addition, you can specify all members in a group as follows: Copy -teams=group1~~ -unsetprivuser Specifies revoking access to users in a given project. -unsetteamadmin Specifies revoking administrator rights to users in a given project. -update Specifies updates to either a project or a program. -updateproject Specifies the specific project for updates. Environment As specified in Setting up a Teamcenter command-line environment. Files The input file must conform to the syntax described in the -input argument description. Restrictions None. Return Values Return value upon success 0 Return value upon failure >1 Examples Note Creating projects does not support building hierarchy. To create a single project with ID 123456, named ABC Car 123 Model, description A high end version of ABC Car, with an active status assigned to Car 1 and Car 2 groups, enter the following command on a single line: Copy create_project -u=Tc-admin-user -p=password -g=group-name -id=123456 -name="ABC Car 123 Model" -desc="A high end version of ABC Car" -status=A -teams="Car 1"DesignerSmith~"Car2"-EngineerJones To create multiple projects from an input file using the create_project utility: Create an input file, project_input_file.txt, containing the project data for each project: Copy # id|name|desc|AorI|teams|priv|teamdmin|projectcategory|collabcategory|Program proj_LCS-74838_1|proj_LCS-74838_1|proj_LCS-74838_1|A|dbaDBAed_admin| dbaDBAed_admin|dbaDBAed_admin|Partner|SI proj_LCS-74838_2|proj_LCS-74838_2|proj_LCS-74838_2|A|dbaDBAed_admin| dbaDBAed_admin|dbaDBAed_admin| |SI proj_LCS-74838_3|proj_LCS-74838_3| |A|dbaDBAed_admin| dbaDBAed_admin|dbaDBA~ed_admin| |SI Enter the following command on a single line: Copy create_project -u=Tc-admin-user -p=password -g=group-name -input=/tmp/project_input_file.txt This example creates three projects: proj_LCS-74838_1, proj_LCS-74838_2, and proj_LCS-74838_3. To update metadata with the create_project utility using an input file: Create an input file, update_metadata_input_file.txt, containing the project metadata that you want to update: Copy -updateproject=N001|-id=N001AA|-name=N001AA|-desc=N001AA|-status=A -updateproject=PSLV07|-id=PSLV07AA|-name=PSLV07AA|-desc=PSLV07AA|-status=A Run the create_project command: Copy create_project -u=Tc-admin-user -p=password -g=group -update -input=C:\apps\tc\project\update_metadata_input_file.txt This example produces the following updated project IDs: N001→N001AA PSLV07→PSLV07AA To change the administrator using the create_project utility input file option: Create an input file, change_project_admin_input_file.txt, containing the new project administrator data: Copy -updateproject=N001AA|-changeprojectadmin=ed_admin -updateproject=N021|-changeprojectadmin=ed_admin Enter the following command on a single line: Copy create_project -u=Tc-admin-user -p=password -g=group -update -input=C:\apps\tc\project\change_project_admin_input_file.txt This example changes the project administrator for both the N001AA and N021 projects to tcadmin. Create a program: Command line Copy create_project -u=Tc-admin-user -p=password -g=group -id=ProjID -name=ProjName -program=y Input file Create an input file, create_program_file.txt, containing the program information for each project: Copy

id|name|desc|AorI|teams|priv|teamdmin|projectcategory|collabcategory|Program

program_1|program_1|program_1|A|dbaDBAed_admin|dbaDBAed_admin|dbaDBAed_admin|Partner| |y program_2|program_2|program_2|A|dbaDBAed_admin|dbaDBAed_admin|dbaDBAed_admin|Partner| |y program_3|program_3|program_3|A|dbaDBAed_admin|dbaDBAed_admin|dbaDBAed_admin|Partner| |y program_4|program_4|program_4|A|dbaDBAed_admin|dbaDBAed_admin|dbaDBAed_admin|Partner| |y program_5|program_5|program_5|A|dbaDBAed_admin|dbaDBAed_admin|dbaDBAed_admin|Partner| |y Enter the following command on a single line: Copy create_project -u=Tc-admin-user -p=password -g=group -input=/tmp/create_program_file.txt Update a project to a program: Command line Copy create_project -u=Tc-admin-user -p=password -g=group -update -updateproject=ProjID -program=y Input file Create an input file, update_program_file.txt, containing the program information for each project: Copy -updateproject=project_1|-program=y -updateproject=project_2|-program=y Enter the following command on a single line: Copy create_project -u=Tc-admin-user -p=password -g=group -update -input=/tmp/update_program_file.txt