Mapping tools

Integration of BIC Mapping Designer

Integration of BIC Mapping Designer

The BIC Mapping Designer is installed locally on your machine. The repository which contains all mappings for the staging and the production environment is located in the iPaaS system. To start working, you need to connect the BIC Mapping Designer and the iPaaS system via a URL.

Information: If you have not worked with the BIC Mapping Designer before, we strongly recommend to take one of our training courses: Business Integration Converter 6 Basics, Business Integration Converter 6 Advanced and SEEXML.

> Training courses

Note: For the connection, it is necessary to open the right port within the VPN tunnel between your company network and the SEEBURGER datacenter. That means you need to set up the VPN connection first.

To connect the BIC Mapping Designer to the iPaaS system, follow these steps:

  1. Open the BIC Mapping Designer.

  2. Make a right click on the Default folder to open the context menu.

  3. Click New > Project.

  4. Give the folder a proper name if needed.

  5. Make a right click on the Default folder to open the context menu.

  6. Click Repository > Manage Repository Connections.

  7. Click Add.

    Information: The default Protocol is http. We recommend using https.
  8. In the field Host, enter the server name or the IP address you have set up to reach the iPaaS system.

  9. In the field Port, enter 10000 for http, and 8443 for https.

  10. Click OK.

  11. In the login dialog, enter your User name and Password or your Access Token.

  12. Click Login.

Login for UMS users

UMS users can log in to the BIS Portal directly using their login credentials.

Note: To log in to the BIS system, you can use the same login credentials as for the BIS Portal.

  1. In the login dialog, in the tab Password, enter your User Name and Password.

  2. Click Login.

You can now see an overview of the data you have entered, and you can also see if you are logged in at the moment. If you are logged in, you can check out mappings from the repository, make changes in them and check them in again.The URL needed for the connection is created from the entries in the fields Protocol, Host and Port.

Note: We recommend to test your mappings within the BIC Mapping Designer before checking the mapping in to the repository.

Login for SAML users

SAML users can access the BIS Portal after logging in to their company account.

Note: To log in to the BIS system, you need to generate and use an access token.

  1. In the BIS Portal, open your user settings in the upper right corner.

  2. Open the tab Access Token.

  3. Click New.

  4. Enter a Description for the token.

  5. Click Generate Access Token.

  6. Click Copy and Close.

    Information: The token will be copied to the clipboard. It will not be visible in the overview. Please make sure to paste it immediately.
  7. Click Save.

  8. In the login dialog of the BIC Mapping Designer, open the tab Access Token.

  9. Paste your access token into the field Enter Access Token.

  10. Click Save.

    A check mark is set in the field Use Token.
  11. Click Login.

You can now see an overview of the data you have entered, and you can also see if you are logged in at the moment. If you are logged in, you can check out mappings from the repository, make changes in them and check them in again.The URL needed for the connection is created from the entries in the fields Protocol, Host and Port.

Note: We recommend to test your mappings within the BIC Mapping Designer before checking the mapping in to the repository.