Skip to content
  • There are no suggestions because the search field is empty.

App Builder Tutorials

Learn how to build and manage simple apps on the Vince platform

00:00: This article explains how to create a supplier portal using the Vince Live app

00:04: builder. You will learn to build workflows and configure necessary resources from

00:08: scratch.

00:10: In this tutorial, we will be creating a supplier portal using the app builder. We

00:15: will create the supplier portal from scratch.

00:19: We will create workflow tables that need to be used in the app builder.

00:23: We will first start by creating the first workflow needed for the supplier portal.

00:33: Click the Workflows menu to access the workflow management area within Vince Live.

00:38: This is where you will create and manage workflows for your supplier portal.

00:43: To do that, we click on workflows, create new workflow.

00:47: First step is to get all the suppliers.

00:53: Enter the name for the workflow to identify it,

00:55: such as the list of all suppliers.

00:57: This helps organize your workflows clearly.

01:00: We will be adding a

01:01: table. Give it a

01:02: tag. Click Next.

01:11: In this tutorial, we'll be using the Dev environment.

01:13: I choose this environment,

01:15: go next.

01:17: Then I choose the M3 API step, then click on create.

01:23: Now we are inside the Workflow Manager.

01:26: We then click the M3 API step and add the first API call.

01:30: So we will be targeting CRS 620.

01:40: MO program.

01:40: Then we will be calling the list by number. Then click select.

01:59: Now for the supply number, I will be using a constant.

02:02: Then I save the step.

02:14: Now the next step, I am going to add a table.

02:17: I select the previous transaction and choose all the columns I need in my table by

02:22: selecting all columns and dragging them to the right.

02:43: I now will use the supply number as the primary key. I go to table info,

02:47: I give it a name.

02:49: Then I choose Upsert and I click Apply.

03:13: And I click on the Save down below.

03:16: We now have the first workflow ready.

03:24: Let's try that by executing it.

03:26: Execute.

03:28: And close.

03:44: Now we can see the new table that is created, which has 100 records.

03:48: And now we have the first resource that we need for us to build a supplier portal.

04:00: We now have the list of suppliers, but if you still notice, we only have 100 rows,

04:04: and we should be able to configure that.

04:15: Click the Edit button to begin modifying

04:17: the supplier list configuration in Vince Live workflows.

04:22: Going to the M3 step, clicking on Configure Execution, selecting the option

04:27: Unlimited, and saving it.

04:34: By doing this we don't have limit on the rows now

04:36: we try to execute it.

04:41: Close.

04:42: Then we go back to the tables.

04:51: Now we see the additional rows.

04:53: We will now create the next workflow required for our supplier portal.

04:58: Now, to create this workflow, I will use another approach.

05:06: Click the Administration menu to access system settings and management options.

05:12: Which you can use the workflow management under the administration.

05:16: Choose the M3 Workflow Builder.

05:22: M3

05:22: Workflow Builder can typically create your workflows for you in some simple steps.

05:29: First we are going to select the environment.

05:32: I will continue to choose the development or the dev environment.

05:38: Click the search field to find the program

05:40: you want to use in the workflow builder.

05:43: I will try to find the program PPS 200 MI.

05:51: Click the search field to select the transaction for the workflow.

05:55: Then try to get this transaction search head.

06:05: Input and output fields, and I just go ahead and click this create, which will create

06:10: the workflow for me.

06:17: I will now give the search query.

06:22: Enter your supplier

06:22: number to specify the search criteria.

06:27: Then click run workflow.

06:29: We now have the workflow that is executed, and we see the result.

06:41: We will now create the next workflow that we need for our supply portal.

06:47: So I will now create a new workflow.

06:51: We will use the same approach to create the new workflow.

06:57: We will choose the same environment.

06:59: Now we will try to find program PPS 200 MI.

07:10: And then now we select the transaction list line.

07:12: So now we go ahead and create this workflow.

07:24: I'm going to verify this workflow.

07:28: By giving a valid purchase order number from my previous run workflow.

07:40: Now I try to run it and I get

07:43: Now that we have the list of line items, we will create another workflow to confirm

07:47: all.

07:53: We will now use the same M3 Workflow Builder,

07:55: use the same environment.

07:58: This time I will be targeting PPS001MI, then try to find, confirm all, and create this workflow.

08:05: this workflow.

08:21: Click the Create button to initiate the workflow creation process within the M3

08:26: Workflow Builder.

08:28: Now I can try to verify it by giving it the same purchase number, then trying to

