CreateDatabasePage method

Creates a Database Page object. This method is only used to create blank standalone or enterprise databases. To create a database based on a template, get the template database item from the Templates Folder and use the CopyTo method in IERUItem. To create an enterprise room instance, use the CreateEnterpriseDBInstancePage method in IERUContainer. To create an enterprise summary, use the CreateEnterpriseDBSummaryPage method in IERUContainer.

Syntax

C++
HRESULT CreateDatabasePage (
   BSTR Name,
   BSTR Welcome,
   ERUTextFormat WelcomeFormat,
   BSTR Instruction,
   ERUTextFormat InstructionFormat,
   ERUDBStyle Style,
   LONG CreateOptions,
   IERUItem** ppDatabasePage)
Scripting languages
Set DatabasePage = Object.CreateDatabasePage (
   Name as String,
   Welcome as String,
   WelcomeFormat as ERUTextFormat,
   Instruction as String,
   InstructionFormat as ERUTextFormat,
   Style as ERUDBStyle,
   CreateOptions as Long)

Parameters

Name

The name of the Database page. The name has to be unique in the container.

Welcome

The welcome message that appears on the summary page.

WelcomeFormat

The format of the Welcome parameter.

For further information, see ERUTextFormat.

Instruction

The instructions that appear on the row page.

InstructionFormat

The format of the Instruction parameter.

For further information, see ERUTextFormat.

Style

The format of the Database.

For further information, see ERUDBStyle.

CreateOptions

One or more values from the ERUCreateOptions enumeration, logically OR'ed together. At present, the only valid create options for CreateDatabasePage are erCreateOptMakeNameUnique and erCreateOptEnterpriseDatabase. [optional, default = erCreateOptNone]. The latter value requires administrative privileges and is valid only if creating a database in the Templates Folder.

CreateOptions

One or more values from the ERUCreateOptions enumeration, logically OR'ed together. [optional, default = erCreateOptNone]. Legal values include:

  • erCreateOptMakeNameUnique

  • erCreateOptEnterpriseDatabase

  • erCreateOptIncludeAttachmentBox

  • erCreateOptIncludeComments

erCreateOptEnterpriseDatabase requires administrative privileges and is valid only if creating a database in the Templates Folder.

ppDatabasePage

Upon return, an IERUItem interface pointer to the newly-created database page.

Return value

C++

The return code.

Scripting languages

An IERUItem interface pointer to the newly-created database page.

Remarks

The name of the new database page can be no longer than 126 characters. It is the eRoom convention to place the PhaseID column of an approval process database in the last column position.  When creating approval processes through SAAPI, remember to put the PhaseID column last so that it looks consistent with approval processes created through the UI.

 Home

Interface
IERUContainer

See also
Creating Items