Skip to main content

Subject Mapping

Subject mapping connects external users, departments, and organizations to subjects in the current Soln workspace. Open the page from a selected OpenLink system so every mapping remains scoped to that system.

Subject Mapping Page​

Use the subject type selector to switch between Organization, Department, and Member mappings.

AreaDescription
SearchFilters the current subject type by local or external name and code
Subject TypeSwitches the list between organization, department, and member mappings
Auto MatchConfigures field-based mapping for the current subject type
CreateOpens the manual mapping window
Mapping ListShows the local subject, external subject, external code, and update time

The page must be opened from an OpenLink system. If no system is selected, mapping actions are unavailable.

Create A Mapping Manually​

  1. Select Organization, Department, or Member
  2. Click Create
  3. Select the local subject
  4. Enter the external subject name
  5. Enter the external subject code
  6. Click Create
FieldDescription
Local SubjectThe organization, department, or member in the current workspace
External SubjectThe corresponding name used by the external system
External CodeThe stable identifier used by the external system

One local subject can have only one mapping for the same OpenLink system and subject type. An external code must also remain unique in that scope.

Edit Or Delete Mappings​

Use the row actions to edit or delete one mapping. Select multiple rows to delete them together. You can also select all records matching the current subject type and search filter, including records outside the current page.

Deleting a mapping does not disable Auto Match. If Auto Match is enabled, a later local subject update can create the mapping again from the configured fields.

Configure Auto Match​

Auto Match uses fields from the local organization, department, or member profile form as the external subject name and external code.

  1. Select the subject type to configure
  2. Click Auto Match
  3. Choose Enabled or Disabled from Status
  4. When enabled, select the external name source field and external code source field
  5. Click Save or Save and Generate

Auto Match is configured independently for each subject type.

SettingDescription
StatusControls whether automatic synchronization is active for the current subject type
External Name FieldSupplies the external subject name
External Code FieldSupplies the external subject code

When Auto Match is disabled, the source fields cannot be edited. Use Save to store the disabled state.

Save And Generate Behavior​

ActionAvailabilityResult
SaveEnabled and disabled statesSaves the configuration without generating mappings for existing subjects
Save and GenerateEnabled state onlySaves the configuration, then immediately generates mappings for existing subjects of the current type

Save and Generate is unavailable when Auto Match is disabled or when the corresponding local profile form is missing.

During generation, Soln updates an existing mapping for the same local subject or creates a new one. A subject is skipped when either selected source field has no value. The completion message reports generated and skipped counts.

After an enabled configuration is saved, later creates and updates of local subjects synchronize their mappings automatically.

  1. Confirm that the organization, department, or member profile form contains stable name and code source fields
  2. Configure Auto Match separately for each required subject type
  3. Use Save and Generate to create mappings for existing subjects
  4. Review generated mappings and resolve missing or duplicate external codes
  5. Keep Auto Match enabled for ongoing synchronization, or save it as disabled when mappings should be maintained manually