Configure

Configure workspace credentials and then configure the app.

Import the App

The Oracle APEX app includes supporting objects to deploy the base schema objects. The schema can be initiated using either the downloaded schema scripts or during the app installation using the supporting objects.
Follow these steps to import the downloaded APEX application:
  1. Log in to APEX App Builder.
  2. Import the downloaded app into the Workspace.
  3. After the app installation, select to install Supporting Objects to initialize the schema.
  4. Validate the app is imported and runs successfully.

Configure Workspace Credentials

Configure the APEX Web Credentials used by the app and set up OCI native authentication with the static identifier OCI credential static identifier and map it to the app substitution strings. Optionally, create separate credentials per OCI service if needed.
The app uses a common OCI credential for OCI Generative AI, OCI Speech, and OCI Object Storage services. The credential's static identifier referenced by the app settings and substitution strings is oci_credential. For deployments that require separate credentials per service, create a new APEX Web Credential per service. See Creating Web Credentials linked in the Explore More topic.

Follow these steps to configure workspace credentials:

  1. Edit the OCI_CREDENTIAL Web Credential in APEX.
  2. Set Authentication type to OCI Native Authentication.
  3. Set the credential's Static Identifier to oci_credential (this value is referenced by the app settings).
  4. Use the following app Substitution Strings to reference the credential:
    • G_APP_OCI_CREDENTIAL
    • G_APP_OCI_GENAI_CREDENTIAL
    • G_APP_OCI_OBJSTOR_CREDENTIAL
    • G_APP_OCI_SPEECH_CREDENTIAL
  5. If using separate credentials per service, create a distinct Web Credential for each service (Generative AI, Speech, Object Storage), and update the app Substitution Strings accordingly.
    Before creating credentials, ensure your user has OCI API keys configured. See Prepare Your User linked in the Explore More topic.

Configure the App

Update application substitution strings and set tenancy and region details in the app configuration to enable integration with OCI Generative AI, OCI Speech, and OCI Object Storage.
The app uses two sets of configuration settings: application definition Substitution Strings and tenancy details managed through App Configuration.
  1. Update application Substitution Strings as needed.
    The app typically uses a common Web Credential and does not require changes. If using separate credentials per service, adjust the values in the Application Definition. See Editing the Application Definition linked in the Explore More topic.
  2. Log in to the app.
  3. Open the navigation menu and select App Configuration under Settings.
  4. Enter tenancy and region details for AI services as follows:
    1. Set AI Services Region.
    2. Set Object Storage Namespace.
    3. Set Bucket Compartment OCID.
    4. Set Source Bucket.
    5. Set Output Bucket.
    6. Set Speech AI Model.
  5. Click Apply.