NEW
Examples
Function
Creates a new object such as a conference, folder, contact database, calendar, group, gateway, monitor, rule, stationery, chat room, message, or document. The EXPORT command will automatically generate the scripts necessary to create new objects. Separate the components of the path with colons. The PATHCHAR command can be used to change the default path character.
Syntax
For creating a leaf item, such as form:
NEW path name subj objtype icon h v formID +p
For creating a conference, message, document, unprotected folder, or uploaded file:
NEW path name subj objtype icon h v +p
For creating a calendar or a typed object:
NEW path name subj objtype icon h v type +p
Parameters
path |
The location of the new object, relative to the administrator’s Desktop. |
DESKTOP userID path |
Creates an object on a user's Desktop. The path is relative to the user's Desktop. |
name |
The name of the new object. |
subj |
The content of the "Subject" field. |
objtype |
The type of object to be created: |
|
CHAT |
A public chat room. |
|
CONFERENCE |
A conference, calendar, group calendar, resources calendar, or location calendar. Unique names are required. |
|
FOLDER |
A folder. Unique names are not required. |
|
FCF |
An uploaded file. |
|
FORMDOC |
A form. |
|
PERMS |
A message that is stationery. |
|
TEMPS |
A voice monitor, Internet monitor, or server monitor. |
|
SYSINFO |
A session monitor. |
|
MESSAGE |
A message. |
|
DOCUMENT |
A document. |
icon |
The ID of the object's icon. |
subtype |
Creates special containers: |
|
Bookmarks |
16 |
|
Contact database |
7 |
|
personal calendar |
21 |
|
group calendar |
28 |
|
resource calendar |
22 |
|
location calendar |
23 |
|
Shared Documents |
33 |
|
My Documents |
32 |
|
Memos |
26 |
|
Web Publishing |
15 |
|
Offline Conferences |
2 |
|
Voice Greetings |
20 |
|
application container |
35 |
|
members' list |
36 |
|
blog container |
50 |
|
podcast container |
51 |
|
workspace |
41 |
|
File Storage |
40 |
h |
The horizontal pixel position for the object relative to the top left corner of the administrator’s Desktop. To place the object automatically, enter -1. |
v |
The vertical pixel position for the object relative to the top left corner of the administrator’s Desktop. To place the object automatically, enter -1. |
formID |
The ID of the form. Form IDs can be found in Example.fc, which is installed with FirstClass Designer. |
+a |
Creates an unapproved object. |
+d |
Creates a read-only object. |
+h |
The new conference or calendar isn't published in the Directory. |
+l |
Creates the object in the upper pane. |
-l |
Creates the object in the lower pane. |
+p |
Protects the object. |
+t |
Creates the object in the toolbar. |
+x |
Creates the object in the Rules & Resources folder. |
Examples
With CHAT
To create a chat room, use the object type CHAT. The icon number is 150 and the form ID is 129. The object will be placed automatically. For example, to create a chat room file inside a conference, enter:
NEW "General Conferences:Employee Lounge" "Water Cooler" "" CHAT 150 -1 -1 129
With CONFERENCE
Used to create conferences and calenders.
To create a new protected conference named Employee Lounge with the standard conference icon, in the General Conferences folder, enter:
NEW "General Conferences" "Employee Lounge" "" CONFERENCE 8 41 15 +p
The conference does not require a subject field, therefore the field has been left blank by including two quotation marks. The conference will be placed in 41 pixels from the left and 15 from the top of the window.
In containers with a split, by default containers are created in the upper pane or left pane. To create a conference in the lower or right pane, enter:
NEW "General Conferences" "Employee Lounge" "" CONFERENCE 8 41 15 +pl
A conference needs to be created on Susan Bram's Desktop, so the path is represented by a pair of quotation marks. To create a conference, you would enter:
NEW desktop sbram "" "Presentations" "" conference 8 41 65 +p
To create a new protected conference, whose name does not appear in the Directory, enter:
NEW "General Conferences" "Employee Lounge" "" CONFERENCE 8 41 15 +ph
PUT PERMISSIONS "General Conferences:Employee Lounge" 2007 6 1
These two commands will also enable you to create conferences with duplicate names as long as the conferences are not created in the same location.
If you want to unpublish an existing conference, enter:
PUT PERMISSIONS "General Conferences:Employee Lounge" 2007 6 1
Duplicate published conferences can be created with the NEW command, if the following conditions are met:
• The System Profile has the "Require unique names" field disabled.
• At SETOU command places the conference in user group where an Organizational Unit has been defined and the "Require unique names within this organizational unit" field is enabled.
• The container where the new conference is to be created does not contain a conference of the same name. For example, with in General Conferences the NEW command can not create a second Employee Lounge conference.To create a second Employee Lounge conference in General Conferences > Sweden's Conferences folder, and make the conference a member of the Sweden Staff user group, enter the following:
SETOU "Sweden Staff"
NEW "General Conferences:Sweden's Conferences" "Employee Lounge" "" Conference 8 -1 -1 +p
The conference keyword is also used to create calendars; however, the type parameter must be included. To create a protected group calendar (type 28) named Staff Events, without a subject, and with the standard icon 24011, in the General Conferences folder, enter:
NEW "General Conferences" "Staff Events" "" CONFERENCE 24011 41 15 28 +p
The type for a personal calendar is 21 and the icon ID is 24011.
The type for a resource calendar is 22 and the icon ID is 24013.
The type for a location calendar is 23 and the icon ID is 24014.
To create an unlisted system events calendar, enter the following commands:
New "FirstClass Services" "System Events Calendar" "" Conference 24011 408 58 28 +P
ACTIVATE SYSCALENDAR
//unlist System Events Calendar
PUT DIRECTORY calendar "System Events Calendar" 1227 6 1
Contact databases also use the conference keyword, and requires a subtype of 7. To create a contact database within Employee Lounge, enter the following:
New "General Conferences:Employee Lounge" "Customer List" "" Conference 23014 35 16 7 +p
With FOLDER
To create a new unprotected folder called Old Messages in the Employee Lounge conference, with the standard icon, enter:
NEW "General Conferences:Employee Lounge" "Old Messages" "" Folder 26093 41 15
In containers with a split, by default containers are created in the upper pane or left pane. To create a folder in the lower or right pane, enter:
NEW "General Conferences:Employee Lounge" "Old Messages" "" Folder 26093 41 15 +l
To create a new contact database that can be shared, enter the following command:
NEW desktop sbram "Contacts" "Friends and Family" "" conference 23014 41 15 7
To create a Contacts folder on a user's desktop, a typed folder is required. Use 7 for a Contacts folder.
NEW desktop sbram "" "Contacts" "" folder 23014 41 15 7
The previous command creates a folder and cannot be shared through the permissions form.
To create a My Documents folder on a user's desktop, a typed folder is required. Use 32 for a My Documents.
NEW desktop sbram "" "My Documents" "" folder 13304 81 303 32
To create a My Web Site folder on a user's desktop, a typed folder is required. Use 15 for My Web Site.
NEW desktop sbram "" "My Web Site" "" folder 23018 55 245 15
With FCF
Both the NEW command and the UPLOAD command are required. You also need to attach the file to the message that contains the batch administration command. The form ID parameter is not required. For example, to upload the staff settings.fc file to Employee Lounge, enter the following:
NEW "General Conferences:employee lounge" "staff settings.fc" "" FCF 17044 -1 -1
UPLOAD "General Conferences:employee lounge:staff settings.fc" "staff settings.fc"
To upload a resource file to the Resources folder of a user group, enter:
NEW MODEL "Employees" "" "staff settings.fc" "" FCF 17044 -1 -1 +X
UPLOAD PREVIOUS "staff settings.fc"
COMPILE MODEL "Employees"
With FORMDOC
To create a new user group called Executive Users, enter:
NEW "Groups" "Executive Users" "" formdoc 23003 -1 -1 124 +p
To create a read only, search form within the Employee Lounge, enter:
NEW "General Conferences:Employee Lounge:Useful Searches" "Find Unread Messages" "" FORMDOC 2001 -1 -1 8000 +d
To create a new contact called "Paul" in an existing Contacts, enter:
NEW desktop sbram "Contacts" "Paul" "" formdoc 23004 -1 -1 105
The +x option creates the new rule in the container's rules folder. To create a new receive rule (form ID 21) for the Susan Bram's Mailbox with the standard icon (7027), enter:
NEW desktop sbram mailbox "Receive Rule" "" FORMDOC 7027 -1 -1 21 +x
To create a Server Tools form, enter:
NEW "core services" "Server Tools" "" formdoc 2005 250 260 18 +p
To create a service account for an Archive Services cluster, with a remote server serial number of 800000010, enter the following commands:
New "Gateways & Services" "Archive Services 1" "Cluster 1" FormDoc 23001 60 210 126 +p
put previous 1102 0 "800000010"
New desktop "800000010" "" "Archive Services" "" Folder 24073 0 0 57
New desktop "800000010" "Archive Services" "Archive Services Setup" "" Document 2005 0 0 36
 NotesArchive Services service accounts must use a remote server serial number between 800000000 and 800000099. Use the client to enter the passwords, connection information and scheduling.