08:32: execute the workflow.

08:33: Now I see that I'm able to update the purchase order.

08:46: And now we continue to build the last workflow that we need for the supplier portal.

08:54: We will use the same dev environment and now try to select the

08:57: PPS001MI program.

09:08: And now I choose the transaction confirm line.

09:14: So now I have the workflow that is ready. I'm going to create it. And that has

09:18: created a workflow.

09:28: We have now created all the workflows needed to create a supply portal.

09:34: In the next part, we will see how to use these workflows and tables that we built in

09:38: the Vince platform, to create a supplier portal.

00:00: This article explains how to build the Supplier Portal app using the App Builder.

00:04: You will learn to create the app,

00:06: add resources, test functionality, and publish the initial version.

00:11: In the last session, we created workflows and tables needed for the Supplier Portal

00:15: app.

00:16: Now, in this tutorial, we will build the Supplier Portal app using the App Builder

00:21: by using the resources.

00:36: Enter your application name to identify the new Supplier Portal app within the App

00:41: Builder environment.

00:42: Choose the connection, provide a description, and optionally select a label. For the

00:47: initial version,

00:48: create the app with just a table to serve as the landing page listing all suppliers.

01:24: Click the Create button to finalize the initial configuration and generate the

01:28: Supplier Portal app structure.

01:32: The app builder is now in build mode with one resource: the table containing all

01:36: supplier details.

01:38: Begin by writing your first prompt to guide app creation.

01:48: Use the Alias name to compose and send the first prompt that will instruct the app

01:53: builder on the supplier portals functionality.

02:26: The app builder processes, The Prompt and stars, building the supplier portal

02:29: application wait until the process completes before sending a new prompt.

02:42: The application creates a landing page displaying a list of suppliers.

02:46: You can search suppliers by number or name, providing an initial version of the app.

03:22: Save the current version of the app and exit

03:24: build mode to add additional resources necessary for further development of the

03:28: Supplier Portal.

03:35: Exit build mode and enter preview mode to examine the app's look and feel, including

03:40: sorting capabilities on columns.

03:56: To enhance the application, add other resources such as workflows that will

04:00: support the Supplier Portal's functionality.

04:12: After selecting a supplier, retrieve all purchase heads for that supplier.

04:17: Then select a purchase head to view its line items.

04:20: Use these workflows to build this functionality.

04:37: Assign an alias name to the new resources and click Apply to include them in the

04:41: app.

05:01: With the new resources added, continue building the app by entering a new build

05:05: session to expand functionality.

05:28: Begin prompting to add the ability to search for suppliers.

05:31: Once the supplier is selected, retrieve all purchase.

05:35: Heads associated with that supplier.

05:45: Confirm the use of the specified workflow to retrieve purchase heads for the

05:48: selected supplier.

06:02: Enter a prompt describing navigation from the supplier selection to a new page

06:06: showing all purchase heads for that supplier, using the appropriate workflow.

06:10: The app builder interprets the prompt and creates navigation to view all purchase

06:15: heads for the selected supplier.

06:44: Test the updated Supplier Portal app to verify that all functions, including

06:48: supplier search, are working correctly.

06:58: Enter a supplier identifier to search for a specific supplier within the app.

07:03: Navigate to the page displaying all purchase orders associated with the selected

07:07: supplier.

07:20: Utilize the quick filter to refine purchase orders and use navigation options to

07:25: return to previous pages.

07:33: Click the supplier search field to enter a new search query.

07:38: Enter the initial characters of a supplier identifier to begin searching.

07:42: Add functionality to retrieve line items for each purchase order header to enhance

07:46: the app's detail view.

08:02: Enter a prompt instructing the app to get line items for a selected purchase

08:06: order header using the specified workflow.

08:09: Check resource information to confirm alias names, such as the list for line items,

08:13: before making changes.

08:39: Apply changes to the top section of the application to incorporate new features or

08:44: updates.

09:03: Confirm that the recent changes have been applied to the application successfully.

09:44: Verify that purchase orders for the selected supplier are visible and that

09:48: clicking a purchase head displays its line items.

10:00: Note that progress has not been saved yet, and a prompt suggests saving your work.

10:08: The initial version of the app is functional, allowing supplier search, viewing

10:12: purchase orders, and displaying line items for each order.

10:32: Save your work and exit build mode to finalize the initial version of the Supplier

10:36: Portal app.

10:43: Click the Save button to store your current app configuration and changes.

10:49: Click Yes to confirm saving your progress and exiting build mode.

