Merge your data

This task requires Data Manager admin permissions.

The Merge process reconciles all of the data sources associated with an object class to create Data Manager objects. It can be triggered manually, but is usually triggered by running the Cleanse and Import client from the command line.

Before you merge:

• All data sources for the object class must be Mapped and Cleansed.

Merge your data manually

Note: Running a merge will merge data from all data sources, even if initiated from a single data source. Therefore, all data sources within the object class must be ready to merge

1. From the sidebar, select Assets.

2. Select Data Manager in the sidebar.

3. Select Object classes in the sidebar.

4. Select the Show data sources button for the object class you want to review.

5. Select the > data source you want to merge data for.

6. [マージ] を選択します。

You can view imported data in Data Manager > Object classes > [Object class] > View using lists, charts, and other views.

To automate your merge, use the Cleanse and Import client. Learn how to https://support.atlassian.com/assets/docs/schedule-an-import-of-your-data

Import your data using the Cleanse and Import client (macOS)

The Cleanse and Import client lets you run Cleanse and Import operations from the command line.

はじめる前に：

• All data sources for the object class must be Mapped and Cleansed.

• You must have:

  • a Cleanse and Import token, and

  • your Workspace ID.

If any parameter contains spaces (for example, My Data Source Name), wrap it in double quotes: "My Data Source Name".

手順

1. Open Terminal (Applications > Utilities > Terminal).

2. Navigate to the Data Manager clients directory, for example:

   cd /Users/Shared/assets_data_manager

3. Select the Cleanse and Import client that matches your CPU:

   cd osx-arm64/assets-cleanse-and-import-client # or cd osx-x64/assets-cleanse-and-import-client

4. (Optional) View help:

   ./dm-cleanseimport --help

5. Ensure you have:

   • Workspace ID, for example: e44regc98-8d2r-3af7-011t-209p44716366

   • Cleanse and Import token, for example: ATCTT3xFrTN0U64VR99p1VfpQtLlpar7R4hq6PSk...

6. Run the import:

   ./dm-cleanseimport --run "import" --workspace-id <workspaceId> --token <your-cleanse-import-token>

オプション パラメーター

• Run Cleanse and Import together:

  ./dm-cleanseimport --run "full" ...

• Restrict to a single Data source type:

  --type "My Data Source Type Name"

• Restrict to a single Data source:

  --ds "My Data Source"

• Restrict to a single Object class:

  --object "Compute"

• Proxy configuration:

  --proxy "Address" # or -p "Address" --proxy-user "Username" --proxy-pass "Password" --proxy-default-credentials --bypass-invalid-certificate

A success message indicates completion and lists any errors encountered.

Import your data using the Cleanse and Import client (Linux)

はじめる前に：

• All data sources for the object class must be Mapped and Cleansed.

• You must have a Cleanse and Import token and Workspace ID.

• Wrap parameters with spaces in double quotes.

手順

1. Open a terminal (for example, Ctrl + Alt + T).

2. Navigate to the Data Manager clients directory:

   cd /Users/Shared/assets_data_manager

3. Select the correct client:

   cd linux-arm64/assets-cleanse-and-import-client # or cd linux-x64/assets-cleanse-and-import-client

4. (Optional) View help:

   ./dm-cleanseimport --help

5. Run the import:

   ./dm-cleanseimport --run "import" --workspace-id <workspaceId> --token <your-cleanse-import-token>

6. Optional parameters are the same as for macOS: --run "full", --type, --ds, --object, and proxy options.

A success message indicates completion and lists any errors encountered.

Import your data using the Cleanse and Import client (Windows/DOS)

はじめる前に：

• All data sources for the object class must be Mapped and Cleansed.

• You must have a Cleanse and Import token and Workspace ID.

• Wrap parameters with spaces in double quotes.

手順

1. Open an elevated command prompt (Ctrl + Shift + Enter or Run as administrator).

2. Navigate to the Data Manager clients directory:

   cd Users\Public\assets_data_manager

3. Select the correct client:

   cd win-x64\assets-cleanse-and-import-client rem or cd win-x86\assets-cleanse-and-import-client

4. (Optional) View help:

   dm-cleanseimport.exe --help

5. Run the import:

   dm-cleanseimport.exe --run "import" --workspace-id <workspaceId> --token <your-cleanse-import-token>

6. Optional parameters:

   • Run Cleanse and Import together:

     dm-cleanseimport.exe --run "full" ...

   • Restrict by data source type, data source, or object class:

     --type "My Data Source Type Name" --ds "My Data Source" --object "Compute"

   • Proxy configuration:

     --proxy "my_proxy_server_address" --proxy-user "my_username" --proxy-pass "my_password" --proxy-default-credentials --bypass-invalid-certificate

A success message indicates completion and any errors encountered.