Import AcmaObjects

Import-AcmaObjects

Description

Imports ACMA objects from an XML file into the ACMA database. This cmdlet can be used to restore objects that were previously exported using Export-AcmaObjects or to bulk import objects from external systems.

Syntax

Import-AcmaObjects -FileName <string> [-ReplaceExisting]

Parameters

FileName (String)

The full path to the XML file containing the objects to import

• Required: Yes
• Position: Named
• Pipeline input: No
• Accepts: String path to a valid XML file

ReplaceExisting (Switch)

Specifies whether to replace existing objects with the same ID during import

• Required: No
• Position: Named
• Pipeline input: No
• Default: If not specified, existing objects will not be overwritten

Return Type

This cmdlet does not return any objects, but outputs progress information to the console

Examples

Basic import operation

Import-AcmaObjects -FileName "D:\temp\exported objects.xml"

Import with existing object replacement

Import-AcmaObjects -FileName "D:\backups\users.xml" -ReplaceExisting

Notes

• The XML file must be in the format generated by Export-AcmaObjects
• Objects are imported with all their attributes and references
• Business rules and constructors are applied during the import process
• Large imports may take considerable time depending on the number of objects and complexity of business rules
• Always test imports in a development environment first when working with production data