10:53: Preview the application to see how it appears on different screen sizes and devices.

11:28: Click to open the device selection menu for previewing the app on various devices.

11:34: Choose MacBook to preview how the app looks on a laptop screen.

11:38: Select Full HD resolution to view the app in high-definition on the chosen device.

11:44: Choose iPad Mini to preview the app on a tablet-sized screen.

11:49: Click to open options for changing the screen orientation in the preview mode.

11:54: Flip the screen orientation to check the app's appearance and usability on mobile

11:58: devices in different orientations.

12:03: Click a supplier entry to view detailed information or related data within the app.

12:09: Click a purchase order number to view its details and associated line items.

12:14: Click the purchase order number again to confirm selection or view additional

12:17: details.

12:19: Now you have a fully functional initial draft version of the Supplier Portal app

12:23: ready for publishing.

12:30: Click Publish, name the version (e.g., version 1 Supplier Portal) and save it to

12:36: make the app available to users.

13:00: Access the published app from the app library and run it via menu or by clicking the

13:05: app icon.

13:33: Favorite the app

13:34: so users with permission can easily find it under the dropdown menu.

13:50: Click the button to add the app to your favorites for quick access.

13:54: Run the Supplier Portal app directly from the app library to begin using it.

14:00: In this tutorial, we've learned how to use resources to create the Supplier Portal

14:04: app.

14:05: Next, we will enhance the app to confirm purchase heads.

14:18: We will also add capabilities to confirm line items in future

14:21: updates. Thank you.

14:23: This article guided you through building the Supplier Portal app using the App

14:27: Builder, covering setup, resource addition, functionality testing, and publishing. For

14:33: more information, explore related articles on app enhancement and workflow

14:37: integration.

00:00: This article explains how to enhance the Supply Portal app by adding purchase order

00:04: confirmation features.

00:05: You will learn how to create new app versions, add workflows, and manage app

00:10: stability effectively.

00:12: In the last version, we created the initial version of the Supply Portal app and

00:16: published it.

00:17: We will now continue to add more features to the Supply Portal app

00:21: so that we have the capabilities to confirm a purchase order head or a line item.

00:37: Now to edit a published app, press the kebab menu and choose the edit option.

00:42: This will take you to the published version of the current app.

00:45: If you see that you're not allowed to make changes on the published version, doing

00:49: so will impact the current version published to users. You are allowed to create a

00:53: new version from the published version.

00:55: I will go ahead and create a new version.

01:15: So we will use the same generator app that we had before. We use the same connection

01:20: for the AI assistant.

01:21: We now will give a version 2 of the Supplier Portal app as a description. We will

01:27: use the same resources that we had before, meaning that we will use the same tables

01:31: and same workflows from the previous version.

01:34: We will use the same app that we created from the previous version.

01:38: We will leave the remaining rest as same and then create the app.

01:59: We now have a new version, which is in draft mode.

02:01: Now we are allowed to make changes or build onto the existing application.

02:11: In this session, we are targeting to have confirmed head and confirm line item for a

02:16: supplier.

02:17: So, we will have a confirmed head and a confirm line option.

02:34: To do that

02:34: now, I will go ahead and add a few more resources which allow me to confirm head and

02:39: confirm line item.

02:41: I now need the workflow confirm all and confirm line. I

02:44: will go ahead and try to queue an alias name and click apply.

03:10: I now have the new resources that I need to start building and add the capabilities

03:14: of confirming head and line items.

03:17: I will now go to build mode.

03:27: All right.

03:27: Now let's see if we have retained the same functional application as the published

03:32: one.

03:43: So we will try to understand and test if everything is working as it should from

03:47: the initial version. We are able to search

03:50: the supplier, get the purchase order heads, and also get the purchase line items.

03:54: We have everything that was working from the previous version.

03:57: Now we will add the capabilities to confirm head and confirm line item.

04:01: I will now prompt it to have the confirm all button for the purchase order heads.

04:17: Selecting a purchase order head and updating the purchase order respectively.

04:48: It is also giving you the list of items that it is going to make changes to your

04:51: purchase supplier portal app.

05:14: It has made the necessary changes.

05:16: Let's try to test it.

05:20: Select the supplier from the list to proceed with purchase order confirmation.

05:25: Select the purchase order number to view its details and line items.

05:30: Let me select a purchase order.

05:32: Now I can see that I have a button to confirm all, meaning that all these purchase

05:36: lines are going to get confirmed.

05:38: Let me go ahead and confirm all.

