The Mapper window has two sections. The top half of the window lists Mappings. When a mapping is selected, the associated mapped domains display in the Domains section in the lower half of the window. The blue badge indicates the number of mapped domains. The buttons across the top of the Domains section are used to manage the mapped domains.

Find Mapped Domains

In the Domains section, the Search box allows searching for domains by name.

Search the Current Mapping

To search for domains in the currently selected mapping, enter any part of the domain name in the Search box. The list of domains updates to display only those matching the entered text.

Search All Mappings

To search for domains across all mappings, enter any part of the domain name in the Search box and press Enter. The list of mappings updates to show only those containing domains that match the criteria. When a mapping is selected, the matching domains display with the matching text highlighted.

Manage Domain Versions

In the Domains section, the version number for each domain is displayed, along with any auto-saved drafts.

For example, the AE2 domain may show that a draft exists and that it is currently on version 10.

• Double-click the domain, or select it and click Design, to open the domain mapping window for the most recent version.
• Click the Draft link to open the draft version.

To edit or delete a specific version:

1. Click the Version number link for the domain to open the Domain Versions window. 

   
   
    

2. To delete a version or draft, select the version and click Delete. The version is deleted, and version numbers do not change.
3. To edit a specific version or draft, select the version and click Edit. The selected version opens in the domain mapping window. Any saved changes create a new version and make it the most recent one.

Access a Mapped Domain Report

The Report button is used to generate a report for the selected domain. The Mapping Domain Report provides information on each transformation in the domain, including:

• A list of variables.
• Transformation types (Pivot, Join, etc.).
• Comments and variable details for each transformation.
• Dependencies, showing which domains depend on or are used by the selected domain.

To generate a report:

1. In the list of Domains, select a row to choose the domain.
2. Click Report. The report opens in a separate window.

Design: Open Domain Editor

Open the Domain Editor to view or edit domain transformation details.

To open the Domain Editor:

1. In the list of Domains, select a row to choose the domain.
2. Click Design, or double-click the row.
3. To close the Domain Editor, click Close.

Export a Domain

Domains can be exported to a JSON file, allowing reuse in other studies by importing.

When exporting a domain that is part of a mapping, only that domain and its dependencies are included. When exporting a domain that will be imported to another environment or study, it is critical that dependencies are preserved.

• A Source dependency occurs when the exported domain is based on another domain in the mapping rather than on the original panel.
• A Dependent domain is one that depends on the domain being exported.

Example:

If a domain named AE1 is created to transform an AE table, and another domain named AE2 uses AE1 as a source domain, exporting AE2 can also include AE1 as a source dependency. 

To export a domain:

1. From the list of Domains, select a row.
2. Click Export above the Domains section. The Export Domain window opens.
   
3. Select Include Source Domains to export any source domains used in the transformations (this option is grayed out if none exist).
4. Select Include Dependent Domains to export domains that depend on the selected domain (this option is grayed out if none exist).
5. Click Yes.
   • If a single domain is exported, a JSON file is saved to the downloads folder.
   • If source or dependent domains are included, a ZIP file containing all related JSON files is saved to the downloads folder.

Import a Domain

1. Click Import above the Domains section. The Domain window opens.
2. Enter the name of the domain.
3. Click Choose File to locate and select the exported JSON file to import.
4. Click Import to import the mapping rules.
   
5. The Domain Editor window opens displaying the imported transformations. Make changes if needed, then click Save to save the imported domain.

Important: elluminate supports importing XML files exported from previous versions of Mapper.

Note: If the imported domain name matches an existing one, confirmation is required. Duplicate domains have their version number increased.
For mappings containing multiple domains, a list of duplicates and new versions display for confirmation before import.

Execute a Domain

Executing a selected domain performs the transformation and outputs the mapped data to the selected data store or staging area.

When executing a domain, there is an option to include dependent domains (child domains).
For example, if a domain named AE3 transforms an AE table and another domain AE uses AE3 as a source, executing AE3 can also execute AE at the same time.

