Creating an SL1 PowerFlow Application

This section explains how to create your own application that can run on a PowerFlow system.

You can also use the PowerFlow user interface to perform many of the actions in this chapter. For more information, see Managing SL1 PowerFlow Applications.

What is a PowerFlow Application?

In PowerFlow, an application is a JSON object that specifies which steps to execute and the order in which to execute those steps. An application also defines variables and provides arguments for each step.

An application combines a set of PowerFlow steps that execute a workflow. The input parameters for each step are also defined in the application and can be provided either directly in the step or in the parent application.

The following is an example of a PowerFlow application:

PowerFlow application JSON objects are defined by configuration settings, steps that make up the application, and application-wide variables used as parameters for each step. The parameters of each step can be configured dynamically, and each step can be named uniquely while still sharing the same underlying class, allowing for maximum re-use of code.

You can run an application in the PowerFlow user interface. You can also execute an application through the REST API, and PowerFlow will process the application as an asynchronous task. Executing an application from the REST API lets you dynamically set parameter values for the variables defined in the application.

During processing, PowerFlow generates a unique task ID for the application and each of its tasks. Using the task IDs, you can poll for the status of the application and the status of each individual running step in the application.

The required parameters of applications are strictly enforced, and PowerFlow will refuse to execute the application if all required variables are not provided.

Workflow for Creating an Application

To create a PowerFlow application, you must perform these tasks:

1. Download a copy of the application template.
2. Define the required fields for the application.
3. Create the list of steps and step parameters.
4. Define application variables.
5. Upload the application to PowerFlow.
6. Validate and test the application.

View the "Template App" PowerFlow Application

PowerFlow includes a pre-defined application called integration_template. This default application appears in the PowerFlow user interface as the Template App application.

To view the Template App application:

1. Log into the PowerFlow user interface and go to the Applications page.
2. In the Search Applications field or the Application Name filter, type "Template App."
3. Select Template App from the list. The Template App detail page appears.

Creating an Application from the Application Template

The easiest way to create a new application is to use the application template that is included with the PowerFlow system. To copy this template to your desktop:

1. Using an API tool like Postman or cURL, use the API GET /applications/{application_name}:

   GET <URL_for_PowerFlow>/api/v1/applications/integration_template

   where <URL_for_PowerFlow> is the IP address or URL for the PowerFlow system.

2. Select and copy all the text in the application.

3. Open a source-code editor and paste the application in the source-code editor.

4. Save the new file as <newfilename>.json.

   where <newfilename>.json is the new name of the application includes the .json suffix. The file name must be unique within your PowerFlow system and cannot contain spaces.

Defining Required Fields for the Application

A PowerFlow application must include the following key:value pairs:

• "author": "name of the author",
• "configuration": "if this application uses configuration variables, specify the name of the configuration object",
• "description": "description of the application",
• "friendly_name": "name that appears in the user interface",
• "name": "file name without the py suffix",
• "version": "version number",

The integration_template includes the required fields listed above. You can edit the value for each key. To do so:

1. Using an API tool like Postman or cURL, use the API GET /applications/{application_name}:

   GET <URL_for_PowerFlow/api/v1/applications/<application_name>

   where <application_name> is the application you want to edit.

2. Copy the contents of the application to a source-code editor.

3. Search for the section of the file that contains the text "description".

4. Supply new values for the following keys:

   • author. User who created the application template.
   • configuration (if applicable). Configuration variables are defined in a stand-alone file called a configuration object that lives on the PowerFlow system and can be accessed by all PowerFlow applications and their steps. If your application or the steps in the application reference configuration variables, you must specify the name of the configuration object in this value. For more details on creating a configuration object, see the section on Defining a Configuration Object.
   • description. This description will be displayed in the PowerFlow user interface when viewing the available applications.
   • friendly_name. The name of the application as it will appear in the user interface.
   • name. Name of the file, without the .py suffix.
   • Version. Version number of the application.

5. Save your changes. Save the file to the same name (<application_name>.json.)
6. To upload the application to the PowerFlow system, see the section on Uploading an Application.

Example Code: integration_template

Creating the List of Steps and Step Parameters

In the PowerFlow application, you must specify the steps to execute and the order in which they should be executed.

If steps do not have dependencies, PowerFlow will execute steps in parallel. If steps have dependencies (meaning one of the steps requires data from another step), PowerFlow will execute the step that provides data and then execute the step that consumes that data.

To edit the steps section of the application:

1. Using an API tool like Postman or cURL, use the API GET /applications/{application_name}:

   GET <URL_for_PowerFlow>/api/v1/applications/<application_name>

   where <application_name> is the application you want to edit.

2. Copy the contents of the application to a source-code editor.

3. Search for the section of the file that contains the text "steps".

4. The section of the application that specifies steps should look like the following:

"steps":[

{

"name": "GETgoogle",

"file": "GetREST",

"prefix_url": "http://google.com",

"output_to": ["next_step"]

},

{

"name": "next_step",

"file": "someOtherStep"

}

]

5. Edit the "steps" section as needed and save your changes. Be sure to your file as a .JSON file with the same name as the application your downloaded.
6. To upload the application to the PowerFlow system, see the section on Uploading an Application.

Specifying Values for name and file

For each step, you must specify its name and the file it executes. These two keys can have the same value.

• name. The name for the step. Other steps in the application can use this name to refer to the step. This value can include spaces. This name must be unique to the application.
• file. The name of the file that will be executed by the step. You could write step logic in a single file but use that step logic with different applications and use different names for the step in each application.

Specifying the Parameters

When you add a step to an application, you must view the step and determine if it includes any required parameters.

To view details about a step (in our example, the step file is named "GetREST"):

1. Using an API tool like Postman or cURL, use the API GET /steps/{step_name}:

   GET <URL_for_PowerFlow>/api/v1/steps/GetREST

2. The step "GETgoogle" (and its parent file, "GetREST") includes the following parameter, which is defined as "required":

   self.new_step_parameter(name=PREFIX_URL, description="used with relative_url to create the full URL.",sample_value="http://10.2.11.253", default_value=None, required=True)

3. As a result, when the application includes the step "GETgoogle", the application must supply values for the required parameters:

   "prefix_url": "http://google.com",

Transferring Data Between Steps

An essential part of PowerFlow applications is passing data between tasks. PowerFlow includes native support for saving and transferring Python objects between steps. Within a step, you can use one of the functions in the included in the ipaascore.BaseStep class.

In a PowerFlow application, you can use the ouput_to key to specify that the results of a step should be piped to one or more specified steps. The output_to key uses the following syntax:

"output_to": ["step_name1", "step name2"]

To pass data from step to step, you must include the output_to key along with the parameters for a step.

To edit the step parameters in the application:

1. Using an API tool like Postman or cURL, use the API GET /applications/{application_name}:

   GET ><URL_for_PowerFlow/api/v1/applications/<application_name>

   where <application_name> is the application you want to edit.

2. Copy the contents of the application to a source-code editor.

3. If you wanted the step "GETgoogle" to pass its output to the step "next-step", the application would include the following:

   "steps":[

   {

   "name": "GETgoogle.com",

   "file": "GetREST",

   "prefix_url": "http://google.com",

   "method": "GET",

   "output_to": ["next_step"]

   },

   {

   "name": "next_step",

   "file": "someOtherStep"

   }

   ]

   If steps have dependencies , PowerFlow will first analyze all steps in an application and ensure that data-gathering steps are performed before steps that require that data.

4. Edit the "steps" section as needed and save your changes. Be sure to save your file as a .JSON file with the same name as the application you downloaded.
5. To upload the application to PowerFlow, see the section on Uploading an Application.

Defining Retry Options for a Step

The following parameters allows you to define multiple retry options for a step. You can specify that the PowerFlow system try to re-run a step if that step fails. Retries work following the rules of exponential backoff: the first retry will have a delay of 1 second, the second retry will have a delay of 2 seconds, the third retry will delay 4 seconds, the fourth retry will delay 8 seconds, and so on.

As a best practice, you should only edit the retry_max parameter and avoid editing any of the other retry parameters. Only advanced users who understand how the retries work and their side effects when they are not set correctly should change the other retry parameters.

You can include the following retry options in the PowerFlow application file, where you define parameters for each step:

• retry_max . The maximum number of times the PowerFlow system will retry to execute the step before it stops retrying and logs a step failure. For example, if retry_max is 3, PowerFlow will retry after 1 second, then 2 seconds, then 4 seconds, and stop if the last retry fails. The default value is 3.

• retry_backoff. Instead of using a defined interval between retries, the PowerFlow system will incrementally increase the interval between retries. Possible values are True or False. The default value is False.

• retry_jitter. Instead of using a defined interval between retries, the PowerFlow system will retry the step execution at random intervals. Possible values are True or False. The default value is False.

