Test integration from Integration Report

The AppDirect Integration Tests section of the Integration Report page displays the status of the subscription event integration tests that you can run, for standalone products, from this page through simulated workflows.

You can test each event in the subscription management workflow, when you perform all of the integration tests that are available on this Integration Report page, and on the Account Details page. For example, create subscription, assign and unassign users, and change subscription. You can also perform these tests through the Preview Profile pages.

These tests use your AppDirect account as the customer account. They create, change, and cancel a real subscription for your account. Your account is flagged as a tester account for your own products, so you are not charged for the subscriptions.

To start, you create a subscription from the Integration Report page, or with the Preview Profile checkout flow. Thereafter, you can run subscription event tests against the subscription from the Integration Report and Accounts page.

Only one subscription exists at a time. Its status appears on the Accounts page, and test events appear on the Events page. When you cancel (remove) the subscription, it disappears from the Accounts page and it is no longer available for testing, however, the event history for the subscription remains on the Events page.

You can stop part way through the workflow and start again later from the same point. If you need to retest the Create Subscription event again and there is an existing subscription account, you need to cancel it first.

Prerequisite: Enter integration endpoint URLs and run the ping tests to ensure that the endpoints work. See Edit integration and Run ping tests.

The following table summarizes the tests that you can perform from each page.

Subscription Test Event	Preview Profile page	Integration Report page	Account Details page
Subscribe to your product/Create subscription (SUBSCRIPTION_ORDER event)	Yes	Yes
Assign user		Yes
Unassign user		Yes
Suspend account			Yes
Reactivate account			Yes
Edit order start date			Yes
Edit order end date			Yes
Edit order billing end date			Yes
Edit Order end of contract date			Yes
Upcoming invoice notification to the customer			Yes
Change subscription		Yes
Cancel subscription		Yes	Yes

To test integration from the Integration Report

1. Go to Manage > Billing and Distribution > Products > applicationName | Edit > Integration Report. The Integration Report page opens.
   Note: In the next step, you test the first event in the subscription workflow, SUBSCRIPTION_ORDER. It creates a subscription against which you run subsequent subscription event tests.
2. Complete one of the following actions:
   • If available, click Subscribe to your product | Run Test. The Purchase page (step one in the subscription workflow) opens.
   • If available, click Success, then select Rerun Test from the drop-down list. The Purchase page (step one in the subscription workflow) opens.
3. (Optional) To leave the test flow at any point, click Return to Overview to return to the Integration Report page.
4. Complete one of the following actions:
   • Take no action to accept the default edition, order quantity, and add-on (if there are connected add-ons) selections.
   • Change the order quantity, edition, or add-on selections (if there are connected add-ons).
5. Click Create Subscription. One of the following messages appears:
   • A message confirms test failure with details. Go to Manage > Billing and Distribution > Products > productName | Edit > Integration | Events to view details of the failed test event, then go to Integration | Edit Integration to edit your integration settings.

📝 Note When a test fails during this procedure, as explained in the previous step, read the failure message details, then go to Events to investigate, and then go to Edit Integration to correct the settings.

• A message confirms that the subscription was created and the Continue to Assignment button activates. The Events page displays the resulting SUBSCRIPTION_ORDER event, the Accounts page displays the resulting subscription, and the Editions & Pricing tab on the Preview profile page displays an Update Subscription button instead of a Buy Now button.

6. Click Continue to Assignment to continue to the next test. The Assignment page opens (step two in the subscription workflow).

📝 Note In this step you can only assign users to subscribed products. If the product purchased in the Subscribe to your product step is incomplete, because the event is still pending and needs to be resolved manually or is waiting for a response from the vendor, it will not appear in the list of possible products to assign.
📝 Note You can test additional events on this subscription from the Account Details page until you run a Cancel Subscription test, which deletes the subscription. For more information, see Accounts.

7. Perform the following steps on the Assignment page to assign and unassign users (steps three and four in the subscription workflow).
   1. Select the checkbox next to the users that you want to assign to the application.
   2. If you configured User Information to Sync for this product (see Edit product integration settings), a dialog appears. Enter the required information, and then click Submit. The dialog closes.
   3. Click Save Changes. A message confirms that the assignment was successful.
      Note: After you assign a user, you have the option to test single sign-on integration.
   4. Deselect the checkbox next to the users that you want to unassign from the application.
   5. Click Save Changes. A message confirms that the unassignment was successful and Continue to Change Subscription activates.
   6. Click Continue to Change Subscription. The Change page opens (step four in the subscription workflow).
8. (Optional) The Change page steps are applicable if the product has unit quantities or multiple editions. If that is not true click Continue to Cancel and proceed to the next step. If it is true, perform the following actions:
   1. Select a different edition or quantity to change the subscription.
   2. Click Change Subscription. A message confirms that the change was successful.
   3. Click Continue to Cancel. The Cancellation page opens (step five in the subscription workflow).
9. Perform the following actions on the Cancellation page.
   1. Click Cancel Subscription. The Request Date of Cancellation dialog appears.
   2. Select a cancellation date option, and then click Continue. A Confirmation of Cancellation dialog appears.
   3. Click Yes. The Integration Report page opens and a message confirms that the application was removed. The test account no longer appears on the Accounts page. The related events remain on the Events page (see Events).