Skip to main content
Adaptive Insights
Knowledge and Support - Adaptive Insights

Setting Up a Microsoft Dynamics GP Data Source

You can use Adaptive Integration to import data from Microsoft Dynamics GP. Adaptive Integration supports Microsoft Dynamics GP version 2010, 2013, and 2015, but not the older Microsoft Dynamics GP 10.0.

To set up a Microsoft Dynamics GP data source, follow these steps:

  1. Access the Data Designer by going to Integration > Data Designer.

  2. In the Data Source folder in the Component Library on the right side of the screen, click Create New Data Source.
    The Create New dialog box appears.

  3. Select Microsoft Dynamics GP as your data source type and enter the name for the data source

  4. Click Create.
    The center area of the screen displays your new data source’s settings, as shown below.

    integrationCreateMicrosoftDynamicsGPdataSource.png
  5. Enter the data source’s information:

  • Associated Agent: Select the agent from the drop-down list.
  • Server: Enter the server.
  • Port: Enter the port.
  • Instance: Enter the instance.
  • User name: Enter the user name for the Microsoft Dynamics GP account.
  • Password: Enter the password associated with the user name.
  • Company Databases: (Optional) Enter the Microsoft Dynamics GP companies to import, separated by semicolons. Leaving this field blank imports all companies.
  • Log level: Select a log level from the drop-down list to specify the detail for the logging for this data source. Your options are:
    • Error: Only logs errors.
    • Info: Logs all basic information, such as when the data source was updated.
    • Verbose: Provides very detailed information about all phases and actions. (This level is used primarily for debugging or auditing, as it may produce more log information than is practical for typical use.)
  1. Click Save on the Actions menu.

You can test the connection information in the new agent by clicking Test connection in the Actions menu. The system tries to connect to Microsoft Dynamics GP using the infor­mation in the data source fields. If the system can connect to your Microsoft Dynamics GP account, click OK. If there are connection problems, contact Adaptive support.

When you can connect to Microsoft Dynamics GP, you’re ready to import the data struc­ture. This shows you the tables and columns in the database.

To import the Microsoft Dynamics GP structure, do the following:

  1. Click Import structure in the Actions menu. The tables and columns appear in the Data Components menu.

  2. Click Close to close the Import Structure dialog box.

  3. Click Save on the Actions menu.

To remove specified characters from Input Text Streams in Microsoft Dynamics GP:

Refer to Remove Specified Characters from Input Text Streams in JDBC and Microsoft Dynamics GP .

Adding Tables to a Microsoft Dynamics GP Data Source

After you have imported the Microsoft Dynamics GP structure, you are ready to specify the information you want to import. The Tables to Import section of the screen lets you configure the data imported from the Microsoft Dynamics GP account.

To specify the tables to import from the Microsoft Dynamics GP account, follow these steps:

  1. Expand the entry for the data source in the Data Components menu, as shown in below. (Data components with a slash through their icon are not currently included for import.)

    !great_plains_data_components.png
  2. Drag and drop the tables you want to import to the Tables to Import section in the center of the screen, as shown below. As you drag each table to the Tables to Import section, a tab appears for the table and information from the Spreadsheet account appears in the Tables to Import section letting you see the type of informa­tion you’ve added. (Several sample tables appear below.) Each table’s tab also has a drop-down menu, which you can access by clicking the arrow next to its name.!great_plains_adding_tables.png

     

You can extend the Adaptive Account Summary table by including extra columns from the base tables, custom SQL expressions, or subquery columns.

If the Microsoft Dynamics GP account includes multiple companies, the data source will also include a union table called ALL.Adaptive Account Summary.

Managing Columns

If a table you are working with has a large number of columns, you can use the Manage Columns to do quick edits for which columns to import. The Manage Columns dialog box displays the columns in a table so you can then check or uncheck columns for importing.

To manage columns for importing, follow these steps:

  1. Click the arrow on the tab to the right of the table name.
    A floating menu with several options appears.

  2. Click Manage Columns on the floating menu.
    The Manage Columns dialog box appears.

BatchEdit-ManageColumns00071.png

3. Check the box next to a column to import it. When you check a column, the column also appears within the preview window after the popup contents are saved. Unchecking a column removes the column from the preview window.

