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 in the selected mapping. The buttons across the top of the Domains section are used to manage mapped domains.

Important: Domain execution respects user privileges and configured Data Blinding rules. If the execution account has the Blinded Data View privilege, unblinded values may be used in transformations and written to downstream data stores. Verify that execution account privileges align with the study’s blinding strategy and configure Data Blinding before executing mapped domains that include sensitive data. 

Mapped domain blinding options (Default, Restrict Blinded Data, Map Blinded Data) further control how data is handled during transformation and help prevent unblinded values from being written to derived domains or downstream data stores.

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.

• Double-click the domain, or select it and click Design to open the Domain Editor 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.

Generate a Mapped Domain Report

Use the Report button 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 the Domain Editor

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

Note: Blinding rules are not automatically applied to derived domains. Configure corresponding blinding rules for domains that create or transform sensitive data to ensure consistent masking in downstream outputs.

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 a mapped domain is exported, only that domain and its dependencies are included. Dependencies must be preserved to ensure the domain executes correctly in the target study.

• 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.

Important: When exporting domains that include sensitive variables, ensure that corresponding blinding rules are also configured in the target study. Exporting and importing domains does not include Data Blinding configurations.

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

Note: Imported domains may include transformations of sensitive data. Review and configure Data Blinding rules in the target study to ensure appropriate masking of both source and derived data.

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 runs its transformation and writes the resulting data to the configured data store or staging area.

When executing a domain, users can 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.

Note: Review the mapped domain blinding options and execution privileges before executing domains that include sensitive data.

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. Users can 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 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 applies the current study's attributes to display relevant mapping domains. The number in the blue badges indicates 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.