NOTE: THIS EXTENSION IS COMMUNITY-TESTED AND IS NOT PART OF OUR REGULAR RELEASE CYCLE. THIS EXTENSION IS FOR THE LATEST VERSION OF APPRENDA. IF YOU ENCOUNTER AN ISSUE OR REQUIRE A PREVIOUS VERSION, PLEASE LEAVE A COMMENT AND WE'LL ADDRESS IT ASAP.
The Subscription Purchaser is an extension offered to the community by Apprenda to support other extensions that require the purchasing of subscriptions through a deployed application.
How does it work?
The Subscription Purchaser takes as an input the application and version aliases for the desired subscription ('developer', 'v1') or the application and version ids (guid,guid) and returns the unique identifier (GUID) of the resulting subscription.
Calling the Subscription Purchaser
In order to call the Subscription Purchaser from your application, you first need to create a service proxy that will allow you to connect to the extension and implement the service interface. You can download a sample proxy and interface by clicking in the link below:
Along with its accompanying System.ServiceModel client configuration in the App.confg:
<client>
<endpoint address="net.tcp://localhost:22000/services/soap12/tcp/r/{extensionalias}/SubscriptionPurchaser/ISubscriptionPurchaser" behaviorConfiguration="ApprendaClientBehavior" binding="netTcpBinding" bindingConfiguration="DefaultTcpBinding" contract="DeveloperPortalPurchaser.ISubscriptionPurchaser" />
</client>
Making the Subscription Purchaser Available
- Download the Archive.
- Create a new Application in Apprenda (Authentication required in the Application Settings page).
- Upload the archive.
- Promote to Sandbox and then Published.
One the Application is in the Published stage, your extensions will be able to call it.
Current Implementation
The Subscription Purchaser is set up to purchase the first available plan for the published entitlement definition if you use one of the methods where the plan name is not a parameter.
Downloading the Extension
To download the extension archive, click on the link below.
A couple of questions, Erik -
1) During testing can the application being subscribed to be in the Sandbox?
2) When the Pricebook contains both trial and paid for plans in both the compulsory user-based pricing and the optional account-wide subscription pricing how do we know which counts as the "first available plan"? The documentation above states that - "Currently, the Subscription Purchaser is set up to purchase the first available plan for the published entitlement definition".
Hi Brian,
1.- In order to target an application in Sandbox you have to specify the version alias (v1, v2, etc) so make sure to use one of the methods that allow you to that. If you don't specify a version alias, the extension will default to the production version.
2.- You can target a specific plan by passing the plan name. The first available plan refers to the first plan within your pricebook.
I hope this answers your questions.
Best Regards,
Erik L
will this work with apprenda 6.0 and on