ActiveTransfer Server 10.5 | webMethods ActiveTransfer Documentation | Working with Services in ActiveTransfer | Admin Folder | Summary of Elements in the Admin Folder | wm.mft.admin:importData
 
wm.mft.admin:importData
Imports ActiveTransfer assets from an XML export file.
Input Parameters
force
String If the imported assets match the assets present on the target system, this variable indicates whether the rows in the database should be overwritten. The following values apply:
*true - Overwrite rows in the database if the imported assets match the assets present on the target system. This is the default.
*false - Do not overwrite rows in the database if the imported assets match the assets present on the target system.
The force parameter does not apply when mapping partner assets; if the partner information already exists on the target server, the imported partner asset is ignored.
For more information about asset matching, see Migrating Assets.
all
String (Optional) Specifies whether to import all of the ActiveTransfer assets contained in the file created by the wm.mft.admin:exportData service or only selected assets. The following values apply:
*true - Import all assets.
*false - Import only the assets identified in importData. This is the default.
importDataFileName
String Specifies the name of the file from which data is to be imported.
importData
Document List (Optional) Specifies the assets to import when all is set to false. Variables are:
Variable
Description
assetType
String (Optional) Specifies the type of ActiveTransfer asset to import.
all
String (Optional) Specifies whether to import all assets of the type specified in assetType. The following values apply:
*true - Import all assets of the specified asset type.
*false - Import only assets of a specified asset type that match the internal IDs specified in ids.
ids
String List (Optional) Specifies the internal IDs associated with the assets to import. For the user asset types, the internal ID is considered the name of the asset; for all other asset types, the internal ID is the individual asset ID.
names
String List (Optional) Specifies the name of the assets to import. For the user asset type, the authentication ID (user ID) is considered the name of the asset; for all other asset types, the individual asset name is used.
Output Parameters
output
Document Contains the results of the import. The document contains the following keys:
Key
Description
assets
Document List The data that was imported into the ActiveTransfer database. The document contains the following keys:
*assetType - String Indicates which asset type was imported.
*id - String Indicates the internal IDs associated with the asset.
*name - String Indicates the name of the asset.
*status - String Indicates the outcome of the import of the asset (success or fail).
*message - String Contains the status message from the last attempt to import the asset.
*stacktrace - String Indicates the stack trace of the exception if the import failed.
*validationMessages - String Contains any validation errors that occurred during import of each asset.
errorMessages
String List Any errors encountered during the import process.
Usage Notes
*Use the wm.mft.admin:exportData service to export the assets you import using wm.mft.admin:importData.
*You can use the wm.mft.admin:importData service to import an asset into ActiveTransfer without specifying the asset ID in the input parameter. ActiveTransfer generates a new identifier for the asset and returns the value using the output parameter, id.
*For more information about the ActiveTransfer assets that this service can import, see Migrating Assets.