Skip to end of metadata
Go to start of metadata

Jitterbit ConnectTM provides a fast, easy route to data transformation. This is made possible through a wizard-based integration tool built directly into Jitterbit. The wizard creates for the user all of the complex, detailed operations and components of a Transformation project. By stepping through the wizard, users can create an integration project without the need for coding.

Use the following steps to create a Database to Database wizard.

  • Open Jitterbit and click the Jitterbit Connect  icon at the top of the screen.
  • The Jitterbit Connect Wizard menu appears.

  • To start the wizard, click the Database to Database button in the Standard column in the Jitterbit Connect Wizard menu, which displays the Database Source Selection screen.
  • Begin creating your project with the wizard.

Create Source Database Structure

  • To use an existing Source database, select from the drop-down and click Edit.
  • To create a new Source database, select the Create New button from the drop-down.
  • If you wish to write your own SQL statement for the Source, check the "Write SQL statement instead of using the Wizard" checkbox.

Complete the fields as follows:

Name

Enter the name of your Source.

Type

The wizard automatically supplies Database as the type. 

 

Complete the connection parameters fields as follows:

Driver

Click the Select button and highlight the driver name.

Server Name

Enter the server name. If the database is installed on your computer, type "local list."

Database Name

Enter the database name.

Login

Enter your login and click the Password button. A dialog appears where you may enter your password.

Use default port checkbox

This box is checked by default. To use a port other than the default, un-check the box and type the port in the Port field.

Option link

Click the Option link to make refinements on the operation, e.g., deleting or re-naming a file after processing.

 

Test Connection: 

  • Click the Test Connection button to test your connection to the endpoint. A dialog box appears confirming that the connection was successful. If the connection test is unsuccessful, go back and check your parameters. You may also contact Jitterbit Support. See Getting Support.

After you have completed your fields:

  • Click Next to display the Source Table Selection screen.
  • Click Back to return to the previous screen.
  • Click Cancel to close the wizard without saving your entries.

Create Table Selection

  • Click the Download List of Tables button to download the list of available tables.
  • Optional: 
    • You may enter a search string as a filter. Check the Table or View checkboxes to limit the objects to select.
    • You may select the checkbox for including the schema/owner.

NOTE: If you have not logged in to your database server at the beginning of your project, you will be prompted to do so when you click the Download List of Tables button.

  • Once the tables are downloaded, you can copy tables from the Available Tables column to the Selected Tables column.
  • Highlight the tables to be copied in the Available Tables column, and click the right arrow. The selections are then copied to the Selected Tables column.

After completing your tables:

  • Click Next to display the Source Hierarchical Relationships screen.
  • Click Back to return to the previous screen.

  • Click Cancel to close the wizard without saving your entries.

Create Hierarchical Relationships

  • Click the Select Parent Table drop-down and make a selection. In this example, we have selected OrderHeader from the list.
  • Click the Select Child Table drop-down and make a selection. In this example, we have selected OrderDetail from the list.
  • Then click the Join Tables button. The Join Properties dialogue appears.

  • In the Link Keys section, drag and drop an item in the parent column (OrderHeader in this example) to the child column (OrderDetail in this example) to link them. As an alternative, you may select an item in the child column on the right to activate the Link button, then click the Link button to link the columns as shown below.

  • You may select an item in the child column on the right to activate the Remove Link button, then click the Remove Link button to remove the link.
  • Click the Column Display Order button to select Database (the default) or Alphabetical.
  • After completing the parent and child joining, select a radio button to identify the join type. The default is 1 to N. In this example, we have left the default at 1 to N.
  • Click OK to return to the Source Hierarchical Relationships screen, which displays your table tree showing the currently defined relationships.
  • Click Cancel to return to the Source Hierarchical Relationships screen without saving your entries. 
  • Click Back to return to the previous screen.

After completing your tables:

  • Click Next to display the SQL Where Clause screen.
  • Click Back to return to the previous screen.
  • Click Cancel to close the wizard without saving your entries.

  • On this screen, you may optionally enter a SQL Where Clause. 
  • Click Next to display the Target Database Selection screen.
  • Click Back to return to the previous screen.
  • Click Cancel to close the wizard without saving your entries.

 

Create the Target

  • To edit an existing Target database, select from the drop-down and click Edit.
  • To create a new Target database, select the Create New button from the drop-down.

