Developing Generic Apps

A "generic" app is built with the intent to be used by multiple CX Marketing customers. This topic explains the high-level process to create a generic app, from joining the Oracle Partner Network to releasing the app.

To develop generic apps:

Step 1 - Evaluation & Onboarding

  1. Submit the details of your proposed app using the evaluation form. If approved, the CX Apps team will advise you to continue with the process.

  2. Join the Oracle Partner Network. Make sure to accept the Oracle CIA (Oracle Cloud Interoperability Appendum). This is a prerequsite for getting sandbox account access. Not applicable to Oracle entities.

Note:

  • If you are an Oracle entity and interested in developing a generic app for Responsys, please ignore the OPN/partner related steps mentioned in the process.

  • For external partner built “generic” apps, as part of co-GTM process at the time of releasing the app, you will need to provide demo credentials for app & your platform. This is required to enable our teams to showcase the app.

Step 2 - Access Developer Resources

  1. Request access to Oracle AMS.

  2. Request access to a Responsys Sandbox account. Applicable only if you are an external partner, joined OPN, signed the CIA, and you do not have your own Responsys account already.

  3. Join the CX Apps Developer Community. This is the primary channel for questions about app development.

  4. Access other useful developer resources:

    1. Intro to CX Apps

    2. Short Developer Videos

    3. Documentation

Step 3 - Build and Test Your App

  1. You are now ready to build your app. Make use of all the developer resources provided in the Developer Help Center.

    Notes:

    • The infrastructure for hosting the app is the responsibility of the App Provider.

  2. For any questions during app development, post them on the CX Apps Insiders to get help from our tech experts and community members.

  3. Test your app.

    To whitelist a tenant for testing:

    1. In AMS navigate to Provider > Publication Whitelist URLs > Edit.

    2. Add the Responsys account ID to be used for testing. You can find your Responsys account ID by logging into Responsys and navigating to Account > Account Summary > Account ID.

    3. Note the following Functional Testing and Performance Testing guidelines.

    Functional Testing

    • It is the responsibility of the provider to ensure that end-to-end functional tests have been run.

    • The provider should use a Responsys sandbox account to perform functional tests.

    Performance Testing

    • Before initiating performance testing, providers should make sure that end-to-end functional testing of the app is complete.

    • Contact the CX Apps team to get access to a performance testing sandbox account (applicable only if you are an external partner, joined OPN, signed the CIA and you do not have your own Responsys account already).

    • Ensure you have tested the app with higher volumes (for example 1M, 2M, 5M records and so on)

    • Ensure you have tested the app with multiple programs running in parallel, to ensure the app is able to handle parallel invokes at the same time.

    • Ensure you do proper optimizations in your app to improve performance of the app.

    • After the performance testing is complete, submit the results using the Performance Testing Report.

Step 4 - Review Your App

Before you submit your app for review, make sure you have thoroughly completed functional and performance testing of your app.

  1. Next, complete and submit the Compatibility Review Document to the CX Apps team. Please make sure you have taken care of all aspects covered in the document. As part of the review process, the CX Apps team may ask for additional information and/or a demonstration of the app.

Step 5 - Release Your App

Step 5.1 Prepare App Resources

  1. Prepare the resources for your app's release such as:

    • Detailed user guide

    • Pitch deck, demo videos etc.

    • Customer on-boarding process

    • Support model

    • Enabling Oracle teams to showcase the app

  2. Change the publication status of your app in AMS.
  3. Update your App's Support information in AMS.

Step 5.2 Publish Your App on the Marketplace

Publish your app to the Oracle Cloud Marketplace.

To publish your app to the Oracle Cloud Marketplace:

  1. Become a Cloud Marketplace Publisher.

    • You must be an OPN member with an Oracle.com login. If you are an OPN member, but you do not have an Oracle.com login, follow the New User registration to associate your Oracle.com login with your OPN Membership Company ID.

    • Ensure to select only the Oracle products you are providing an integrated application.

  2. Create a listing on the Cloud Marketplace following the Oracle Cloud Marketplace Listing Guidelines.

    1. Sign in to the Oracle Cloud Marketplace Partner Portal

    2. Click Home > Create Listing > Application Listing.

    3. In the Demo URL field, enter a video demonstration of your app hosted on YouTube or Vimeo.

    4. In the Additional Information tab from your app listing, complete and submit the following documents from the Get Templates section:

      • Security Questionnaire, Test Plan

      • Integrates-with Supplement - <Oracle CX Cloud Product> (required if your app is hosted on the Oracle Cloud)

      • Partner Supplied Template: Deployment Guide (describes how to install, setup, and configure your application with the Oracle CX Cloud product)

      Your listing may be returned for further editing to improve overall content or add/correct content. Reference the Marketplace Guidelines document for requirements and tips.

  3. Publish your Marketplace listing

    After the listing, video demonstration and technical documentation are submitted, your listing will be reviewed and approved by Oracle. You will receive a notice that your listing has been approved to publish. Now you can publish your listing within the Partner Portal!

    1. Select your listing under Submitted and click Publish.

Learn more

Onboarding and the App Development Process

Developing Custom Apps