...

• PIPEFORCE Enterprise 7.0 or higher

• You have a valid PIPEFORCE Developer account

• You have executed tutorial Tutorial: Create a new app

Introduction

A pipeline in PIPEFORCE is an easy to learn low code script which can do many different things for you:

...

Because of its simplicity and power at the same time, the pipeline is one of the most important part in PIPEFORCE. In this tutorial, you will learn how to create and execute such a pipeline script. To learn more about pipelines and commands in detail, see this section of the documentation: Pipelines & Commands.

1 - Executing an ad-hoc pipeline

You can have these two main types of pipelines:

...

1. Login to the portal https://NAMESPACE.pipeforce.net

2. Navigate to LOW CODE → Workbench

3. Now you should see the ad-hoc pipeline editor automatically opened for you. It looks similar to this:
   

   

4. Here you can scribble any ad-hoc pipeline and execute it by pushing the RUN button.

5. There is already a hello world demo pipeline prepared for you here.

6. Do not change this pipeline and execute it by pushing the RUN button. After this, you should see an output like this at the bottom:
   

   

7. Congrats, you have executed your first pipeline!

8. Next, lets create a more sophisticated pipeline by sending a simple email. To do so, start typing inside the editor after the dash - and you should see command suggestions like this:
   

   

9. Lets select the command mail.send from the list, finish the line with a colon :, go to next line and indent with two tabs [->|]. To see the list of available parameters for the command press [CTRL] + [SPACE] and you should again see the auto-completion list like this:

   

10. Lets select the parameter to from the list and set your email address here and a subject as shown below:

    

11. In your pipeline you have now two commands: The first one simply logs a message, the second one sends an email. Note that each command

    1. is listed below pipeline:,

    2. is indented with one tab,

    3. starts with a dash - followed by the command name.

    4. is finished with a colon : finally.

    5. can have optional parameters. In this case, you can specify them below the command after an additional indent using a tab.

    6. can exchange data with other commands. If you want to learn more about this, have a look here: Pipelines & Commands: https://logabit.atlassian.net/wiki/spaces/DEVEX/pages/785088596.

12. Now lets execute this pipeline by pressing the RUN button.

13. After a while you should receive the email in your inbox.

14. Since this is an ad-hoc pipeline, in case you leave this view, your pipeline is gone. Therefore, you should persist (store) it if you later need it. At first copy this pipeline into your clipboard, then go on to the next part in this tutorial to learn how to persist it.

2 - Persisting a pipeline

Persisting a pipeline means “storing” a pipeline script at server side in the property store (Property Store https://logabit.atlassian.net/wiki/spaces/DEVEX/pages/988807265 ) under a unique key. From there you can then load and execute it later by this unique key. Follow these steps to create such a persisted pipeline:

1. Select LOW CODE → Workbench.

2. In the property tree select the node of the app you’ve created in the last tutorial.

3. Click the plus icon at the top of the tree.

4. The new property view opens:

   1. As a property key use the value global/app/MY_APP/pipeline/mypipeline. Replace MY_APP with the name of the app you created before, for example myapp24. Do use only lower case letters and don’t use special characters or spaces!

   2. As mime type select application/yaml; type=pipeline. Do not select application/json; type=pipeline!

5. Click SAVE.

6. You should now see again the hello world pipeline in the editor.

7. Replace the content of this editor by pasting your clipboard content here (Ctrl + V).

8. Click again SAVE.

9. Congrats: Now you have your first persisted pipeline. This pipeline has the unique key global/app/MY_APP/pipeline/mypipeline.

3 - Executing a persisted pipeline

After you have persisted a pipeline you can execute it by calling it using its unique property key. There are many different possibilities in PIPEFORCE to do so. In this step, you will learn how to do it using the command pipeline.start:

...

Next tutorial: Tutorial: Release an app