• retry_backoff_max. The maximum time interval for the retry_backoff option, in seconds. For example, This means, if you have retry_max set to 15, the delays will be 1, 2, 4, 8, 16, 32, 64, 120, 240, 480, 600, 600, 600, 600, and 600. The default value is 600 seconds.

• retry_countdown. The interval between retries, in seconds. If you enabled retry_backup, the PowerFlow system will incrementally increase this interval. The default value is 180.

  Use caution when editing the retry_countdown option. If you set it to a value smaller than the default of 180 seconds, PowerFlow might experience collisions between task executions, and PowerFlow might stop unexpectedly. If you set this option to a value larger than the default, you might have to wait longer for a task to execute.

To define the retry options for a step in the application file:

1. Using an API tool like Postman or cURL, use the API GET /applications/{application_name}:

   GET <URL_for_PowerFlow>/api/v1/applications/<application_name>

   where <application_name> is the application you want to edit.

2. Copy the contents of the application to a source-code editor.

3. If you wanted to add retry options to the step "GETgoogle", you could include the following:

   "steps":[

   {

   "name": "GETgoogle",

   "file": "GetREST",

   "prefix_url": "http://google.com",

   "retry_max": 5

   "retry_backoff": True

   "retry_backoff_max": 600

   "retry_countdown": 120

   "output_to": ["next_step"]

   },

   {

   "name": "next_step",

   "file": "someOtherStep"

   }

   ]

4. Edit the "steps" section as needed and save your changes. Be sure to save your file as a .JSON file with the same name as the application you downloaded.

Defining Variables for an Application

Application variables are defined in the PowerFlow application. These variables can be accessed only by steps in the application. In a step, including the appvar. prefix in a variable tells the PowerFlow system to look in the application to resolve the variable. In a step, application variables are used in step parameters.

To define an application variable:

1. Using an API tool like Postman or cURL, use the API GET /applications/{application_name}:

GET <URL_for_PowerFlow>/api/v1/applications/<application_name>

where <application_name> is the application you want to edit.

2. Copy the contents of the application to a source-code editor.
3. Search for the section of the file that contains the text "app_variables".
4. In the integration_template file, the section looks like this:

"app_variables": [

{

"name": "exampleVariable", "value": "exampleValue","description": "Variables defined here will be available in all steps of an application","required": true,"sample_value": "SampleValue", "default_value": "DefaultValue"

}

],

5. You can copy and paste the example section above for each application variable you want to define.
6. For each application variable, supply values for the following keys:

• name. This key requires a value. This is the name of the variable.
• value. This key requires a value. This is the value that the variable will resolve to at runtime.
• description. A description of this variable. This description appears in the user interface. The default value is null.
• required. Specifies whether the variable is required. Possible values are "True" or "False". The default value is "False". If the variable is required, but a value is not specified and a default value is not specified, the application will fail.
• sample_value. A sample value of the required data type or schema. The default value is null. For example, if the parameter is "port" and the expected value is an integer, a good sample_value would be "443".
• default_value. If no value is specified for this variable (in the value key), use the value of this key. The default value of this key is null.

7. Edit the "app_variables" section as needed and save your changes. Be sure to your file as a .JSON file with the same name as the application your downloaded.
8. To upload the application to PowerFlow system, see the section on Uploading an Application.

Uploading the Application to PowerFlow

When you create a new application or edit an existing application, you must upload the application to PowerFlow. There are two ways to upload an application to PowerFlow:

• at the command line with the iscli tool
• with the API

Uploading an Application with iscli

The PowerFlow system includes a command-line utility called iscli. When you install PowerFlow system, iscli is automatically installed.

To upload an application to the PowerFlow system using iscli:

• Either go to the console of the PowerFlow system or use SSH to access the server.
• Log in as isadmin with the appropriate password.

• Enter the following at the command line:

  iscli -u -a -f <path_and_name_of_application_file>.py -H <hostname_or_IP_address_of_powerflow> -P <port_number_of_http_on_powerflow> -U <user_name> -p password

  where:

  • <path_and_name_of_application_file> is the full pathname for the application.
  • <hostname_or_IP_address_of_powerflow> is the hostname or IP address of PowerFlow.
  • <port_number_of_http_on_powerflow> is the port number to access PowerFlow. The default value is 443.
  • <user_name> is the user name you use to log in to PowerFlow.
  • password is the password you use to log in to PowerFlow.

Uploading an Application with the API

To specify that an application always uses a custom queue, edit the .JSON file for the application::

