Embedding Emakin

With embedded forms you can display emakin forms in other applications in HTML iframe. Emakin uses responsive layout to automatically fit in frame size.

Embedded views requires a valid authentication method depending of your choice.

Anonymous Access

Initiating of a new process anonymously

Please follow these steps to enable anonymous access.

Enable Anonymous Access of process to initiate a new process or share screen as a view anonymously.
Generate a API Key with "login" and other required scopes. Please only select the mandatory scopes because of anonymous access may risk your system.
Copy link of initiate process link and replace '#' character with '?' and add generated API Key parameter to end of address.
Updated address link should be similar like to following address
https://ertan.emakin.com/app/?/initiate/55e4e5e3-98b1-4a14-8067-a44fe7414e6b/c2624944-397d-4fb4-a9b0-b206be2ab718/08f42ff8-5697-4e53-a377-f28b5f5f78c8&apiKey=...............

Sharing a screen anonymous access

Enable anonymous access of screen
Generate a API key with "login" and other required scopes. Please only select the mandatory scopes because of anonymous access may risk your system.
Copy address of screen and replace '#' character with '?' and add generated API key parameter to end of address.
Updated address link should be similar like to following address;

Embedded form layout can be accessed from "http(s)://<mydomain>.emakin.com/app/embed" url. Embedded layout does not show any side bar and only shows the main content of the form with optionally actions. Example view of the embedded layout of a form.

Authentication

Embedded forms need valid authentication, so if the user is not logged in before, browser automatically redirects to the login page. Alternatively, you can specify an authentication token to login user automatically and skip login page.

Example embedded page url with authentication token;

	http://ertan.emakin.com/app/embed?/workitem/d4c1adc7-c9d2-4af0-a2b3-b6d61d88df6d&auth=41AA3CE3CAFB..............BF8114

You can generate required authentication token with getToken method in rest service.

Generated authentication tokens are limited to configured based time period and they can get expired. Please always generate new tokens as long as it's needed, and do not store in any place like disk or code.

Embedding Form

You can embed emakin forms in a basic HTML IFrame tag like below;

Example:

<html>
	<body>
        Hello!
		<iframe src="http://ertan.emakin.com/app/embed?/workitem/d4c1adc7-c9d2-4af0-a2b3-b6d61d88df6d" width="100%" height="600" frameborder="0"></iframe>
	</body>
</html>

Default configuration prevents the use emakin in IFrame tag because of security. If you get any error please try to remove "X-XFrame-Options" header from your web configuration file to allow to use emakin in an iframe tag.

Action Toolbar

By default, emakin does not show action toolbar of work items. If you want the action toolbar to be shown, you can specify "actions=1" parameter in query string to show action toolbar.

Example:

<html>
	<body>
        Hello!
		<iframe src="http://ertan.emakin.com/app/embed?/workitem/d4c1adc7-c9d2-4af0-a2b3-b6d61d88df6d&actions=1" width="100%" height="600" frameborder="0"></iframe>
	</body>
</html>

Return Address

You can specify "returnUrl" parameter in the query string, to redirect user the another address after the form is completed. This parameter is only meaningful if an action toolbar is visible.

Example:

<html>
	<body>
        Hello!
		<iframe src="http://ertan.emakin.com/app/embed?/workitem/d4c1adc7-c9d2-4af0-a2b3-b6d61d88df6d&actions=1&returnUrl=http://localhost" width="100%" height="600" frameborder="0"></iframe>
	</body>
</html>