Quick Start

Improving User On-Boarding Experience in BAM

Consider when the need is to provision BAM testing Environment quickly, the user will have to set up a business process manually, provision BAM connectors into the required resource group and set up the testing Azure Logic App with the BAM connectors. To make this testing process easier, the user can follow the below process of provisioning the BAM test environment using PowerShell script.

1. Associate storage principle
2. Create a business process in BAM (Import Business Process)
3. Create a new resource group in Azure
4. Create resources in Azure
5. Use BAM

Associating Storage Account

To associate a Storage account for BAM user can follow the steps below:

1. Click on the associate storage icon
   

2. Now in this blade, User need to associate both the Azure SQL Database to store transaction records and Storage account to store archived messages
   

3. Click Test Connection to validate the connection string and click on save button
   User will now see the screen showing deployment is happening, and the deployment may take a while.
   

After the storage account association, the user can create a business process flow in Serverless360. To make this process easier, import the template business process as given in the upcoming part.

Import Business process

After associating the Storage account, the next step is to import the Business process.

1. Click on the Import Business Process button
   

2. Click on Select File button and select the Business Process Json file that is downloaded from the below link

BusinessProcesses-BAM.json

Now the Business Process is imported, and the next step is to deploy the Logic App configured with BAM connectors using Powershell, CloudShell or Azure CLI.

Instrument Business Process

Again, to instrument Business process, the user must make some changes in their existing Business process. But to make the user feel the experience more easily, the user can run the scripts given below in their Azure Cloud Shell and deploy resources to the required Subscription.

1. Open Azure portal
2. Create a new resource group if you want to deploy the resource in anew resource group. This step can be skipped if you want to deploy the resources in an existing resource group.
3. Click on the Cloud Shell icon from the Azure portal
   
4. Run the following Powershell scripts

$subscriptionId = Read-Host -Prompt "Enter the Subscription ID"
$resourceGroupName = Read-Host -Prompt "Enter the Resource Group name" 
$bamEndpoint = Read-Host -Prompt "Enter the BAM API Endpoint"
$apiKey = Read-Host -Prompt "Enter the BAM API Key"
$secureString = ConvertTo-SecureString $apiKey –asplaintext –force

New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName ` -SubscriptionID $subscriptionId ` -BAMEndpoint $bamEndpoint -TemplateUri https://raw.githubusercontent.com/Serverless360/serverless360-bam-lib/master/Kovai.Serverless360.Sample/BamCustomConnector.json

New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName ` -SubscriptionID $subscriptionId ` -APIKey $secureString -TemplateUri https://raw.githubusercontent.com/Serverless360/serverless360-bam-lib/master/Kovai.Serverless360.Sample/BamConnection.json

New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName ` -SubscriptionID $subscriptionId ` -TemplateUri https://raw.githubusercontent.com/Serverless360/serverless360-bam-lib/master/Kovai.Serverless360.Sample/BamLogicApp.json

5. BAM API Endpoint and Key can be found in the Serverless360 portal by moving to the below mentioned path

Settings>Access Keys>BAM Connection Details>Function App API Key

6. After provisioning the resources, Go to the appropriate resource group where you can find the deployed resources
   

7. Now get the HTTP endpoint from the HTTP Request connector and trigger it with the below given JSON body
   

Body Format: 
{
"Topic": "BAM_Testing",
"UserId": "sl360_u001475",
"DriverId": "sl360_d0058962",
"DriverLocation": "Location1",
"UserLocation": "Pickup Location 1",
"Destination": "User Destination001",
"IsValid": false
}

Achieving End to End Visibility

Once the messages have been triggered, User can view those data in the BAM section of Serverless360. User can move to the tracking tab inside BAM to investigate the transactions in the created business process.

To investigate on a transaction, user can click the more options icon and select View Transaction Details

For every business, there will be some business properties that we want to track. Those properties can be tracked in BAM which can be found in the Tracked Data tab.

Below are a few articles to know more about Business Activity Monitoring
• Tracking Hybrid Application Using Serverless360 BAM
• Uncover the Logic Apps Business Exceptions Using Serverless360 BAM