1. Using an API tool like Postman or cURL, use the API POST/applications/{application_name}/run:

   POST https://<URL_for_PowerFlow>/api/v1/applications/<application_name>/run

   where <application_name> is the application you want to edit.

2. Copy the contents of the application to a source-code editor.

3. Search for the section of the file that contains the lines "author", "configuration", "description", "friendly_name", and "name".

4. In that section of the file, added the bolded line:

   "queue": "<name_of_queue>",

   where <name_of_queue> is one of the custom queues you defined in the docker-compose.yml file.

5. For example:

   "author": "ScienceLogic, Inc.",

   "configuration": "",

   "description": "Read SL1 and ServiceNow devices and write them to a cache.",

   "friendly_name": "Cache SL1 Devices using GraphQL",

   "name": "cache_em7_device_data",

   "generate_report": true,

   "queue": "test_queue",

6. Save your changes. Save the file to the same name:<application_name>.json. The application will now always use the specified queue.
7. To upload your changes to the PowerFlow system, see Uploading an application.

Running the Application

After uploading an application to PowerFlow, you can run it to ensure that it works as designed.

To run an application from the API:

1. Using an API tool like Postman or cURL, use the API POST/applications/{application_name}/run:

POST https://<URL_for_your_PowerFlow_system>/api/v1/applications/<application_name>/run

where <application_name> is the application you want to edit.

2. The body of the post should contain:

{

"name": "name_of_application",

"params": {}

}

3. You can include the following parameters with the POST request:

• parameters use the following syntax:

"parameter name":"parameter value"

• wait. Number of seconds to wait for application to complete.
• configuration. The configuration object to use with the application. For details, see configuration objects.

4. The API returns one of the following:

• 200. Application started successfully.
• 400. Name or data parameter is missing.
• 404. Application not found.
• 500. Internal error. Database connection might be lost.

Running the Application with a Custom Queue

If your PowerFlow system runs multiple applications, you might want to ensure that one of those applications runs before other applications in the processing queues. To do this, you can align a queue with a worker process; the worker process will be dedicated to only that queue, will listen only to that queue, and process only jobs from that queue. You can then configure the high-priority application to use the queue that you aligned with its own worker process.

There are two steps to using a custom queue:

• Defining the queue and aligning it with a worker
• Configuring the application to use the custom queue

Defining a Custom Queue

To create a custom queue:

1. SSH to the PowerFlow system.
2. Use a text editor like vi to edit the file /opt/iservices/scripts/docker-compose.yml.
3. The docker-compose.yml file contains definitions for worker processes. For example, you might see something like this:

services:

steprunner:

image: sciencelogic/pf-worker:latest

environment:

logdir:

/var/log/iservices

broker_url: 'pyamqp://guest@rabbit//'

result_backend:

'redis://redis:6379/0'

db_host: 'couchbase,localhost'

secrets:

- is_pass

- encryption_key deploy:

replicas: 2 networks:

- isnet volumes:

- "/var/log/iservices:/var/log/iservices"

- /var/log/iservices:/var/log/contentapi:rw

- read_only: true

source: syncpacks_virtualenvs

target: /var/syncpacks_virtualenvs

type: volume

steprunner_1:

image: sciencelogic/pf-worker:latest

environment:

LOGLEVEL: 10

celery_log_level: 10

logdir:

/var/log/iservices

broker_url: 'pyamqp://guest@rabbit//'

result_backend:

'redis://redis:6379/0'

db_host: 'couchbase,localhost'

user_queues: 'test_queue'

secrets:

- is_pass

- encryption_key deploy:

replicas: 2

networks:

- isnet

volumes:

- "/var/log/iservices:/var/log/iservices"

- /var/log/iservices:/var/log/contentapi:rw

- read_only: true

source: syncpacks_virtualenvs

target: /var/syncpacks_virtualenvs

type: volume

steprunner_2:

image: sciencelogic/pf-worker:latest

environment:

LOGLEVEL: 10

celery_log_level: 10

logdir:

/var/log/iservices

broker_url: 'pyamqp://guest@rabbit//'

result_backend:

'redis://redis:6379/0'

db_host: 'couchbase,localhost'

user_queues: 'critical_queue'

secrets:

- is_pass

- encryption_key deploy:

replicas: 2

networks:

- isnet

volumes:

- "/var/log/iservices:/var/log/iservices"

- /var/log/iservices:/var/log/contentapi:rw

- read_only: true

source: syncpacks_virtualenvs

target: /var/syncpacks_virtualenvs

type: volume

4. The services with names that start with "steprunner" are the workers for the PowerFlow system.

