{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"4"},"outline":{"value":"false"},"style":{"value":"default"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"7033eace-a187-4c40-ad1e-ec5228034cff"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"1f406df9-9c01-4bec-bd3e-6a245a5c7647"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"What is an Automation App?","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#what-is-an-app"}}]}]},{"type":"paragraph","content":[{"text":"An automation app in PIPEFORCE is like an app for mobile phones. Such an app groups together resources like scripts, templates, configurations and others to solve a certain business task. Any automation pipeline, form, workflow etc. is part of exactly one app. Such an app is the ","type":"text"},{"text":"logical unit","type":"text","marks":[{"type":"strong"}]},{"text":" of an ","type":"text"},{"text":"automation solution","type":"text","marks":[{"type":"strong"}]},{"text":" having a ","type":"text"},{"text":"unique name","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"An automation app can be shared with others on the marketplace and installed, updated or uninstalled using commands.","type":"text"}]},{"type":"paragraph","content":[{"text":"For each automation app, certain access rules can be specified. Furthermore, it is also possible to use staging and versioning for automation apps. They can be developed online using the workbench or offline using source files and the ","type":"text"},{"text":"CLI","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/guides/cli"}}]},{"text":". You can think of automation apps also like “plug-ins” for PIPEFORCE which can be installed and updated at runtime.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also see ","type":"text"},{"text":"this tutorial","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/tutorials/create-app"}}]},{"text":" to learn how to create an automation app in PIPEFORCE.","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#app-structure"}}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"For simplicity reasons, ","type":"text"},{"text":"automation apps","type":"text","marks":[{"type":"strong"}]},{"text":" will sometimes also be called just ","type":"text"},{"text":"apps","type":"text","marks":[{"type":"strong"}]},{"text":" in PIPEFORCE.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"App home folder","type":"text"}]},{"type":"paragraph","content":[{"text":"Typically, all properties (resources) of an app reside in the property store and having a property path with a prefix like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/","type":"text"}]},{"type":"paragraph","content":[{"text":"The path always starts with prefix ","type":"text"},{"text":"global/app","type":"text","marks":[{"type":"code"}]},{"text":", followed by the name of the app ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", whereas ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" must be a fully qualified, unique name as described below.","type":"text"}]},{"type":"paragraph","content":[{"text":"This path is called the ","type":"text"},{"text":"app home folder","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Qualified app naming","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#qualified-app-naming"}}]}]},{"type":"paragraph","content":[{"text":"In order to avoid a naming clash with other apps from other users which could probably have the same naming as your app, as best practise, you should give the app always a name which follows the reversed domain name package conventions from the ","type":"text"},{"text":"Java package specification","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.oracle.com/javase/tutorial/java/package/namingpkgs.html"}}]},{"text":", which works like this:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The app name is written in ","type":"text"},{"text":"lower case","type":"text","marks":[{"type":"strong"}]},{"text":" and may not contain any space or special character.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use the ","type":"text"},{"text":"reversed internet domain name","type":"text","marks":[{"type":"strong"}]},{"text":" of your company, project or organisation to begin the app name. For example if your domain name is ","type":"text"},{"text":"myproject.org","type":"text","marks":[{"type":"code"}]},{"text":", then you should prefix your app name with ","type":"text"},{"text":"org.myproject","type":"text","marks":[{"type":"code"}]},{"text":" (reversed, in order to start from most generic to more specific parts).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Append your app name after the reversed domain name. For example: ","type":"text"},{"text":"org.myproject.myapp","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Here is an example of a property path to a resource inside an app with fully qualified name:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/com.logabit.myapp/data/helloworld","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Built-in apps from PIPEFORCE always start with prefix ","type":"text"},{"text":"io.pipeforce.","type":"text","marks":[{"type":"code"}]},{"text":" for example: ","type":"text"},{"text":"io.pipeforce.common","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The internet domain names of your app prefixes must be valid ones if you want your apps to become trusted in the marketplace.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"App folders and resources","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#app-folders"}}]}]},{"type":"paragraph","content":[{"text":"Inside of an app path, there is a certain folder structure at top app home folder level which defines the main resource types of an app. Depending on in which folders properties are stored inside an app, auto-backend tasks could be fired. The typical folder structure looks like this (folders could vary, depending on your setup):","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Naming convention","type":"text"}]},{"type":"paragraph","content":[{"text":"Any resource inside an app should follow this naming convention:","type":"text"}]},{"type":"paragraph","content":[{"text":" The property name is always in lower case, sections are separated with dashes and the name can start with an optional prefix, followed by a verb (if applicable): ","type":"text"},{"type":"hardBreak"},{"text":"--section1-section2-sectionN","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is optional and is the only part which may contain upper case letters (for example ","type":"text"},{"text":"A001","type":"text","marks":[{"type":"code"}]},{"text":"). This can be used to define the order of properties or to link them to workflow tasks.","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/pipeline/001-send-invite-email\nglobal/app/tld.domain.myapp/pipeline/A1-upload-invoice\nglobal/app/tld.domain.myapp/pipeline/add-to-sap\nglobal/app/tld.domain.myapp/pipeline/inform-hr","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/config","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This optional folder contains all app specific configuration properties. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/app","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The default configuration property for an app is the ","type":"text"},{"text":"app","type":"text","marks":[{"type":"code"}]},{"text":" property. This is automatically created if you create an app via CLI or the online property wizard. It is a JSON document of this basic format:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"title\": \"My App\",\n \"description\": \"The description of the app\",\n \"icon\": \"some_icon_id\",\n \"color\": \"teal-8\",\n \"hidden\": false,\n \"tags\": [\n \"admin\"\n ],\n \"permissions\": {\n \"read\": [\n \"CAN_APP_io.pipeforce.myapp\",\n \"ROLE_ADMIN\",\n \"ROLE_DEVELOPER\"\n ],\n \"write\": [\n \"CAN_APP_io.pipeforce.myapp\",\n \"ROLE_ADMIN\",\n \"ROLE_DEVELOPER\"\n ],\n \"view\": [\n \"CAN_APP_io.pipeforce.myapp\",\n \"ROLE_ADMIN\",\n \"ROLE_DEVELOPER\"\n ]\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"\"title\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The short title of the app. Can optionally be a ","type":"text"},{"text":"$uri:i18n","type":"text","marks":[{"type":"link","attrs":{"href":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2549088261"}}]},{"text":" key for translations.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"\"description\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The description of the app. Can optionally be a ","type":"text"},{"text":"$uri:i18n","type":"text","marks":[{"type":"link","attrs":{"href":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2549088261"}}]},{"text":" key for translations. Can be empty.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"\"icon\"","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"The id of the Google Material icon to be used for this app. See here for listing of all available icons: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://fonts.google.com/icons"}},{"text":" . Note: Make sure to use the ","type":"text"},{"text":"id","type":"text","marks":[{"type":"strong"}]},{"text":" of the icon not its name. If no icon is set, the system default icon will be used.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"\"color\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The color to be used for the app icon. If not set, the default color will be used. Also see here: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2547089475"}},{"text":" for more details about supported color codes.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"\"hidden\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"An optional flag. If ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", the app wont be shown in the apps listing in the portal. The default value is ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"\"tags\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"A list of optional search keywords. This improves finding this app via UI search.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"\"permissions\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Defines the required permissions for this app.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"read","type":"text","marks":[{"type":"code"}]},{"text":" = A list of ROLES, the logged-in user must be member of (at least in one of it) to be able to read values in this app (for example list properties / data stored in this app).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"write","type":"text","marks":[{"type":"code"}]},{"text":" = A list of ROLES, the logged-in user must be member of (at least in one of it) to be able to write values in this app (for example properties / data to the property store, submit forms).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"view","type":"text","marks":[{"type":"code"}]},{"text":" = A list of ROLES, the logged-in user must be member of (at least in one of it) to be able to see the app tiles, forms and lists in the web UI.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/data","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"In case there are data objects (JSON documents), typically based on a schema, they should be stored inside this path structure:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/data//","type":"text"}]},{"type":"paragraph","content":[{"text":"Whereas ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is the name of the data object.","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is the unique id of a single data object.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/data/person/fa471958-fdb7-4bf6-a0a3-c5e8c782893e","type":"text"}]},{"type":"paragraph","content":[{"text":"Each instance property will contain as value the data of the object instance which typically matches the schema, for example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"firstName\": \"Homer\",\n \"lastName\": \"Simpson\",\n \"age\": 48,\n \"gender\": \"male\"\n}","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note: In case of an update of an app, the data folder wont be deleted by default. See the options of the ","type":"text"},{"text":"app.update","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"app.install","type":"text","marks":[{"type":"code"}]},{"text":" commands for more details.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/form","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#form"}}]}]},{"type":"paragraph","content":[{"text":"This optional folder contains all form configurations for any form of the app, whereas the name of the property is the name of the form. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/form/create-user\nglobal/app/tld.domain.myapp/form/delete-user","type":"text"}]},{"type":"paragraph","content":[{"text":"See here for more details: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2545451358"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/function","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This optional folder contains all Python FaaS functions which will be automatically deployed when such a property of this app is stored in the property store in this folder.","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information see: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2548367361"}},{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Any time the hub service restarts (for example because of rescaling), all function scripts inside this folder will be automatically scanned and re-deployed to the FaaS backend if required.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/i18n","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This optional folder contains all internationalization (i18n) files like message files and other resources. ","type":"text"},{"type":"hardBreak"},{"text":"Also see: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2549088261"}},{"text":". ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/install","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"blue","style":"bold","text":"SInce Version 9.0","localId":"b9839c4a-f9d7-42be-8983-466dc07d18e9"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"This optional folder can also contain pipeline YAML scripts. These pipelines will be executed only in case the app will be installed using the ","type":"text"},{"text":"app.install","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"app.update","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is handy in case you would like to do some preparation on the install or update phase of an app like migrations for example.","type":"text"}]},{"type":"paragraph","content":[{"text":"The pipelines will be executed in their natural naming order. So if you would like to make sure a pipeline gets executed the very first, make sure it is at the very top of the naming order by using prefixes like ","type":"text"},{"text":"001-","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"002-","type":"text","marks":[{"type":"code"}]},{"text":" and so on.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The pipelines in this folder ","type":"text"},{"text":"wont","type":"text","marks":[{"type":"strong"}]},{"text":" be auto-executed on save of properties in the portal or on publish using the CLI or on hub restart. Only the initial ","type":"text"},{"text":"app.install","type":"text","marks":[{"type":"code"}]},{"text":" will execute them.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/list","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#list"}}]}]},{"type":"paragraph","content":[{"text":"This optional folder contains all list configuration properties for any list of the app, whereas the name of the property is the name of the list. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/list/all-users\nglobal/app/tld.domain.myapp/list/all-employees","type":"text"}]},{"type":"paragraph","content":[{"text":"See here for more details: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2548433217"}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/object","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#object"}}]},{"text":" (deprecated)","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"DEPRECATED since ","type":"text","marks":[{"type":"em"}]},{"type":"status","attrs":{"color":"blue","style":"bold","text":"VERSION 9.0","localId":"cd9181ab-53e1-4a74-b9b9-8b71f4224401"}},{"text":". Use","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"/data","type":"text","marks":[{"type":"code"}]},{"text":" folder instead. ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"paragraph","content":[{"text":"This optional folder contains any application model (schema) and its instances (if there are any).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/schema","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#schema"}}]},{"text":" (deprecated)","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Folder ","type":"text","marks":[{"type":"em"}]},{"text":"/object/schema","type":"text","marks":[{"type":"code"}]},{"text":" is DEPRECATED since ","type":"text","marks":[{"type":"em"}]},{"type":"status","attrs":{"color":"blue","style":"bold","text":"VERSION 9.0","localId":"1509f6a1-6493-47c6-8494-ec958952d0dd"}},{"text":". Use","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"/schema","type":"text","marks":[{"type":"code"}]},{"text":" folder in app root instead. ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"paragraph","content":[{"text":"The schema of an object is stored in a property having this path:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/object///schema","type":"text"}]},{"type":"paragraph","content":[{"text":"Whereas ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is the name of the object.","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is the version of the object schema.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"object/person/v1/schema","type":"text"}]},{"type":"paragraph","content":[{"text":"The schema property typically contains as value a JSON schema, which describes this object. For the person object, the schema could, for example, look like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"type\": \"object\",\n\n \"properties\": {\n \"firstName\": {\n \"type\": \"string\"\n },\n \"lastName\": {\n \"type\": \"string\"\n },\n \"age\": {\n \"type\": \"number\"\n },\n \"gender\": {\n \"type\": \"string\",\n \"enum\": [\"male\", \"female\", \"neutral\"]\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"See the JSON schema section for more details: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2545090620"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"/instance","type":"text","marks":[{"type":"code"}]},{"text":" (deprecated)","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"DEPRECATED since ","type":"text","marks":[{"type":"em"}]},{"type":"status","attrs":{"color":"blue","style":"bold","text":"VERSION 9.0","localId":"ba3d1b8b-081e-48f7-812a-a970ba1df861"}},{"text":". Use","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"/data","type":"text","marks":[{"type":"code"}]},{"text":" folder instead. ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"paragraph","content":[{"text":"In case there are object instances (JSON documents) based on a schema, they should be typically stored inside this path structure:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/object///instance/","type":"text"}]},{"type":"paragraph","content":[{"text":"Whereas ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is the name of the object.","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is the version of the object schema.","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is the unique id of a single object.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/object/person/v1/instance/fa471958-fdb7-4bf6-a0a3-c5e8c782893e","type":"text"}]},{"type":"paragraph","content":[{"text":"Each instance property will contain as value the data of the object instance which matches the object schema, for example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"firstName\": \"Homer\",\n \"lastName\": \"Simpson\",\n \"age\": 48,\n \"gender\": \"male\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/pipeline","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#pipeline"}}]}]},{"type":"paragraph","content":[{"text":"This optional folder contains all persisted pipeline YAML scripts for the given app. A pipeline can be seen as the business logic or data integration part of an application.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each property name corresponds with the name of the pipeline and contains as value the pipeline YAML script. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/pipeline/001-send-invite-email\nglobal/app/tld.domain.myapp/pipeline/add-to-sap\nglobal/app/tld.domain.myapp/pipeline/inform-hr","type":"text"}]},{"type":"paragraph","content":[{"text":"Such a pipeline YAML script could look like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - mail.send:\n to: hr@company.de\n subject: \"A new employee was addded!\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Also see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2542796840"}},{"text":" for more details how to create persisted pipelines.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Any time the hub service restarts (for example because of rescaling), all pipeline scripts inside this folder (recursively) will be automatically scanned and any trigger command inside each pipeline will be re-registered (for example jobs, message listeners, …).","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/report","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This optional folder can contain all report configurations.","type":"text"}]},{"type":"paragraph","content":[{"text":"See here for more details: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2548367603"}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/resource","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This optional folder can contain any resource required inside the app. For example images, CSS files or similar.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/schema","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The schema of an data object is stored in a property having this path:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/schema/","type":"text"}]},{"type":"paragraph","content":[{"text":"Whereas ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is the name of the data object this schema stands for.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/schema/person","type":"text"}]},{"type":"paragraph","content":[{"text":"The schema property typically contains as value a JSON schema, which describes this object. For the person object, the schema could, for example, look like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"type\": \"object\",\n\n \"properties\": {\n \"firstName\": {\n \"type\": \"string\"\n },\n \"lastName\": {\n \"type\": \"string\"\n },\n \"age\": {\n \"type\": \"number\"\n },\n \"gender\": {\n \"type\": \"string\",\n \"enum\": [\"male\", \"female\", \"neutral\"]\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"See the JSON schema section for more details: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2545090620"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/setup","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#setup"}}]},{"text":" (deprecated)","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"DEPRECATED since ","type":"text","marks":[{"type":"em"}]},{"type":"status","attrs":{"color":"blue","style":"bold","text":"VERSION 9.0","localId":"2a5bd5db-971a-4327-8c09-9b6d602c8208"}},{"text":". Use","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"/install","type":"text","marks":[{"type":"code"}]},{"text":" folder instead. ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"paragraph","content":[{"text":"This optional folder can also contain pipeline YAML scripts. These pipelines will be executed only in case the app will be installed using the ","type":"text"},{"text":"app.install","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is handy in case you would like to do some preparation on setup phase of an app.","type":"text"}]},{"type":"paragraph","content":[{"text":"The pipelines will be executed in their natural naming order. So if you would like to make sure a pipeline gets executed the very first, make sure it is at the very top of the naming order by using prefixes like ","type":"text"},{"text":"001-","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"002-","type":"text","marks":[{"type":"code"}]},{"text":" and so on.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The pipelines in this folder ","type":"text"},{"text":"wont","type":"text","marks":[{"type":"strong"}]},{"text":" be auto-executed on save of properties in the portal or on publish using the CLI or on hub restart. Only the inital ","type":"text"},{"text":"app.install","type":"text","marks":[{"type":"code"}]},{"text":" will execute them.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/script","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#script"}}]},{"text":" (deprecated)","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"DEPRECATED since ","type":"text","marks":[{"type":"em"}]},{"type":"status","attrs":{"color":"blue","style":"bold","text":"VERSION 9.0","localId":"085cecbf-91af-48d3-bd72-8860c7d3cec0"}},{"text":". Use","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"/function","type":"text","marks":[{"type":"code"}]},{"text":" folder instead. ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/system","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This folder contains all system related backend data of this specific app. For example tmp data, workflow or form data. It is not meant for manual handling and you should not be required to touch or change content in it. It is fully managed by the platform.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note: By default this folder wont be deleted on ","type":"text"},{"text":"app.install","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"app.update","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/template","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This optional folder should contains all templates like FreeMarker templates an others.","type":"text"}]},{"type":"paragraph","content":[{"text":"See here for more details: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2545647697"}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/test","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#test"}}]}]},{"type":"paragraph","content":[{"text":"This optional folder typically contains pipelines for tests only. Whenever necessary, PIPEFORCE automatically executes the test pipelines inside this folder to make sure the app is working as expected. Therefore you have to make sure that these tests can be executed at any time and are fully reentrant (once a test has been finished it can be executed again as often as necessary).","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/test/create-user","type":"text"}]},{"type":"paragraph","content":[{"text":"The property contains the test pipeline as value. Such a test pipeline could look like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - assert:\n true: ${someTestExpression}","type":"text"}]},{"type":"paragraph","content":[{"text":"See here for more details: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2545352861"}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/uninstall","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"blue","style":"bold","text":"SInce Version 9.0","localId":"55d01297-50a3-4fe9-9108-27a8b5de0359"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"This optional folder can also contain pipeline YAML scripts. These pipelines will be executed only in case the app will be uninstalled using the ","type":"text"},{"text":"app.uninstall","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is handy in case you would like to do some preparation before uninstall.","type":"text"}]},{"type":"paragraph","content":[{"text":"The pipelines will be executed in their natural naming order. So if you would like to make sure a pipeline gets executed the very first, make sure it is at the very top of the naming order by using prefixes like ","type":"text"},{"text":"001-","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"002-","type":"text","marks":[{"type":"code"}]},{"text":" and so on.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The pipelines in this folder ","type":"text"},{"text":"wont","type":"text","marks":[{"type":"strong"}]},{"text":" be auto-executed on save of properties in the portal or on publish using the CLI or on hub restart. So triggers in these pipelines wont work. Only a call of ","type":"text"},{"text":"app.uninstall","type":"text","marks":[{"type":"code"}]},{"text":" will execute them.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/update","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"blue","style":"bold","text":"SInce Version 10.0.1","localId":"daaf1fda-0da8-4b43-9526-e7c47450e799"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"This folder is optional and contains all migration pipeline YAML scripts in order to migrate from one app version to another. These pipelines will be executed only in case the app will be installed using the ","type":"text"},{"text":"app.update","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]},{"type":"paragraph","content":[{"text":"The pipelines will be executed in their natural naming order. So if you would like to make sure a pipeline gets executed the very first, make sure it is at the very top of the naming order by using prefixes like ","type":"text"},{"text":"001-","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"002-","type":"text","marks":[{"type":"code"}]},{"text":" and so on.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The pipelines in this folder ","type":"text"},{"text":"wont","type":"text","marks":[{"type":"strong"}]},{"text":" be auto-executed on save of properties in the portal or on publish using the CLI or on hub restart. So triggers in these pipelines wont work. Only a call of ","type":"text"},{"text":"app.update","type":"text","marks":[{"type":"code"}]},{"text":" will auto-execute them.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/workflow","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#workflow"}}]}]},{"type":"paragraph","content":[{"text":"This optional folder contains any BPMN workflow files defining a business process.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/tld.domain.myapp/workflow/approve-new-employee","type":"text"}]},{"type":"paragraph","content":[{"text":"See here for more details: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2548400491"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Developing an automation app","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/apps#app-development"}}]}]},{"type":"paragraph","content":[{"text":"In its simple case you can manage all properties of an app in the property store with the ","type":"text"},{"text":"property.*","type":"text","marks":[{"type":"code"}]},{"text":" commands and the CLI using ","type":"text"},{"text":"pi publish","type":"text","marks":[{"type":"code"}]},{"text":" or using the online workbench.","type":"text"}]},{"type":"paragraph","content":[{"text":"But if you want to develop complex apps with forms, pipelines or workflows inside, we recommend you to use a local development & customization workspace. This workspace contains the properties of such an app stored as files inside a local folder. Any file created inside this folder can then easily be uploaded to the property store with a single command line call using the CLI. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi publish","type":"text"}]},{"type":"paragraph","content":[{"text":"This CLI command scans your local folder and uploads only those resources which have been changed since the last upload or have been created since then. See here how to setup the CLI and how to create a local workspace: ","type":"text"},{"text":"Local Low-Code Workspace","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli"}}]}]}],"version":1}

Browser not supported