05:50: We now see that the status is confirmed.

05:53: Now I would like to have the line items updated and also get a confirmation for

05:57: confirm all.

06:00: All right,

06:00: now let's see how the changes have been applied.

06:14: Select the supplier from the list to review updated purchase orders.

06:19: Me now choose a different purchase order

06:21: and now I am going to confirm this.

06:28: Now it's asking me for confirmation, and I see that the record is processed and

06:32: updated.

06:32: I also have a confirmation message here.

06:48: The line items confirmed.

06:49: I can also ensure that by looking into my logs for the last executed workflows.

06:54: I now have my confirm all.

07:17: Go ahead and also have a confirm button for the line items.

07:23: We now have the changes that are applied.

07:36: Now we go ahead and test the line item.

07:37: I select one header and see a button line item.

07:40: I select one row. Now I can confirm a line item.

07:59: I also see that it is able to confirm it.

08:01: We now see that we have the capabilities to confirm head and also confirm a line.

08:15: The simple supply portal that we are able to create.

08:17: I will now save my work.

08:25: Click Yes to confirm

08:26: saving your work.

08:29: Now see that we have the saved version.

08:38: Refresh the app view to load the latest changes.

08:42: I can also refresh and test my changes.

08:45: Now I will exit the build mode.

08:50: Click Yes to confirm exiting build mode.

08:54: Now that I have a stable version and I don't want anybody else to start making

08:57: changes on top of my last version, I can choose to archive it.

09:01: So I now have a version that I can archive so that I will not make any more changes

09:06: on top of it. And I'm enforcing to create a new version to make any more changes to

09:11: this app.

09:27: In this part we covered how to create a new version and make changes on top of the

09:31: current version, and also archive the version that you feel is stable.

09:41: This article demonstrated how to create, edit, and manage versions of the Supply

09:46: Portal app, including adding confirmation features for purchase orders and line

09:51: items. For more information,

09:52: see related articles on app versioning and workflow management.

00:00: This article explains how to add and configure in-app roles to manage user

00:04: permissions within your application.

00:05: You will learn how to create roles, assign users, and test role-based functionalities

00:10: to enhance your app's security and usability.

00:14: In the previous versions, we were able to create a supply portal app.

00:21: In this version, we will explore the app Builders capabilities in app roles where

00:25: you can now start having in-app roles for your application.

00:29: To do that,

00:29: I'm going to create a new version from my Arcade version.

00:32: Let's call this the version three.

00:36: Enter the name for the new version to identify it as the one with app roles.

00:41: Click the Create button to generate the new version of your application with the

00:44: specified name.

00:46: I just create everything the same as the previous version.

00:49: I can

00:50: now start adding an in-app rule.

01:04: Click the In-app Roles section to manage user roles within your application.

01:10: I'm going to create a new rule which we say is confirm All. And I will also try to

01:15: add another rule which says confirm line.

01:46: Click to add a new role to your application for managing permissions.

01:51: Enter the name for the new role to identify it clearly within the app.

01:55: Enter a description for the role to specify its purpose, such as users

01:58: who can confirm line items.

02:00: Click the Save button to store the new role and its settings.

02:04: Click the user role designated as the one who can confirm purchase order heads.

02:09: Now, once I'm here, I can add users that I would like to use for my confirm all, and

02:13: I will add users that I would like to use for my confirm line.

02:35: Now remember you can also choose to select roles, being the roles that you create in

02:39: Winz platform.

02:46: All the users inside the rules are going to have the capabilities to confirm line

02:50: items

02:50: in this case. Any user under the system row can now have the capability to confirm

02:55: a line item now.

03:03: I will try to save this

03:04: now. I get into the build mode of the new version.

03:16: Now I'm going to prompt it to ask creating functionalities confirm all and

03:20: confirm.

03:35: Prompt to enable the app builder for implementing in-app roles functionality.

03:40: Enter the condition to show the confirm all button on the purchase order page only

03:44: if the user has the role confirm all.

03:47: I will now ask it to make the changes and try to show the confirm all button

03:51: only if the user has the role confirm all.

04:02: Let's wait until it

04:03: does the changes needed.

04:27: We will now try to test this

04:29: version. Now see that I don't see the confirm all button anymore, but I can try to

04:34: simulate to see if I am a confirm all user.

05:00: Click to open the simulation settings to test user roles and permissions.

05:05: Click the Refresh button to reload the app and apply role changes.

05:10: Refresh this app.

05:11: Try to do the same operation.