Complete the fields as follows:

Name

Enter the name of your Target.

Type

The wizard automatically supplies Database as the type.

 

Complete the connection parameters fields as follows:

Driver

Click the Select button and highlight the driver name.

Server Name

Enter the server name. If the database is installed on your computer, type "local list."

Database Name

Enter the database name.

Login

Enter your login and click the Password button. A dialog appears where you may enter your password.

Use default port checkbox

This box is checked by default. To use a port other than the default, un-check the box and type the port in the Port field.

Option link

Click the Option link to make refinements on the operation, e.g., deleting or re-naming a file after processing.

 

After you have completed your fields:

  • Click Next to display the Target Table Selection screen.
  • Click Back to return to the previous screen.
  • Click Cancel to close the wizard without saving your entries.

  • Click the Download List of Tables button to download the list of available tables.

  • Optional: 

    • You may enter a search string as a filter. Check the Table or View checkboxes to limit the objects to select.

    • You may select the checkbox for including the schema/owner.
  • Once the tables are downloaded, you can copy tables from the Available Tables column to the Selected Tables column.

  • Highlight the tables to be copied in the Available Tables column, and click the right arrow.

  • The selections are then copied to the Selected Tables column.

After completing your tables:

  • Click Next to display the Target Hierarchical Relationships screen.
  • Click Back to return to the previous screen.

  • Click Cancel to close the wizard without saving your entries.

Create Hierarchical Relationships

  • Click the Select Parent Table drop-down and make a selection. In this example, we have selected OrderHeader from the list.
  • Click the Select Child Table drop-down and make a selection. In this example, we have selected OrderDetail from the list.
  • Click the Join Tables button. The Join Properties dialogue appears.

  • In the Link Keys section, drag and drop an item in the parent column (OrderHeader in this example) to a child column (OrderDetail in this example) to link them. As an alternative, you may select an item in the child column on the right to activate the Link button, then click the Link button to link the columns as shown below.

  • You may select an item in the child column on the right to activate the Remove Link button, then click the Remove Link button to remove the link.
  • Click the Column Display Order button to select Database (the default) or Alphabetical.
  • After completing the parent and child joining, select a radio button to identify the join type. The default is 1 to N. In this example, we have left the default at 1 to N.
  • Click OK to return to the Source Hierarchical Relationships screen, which displays your table tree showing the currently defined relationships.
  • Click Cancel to return to the Source Hierarchical Relationships screen without saving your entries. 
  • Click Back to return to the previous screen.

After completing your tables:

  • Click Next to display the SQL Where Clause screen.
  • Click Back to return to the previous screen.
  • Click Cancel to close the wizard without saving your entries.

Select an Insert/Update Mode

  • Select one of the radio buttons to create an Insert or Update mode. In this example, we have selected the Insert/Update radio button.

  • You may optionally select and edit a table on this screen. First select the table to edit (parent or child) and then click the Edit Selected Table button to display Select the Primary Keys dialogue.

  • The dialogue will display items from the table you selected. Make your entries and click OK to save them and return to the select an Insert/Update Mode screen.
  • Click Next to display the Summary screen.
  • Click Back to return to the previous screen.
  • Click Cancel to close the wizard without saving your entries.

Review the Summary

  • This step allows you to review the elements of your project before having Jitterbit automatically create all project definitions including operations, transformations, and web service calls. Take a few moments to browse through all elements of the project.
  • If you need to make adjustments to your Database, click Back to return to the previous screen and make the necessary changes.
  • After reviewing your Database, click Finish. The Transformations tab is displayed, and the Design pane populates with the name of your new project.
  • In addition, you may view the operation by clicking the Operations tab to the left of the Transformations tab.

NOTE: If you have not already logged in to your local database server, you will be prompted to do so now.

Review the Mapping

When you click Finish on the Summary screen, the Transformations tab opens in the workspace. You can also open it at any time by selecting the name of your project under Jitterbit Connect / Database to Database in the hierarchical tree in the left pane and double-clicking.

Deploy the Project

  • On the heirarchical tree in the left pane under Operations, right-click on the Project just created to highlight it, and then left-click Deploy on the resulting drop-down.
On This Page

Related Topics

Last updated:  Nov 26, 2016