createFromTemplate (NotesDatabase - JavaScript)

既存のデータベースから新規データベースを作成します。

定義場所

NotesDatabase

構文

createFromTemplate(server:string, dbfile:string, inherit:boolean) : NotesDatabase

createFromTemplate(server:string, dbfile:string, inherit:boolean, maxsize:int) : NotesDatabase

パラメータ 説明
server 新規データベースが配置されるサーバーの名前。現在のコンピュータ上にデータベースを作成する場合は、NULL または空ストリング ("") を指定します。
String dbfile 新規データベースのファイル名。
boolean inherit 将来の設計変更をテンプレートから新規データベースに継承する場合は、true を指定します。継承しない場合は false を指定します。
int maxsize 新規データベースに割り当てる最大サイズ (G バイト)。このパラメータが適用されるのは、リリース 4 のデータベースか、リリース 5 にアップグレードしていないサーバー上で作成されたデータベースに限られます。4 より大きい整数を入力すると、実行時エラーが発生します。
戻り値 説明
NotesDatabase 新規データベース。このデータベースは、テンプレートのフォーム、サブフォーム、フィールド、ビュー、フォルダ、ナビゲータ、エージェント、文書を含みます。

使用法

指定したファイル名のデータベースが既に存在する場合は、例外が発生します。

新規データベースには、既存のデータベースの設計要素と文書があります。

現在のデータベースに [マスターテンプレートのデータベース] が設定されている場合、新規データベースの ACL には、以下のエントリが入ります。
  • [管理者] 権限を持つ現在のユーザー。
  • 新規データベースがサーバー上にある場合は、[管理者] 権限が設定されたデータベースが格納されているサーバー。
  • 不確定なアクセス権限を持つ「デフォルト」。 データベースの作成後に「デフォルト」に対してアクセス権限を明示的に設定してください。
  • 既存のデータベースの ACL に大括弧で囲まれた名前がある場合は、その大括弧がない状態の名前。例えば、既存の ACL の「[Mary Brackets]」は、新規の ACL では「Mary Brackets」になります。 その他のアイテムが既存の ACL からコピーされることはありません。

現在のデータベースに [マスターテンプレートのデータベース] が設定されていない場合、現在のデータベースの ACL は新規データベースにコピーされます。

現在のデータベースに [マスターテンプレートのデータベース] が設定されていて、新規データベースがサーバー上にある場合、そのサーバーは新規データベースの管理サーバーとして設定されます。

サーバーへのリモート (IIOP) 呼び出しを行うプログラムは、その他のサーバー上でデータベースを作成することや、その他のサーバー上のデータベースにアクセスすることはできません。 このような場合、サーバーパラメータは、プログラムの実行先サーバーと対応する必要があります。 これを実行するには 2 つの方法があります。
  • NULL または空ストリング ("") を使用して、現在のコンピュータを指定する。この方法の方が安全です。
  • プログラムの実行先サーバーの名前が、サーバーパラメータの名前と一致することを確認する。

クライアント上で実行されているプログラムは、単一のプログラムで、複数の異なるサーバーにアクセスできます。

例

以下のボタンは、ディスカッションテンプレートからデータベースを作成します。
var template:NotesDatabase = session.getDatabase(null, "discussion8.ntf", false);
if (template == null) {
	requestScope.status = "discussion8.ntf does not exist locally";
	return;
}
var newdb:NotesDatabase = template.createFromTemplate (null, "suggest", true);
newdb.setTitle("Suggestions for Giving Campaign");
newdb.grantAccess("-Default-", NotesACL.LEVEL_READER);
requestScope.status = "¥"Suggestions for Giving Campagn¥" created";

言語間の参照

LotusScript® NotesDatabase クラスの CreateFromTemplate メソッド

Java™ Database クラスの createFromTemplate メソッド

式言語の FileNewDatabase @コマンド

親トピック: NotesDatabase (JavaScript)