05:13: Now I start to see the confirm all button because I am now simulating the role of

05:18: confirm all.

05:29: Let's try the same for the purchase line item.

05:38: Thank you.

05:38: Thank you.

06:11: Now we have the app refreshed. Let's try to find out

06:14: if you are able to hide or show the confirm line based on permissions.

06:17: I am now in the role of confirm all. I am allowed to confirm all.

06:33: Click to access the role settings for further configuration.

06:37: Now I switch to confirm line.

06:40: I will refresh the app to see the changes.

06:42: I now don't see any button to confirm all.

07:02: Click to select the purchase order for which you want to check permissions.

07:07: I can try to see if I have the permissions to confirm line.

07:09: Now I can confirm my line.

07:16: So we can have in-app role permissions for different users using the same app.

07:21: I will now save this and exit build mode.

07:24: I ensure my changes are now applied with the roles permission.

07:33: We now have a complete supplier portal app that has a list of all suppliers with the

07:37: capabilities to search supplier, to retrieve the purchase order head based on the

07:41: supplier, to retrieve line items based on the purchase heads, and also having role

07:47: permissions to do different activities inside the portal.

08:07: Click the search field to look up suppliers by number or name.

08:12: Enter the supplier number or name to filter the supplier list.

08:15: Click to select the supplier from the filtered list.

08:19: Click to select the purchase order head associated with the supplier.

08:23: Click the Confirm All button to approve

08:25: all items in the purchase order.

08:28: Click

08:28: Yes, Confirm All to finalize the approval of all items.

08:33: Click the Close button to exit the confirmation dialog.

08:36: Click to toggle the option on for the selected items.

08:40: Click to open the preview, simulate roles,

08:43: view the bridge log, and refresh the app.

08:47: Click the Refresh button to reload the app and apply any recent changes.

08:51: Click the search field to look up suppliers by number or name.

08:55: Enter the supplier number or name to filter the supplier list.

08:59: Click to select the supplier from the filtered list.

09:02: Click to select the purchase order associated with the supplier.

09:06: Click to select the specific line item within the purchase order.

09:10: Click to open the confirmation dialog for the selected line item.

09:15: Click Yes,

09:15: Confirm Line to approve the selected line item.

09:19: Click the Close button to exit the confirmation dialog.

09:23: Now I confirm my app is working as intended.

09:25: Now I'm going to publish this app, which is version 3 with app roles.

09:29: So now this will be the new version of the app the user is going to use.

09:40: So, summary of this tutorial: we have created the app to have different permissions

09:44: based on users with their roles entitled.

09:53: This article demonstrated how to create and manage in-app roles to control user

09:57: permissions effectively within your application. For more information, see related

10:02: articles on role management and app versioning.

00:00: This article explains how to manage and enhance your supplier portal application

00:04: using the Vincelive app builder. You

00:06: will learn to navigate key features such as version control, role management, and application

00:11: preview to optimize your portal's functionality.

00:15: In previous tutorials, we created workflows needed for our supplier portal.

00:20: We created an app to build the supplier portal.

00:22: We also created different versions of the supply portal and published them.

00:27: Additionally, we implemented in-app role permissions to enable users to access

00:32: features based on their roles.

00:50: In this video, we will now see the other features the app builder has. And we will

00:55: start from the menu.

01:03: Click the menu to access its features within the Vincelive app builder interface.

01:07: Interface

01:08: Notes provide your version information or a description of your

01:12: version. You can review the files generated by the AI to create the app and see the assets

01:17: it has built for you.

01:33: You can also see all your prompt histories, and you can add more roles to it and see

01:37: all the resources that you have used for this application.

02:09: Click here to access the screen preview options

02:12: You have the preview mode where you can see the preview of the application in

02:16: different devices.

02:17: You can also simulate roles to ensure that your application is working as per the

02:22: roles entitlement.

02:38: Click Bridge log to review all the requests and responses the app is processing.

02:43: We have Bridge logs to see all the requests and responses

02:45: the app is trying to do.

02:47: Refresh to update any changes you want to see in the preview.

02:57: You can also change the name of the info, your application.

03:00: You can add more descriptions and also add more tags if you need.

03:07: Back will take you back to the application library.

03:10: You can start editing the app or choose to delete it if you want to remove the app.

03:23: Thank you.

03:24: This article guided you through managing your supplier portal app using Vincelive, covering

03:28: workflows, version control, role management, previews, and application editing. For

03:34: more information, explore related articles on app building and role configuration.

03:39: configuration.