• Notice that the service named "steprunner" does not include any queues. This means that the worker "steprunner" listens to the default queues in the PowerFlow system.

  ScienceLogic recommends that you allot at least one worker to handle the default queues.

• To add additional services to your PowerFlow system. copy all the lines included in the service definition, paste it into the file, and rename the service.
• For example, you could copy all the lines from "steprunner_2", paste the text in the "services" section, and rename the service "steprunner_3".

5. To create one or more queues and dedicate a worker to them, enter the following line in definition of the worker, under the environment section:

   user_queues: '<queue_name1>,<queue_name2>'

where <queue_name1>,<queue_name2> are the names of the new queues. The worker will monitor only these queues and execute tasks only from these queues.

6. After you have updated the docker-compose file, you can update and re-deploy PowerFlow to pick up the changes to the docker-compose file. To do this, SSH to PowerFlow and execute the following command:

   docker stack deploy -c /opt/iservices/scripts/docker-compose.yml iservices

Configuring an Application to Use a Custom Queue

There are two ways to specify that a PowerFlow application should use a custom queue:

• In the .JSON file for the application, you can specify that the application should always use a custom queue.
• At run time, you can specify that the application should use a custom queue only for that single execution of the application.

Configuring an Application to Always Use a Custom Queue

To specify that an application always uses a custom queue, edit the .JSON file for the application:

1. Using an API tool like Postman or cURL, use the API POST/applications/{application_name}/run:

   POST https://<URL_for_PowerFlow>/api/v1/applications/<application_name>/run

   where <application_name> is the application you want to edit.

2. Copy the contents of the application to a source-code editor.

3. Search for the section of the file that contains the lines "author", "configuration", "description", "friendly_name", and "name".

4. In that section of the file, add the bolded line:

   "queue": "<name_of_queue>",

   where <name_of_queue> is one of the custom queues you defined in the docker-compose.yml file.

   For example:

   "author": "ScienceLogic, Inc.",

   "configuration": "",

   "description": "Read SL1 and ServiceNow devices and write them to a cache.",

   "friendly_name": "Cache SL1 Devices using GraphQL",

   "name": "cache_em7_device_data",

   "generate_report": true,

   "queue": "test_queue",

5. Save your changes. Save the file to the same name:<application_name>.json. The application will now always use the specified queue.
6. To upload your changes to the PowerFlow system, see Uploading an application.

Configuring an Application to Use a Custom Queue at Run Time

After uploading an application, you can run it and specify a queue.

To run an application from the PowerFlow API:

1. Using an API tool like Postman or cURL, use the API POST/applications/{application_name}/run:

POST https://<URL_for_PowerFlow>/api/v1/applications/<application_name>/run

where <application_name> is the application you want to edit.

2. The body of the post should contain:

{

"name": "name_of_application",

"params": {

"queue": "custom_queue"

}

}

3. You can include the following parameter with the POST request:

   "queue": "<name_of_queue>"

   where <name_of_queue> is one of the custom queues you defined in the docker-compose.yml file.

4. The API returns one of the following:

• 200. Application started successfully.
• 400. Name or data parameter is missing.
• 404. Application not found.
• 500. Internal error. Database connection might be lost.

Defining a Configuration Object

Configuration variables are defined in a stand-alone JSON file called a configuration that lives on PowerFlow and can be accessed by all applications and their steps.

In a step, including the config. prefix with a variable tells PowerFlow to look in a configuration file to resolve the variable.

If you want to re-use the same settings (like hostname and credentials) between applications, define configuration variables.

To define a configuration file:

1. Use a source-code editor to open a new file.
2. Copy and paste the following example text into the new file:

{

"author": "ScienceLogic, Inc.",

"description": "Fsun's config for demo.",

"name": "fsun-demo-settings",

"friendly_name": "Demo Settings",

"configuration_data": [

{

"encrypted": false,

"name": "em7_host",

"value": "10.2.11.42"

},

{

"encrypted": false,

"name": "em7_user",

"value": "em7admin"

},

{

"encrypted": true,

"name": "em7_password",

"value": "+dqGJe1NwTyvdaO2EizTWjJ2uj2C1wzBzgNqVhpdTHA="

},

],

}

3. To create your own configuration file, edit the following keys:

• author. Name of the author of the configuration file. This field is optional.
• description. Description of the configuration file. This field is optional.
• name. Name of the configuration file. The name cannot contain any spaces and should be unique in your PowerFlow system.
• friendly_name. User-friendly name for the configuration.

