Skip to main content

Data import

Connection details

  1. In the Client ID and Client secret field, enter the details found under API Application Keys (in SAP Fieldglass, when logged in as the configuration manager).
  2. In the Headers field, enter the following:
{"Authentication":{"Content-Type":"application/json","x-api-key":"{your application Key}","Authorization":"{your Basic Authentication token}"}}

where:

{your application Key} - the key found under API Application Keys (in SAP Fieldglass, when logged in as the configuration manager).
{your Basic Authentication token} - the authentication token. To get the token, create a Base64 with the username and the password of the configuration manager (username: password). Copy the basic authentication and enter inside the brackets.

Queries and mappings

Suppliers – Identity

Parameters:

TabParameterValue
GeneralURLSupplierDownload
GeneralDistinctEnabled
GeneralDescriptionSuppliers
AdvancedHTTP verbGET
AdvancedURL is a DynamicExpresso expressionNo

Mappings:

DestinationOperatorSource
Business keyMapSupplierCode
Unique IDMapSupplierCode
NameMapSupplierName
StatusConstantActive
First nameMapSupplierName
Last nameMapSupplierName
TypeConstantPrimary
CategoryConstantOther

Contractors – Identity

Parameters:

TabParameterValue
GeneralURLActiveWorkersDownload
GeneralDistinctEnabled
GeneralDescriptionContractors
AdvancedHTTP verbGET
AdvancedURL is a DynamicExpresso expressionNo

Mappings:

DestinationOperatorSource
Business keyExpressionString.IsNullOrWhiteSpace(PersonID) ? WorkerID : PersonID
Unique IDMapWorkerID
NameExpressionFirstName + " " + LastName
StatusConstantActive
First nameExpressionFirstName == null ? PersonID : FirstName
Last nameExpressionLastName == null ? PersonID : LastName
EmailMapWorkerEmail
Employee IDMapWorkerID
Valid fromMapStartDate
Valid toExpressionString.IsNullOrWhiteSpace(EndDate) ? new DateTime(9999, 12,31): DateTime.Parse(EndDate)
TypeConstantPrimary
CategoryConstantContractor

Users – Identity

Parameters:

TabParameterValue
GeneralURLUserDownload
GeneralDistinctEnabled
GeneralDescriptionGet all the users
AdvancedHTTP verbGET
AdvancedURL is a DynamicExpresso expressionNo

Mappings:

DestinationOperatorSource
Business keyExpressionFirstName + "_" + LastName + "_" + Username
Unique IDMapUsername
NameMapUsername
StatusConstantActive
First nameMapFirstName
Last nameMapLastName
EmailMapEmail
TypeConstantPrimary
CategoryConstantContractor

Cost Center – Context

Parameters:

TabParameterValue
GeneralURLCostCenterDownload
GeneralDistinctYes
GeneralDescriptionCost centers
AdvancedHTTP verbGET
AdvancedURL is a DynamicExpresso expressionNo

Mappings:

DestinationOperatorSource
Business keyMapCostCenterCode
NameMapCostCenterName
TypeConstantCost Center
Short nameMapCostCenterCode

Business Unit – Context

Parameters:

TabParameterValue
GeneralURLBusinessUnit
GeneralDistinctYes
GeneralDescriptionBusiness unit
AdvancedHTTP verbGET
AdvancedURL is a DynamicExpresso expressionNo

Mappings:

DestinationOperatorSource
Business keyMapCode
NameMapName
TypeConstantOrgUnit
Short nameMapCode

Location – Context

Parameters:

TabParameterValue
GeneralURLActiveWorkersDownload
GeneralDistinctYes
GeneralDescriptionLocations
AdvancedHTTP verbGET
AdvancedURL is a DynamicExpresso expressionNo

Mappings:

DestinationOperatorSource
Business keyMapSiteCode
NameMapSiteName
TypeConstantLocation
Short nameMapSiteCode

Cost Center – Context assignment

Parameters:

TabParameterValue
GeneralURLActiveWorkersDownload
GeneralDistinctYes
GeneralDescriptionCost centers
AdvancedHTTP verbGET
AdvancedURL is a DynamicExpresso expressionNo

Mappings:

DestinationOperatorSource
Context business keyMapCostCenterCode
Owner UIDMapWorkerID

Business Unit – Context assignment

Parameters:

TabParameterValue
GeneralURLActiveWorkersDownload
GeneralDistinctYes
GeneralDescriptionBusiness unit
AdvancedHTTP verbGET
AdvancedURL is a DynamicExpresso expressionNo

Mappings:

DestinationOperatorSource
Context business keyMapBusinessUnitCode
Owner UIDMapWorkerID

Location – Context assignment

Parameters:

TabParameterValue
GeneralURLActiveWorkersDownload
GeneralDistinctYes
GeneralDescriptionLocation
AdvancedHTTP verbGET
AdvancedURL is a DynamicExpresso expressionNo

Mappings:

DestinationOperatorSource
Context business keyMapSiteCode
Owner UIDMapWorkerID

Additional configuration

Add the following existing properties to Identities using the Form designer:

  • Cost center
  • Location
  1. In Omada Identity, in the onboarded system view, click Warehouse to portal mappings.
  2. Open Identities (Update or create, Identity update) and then click Mappings.
  3. Enter the following details (for Cost center):
    • Operator – Lookup
    • Source (search source field) – ComposedBusinessKey


  1. Click Edit. Enter the following details:

    • Target key property – ODWBUSIKEY
    • Lookup view – Context assignments
    • Lookup join field – IdentityComposedBusinessKey
    • Lookup value field – ContextComposedBusinessKey
    • Lookup field (SQL) – [ContextType]= 'Cost Center'


  1. Change the ContextType to the respective destination you are editing.
  2. Repeat the steps for Location. Click OK.
  3. Open the Location data object type. Click Source.
  4. In the Additional filtering (SQL), change the Personal Area to Location. Click OK.
  5. Move up the Cost centers and Locations data object types so they are beneath Organizational units but above Identities.
  1. In the warehouse to portal mappings, enable all data object types.

Event definition - Generate Email for Identities

  1. In Omada Identity, go to Event definitions.
  2. Open the Generate Email for Identities event. Select Disabled.
  3. Click Apply and OK.
  4. Enable the Create identity user (initial load only) event definition.

Verify the authorization source policies

  1. Go to Setup > Administration > Connectivity Configuration > Auth. Source policies.
  2. Open Non-employee policy.
  3. In the building rules, change the source from Internal to External.
  4. Click Apply and OK.