DesignImportOption (NotesDXLImporter - LotusScript®)

Read-write. Indicates the handling of the incoming design elements: create, ignore, or replace.

Defined in

NotesDXLImporter

Data type

Constant of type Integer

Syntax

To get: option% = notesDXLImporter .DesignImportOption

To set: notesDXLImporter .DesignImportOption = option%

Legal values

  • DXLIMPORTOPTION_IGNORE (1)

    (Default) Ignores design elements in the incoming DXL and leaves the design elements in the output database intact.

  • DXLIMPORTOPTION_CREATE (2)

    Creates new design elements from the incoming DXL, leaving existing design elements in the output database intact.

  • DXLIMPORTOPTION_REPLACE_ELSE_IGNORE (5)

    Replaces design elements in the output database with design elements in the incoming DXL that match. Leaves non-matching design elements in the output database.

  • DXLIMPORTOPTION_REPLACE_ELSE_CREATE (6)

    Replaces design elements in the output database with design elements in the incoming DXL that match. Adds any new design elements from the incoming DXL.

Usage

For purposes of replacement, two design elements match if:

  • The design elements are of the same type (forms, views, folders, and so on).
  • A name or alias in one design element matches a name or alias in the other design element.
  • The design elements are of the same language if the design element uses a language.
CAUTION: If multiple elements share a name or alias, Replace_Else_Create and Replace_Else_Ignore will have unpredictable results. If there is at most one matching design element in the output database, whichever incoming element is the last one processed will replace all previously processed matching elements. If there are multiple matching design elements in the output database, there is no way to predict which one will be replaced. These options should only be used when there is at most one element with the same name or alias.

Example