Altova MapForce 2024 Enterprise Edition

This topic explains how to add components to a mapping. To add a component, you need to create a new mapping design first and then do one of the following:

 

In the Insert menu, choose a component type (e.g., XML Schema/File).

Drag a file from Windows File Explorer into the mapping area.

Click the relevant button in the Insert Component toolbar (see screenshot below).

MF_MapFund_Mappings_AddComponents1

Each component type has a specific purpose and function. To get an overview of components, see Components. To find out more about data structures that can be used as sources and targets, see Structural Components. For information about MapForce components used to store data temporarily or to transform it, see Transformation Components.

 

When you want to add a structural component to your mapping, you can choose to add a local file, a component from a URL or from the list of global resources (see subsections below).

 

Add components from URL

Adding components from a URL is supported only for source components. The supported protocols are HTTP, HTTPS, and FTP. Depending on the type of data structure, the instructions on how to add a component from a URL may very. For most data structures, the following instructions apply:

 

1.Select the component type you wish to add (e.g., XML Schema/File).

2.Click Switch to URL in the Open dialog box.

3.Enter the URL of the file in the File URL text box and click Open (see below).

MF_MapFund_Mappings_AddComponents2

The list below describes the available options in the Open dialog.

 

Open as: This option defines grammar for the parser. The default and recommended option is Auto.

 

File load: If the file you are loading is not likely to change, select the Use cache/proxy option to cache the data and speed up file loading. Select Reload if you want the file to be reloaded every time you open the mapping.

 

Identification: If the server requires password authentication, you will need to enter your user name and password. If you want your user name and password to be remembered next time, select the check box Remember password between application starts.

 

Server URL: For servers with Web Distributed Authoring and Versioning (WebDAV) support, you can browse files after entering the server URL in the Server URL text box and clicking Browse. Although the preview shows all file types, make sure to open the same file type as in Step 1 above. Otherwise, errors will occur.

 

Check in/out: If you use a Microsoft SharePoint Server, select the check box This is a Microsoft SharePoint Server. This displays checked-in/checked-out files in the preview area. If you want to make sure that no one else can edit the file on the server while you are using it, right-click the file and select Check Out (see screenshot above). To check in any file that you previously checked out, right-click the file and select Check In.

 

Switch to File Dialog: Clicking this button will redirect you to the dialog in which you can select a local file.

 

Switch to Global Resources: Clicking this button will redirect you to the dialog that allows selecting a global resource.

 

Add global resources

If you have defined a database (Professional and Enterprise editions), a file, or a folder as a global resource, you can add it to your mapping. For more information about global resources, see Altova Global Resources. Depending on the type of data structure you are working with, the instructions on how to add a global resource may very. For most data structures, the following instructions apply:

 

1.Select the component type you wish to add (e.g., XML Schema/File).

2.Click Global Resources in the Open dialog box.

3.Select one of the resources from the list and click Open (see below).

OpenGlobalResourceDialog

If you want to add, edit, or delete global resources, click the Manage Global Resources icon (circled red above). The Open dialog for global resources allows you to switch back to the dialog with local files (Switch to File Dialog) or open a file from a URL (Switch to URL).

 

If you have created a database as a global resource and you want to add it to your mapping, follow the steps described in Global Resources.

 

© 2017-2023 Altova GmbH