3.9 Creating a Service Signup Wizard

Instance administrators can create a Service Signup Wizard that users must complete before new workspace requests are submitted.

Note:

To ensure the security and performance of your development environment, this functionality is not available in Oracle APEX instances running in Oracle Cloud.

When users request a new workspace, administrators can create a wizard that requires the user provide a justification, accept an agreement, or optionally respond to survey questions. In addition, administrators can specify whether to support Productivity App Only workspaces, define blocked email domains and provide a message that displays when a user enters an email address containing a blocked domain, and create a custom success message.

3.9.1 Defining a Service Signup Wizard

Instance administrators define a Service Signup Wizard on the Service Signup Wizard page.

When users request a new workspace, administrators can create a wizard that requires the user provide a justification, accept an agreement, or optionally respond to survey questions. In addition, administrators can specify whether to support Productivity App Only workspaces, define blocked email domains and provide a message that displays when a user enters an email address containing a blocked domain, and create a custom success message.

To define a New Service Signup Wizard:

Sign in to Oracle APEX Administration Services.

  1. Click Manage Instance.
  2. Under Self Service Sign Up, click Manage New Service Signup Wizard.
  3. Under Options:
    1. Blocked Email Domains - Specify a comma-delimited list of email domains that are not permitted to request a workspace (for example: example1.com,example2.com). Use the prefix ! to specify an email domain that is only permitted to request a workspace (for example: !example1.com).
    2. Blocked Email Message - Message to be shown to the user when an email address with a blocked domain is entered.
    3. Enable Schema Selection - Determines whether the user is prompted for the database schema information or whether the schema is defaulted.
    4. Require Justification - Determines whether to prompt the user for a justification for creating the workspace.
    5. Enable Agreement - Determines whether to include or exclude an agreement. Select Yes to display an agreement.
    6. Agreement Text - Enter the text of the agreement.
    7. Request Success Message - Message to be shown to the user when they get to the Workspace Request successful page. This message replaces the standard message provided.
  4. Under Survey Questions:
    1. Enable Survey - Determines whether to include or exclude the survey. Select Yes to display the survey questions you define during the New Service Signup Wizard.
    2. Questions - Each question can have any number of answers. Enter all answers for each question in one field, delimited by a new line.
    3. Pre Text - Enter introductory text.
    4. Post Text - Enter closing text.
  5. Click Apply Changes.

3.9.2 Running a New Service Signup Wizard

Instance administrators can run the Signup Wizard by clicking Run New Service Signup Wizard on the Manage Instance page.

To run a new Service Signup Wizard:

  1. Sign in to Administration Services.
  2. Click Manage Instance.
  3. Under Self Service Sign Up, click Run New Service Signup Wizard.
  4. Follow the on-screen instructions.