IMPORT STRUCTURE

Home

4D v15

IMPORT STRUCTURE


IMPORT STRUCTURE ( xmlStructure )

Parameter	Type	Description
xmlStructure	Text	XML definition of a 4D database structure

Description

Originally introduced in 4D v14 R4

Theme: Structure Access

The new IMPORT STRUCTURE command allows you to import, in the current database, the 4D XML structure definition you passed in xmlStructure.

The xmlStructure parameter must contain a valid 4D structure definition in XML format. You can get such a structure definition using one of the following features:

execute the new EXPORT STRUCTURE command,
select the Export > Structure definition to XML file... menu command available in the 4D Design mode interface (see Exporting and importing structure definitions),
create or edit a custom XML file based on public DTDs that can be found in the 4D application's "DTD" folder.

The imported structure definition is added to the current one and is displayed in the standard 4D Structure editor, among existing tables (if any). If an imported table has the same name as a local table, an error is generated and the import operation is canceled.

You can also import the structure into an empty database, thus creating a new database.

An error is generated if the structure is in compiled or read-only mode. Also, it cannot be called from a 4D remote application.

Example

You want to import a saved structure definition into the current database:

 $struc:=Document to text("c:\\4DStructures\\Employee.xml")

 IMPORT STRUCTURE($struc)