Working with an ISV solution

Follow the following guidelines to install and use an ISV solution.

Install an ISV solution

1. Once you install an instance of Azure Data Manager for Agriculture from Azure portal, navigate to Settings ->Solutions tab on the left hand side in your instance. Ensure you have application admin permission.
2. Select Add to view the list of Solutions available for installation. Select the solution of your choice and select on Add button against it.

3. You're navigated to the plan selection pane where you have to give the following inputs:
   1. Select Authorize button to give consent to the Solution Provider to create app needed for Solution installation.
   2. Object ID. See here to find your Object ID
   3. Select plan of your choice
4. Select the Terms and Conditions checkbox and select on Add.
5. The solution is deployed on your Data Manager for Agriculture instance and role assignment is handled at the backend.

Edit an installed Solution

To edit an installed Solution, select on the edit icon against the Solution in Solutions page. You're redirected to plan selection pane to modify your plan. If it's a solution with private plans, you're redirected to Azure Marketplace from where you can contact the ISV partner by clicking on Contact Me.

Delete an installed Solution

To delete an installed Solution, select on the delete icon against the solution in solutions page and confirm the same on the popup. If it's a Solution with private plans, you're redirected to Azure Marketplace from where you can Contact the ISV partner by clicking on Contact Me.

Use an ISV solution

Once you install an ISV solution, use the below steps to understand how to make API calls from your application. Integration (request/response) is done through APIs asynchronously.

A high level view of how you can create a new request and get responses from the ISV partners solution:

1. You make an API call for a PUT request with the required parameters (for example Job ID, Farm details)
   • The Data Manager API receives this request and authenticates it. If the request is invalid, you get an error code back.
2. If the request is valid, the Data Manager creates a PUT request to ISV Partners solution API.
3. The ISV solution then makes a GET request to the weather service in data manager that is required for processing.
4. The ISV solution completes the processing the request and submits a response back to the Data Manager.
   • If there's any error when this request is submitted, then you might have to verify the configuration and parameters. In case you're unable to resolve the issue then reach out to us by creating a support ticket.
5. Now you make a call to Data Manager using the Job ID to get the final response.
   • If the request processing is completed by the ISV Solution, you get the insight response back.
   • If the request processing is still in progress, you get the message 'Processing in progress'

Once all the request/responses are successfully processed, the status of the request is closed. This final output of the request is stored in Data Manager for Agriculture. You must ensure that you're submitting requests within the predefined thresholds.

Identify Object ID of the Solution

1. Navigate to Enterprise Applications page in Azure portal.
2. Use the Application ID mentioned in the Solution Plan selection pane and filter the Applications.
3. Copy the Object ID

Next steps

• Test our APIs here.