13.5 Create your Microsoft Azure Project

Segment Activation to Microsoft Azure Event Hub - Define an Azure Function

13.5.1 Getting familiar with Azure Event Hub functions

Azure Functions allows you to run small pieces of code (called functions) without worrying about application infrastructure. With Azure Functions, the cloud infrastructure provides all the up-to-date servers you need to keep your application running at scale.

A function is triggered by a specific type of event. Supported triggers include responding to changes in data, responding to messages (for example Event Hubs), running on a schedule, or as the result of an HTTP request.

Azure Functions is a serverless compute service that lets you run event-triggered code without having to explicitly provision or manage infrastructure.

Azure Event Hubs integrates with Azure Functions for a serverless architecture.

13.5.2 Open Visual Studio Code and Logon to Azure

Visual Studio Code makes it easy to...

• define and bind Azure functions to Event Hubs

• test locally

• deploy to Azure

• remote log function execution

Open Visual Studio Code

To open Visual Studio Code enter visual in your operating system's search (Spotlight search on OSX, Search in Window's Taskbar). If you do not find it, you need to repeat the steps outlined in Exercise 0 - Pre-requisites.

visual-studio-code-icon.png

Logon to Azure

When you logon with your Azure account that you used to register in Exercise 0 - Pre-requisites, Visual Studio Code will let you find and bind all Event Hub resources.

Click the Azure icon in Visual Studio Code. If you do not have that option, something might have gone wrong with the installation of the required extensions.

Next select Sign in to Azure:

3-01-vsc-open.png

You will be redirected to you browser to login. Remember to select the Azure account that you used to register.

3-02-vsc-pick-account.png

When you see the following screen in your browser, you are logged in with Visual Code Studio:

3-03-vsc-login-ok.png

Return to Visual Code Studio (you will see the name of your Azure subscription, for example Azure subscription 1):

3-04-vsc-logged-in.png

13.5.3 Create an Azure Project

When you hover over Azure subscription 1, a menu will appear above the section, select Create New Project...:

3-05-vsc-create-project.png

Select a local folder of your choice to save the project and click Select:

3-06-vsc-select-folder.png

You will now enter the project creation wizard. Select Javascript as the language for your project:

3-07-vsc-select-language.png

Select Azure Event Hub trigger as your project's first function template:

3-08-vsc-function-template.png

Enter a name for your function, use the following format --demoProfileLdap---aep-event-hub-trigger and press enter:

3-09-vsc-function-name.png

Select Create new local app setting:

3-10-vsc-function-local-app-setting.png

Select an event hub namespace, you should see the Event Hub that you defined in Exercise 2. In this example the Event Hub namespace is vangeluw-aep-enablement:

3-11-vsc-function-select-namespace.png

Select your Event Hub, you should see the Event Hub that you defined in Exercise 2. In my case that is vangeluw-aep-enablement-event-hub:

3-12-vsc-function-select-eventhub.png

Select RootManageSharedAccessKey as your Event Hub policy:

3-13-vsc-function-select-eventhub-policy.png

Enter to use $Default:

3-14-vsc-eventhub-consumer-group.png

Select Add to workspace on how to open your project:

3-15-vsc-project-add-to-workspace.png

After you project is created, click on index.js to have the file open in the editor:

3-16-vsc-open-index-js.png

The payload sent by Adobe Experience Platform to your Event Hub will include segment id's:

[{
"segmentMembership": {
"ups": {
"ca114007-4122-4ef6-a730-4d98e56dce45": {
"lastQualificationTime": "2020-08-31T10:59:43Z",
"status": "realized"
},
"be2df7e3-a6e3-4eb4-ab12-943a4be90837": {
"lastQualificationTime": "2020-08-31T10:59:56Z",
"status": "realized"
},
"39f0feef-a8f2-48c6-8ebe-3293bc49aaef": {
"lastQualificationTime": "2020-08-31T10:59:56Z",
"status": "realized"
}
}
},
"identityMap": {
"ecid": [{
"id": "08130494355355215032117568021714632048"
}]
}
}]

Replace the code in your Visual Studio Code's index.js with the code below. This code will be executed each time Real-time CDP sends segment qualifications to your Event Hub destination. In our example, the code is just about displaying and enhancing the received payload. But you can imagine any kind of function to process segment qualifications in real-time.

// Marc Meewis - Solution Consultant Adobe - 2020
// Adobe Experience Platform Enablement - Module 13

// Main function
// -------------
// This azure function is fired for each segment activated to the Adobe Exeperience Platform Real-time CDP Azure 
// Eventhub destination
// This function enriched the received segment payload with the name fo the segment. 
// You can replace this function with any logic that is require to process and deliver
// Adobe Experience Platform segments in real-time to any application or platform that 
// would need to act upon an AEP segment qualiification.
// 

module.exports = async function (context, eventHubMessages) {

    return new Promise (function (resolve, reject) {

        context.log('Message : ' + JSON.stringify(eventHubMessages, null, 2));

        resolve();

    });    

};

The result should look like this:

3-16b-vsc-edit-index-js.png

13.5.4 Run Azure Project

Now it is time to run your project. At this stage we will not deploy the project to Azure. We will run it locally in debug mode. Select the Run icon, click the green arrow.

3-17-vsc-run-project.png

The first time you run you project in debug mode, you will need to attach a Azure storage account, click Select storage account.

3-17-vsc-run-project.png

From the list of storage accounts, select the one that you have created as part of 13.1.4 Setup your Azure Storage Account. Your storage account is named --demoProfileLdap--aepstorage, for instance: mmeewisaepstorage.

3-22-vsc-select-storage-account.png

Your project is now up and running and is listing for events in the Event Hub. In the next exercise you'll demonstrate behavior on the Luma demo website that will qualify you for those segments. As a result you will receive a segment qualification payload in the terminal of your Event Hub trigger function:

3-23-vsc-application-started.png

13.5.5 Stop Azure Project

To stop your project, select the Terminal tab, click in the terminal window and press CMD-C on OSX or CTRL-C on Windows:

3-24-vsc-application-stop.png