Creates a new database from an existing database.

Defined in

NotesDatabase

Syntax

Set notesDatabaseNew = notesDatabase.CreateFromTemplate( newServer$, newDbFile$, inheritFlag [, maxsize% ] )

Parameters

newServer$

String. The name of the server where the new database resides. Use an empty string ("") to create a database on the current computer.

String. The file name of the new database.

Boolean. Specify True if you want the new database to inherit future design changes from the template; otherwise, specify False.

Note This parameter is new with Release 5.

Integer. Optional. The maximum size (in gigabytes) that you would like to assign to the new database. This parameter applies only to Release 4 databases or those created on a server that has not been upgraded to Release 5. Entering an integer greater than 4 generates a run-time error that reads "Maximum size for database is 4 (gigabytes)," and the script fails.

notesDatabaseNew

NotesDatabase. The new database, which contains the forms, subforms, fields, views, folders, navigators, agents, and documents of the template.

If a database with the specified file name already exists on the newServer$, an error is raised.

The new database has the design elements and documents of the existing database.

The template is a Notes database with the "Database is a template" property is checked. If the database property is not checked, the source is treated as a database instead of a template, and the method acts like the CreateCopy method.

If the source is a template, entries in the template ACL enclosed in brackets are copied to the new database with the brackets dropped. For example, [-Default-] in the template becomes -Default- in the new database. Entries not enclosed in brackets are not copied. In addition, the effective user name is added to the ACL with manager access. If the database is on a server, the server name is added to the ACL with manager access.

Scripts running on a server can't create or access databases on other servers. Therefore, if the script runs on a server, the newServer$ parameter must correspond to the server the script is running on. There are two ways to do this:

• Use an empty string ("") to indicate the current computer. This is the safer method.
• Make sure the name of the server that the script runs on matches the name of the newServer$ parameter.

Language cross-reference

createFromTemplate method in Java Database class

@Command([FileNewDatabase]) function in formula language

Example
See Also

Creating and deleting a database