Skip to main content

Articles in this section

Print

Import Oracle Data | Create Office 365 Guest Users

  • Updated

Import Oracle Data | Create Office 365 Guest Users

Rule description

This rule queries the specified Oracle data source and provisions new Microsoft 365 guests accounts according to the Action section settings.

When to use this rule

Use this rule when you need to perform bulk Office 365 guest user accounts provisioning into Microsoft 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 the Where clause is also specified, it will be applied and DataSource Filter will be ignored.
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

Each object property defined in this setting matches the column that will be displayed in the Web Portal for this web query.

To display additional columns, add the required properties to the Properties to display list.

To add extension attribute 1 that is synchronized from AD, you need to use a value like:

Copy
"OnPremisesExtensionAttributes/extensionAttribute1~Extension Attribute 1"

Filter Data

 

Set the filtering conditions to hide unwanted data based on criteria not supported in the Query criteria setting.

Example: filter by the found object Distinguished Name.

TIP: For optimal performance, use the Query criteria setting above to filter objects whenever possible.

Initialization Script

Script

Usually, rules use query criteria to limit the query search scope. It improves the performance of the executed rule.

Due to the PowerShell limitations, it is not possible to use calculated expressions in query criteria. That is the point where the initialization script can help. You can initialize a global variable in this setting and then use it in query criteria.

IMPORTANT: To use a variable, declared in the initialization script, in the query scope, it must be global: $global:<variable name>.

Example: Update AD users, created in the last ten days.

  1. Add this initialization script

    Copy
    {$global:DatePeriod = (Get-Date).AddDays(-10)}

  2. Use the $DatePeriod variable in the query criteria builder:

Action section

Setting name Description
Account

InviteEmail

The Email address to which the invitation is sent.

If the Data Source contains a field named InviteEmail, ignore this setting. Otherwise, use the Selector button to choose a field from the Data Source. 

First Name (FirstName)

If the Data Source contains a field named FirstName, ignore this setting. Otherwise, use the Selector button to choose a field from the Data Source. 

Last Name (LastName)

If the Data Source contains a field named LastName, ignore this setting. Otherwise, use the Selector button to choose a field from the Data Source. 

Display Name

 

If the Data Source contains fields named FirstName and LastName, ignore this setting. Otherwise, use the Selector button to select a field from the Data Source or contact Cayosoft for an override format.  

Settings

Usage location Specify the usage location.
Account status Specify invited guest user account status. 
Send invite Specify if to send an invitation email to the invited guest user.
Personal message You can specify a personal message that will be sent to the invited guest user.

Redirect URL

 The URL to which the invited user is forwarded after accepting the invitation.

Organization

  • Office

  • Job Title (Title)

  • Department

Specify a static text value or use the Selector button to choose a field from the Data Source.

Contact Info

  • Country

  • Office Phone (telephoneNumber)

  • Mobile Phone (mobile)

  • Street Address

  • City

  • State

  • Postal Code

  • Fax 

Specify a static text value or use the Selector button to choose a field from the Data Source.

Output section

This section defines the output format of this rule.

To get more information about this section, please see the Rule 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 Rule Enforce/Schedule section article.

© Copyright 2013-2026 Cayosoft Inc. All rights reserved.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Return to top

Related articles

Comments

0 comments

Please sign in to leave a comment.