Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Multiple connections can be created after defining the sources and destinations.

1

...

Once you complete Source and Destination configurations, it is time to create Object Types and their relations according to the Salesforce data model.

- First, click the “Add new connection” button.

Add new connection.pngImage Added

2- Give a name to the connection.

3- Select a source from the list of sources.

4- Select a destination from the list of destinations.

5- If this is your first time trying the import configuration, select “None” from the list for the schedule. You can update this value after performing the following steps on this page.

6- Click the the Save button.

7- Click the Close button to return to the list of Connections.

8- Follow the three steps described below:

Table of Contents
stylenone

Step 1- Build Object Type and Attributes

Click the Build button. You may also choose to enable or disable Object Schema sharing.

Info

Pro Tip: Commonly, our customers create references from other Object Schemas and are in need of accessing the

...

Database data. We recommend enabling the Object Schema sharing.

Review the options and click the Build Objects/Attributes Data Model button.

Image RemovedScreenshot 2024-08-10 at 22.27.07.pngImage Added
Note

This needs to be done only one time. When this build is completed successfully you don't need to do it again. You will get a message if you already completed this step.

You may check your new Object Schema now and make sure the Object TypesType and Attributes are successfully created.

...

salesforce_schema_2.pngImage Removed

Step 2- Test

...

Import

You can test the configuration by clicking the Test Import button. This will import the first 100 Salesforce database records to your Object Schema. This way, you will have the chance to validate that:

  • Salesforce Database credentials are correct, and proper permissions are granted

  • Jira credentials are correct

  • Object Schema is set without any problems

After clicking the test import button, wait for the process to finish for a few minutes, and then check your Object Schema.

You may click the Check Import Status button to check the import execution status.

...

Step 3- Full Import

If you are happy with the results of the test runimport, please run a Full Import.

Info

Pro Tips:

You can select which data types you would like to import under the Admin tab. This way you can decrease the amount of data transferred to your Assets.

  • Please note that if you have a large number of Salesforce database records, this import will take time. We suggest testing it outside of the busy hours when JSM Assets is not used heavily.

  • Avoid clicking Test Import and Full Import buttons consecutively without waiting for the first one to complete. JSM Assets does not support multiple imports to run simultaneously.

3- Schedule

You have three options for the scheduling.

...

Info

Pro Tip:

We recommend importing manually first by clicking the “Full Import“ button and measuring the import duration. In case a full import takes long time (i.e. more than an hour), or if there are multiple imports scheduled at the same time in your JSM Site, then hourly scheduling may not be the best option. Prefer Daily scheduling in such case which is the most common import schedule among the JSM customers
  • .

Note

Important note regarding daily imports

Daily imports are commonly scheduled for late night hours (00:00-06:00) when there is no heavy load on the system. However, it is also good to know that these times are also used for the JSM/Assets version updates by Atlassian. In case there is a conflict, the import process fails. You would see the error message in your logs. Please check your import flow daily and configure the Notify Me feature under the Admin tab if you want to get notified when there is an error. We highly recommend following the Operational tips provided on the following page: Operations

...