4. The section under "configuration_data" defines each configuration variable. You can use these variables as examples.
5. To create your own configuration variables, note the syntax:

• The variable definition is surrounded by curly braces
• Each key:value pair in the definition is separated with a comma.

6. To create your own configuration variable, define the following keys:

• encrypted. Specifies whether the value will appear in plain text or encrypted in this .json file. If set to "true", specifies that when the value is uploaded, the PowerFlow system will encrypt value of the variable. The plain text value will never again be retrievable by an end user. The encryption key is unique to each PowerFlow system.
• name. Name of the configuration file (without the .json suffix). This value appears in the user interface.
• value. The value to assign to the variable.

7. Repeat steps 5-6 for each configuration variable.
8. Save the new file as <config_file>.json.
   

where <config_file> is the name of the configuration file. This value must match the name key in the file. The file name must be unique within your PowerFlow system and cannot contain spaces.

Uploading the Configuration Object to PowerFlow

When you create a new configuration file or edit an existing configuration object, you must upload the step to the PowerFlow system. There are two ways to upload a configuration object file to the PowerFlow system:

• at the command line with the iscli tool
• with the API

Uploading a Configuration with iscli

The PowerFlow system includes a command line tool called iscli. When you install PowerFlow system, iscli is automatically installed.

To upload a configuration file to the PowerFlow system using iscli:

• Either go to the console of the PowerFlow system or use SSH to access the server.
• Log in as isadmin with the appropriate password.

3. Type the following at the command line:

iscli -u -c -f <path_and_name_of_configuration_file>.py -H <hostname_or_IP_address_of_PowerFlow> -P <port_number_of_http_on_PowerFlow> -U <user_name> -p <password>

where:

• <path_and_name_of_configuration_file> is the full pathname for the step.
• <hostname_or_IP_address_of_PowerFlow> is the hostname or IP address of the PowerFlow system.
• <port_number_of_http_on_PowerFlow> is the port number to access the PowerFlow system. The default value is 443.
• <user_name> is the user name you use to log in to the PowerFlow system.
• <password> is the password you use to log in to the PowerFlow system.

Uploading a Configuration Object Using the API

PowerFlow includes an API. When you install the PowerFlow system, the API is available.

To upload a configuration with the API:

POST /configurations

{

<contents of the .json file for the configuration>

}

The API returns one of the following:

• 200. Configuration successfully updated or added.
• 400. Name or data parameter is missing.
• 500. Internal error. Database connection might be lost.

View Logs for an Application

After running an application, you can view its log information. To view the log information for an application:

1. In PowerFlow, run an application.
2. Using an API tool like Postman or cURL, use the API GET /applications/{appName}/logs:

GET <URL_for_PowerFlow/api/v1/applications/<application_name>/logs

3. You should see something like this:

{

"app_name": "example_integration",

"app_vars": {},

"href": "/api/v1/tasks/isapp-af7d3824-c147-4d44-b72a-72d9eae2ce9f",

"id": "isapp-af7d3824-c147-4d44-b72a-72d9eae2ce9f",

"start_time": 1527429570,

"state": "SUCCESS",

"steps": [

{

"href": "/api/v1/tasks/2df5e7d5-c680-4d9d-860c-e1ceccd1b189",

"id": "2df5e7d5-c680-4d9d-860c-e1ceccd1b189",

"name": "First EM7 Query",

"state": "SUCCESS",

"traceback": null

},

{

"href": "/api/v1/tasks/49e1212b-b512-4fa7-b099-ea6b27acf128",

"49e1212b-b512-4fa7-b099-ea6b27acf128",

"name": "second EM7 Query",

"state": "SUCCESS",

"traceback": null

}

],

"triggered_by": [

{

"application_id": "isapp-af7d3824-c147-4d44-b72a-72d9eae2ce9f",

"triggered_by": "USER"

}

]

}

4. Notice the bolded lines that start with href and id. You can use these lines to view the logs for the application.
5. To use the href value to get details about an application, use an API tool like Postman or cURL and use the API GET /applications/{appName}:

GET <URL_for_PowerFlow>/<href_value>

where <href_value> is the href value you can copy from the log file. The href value is another version of the application name.

To view logs for subsequent runs of the application, you can include the href specified in the last_run field.

6. To use the task id value to views details about an application, use an API tool like Postman or cURL and use the API GET /tasks/{task_ID}:

GET <URL_for_PowerFlow>/<task_id>

where <task_id> is the ID value you can copy from the log file for the application. The task ID specifies the latest execution of the application.