1. From the list of Domains, select a row.
2. Click Execute. The Execute Domain window opens.
3. Select Republish all visualizations to publish associated visualizations (this option is grayed out if none exist).
4. Select Include Source Domains to execute source domains.
5. Select Include Dependent Domains to execute any dependent domains (this option is grayed out if none exist).

Important: When creating a mapped domain, tables from the target data store are available. It is possible to select a table that depends on an existing mapping, creating a cyclical (self-referential) mapping. If a cyclical mapping is created, the system does NOT execute it and displays a warning.

Mapped Domains and the Global Library

In addition to importing and exporting mapped domains as .json files, the Global Library in elluminate can be used to share mapped domains between studies.

Mapped domains can be promoted to the Global Library or imported from it.

Promote Mapped Domains to the Global Library

Promoting mapped domains to the Global Library makes the domains available to other studies within the same URL or environment.

1. From the list of mapped Domains, select a row to promote.
2. Click the drop-down arrow next to Export in the Domains section.
3. Select Promote to Global Library. The Promote [Mapping Name] to Global Library window opens. This window allows selection of multiple domains to promote. 
   
4. Select the checkboxes next to the domains to promote and click Next. 
5. The next window allows selection of the folder and scope for the domains in the Global Library.
   
   
   • Folder: Select the folder where the mapped domain will be located. The Home folder is selected by default. Users with the Global Library Configure privilege can also create, modify, or delete folders.
   • Scope: Click the down arrows to expand Therapeutic Areas, Compounds, and Programs, then select the checkboxes to define the scope.
     • Use the scrollbar to view all items.
     • The selected Scope determines which studies can access to the mapped domain. 
6. If a Domain with the same name already exists in the Global Library, a popout window opens: Overwrite Global Library Objects? 
   
    
   1. Click Overwrite to overwrite, or Back to change the domain's location.
7. If Overwrite is selected, the system checks for differences between the existing and new versions.
   • If no changes were found, the Findings column displays: Exists in Library, No Changes Found. The dependent domains are promoted when Save is selected.
   • If changes are found, the Findings column displays: Overwrite Global Library Objects.
     • Select the Overwrite Global Library checkbox to create a new version in the library when Save is selected. 
     • Leave the box unchecked to keep the current version in the library.
8. In the Manage Dependencies window, the system checks for dependencies that will also be promoted to the library.
   • If no dependencies exist, the message No dependencies for this domain. displays. 
   • If a dependent domain does not exist in the library, the Findings column displays: Does not exist in Library. The dependent domains are promoted when Save is selected. 
     
9. Click Save to promote the domain and any dependent domains to the Global Library.
   • Click Back to make changes, Cancel to cancel the action.

Import a Mapped Domain from the Global Library

1. In the Mappings list at the top half of the window, select the mapping where the domain will be imported.
2. Click the drop-down arrow next to Import in the Domains section.
3. Select Import from Global Library. The Import Mapping from Global Library window opens.
   
4. By default, Select Objects is selected in the left navigation, and the window displays the Filter Library Objects and Library Mapping Objects.

5. Optionally, apply filters in Filter Library Objects. By default, the filter automatically applies the current study's attributes to display relevant mapping domains. The number in the blue badges indicate the number of selected items in each category (TA, Compounds, Programs). 

   1. Click the down arrows to expand Therapeutic Areas, Compounds, and Programs. 
   2. Select the checkboxes for items to filter.
   3. Click Reset to clear filters.

   The window updates automatically based on the selections.

6. Locate the Domain object to import using the folder structure or the Search field. Use the scrollbar to view all items.
7. Select the Domain object to import.
8. Click Mapping Dependencies in the left navigation (or Next) to verify dependencies.
   • Dependent domains that do not exist in the study are imported automatically.
   • If a mapping domain already exists, a popout window opens: Overwrite Mapping Domain?
     A mapping domain already exists for this table. Do you want to overwrite it?
9. Click Overwrite to overwrite, or Cancel to cancel the import.
   • If Overwrite is selected, click Save to import the domain to the mapping.
   • Click Back to make changes, or Cancel to cancel the action.