Initiating a Workflow Anonymously¶

Scenario¶

Use this example when a process should be started by users who are not signed in to Emakin, such as visitors using an embedded request form on a public website.

Prerequisites¶

• permission to create processes and API keys
• anonymous access allowed for the pool or screen
• a destination application or page where the form will be embedded

Steps¶

Create the Process¶

1. Create a process such as Anonymous Task.
2. Open the pool settings.
3. Enable Is Anonymously Accessible? on the start pool.

Create the Tasks and Role¶

1. Create the opening task, for example Service Request.
2. Create the handling task, for example Service Handling.
3. Create a normal role such as Service Handler and assign it to the internal handling task.

Create the Form¶

1. Build the form that the anonymous user will complete.
2. Add the required input controls.

Save and Test in Emakin¶

1. Commit the process changes.
2. Start a test instance from the folder to confirm the runtime flow behaves correctly.

Create the API Key¶

1. Open domain security settings.
2. Create an API key with the minimum required scopes.
3. Keep the key for the embedding URL.

Build the Anonymous Link¶

1. Copy the initiation link for the process.
2. Replace # with ? in the URL.
3. Append the apiKey parameter.

Embed the Form¶

Place the generated URL inside an iframe on the target site or application, for example:

1
2
3
4

<iframe src="https://mydomain.emakin.com/app/?/initiate/55..c8&apiKey=58ea0f3d.....90b984be905a"
        width="100%"
        height="300"
        frameborder="0"></iframe>

Result¶

The workflow can now be initiated anonymously through an embedded Emakin form, while the internal handling tasks still run under normal authenticated process logic.

Example File¶

Process Definition

Related Pages¶

• Embedding Emakin Forms
• Access Scopes
• Forms