...
| Note |
|---|
Unlike other examples, make sure to assign an ID to the IFrame element that you want to monitor, as this is essential for tracking and dynamically adjusting its size. |
Sending Parameters
When embedding Emakin forms, you may need to submit additional values to the Emakin form data. Emakin supports receiving parameters through query strings, allowing you to set values directly within the process instance.
How to Submit Parameters
To specify a parameter, add it to the embedding URL using the following format:
Query String: Use
?parameterName=valueto pass parameters as part of the URL.
Note: For nested nodes, you can specify the exact path using path segmentation. Structure the parameter name as nodeName/nestedNode/nestedNestedNode to target a specific field within the hierarchy.
Example
Suppose you want to submit a CompanyId parameter, represented as a GUID. This can be done by appending the parameter to the URL:
| Code Block | ||
|---|---|---|
| ||
<iframe src="https://mydomain.emakin.com/app/?/initiate/55..c8&apiKey=58ea0f3d.....90b984be905a&CompanyId=123e4567-e89b-12d3-a456-426614174000" width="100%" height="600px"></iframe>
|
In this example, the CompanyId parameter is assigned a unique identifier (GUID), which will be used in the process instance upon load.
| Info |
|---|
As a best practice, we advise keeping the number of parameters passed through the URL to a minimum. Instead, consider submitting a single identifier (such as an |
Sending the Culture Parameter
When embedding forms, you may sometimes need them to display in a specific culture or locale, which determines the language, date formats, and other region-specific settings. This can be particularly useful in applications serving a global audience or in situations where the user’s culture is known and you want to provide a seamless experience.
...