Introduction

In PIPEFORCE an app groups together resources like scripts, templates, configurations and others which solve a certain business task together. Any pipeline, form or workflow for example is part of exactly one app.

For each app certain access rules can be specified. Apps can be installed, uninstalled, exported and imported. Furthermore, it is possible to use staging and versioning for apps. They can be developed online using the workbench or offline using source code files. You can think of apps also like “plug-ins” for PIPEFORCE.

Typically, all apps reside in the property store under the key path global/app/.. for example global/app/myapp.

In this tutorial you will learn how to create and publish an app using the online workbench in a few simple steps.

1 - Create a new app with the online workbench

The easiest way to create a new app is by using the online workbench. To do so, follow these steps:

Login to your portal https://YOUR_NAMESPACE.pipeforce.net.
Navigate to LOW CODE → Workbench.
Select the node app in the tree and click the plus icon at the top.
The new property view opens:
1. As a property key use the value global/app/MY_APP/config/app. Replace MY_APP with the name of the app you would like to create, for example myapp24. Do use only lower case letters and don’t use special characters or spaces!
2. As mime type select application/json.
Click SAVE:
The new property configuration was created and pre-filled with some data.
Here you can make later changes to configure your app.
For now don’t do any changes and leave it as it is.
Navigate to All Apps in order to show the apps overview page.
Here also your app should be listed.
Congrats, you’ve created your first custom app!

If you click your app, currently nothing happens since we did not add any logic to this app for now. This will change in the next tutorials.

2 - Release your app

For security and productivity reasons any app created this way is by design only visible to developers, but not to other users: It is automatically staged in development mode in the beginning.

In order to show this app also to other users (and therefore move to production stage), follow the steps shown below.

Note: You should switch to production mode only in case you really want to make this app visible to other users like the employees for example. This is usually the case when you’re finished with creating and testing your app. At the time the app is in production mode other users can see and execute it!

Login to portal https://YOUR_NAMESPACE.pipeforce.net as admin or developer.
Go to IAM.
Select the single user or the group you want to give access to your app.
Select tab Role Mappings.
In the Available Roles list select the role CAN_APP_YOURAPP (replace YOURAPP by the app name you used in section 1) and click Add selected. Note that the role name is prefix CAN_APP_ plus upper case of your app name by convention: So for example if you named your app myapp then the role for the app is CAN_APP_MYAPP. This role was automatically created for you. A role can also be seen as a permission to view and execute your app.
After this role was added to the user or group, these users can now see and execute your app.

Tip: You can create custom staging groups for example app-testing, app-qa and app-review and then assign your CAN_APP_ role to the according group depending on the stage your app currently is in. With this approach the users of the different groups can see and work with your app depending on the stage of the app. This way you can also easily work with different versions of an app.

Staging
Staging is the process of hiding an application from the production context until it was fully tested and approved for production. After this approval it will be switched to a production context so that it will be visible and usable by the target users. PIPEFORCE has two different concepts of staging:

Staging by permission (soft staging)
An app can be switched to production by changing its permission. The advantage here is that it is very quick and easy to do so. The downside is that other apps in the same namespace are already in production mode and side effects could potentially harm them. Therefore, you have to be careful in development since apps in development and in production stage reside side by side in the same namespace.
Staging by namespace
There are two namespaces: development and production. In the development namespace apps are developed. Also services like databases or other microservices can be in this namespace. Once development and testing is finished, the app will copied to the production namespace. The advantage here is that the two namespaces separate each app with its environment from each other. Chances are very low that development on an app will affect apps in production. The downside is that it is much more effort to put such an app from development to production stage. Staging by namespace requires at least two Enterprise instances or a Corporate license.

Next tutorial: Tutorial: Create a new form

Developer Manual EN

Tutorial: Create a new app

Introduction

1 - Create a new app with the online workbench

2 - Release your app

Related content