You can not change the import status on system-generated fields such as isDe­leted. You can also change the import status on individual columns by selecting col­umn properties and setting the property or by dragging and dropping the columns onto the designer.

Customizing the Tables

For each table, you can customize the way in which data is imported.

To customize the table settings, follow these steps:

  1. Click the arrow on the tab to the right of the table name.
    A floating menu with several options appears.

  2. Click Table Settings on the floating menu.
    The Table Settings dialog box appears, as shown below.

    !salesforce_table_settings00072.png
  3. Enter the table settings:

  • Data Import Filter: Use this to enter a SQL expression that filters or formats information being imported. The SQL filter is applied before data is extracted from the database to reduce the amount of data that needs to be imported, giving you an additional level of control for which data is brought into the staging area. Click the field to display the Edit SQL Expression dialog box, shown earlier. (The filter you enter here is applied to the actual data in the database rather than the pre­view data in the staging area.) Not all data sources support the same level of SQL filtering capability.

  1. Click Apply to apply the settings.
  2. Repeat steps 1-3 for each table.
  3. Click Save to save the settings in the data source.

Setting Column Options

While using the Tables to Import section, you can see a preview of the data as it is in the data source or as it is in the staging area after it has been imported. Select Microsoft Dynamics GP or Staging table from the drop-down to preview data.

You can change the options for each column by mousing over its heading and then click­ing the drop-down menu next to its name. These options are:

  • Sort Ascending: Sort the entire table based on this column in ascending order.
  • Sort Descending: Sort the entire table based on this column in descending order.
  • Column Settings: This dialog is used to change the properties of the column within the staging table.
    • Name: The name of the column, displayed in the header.
    • Column Type: The type of data used in the column.
    • Convert Column Type: Select the new type from this drop-down menu.
  • Exclude column from import: Select this to remove this column from the data being imported.
  • Delete custom column: Select this to delete the column. (Available for custom col­umns only.)

Downloading Data from a Staging Table

You can download data from a single staging table.

To download data from a single staging table, follow these steps:

  1. Click the down arrow in a table heading in the Tables to Import section.

  2. Select Download Data.

  3. At the prompt “This operation will send an email with a url to download the data,” click Send. Adaptive Integration sends an email containing a URL to the email account associated with the data designer.

  4. Open the email and click the URL. The data is downloaded in .csv format.

Using the Advanced Filter

Below the Source drop-down menu, you can click Advanced Filter to reveal options for fil­tering the data in the Tables to Import preview area. The Advanced Filter provides tools to view and browse a subset of the data within a staging table. By changing filter properties, you can change the view of the data shown within the preview window without changing the data in the staging area.

The preview area is specifically for previewing a small portion of the data in the staging area. You can explore the data that is available from the Spreadsheet account and verify that you are getting the data you expect by examining the staging area. (Filters set in the preview function do not affect the actual data in the staging area.) The Advanced Filter lets you experiment with the data in the preview to set up a data import filter.

The options for the Advanced Filter are:

  • Distinct Rows: Check this box to hide duplicate rows.
  • Max Rows: Limit the number of rows displayed in the preview area by entering a number in the text box.
  • Columns: Check or uncheck columns in this drop-down menu to show or hide the columns displayed.

Removing a column from this list does not remove the column from the import list.

  • SQL Filter: Click the large text box to display the Edit SQL Filter dialog box, shown below.

    !JDBC_edit_SQL_xantus00074.png

Enter a SQL expression in the field. This is a filter to restrict the rows being previewed. Click Apply to automatically check the SQL syntax of the filter. (If there are any errors, the error is indicated in the expression.) For detailed SQL syntax help, you can click online help in the Notes section. The expression you entered appears in the Advanced Filter section of the preview window.

Click Remove Filter (next to the Source drop-down menu) to clear all advanced filter set­tings.

As part of the table customization process, you can also create join tables and custom columns using SQL expressions.

Clearing the Staging Area

Information remains in the staging area until you clear it.

To clear data from the staging area, do the following:

  1. Click Clear staging tables in the Actions menu.
    The staging area for all the tables in the data source is cleared.

  • Was this article helpful?