To create a send rule, use form ID 22, to create an advanced rule use form ID 23, to create an application developer rule.
To create a new receive rule for the Employee Lounge conference, enter:
NEW "General Conferences:employee lounge" "Receive Rule" "" FORMDOC 7027 -1 -1 21 +x
COMPILE "General Conferences:employee lounge"
FC Scripting does not support the deletion of Rules.
See the EXPORT command for more information about creating rules.
To create an Application Developer rule in the Employee Conferences container template group:
NEW MODEL "Employee Conferences" "" "Receive Rule" "" FORMDOC 7027 -1 -1 27 +x
COMPILE MODEL "Employee Conferences" ""
To create a new Server Control form (form ID 58), enter the following:
NEW "core services" "Server Control" "" FORMDOC 23007 -1 -1 58 +p
With PERMS
Creates stationery forms. The form must be available in the Admin > Add New Stationery menu. For example, to add a user-defined stationery, whose form ID is 1001, you would enter:
NEW "General Conferences:Employee Lounge" "Suggestions" "" PERMS 17044 -1 -1 1001 +p
To create a stationery item, from any available message or document, you would enter:
NEW "General Conferences:Employee Lounge" "Suggestions" "Submit your suggestions" MESSAGE 17044 -1 -1 1001 +pm
Include a subject in the above command or the stationery will appear with a blank name. Stationery created with the above command will include the unsent flag.
With TEMPS
Creates monitor forms. These objects must be protected in order to function. To create these monitors, enter:
NEW "Core Services" "Server Monitor" "" Temps 23007 -1 -1 7900 +p
You also need to bind the monitor to a Service account number. The New Cluster and Site Script version 8.0 and above include this step.
NEW "Internet Services" "Internet Monitor" "" Temps 23007 244 19 8900 +p
PUT PREVIOUS 1302 0 1000000000
NEW "Voice Services" "Voice Services Monitor" "" Temps 23007 244 19 7901 +p
PUT PREVIOUS 1302 0 9000000000
With SYSINFO
The icon number is 23007. These objects must be protected in order to function. To create a session monitor or task monitor, enter one of the following commands:
NEW "Core Services" "Session Monitor" "" SYSINFO 23007 120 21 0 +p
NEW "Core Services" "Tasks Monitor (All)" "" SYSINFO 23007 120 21 1 +p
NEW "Core Services" "Tasks Monitor (System)" "" SYSINFO 23007 120 21 2 +p
NEW "Core Services" "Tasks Monitor (Active)" "" SYSINFO 23007 120 21 3 +p
With MESSAGE
To create a message in Susan's Mailbox, enter:
NEW DESKTOP sbram "mailbox" "Susan A. Bram" "Away today" Message 23032 273 21 0
With DOCUMENT
To create a new personal web page document (form ID 900) for Susan, enter:
NEW DESKTOP sbram "My Web Site" "Home Page" "" Document 23019 30 15 900
In a container with a split, documents are created in the lower or right pane, if you want to create a document in the upper or left pane, enter:
NEW DESKTOP sbram "My Web Site" "Home Page" "" Document 23019 30 15 900 -l
In a container with a split, documents are created in the lower or right pane, if you want to create a document toolbar enter:
NEW DESKTOP sbram "My Web Site" "Home Page" "" Document 23019 30 15 900 +t
Related commands
To fill in field data on objects created with the NEW command see the PUT command and the EXPORT command.
| 