This guide discusses how to embed ProcessMaker's actionable forms or web entries into third-party web applications.
Overview
This guide discusses the process of embedding ProcessMaker actionable forms or most commonly known as Web Entry into a web application using an iFrame to initiate new requests of your workflow/process on the ProcessMaker platform.
ProcessMaker Web entries are dynamic and actionable forms that are used to seamlessly integrate into third-party applications. These versatile forms not only merge smoothly with external platforms but also provide a wealth of interactive possibilities, empowering users to engage, input, and interact within their preferred applications effortlessly.
Steps to Embed Actionable Forms
By following the steps below, seamlessly integrate actionable forms into your application.
Step 1: Generate the Web Entry Link or Code Snippet
To seamlessly integrate an actionable form or web entry, begin by generating the web entry link. Follow these steps to get the web entry link or the web entry code snippet. Below are examples of the web entry link or code snippet:
Step 2: Embed the Web Entry Link into Your Web Application
Identify the appropriate location within your Web application to embed the Web entry link. This could be a specific page, a modal window, or any other suitable area. Insert the provided web entry link, including the iFrame, into the desired location in your HTML file.
Let's embed the web entry link into the iFrame, use the following sample HTML code:
HTML
<!DOCTYPEhtml><htmllang="en"><head> <metacharset="UTF-8"> <metaname="viewport"content="width=device-width, initial-scale=1.0"> <title>ERP Website</title> <linkrel="stylesheet"href="https://fonts.googleapis.com/icon?family=Material+Icons"> <style>/* CSS styles for the ERP website */* {box-sizing:border-box; }body {margin:0;padding:0;font-family:Arial, sans-serif;background-color:#f1f1f1; }header {background-color:#ff6347; /* New color for the header */color:#fff;padding:10px;text-align:center; }.container {display:flex;max-width:1200px;margin:0 auto; }.sidebar {background-color:#f9f9f9;width:200px;padding:20px;box-shadow:0 0 10pxrgba(0, 0, 0, 0.1); }.sidebarh3 {margin-top:0;font-size:1.2rem;color:#555; }.sidebarul {list-style-type:none;padding:0;margin:10px 0; }.sidebarli {margin-bottom:5px; }.sidebara {text-decoration:none;color:#333;display:flex;align-items:center; }.sidebar.material-icons {margin-right:5px; }.content {flex-grow:1;padding:20px; }.content-header {display:flex;align-items:center;justify-content:space-between; }h1 {margin:0;color:#ff6347; /* New color for the heading */font-size:2.5rem; }p {font-size:1.1rem;line-height:1.6;color:#444; }.iframe-container {position:relative;width:100%;height:100%; }iframe {width:100%;height:100%;border:none;box-shadow:0 0 10pxrgba(0, 0, 0, 0.1); }.action-button {background-color:#ff6347; /* New color for the button */color:#fff;border:none;padding:10px 20px;border-radius:4px;cursor:pointer; } </style></head><body> <header> <h1>Rocket ERP</h1> </header> <divclass="container"><!-- Sidebar --> <divclass="sidebar"> <h3>Menu</h3> <ul> <li> <ahref="#"><iclass="material-icons">dashboard</i> Dashboard</a> </li> <li> <ahref="#"><iclass="material-icons">inventory</i> Inventory</a> </li> <li> <ahref="#"><iclass="material-icons">shopping_basket</i> Sales</a> </li> <li> <ahref="#"><iclass="material-icons">add_shopping_cart</i> Purchases</a> </li> </ul> </div><!-- Main Content Area --> <divclass="content"> <divclass="content-header"> <h1>Rocket ERP</h1> <buttonclass="action-button">New Purchase Approval</button> </div> <p>You are logged into the ERP system, and here's a snapshot of the dashboard:</p> <divclass="iframe-container"><!-- Replace the iframe content with your actual ERP system's URL or relevant content --> <iframe src="https://veggiedonuts.training.processmaker.net/webentry/8/node_1" frameborder="0" style="height:1000px;"></iframe>
</div> </div> </div></body></html>
Step 3: Customize the iFrame Attributes (Optional)
You can customize the attributes of the iFrame according to your requirements. For example, you can adjust the width, height, frameborder, and other attributes of the iFrame to fit your application's design and layout.
Step 4: Test and Verify the Integration
Save your changes and reload your Web application. Ensure that the embedded actionable form is visible and functioning correctly within your application. Test the functionality of the actionable form, such as submitting a new request to ensure that everything works as expected.
Output Preview: Embedded ProcessMaker Actionable Form
After you have completed the steps above, verify ProcessMaker's Actionable Form or Web entry is embedded to your Web application.
Conclusion
By following the steps outlined in this guide, you can integrate the ProcessMaker's powerful Web entry or actionable form into your Web application using an iFrame to submit new requests.