Articles in this section

See more
Print

Import Oracle Data | Update Office 365 Users rule

  • Updated
Follow

Rule description

This rule queries the specified Oracle data source and updates Office 365 user accounts according to the Action section settings.

 

When to use this rule

Use this rule when you need to perform bulk user account update from HR/ERP/SIS system into Microsoft Office 365.

 

Rule Settings

Query Section

Setting name Description

Hostname 

Specify Oracle server hostname (or its IP address) to which Cayosoft Administrator will connect.

Note: for more information, please read Connecting to Oracle Database article.

Service name

Specify the Oracle database service name.

Port

Specify Oracle SQL*Net Listener port number; the default is 1521.

Table

Specify Table or View from the selected database. Click the Selector button to display a list of tables from which to choose.

Credentials

Specify Oracle user account name and password.

Data Source Filter

You can use the point-and-click filter builder for the specified data source.

Note: If Where Clause is also specified, it will be applied and DataSource Filter will be ignored.

Data source anchor attribute

UserPrincipalName must be used as a DataSource Anchor attribute. It must be a unique value.  

Office 365 anchor attribute

UserPrincipalName must be used as a DataSource Anchor attribute. 

Note: Microsoft best practices assume the Active Directory and Office 365/Azure AD UPNs will match. 
More options  

Return these SQL columns

 

Specify columns returned by the data source.

Where clause

Define a WHERE statement in the SQL query sent to the data source to limit the rows returned by Oracle Server.

Properties to display

Select properties to display for each object found by the query.

Filter SQL data

 

Set the filtering conditions to only return objects or data that need to be processed by the rule.

Example: filter by Name column.

 

Filter Office 365 users

To hide unwanted data set the filtering conditions here.
Empty field in Data Source If the record in SQL column is empty, you can skip updating the attribute or clear its value.

 

Action Section

Setting name Description
Account  

First name (FirstName)

If the Data Source contains a field named FirstName, do nothing. Otherwise, use the Selector button to choose a field from the Data Source or just skip this setting.

Last name (LastName)

If the Data Source contains a field named LastName, do nothing. Otherwise, use the Selector button to choose a field from the Data Source or just skip this setting.

Display name

 

Specify DislpayName format.

Settings

 

Default password

Specify the password for the updated Office 365 user account. This value can be static text or a field from the Data Source chosen using the Selection button or just skip this setting.

Usage location

Specify the usage location for the updated Office 365 user account or just skip this setting.

Must change password at next logon

 

Specify if a user must change password at next logon or just skip this setting.

Account enabled

Specify if an updated user account will be enabled or disabled or just skip this setting. 

Organization

 

Office

Job title (Title)

Department

 

If the Data Source contains one of these field names, do nothing. Otherwise, manually enter a static text value or use the Selector button to choose a field from the Data Source or just skip this setting.

Contact Info

 

Country

Office phone (telephoneNumber)

Mobile phone (mobile)

Fax

Street address

City

State

Postal code

If the Data Source contains a field with one of these names, do nothing. Otherwise manually enter a static text value or use the Selector button to choose a field from the Data Source or just skip this setting.

 

Virtual Attributes

 

Virtual attributes

If you want every provisioned user to have a virtual attribute populated with some string value then use this:
{@{'csvaAttribute1'='YourString'}}, where csvaAttribute1 is a name of a virtual attribute in 

HOME > CONFIGURATION > Virtual Attributes in Cayosoft Administrative Console.

If you want every provisioned user to have a virtual attribute populated with the corresponding value from the column in your data source, then use this:
{@{'csvaAttribute1'=$_.VAName}}, since VAName is the name of the column from your data source.
Example: {@{'csvaAttribute1'='YourString1';'csvaAttribute2'='YourString2'}}

 

Output Section

This section defines the output format of this rule.

To get more information about this section, please see the Output section article.

 

Enforce/Schedule section

This section defines the schedule for how often to run the rule.

To get more information about this section, please see the Enforce/Schedule section article.

 

 Change History

Version Notes
7.3.0 Data Source filter is added.
6.4.0 If the record contains empty fields, then overwrite fields with empty values setting is renamed to Empty field in Data Source.
6.3.1 The rule is introduced in the product.

 

Related articles

Comments

0 comments

Please sign in to leave a comment.