Logic Apps (Standard) Connectors
  • 16 Nov 2022
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Logic Apps (Standard) Connectors

  • Dark
    Light
  • PDF

Article summary

To enable tracking in Logic Apps Standard, Atomic Scope deploys some components in Azure. Those components can be deployed using both PowerShell and the Atomic Scope portal. Next, by creating Logic apps or use the sample logic Apps that come with Atomic Scope, data can be tracked in the portal.

Logic Apps Standard workflows

In case of Logic Apps Standard Workflows, user cannot create their own custom connectors, which results in lack of tracking Atomic Scope business activities, compared to Logic Apps Consumption workflows.

As an alternative method to overcome this limitation, users can make use of the HTTP Actions provided in Azure functions.

Azure functions will deploy automatically while installing the Azure samples.

https://docs.atomicscope.com/v83/docs/installing-azure-samples.

Resource group -> Azure Functions -> Activities -> Get function URL

Logicstandard1.gif

You can create Logic Apps Standard flows using the same connector function URLs. Be aware, that you should create Logic App in the same Resource Group and Function App deployed through Atomic Scope. Every Logic App standard will have an automatically created service plan, API connection, and storage account.

Configuration and corresponding Header Values
Business Process Name – AS-BusinessProcess
Business Transaction Name - AS-BusinessTransaction
Stage Name - AS-CurrentStage
API Resource ID (for localhost) – AS-ResourceId
Resource Group Name (Azure Function) – x-ms-workflow-resourcegroup-name
Subscription Id (Azure Function) - x-ms-workflow-subscription-id

**StartActivity **
This is the first step in starting an activity that will push the data to Atomic Scope. The Logic Apps should be initiated by using the Start activity function URL.

image.png

The request to the start activity should contain the above mandatory headers as well as message body in the below format (Json schema).

{
"MessageBody": "some message...",
"MessageHeader":"headers.."
}

UpdateActivity

The update activity function is used to update the object created in the StartActivity with the parameters provided. Using the Update function URL, you can update the Start stage.

image.png

Note:
The activity Ids will be directly available in the output of Logic App consumption. You need to provide input for the same, because Logic Apps Standard does not provide the activity ids separately.

Input for MainActivitiyId and StageActivityId respectively as a function
body('Start_Activity')?['MainActivityId']
body('Start_Activity')?['StageActivityId']

LogExceptionActivity
The Log Exception Activity function is used to log an exception on a specific stage using an exception message and exception code.

image.png

ArchiveActivity

The ArchiveActivity connector function helps in storing the data. This function URL can be used to archive the message body for a specific stage. You can also archive the message within the Start / Update Activities by setting the AS-ArchiveMessage header to True.

image.png

LogActivity

This is a one-time request in which Atomic Scope will automatically perform a start and update activity. Many of our customers wanted this API to be exposed in the cloud, so that they could avoid exhausting the messaging limit by consuming this API. Mandatory properties work in the same way as other APIs.
However, if you want the activity to continue, for example, if you are processing Stage2, you must send As-PreviousStage and As-MainActivityId from the output of the previous activity.

image.png

Usage Guide

To be able to use all functions within a single Logic App, follow the steps as shown below to invoke the Atomic Scope Custom Connector function URLs inside a Logic App.

image.png

The picture represents a Logic App Standard workflow and result of the flow in the AtomicScope portal.

• Get the StartActivity Function URL mentioned above to begin the flow and enter the mandatory fields.
• The MainActivityId and StageActivityId values are returned by the StartActivity function. These values will be passed to the UpdateActivity connector function as input and also mandatory fields.
• LogActivity is a single connector function that allows you to perform both the Start and Update events in a single action. The second stage in this flow is LogActivity. To connect to the current stage, you must provide the required fields and the previous stage name.
• Using the LogException function, you can display the exception in the second stage.
• The ArchiveActivity function is being used to archive the second stage, because we are providing specific stage details.

Important

  • In a custom connector, the user can dynamically obtain all mandatory fields and URLs. In contrast to the Logic Apps Standard, manually pass the required parameters and URLs (Function).
  • MainActivityId and StageActivityId should pass as function(Input) for the required stages.

Was this article helpful?