ProjectAdd

SOAP

ProjectAdd( aHandle, 

            aUserGroupName, aUserName,

            &aName, aDescription, aObjType, 

            aTemplate, aParameters, 

            aUseExisting, 

            &aErrorMsg );

REST

/ProjectAdd?Handle=<value>&UserGroup=<value>&UserName=<value>

            &Project=<value>&Description=<value>&ObjType=<value> 

            &Template=<value>&Parameters=<value>&UseExisting=<value>

returns Project, ErrorMsg

Description: Creates a new project in the CrashMagic system under the current account.  If Name already exists, a unique name will be created and returned in the Name parameter.

aHandle The value created in the call to Login().  

aUserGroupName, aUserName Identify where the project is to be located

aName Is the name for the new project.  This parameter may be changed by the call depending on the value of aUseExisting.

aDescription A text description for this project.

aObjType Type of project.  (currently reserved, must be "project")

aTemplate The name of a template to base this new project on.  If blank, the Default template will be used.

aParameters A list of parameters to modify the current settings.  If blank, no settings are modified.

aUseExisting If UseExisting is true and a project with the same name already exists, a new project will not be created, and no error will be returned.  If UseExisting is false and a project with the same name already exists, then a unique project name will be created and returned in the Name parameter.

&aErrorMsg is populated only if an error occurred that prevented the function from succeeding.  Otherwise, this parameter is empty.

Example: ProjectAdd( lHandle, "CO@Denver", "Pete",

                                  "My first project", "A project for all seasons", "project", "Favorite", "", true,  lErrorMsg );

Example: ProjectAdd( lHandle, "CO@Denver", "Pete",

                                   lProjectName, "A project for all seasons", "project",  "", "", false,  lErrorMsg );