{"type":"doc","content":[{"type":"paragraph","content":[{"type":"status","attrs":{"color":"blue","style":"bold","text":"Since Version 6.0","localId":"b0e0b11d-f71a-4eed-9588-b722cef0c8bd"}},{"text":" ","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"7476816b-b1e6-4ed8-ab17-0ecd61d51ca0"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"5d69d883-9760-4457-a408-64caa667522f"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"What is a PIPEFORCE URI?","type":"text"}]},{"type":"paragraph","content":[{"text":"Whenever you need to load data from some internal or external location inside an automation pipeline or a command, a form, list or report, you can use a ","type":"text"},{"text":"URI","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/Uniform_Resource_Identifier"}}]},{"text":" to point to such a location. You do so already by using such URIs in your web browser, for example. Common URI types you might be familiar with, are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://www.google.com","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ftp://smith:12345@ftp.host","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"file:/data/path/contract.docx","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Besides such commonly known URI types, PIPEFORCE also supports custom URI types to simplify access to common resources used internally in PIPEFORCE. Such a custom URI is called a ","type":"text"},{"text":"PIPEFORCE URI","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Custom PIPEFORCE URIs typically start with an additional prefix ","type":"text"},{"text":"$uri:","type":"text","marks":[{"type":"code"}]},{"text":" followed by the concrete uri scheme (type).","type":"text"}]}]},{"type":"paragraph","content":[{"text":"They typically have a format like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri::","type":"text"}]},{"type":"paragraph","content":[{"text":"Whereas:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" must be replaced by the type name of the URI to be used such as ","type":"text"},{"text":"drive","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"property","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"pipeline","type":"text","marks":[{"type":"code"}]},{"text":" or similar for example (see below). It is the implementation type of the URI.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" must be replaced by the path or value which will be passed as input value to the URI implementation. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is optional an can contain parameters in the format ","type":"text"},{"text":"?param1=value1¶m2=value2","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In most locations where a URI is accepted as an argument, for example in commands or utils, you can apply such a PIPEFORCE URI. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Here are some ","type":"text"},{"text":"examples","type":"text","marks":[{"type":"strong"}]},{"text":" of common PIPEFORCE URIs:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c2c6d330-11c7-452a-80d4-4561d6291438"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[403.0]},"content":[{"type":"paragraph","content":[{"text":"URI","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[403.0]},"content":[{"type":"paragraph","content":[{"text":"$uri:drive:/someFolder/myFile.txt","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"paragraph","content":[{"text":"Loads a file from the ","type":"text"},{"text":"drive","type":"text","marks":[{"type":"code"}]},{"text":" data room.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[403.0]},"content":[{"type":"paragraph","content":[{"text":"$uri:property:global/app/myapp/template/text","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"paragraph","content":[{"text":"Loads a property from the property store and returns the ","type":"text"},{"text":"value","type":"text","marks":[{"type":"code"}]},{"text":" of the property plus all metadata such as ","type":"text"},{"text":"uuid","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"created","type":"text","marks":[{"type":"code"}]},{"text":" time for example.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[403.0]},"content":[{"type":"paragraph","content":[{"text":"$uri:pipeline:global/app/myapp/pipeline/hello","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"paragraph","content":[{"text":"Executes the persisted pipeline at given location and returns the final body content as result.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[403.0]},"content":[{"type":"paragraph","content":[{"text":"$uri:pipeline:global/app/myapp/pipeline/hello?firstName=Sam&lastName=Smith","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"paragraph","content":[{"text":"Executes the persisted pipeline at given location, passes the given parameters ","type":"text"},{"text":"firstName","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"lastName","type":"text","marks":[{"type":"code"}]},{"text":" to it and returns the final body content as result. The parameters can be accessed via the ","type":"text"},{"text":"vars","type":"text","marks":[{"type":"code"}]},{"text":" scope inside the pipeline.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[403.0]},"content":[{"type":"paragraph","content":[{"text":"$uri:user:admin","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the information object of the given user with given username.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[403.0]},"content":[{"type":"paragraph","content":[{"text":"$uri:user:uuid=260e8400-e29b-11d4-a716","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Returns the information object of the given user with given uuid.","type":"text"}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Here is an example to apply a custom URI on a command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - mails.send:\n to: recipient@mail.tld\n subject: \"Hello!\"\n message: \"Hello World!\"\n attachments: $uri:property:global/app/myapp/resources/file","type":"text"}]},{"type":"paragraph","content":[{"text":"As you can see in this example, the attachments argument contains a PIPEFORCE URI pointing to a property in the property store. This property will be loaded and added as an attachment.","type":"text"}]},{"type":"paragraph","content":[{"text":"And in this example, a PIPEFORCE URI is used inside a PEL util instead:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pipeline:\n - body.set:\n value: ${@resolve.uri('$uri:drive:/someFolder/document.json')}","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Resolving a PIPEFORCE URI","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/api/uris#resolving-an-uri"}}]}]},{"type":"paragraph","content":[{"text":"You have multiple options to resolve a PIPEFORCE URI: Resolving an URI means, loading the content this URI is pointing to.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"By command","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/api/uris#by-command"}}]}]},{"type":"paragraph","content":[{"text":"In case you use a PIPEFORCE URI as parameter to a supporting command, this URI will automatically resolved to its content data by this command, as you could see by the previous example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - mails.send:\n to: recipient@mail.tld\n subject: \"Hello!\"\n message\": Hello World!\"\n attachments: $uri:property:global/app/myapp/resources/file","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"By ","type":"text"},{"text":"resolve","type":"text","marks":[{"type":"code"}]},{"text":" command","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/api/uris#by-resolve-command"}}]}]},{"type":"paragraph","content":[{"text":"In order to explicitly resolve a PIPEFORCE URI, there is a special command ","type":"text"},{"text":"resolve","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/api/commands#resolve-v1"}}]},{"text":" for this, which can resolve any URI and returns the content of it.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can use it in a pipeline like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pipeline:\n - resolve:\n uri: $uri:property:gloabl/app/myapp/config/app","type":"text"}]},{"type":"paragraph","content":[{"text":"This example will return you the full property (metadata + value) of the given property path. For example like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"checksum\": \"sha-256=38334e50687bc68125e3b66121311a0bd1b848b8fa36c85dfe189d84313c5582\",\n \"path\": \"/pipeforce/ns/global/app/myapp/config/app\",\n \"uuid\": \"cc059f6e-fa6a-4ad8-bc51-04a85e33b965\",\n \"locked\": false,\n \"trashed\": false,\n \"value\": \"{ \\\"title\\\": \\\"My App\\\", ...}\",\n \"defaultValue\": null,\n \"type\": \"application/json\",\n \"created\": 1669907722095,\n \"updated\": 1671171893712,\n \"timeToLive\": null\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"And if you would like return only the ","type":"text"},{"text":"title","type":"text","marks":[{"type":"code"}]},{"text":" text of the JSON property value, you can use the ","type":"text"},{"text":"#","type":"text","marks":[{"type":"code"}]},{"text":" symbol which let you query the content of the returned JSON value by applying a PEL on it. For example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - resolve:\n uri: $uri:property:gloabl/app/myapp/config/app#title","type":"text"}]},{"type":"paragraph","content":[{"text":"This would return:","type":"text"}]},{"type":"codeBlock","content":[{"text":"My App","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"In case you use the ","type":"text"},{"text":"#","type":"text","marks":[{"type":"code"}]},{"text":" symbol as request parameter, you need to decode it before sending. Otherwise the server would strip it off. Alternatively, you can send the URI in a POST request, ","type":"text"},{"text":"form-data","type":"text","marks":[{"type":"code"}]},{"text":" encoded in the body. In this case, no encoding is required.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Here is an example how to use this command with ","type":"text"},{"text":"curl","type":"text","marks":[{"type":"code"}]},{"text":" on the terminal with URI encoded parameter (the symbol ","type":"text"},{"text":"#","type":"text","marks":[{"type":"code"}]},{"text":" is encoded to ","type":"text"},{"text":"%23","type":"text","marks":[{"type":"code"}]},{"text":"):","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -X GET -u username:password 'https://hub-ns.pipeforce.net/api/v3/command/resolve?uri=$uri:property:gloabl/app/myapp/config/app%23title'","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"By the ","type":"text"},{"text":"@resolve.uri","type":"text","marks":[{"type":"code"}]},{"text":" util","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/api/uris#by-the-resolve-functions"}}]}]},{"type":"paragraph","content":[{"text":"Another possibility inside a pipeline is to use the ","type":"text"},{"text":"@resolve.uri","type":"text","marks":[{"type":"code"}]},{"text":" function:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pipeline:\n - body.set:\n value: \"Content is: ${@resolve.uri('$uri:property:gloabl/app/myapp/config/app')}\"","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"PIPEFORCE URI Types","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"$uri:command","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Using this URI you can call a single command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:command:{command.name}","type":"text"}]},{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"{command.name}","type":"text","marks":[{"type":"code"}]},{"text":" by the real name of the command you would like to call.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also add parameters like this wheras the URI query parameters become the parameters to the command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:command:{command.name}?param1=value1¶m2=value2","type":"text"}]},{"type":"paragraph","content":[{"text":"See here for the documentation of commands and their parameters: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://pipeforce.github.io/api.html"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"$uri:drive","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/api/uris#drive-uri"}}]}]},{"type":"paragraph","content":[{"text":"This custom URI points to a file on the data room service ","type":"text"},{"text":"drive","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:drive:","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - mail.send:\n attachments: $uri:drive:/contracts/contract1.pdf","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"$uri:pipeline","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/api/uris#pipeline-uri"}}]}]},{"type":"paragraph","content":[{"text":"This URI can be used to execute a persisted pipeline, and return the final body output of this pipeline as a result.","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:pipeline:","type":"text"}]},{"type":"paragraph","content":[{"text":"Let's assume you have a pipeline like this stored at ","type":"text"},{"text":"global/app/myapp/pipeline/hello","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"vars:\n name: null\npipeline:\n - body.set: \"HELLO: + ${vars.name}\"","type":"text"}]},{"type":"paragraph","content":[{"text":"To execute this pipeline and to output this hello world example, you could execute a URI like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - resolve: $uri:pipeline:global/app/myapp/pipeline/hello?name=Sam","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example the URI parameter ","type":"text"},{"text":"name","type":"text","marks":[{"type":"code"}]},{"text":" is used inside the pipeline as variable ","type":"text"},{"text":"name","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"This will create a log-entry like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Output: HELLO: Sam","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Adhoc Pipeline URI","type":"text"}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"red","style":"bold","text":"DEPRECATED SINCE 10","localId":"50aab038-9fa0-4214-8728-ed6294c8819f"}},{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Note that this approach is deprecated since version 10 as pipelines are no longer allowed to be called adhoc by default for security reasons.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"You can use the ","type":"text"},{"text":"$uri:pipeline","type":"text","marks":[{"type":"code"}]},{"text":" scheme also in order to execute an adhoc pipeline. This is a combination of commands to be executed in serial, one after another from left to right. The format is like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:pipeline:?commandA=\"param1:value1;param2:value2\"&commandB","type":"text"}]},{"type":"paragraph","content":[{"text":"This approach is handy in case you would like to call one or more commands in serial without persisting a pipeline for this.","type":"text"}]},{"type":"paragraph","content":[{"text":"The path part of the URI is empty and only the query string is given, starting with ","type":"text"},{"text":"?","type":"text","marks":[{"type":"code"}]},{"text":" whereas the name of a query param is the name of the command. The optional query param value contains the parameters to the command whereas name and value is separated by a colon ","type":"text"},{"text":":","type":"text","marks":[{"type":"code"}]},{"text":" and multiple params are separated by by a semicolon ","type":"text"},{"text":";","type":"text","marks":[{"type":"code"}]},{"text":" . For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:pipeline:?uri.get=\"uri:http://host/path;body=abc\"&data.filter.jmespath=\"query:[?id=12]\"","type":"text"}]},{"type":"paragraph","content":[{"text":"In case a command parameter is a ","type":"text"},{"text":"default command parameter","type":"text","marks":[{"type":"link","attrs":{"href":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2542796840/Command+and+Pipeline#Default-Command-Parameter-(short-form)"}}]},{"text":", it can be used without any parameter name prefix in the URI. So the example from above can be simplified to this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:pipeline:?uri.get=\"http://host/path\"&data.filter.jmespath=\"[?id=12]\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Since ","type":"text"},{"text":"uri","type":"text","marks":[{"type":"code"}]},{"text":" of command ","type":"text"},{"text":"uri.get","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"query","type":"text","marks":[{"type":"code"}]},{"text":" of command ","type":"text"},{"text":"data.filter.jmespath","type":"text","marks":[{"type":"code"}]},{"text":" are default parameters, these parameter names can be skipped. But this must be then the only parameter given to the command. If you need more than one parameter per command, the pipeline must be written including the parameter names.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"$uri:property","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/api/uris#property-uri"}}]},{"text":" and ","type":"text"},{"text":"$uri:property-value","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This custom URI points to a property in the property store.","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:property:","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pipeline:\n - body.set:\n value: \"${@resolve.uri('$uri:property:global/app/myapp/config')}\"","type":"text"}]},{"type":"paragraph","content":[{"text":"or","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - resolve: $uri:property:global/app/myapp/config","type":"text"}]},{"type":"paragraph","content":[{"text":"Will return the property including metadata and value like this example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"checksum\": \"sha-256=38334e50687bc68125e3b66121311a0bd1b848b8fa36c85dfe189d84313c5582\",\n \"path\": \"/pipeforce/ns/global/app/myapp/config/app\",\n \"uuid\": \"cc059f6e-fa6a-4ad8-bc51-04a85e33b965\",\n \"locked\": false,\n \"trashed\": false,\n \"value\": \"{ \\\"title\\\": \\\"My App\\\", ...}\",\n \"defaultValue\": null,\n \"type\": \"application/json\",\n \"created\": 1669907722095,\n \"updated\": 1671171893712,\n \"timeToLive\": null\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"In case ","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:property-value:","type":"text"}]},{"type":"paragraph","content":[{"text":"is used instead. The value part of the property is returned instead, without any metadata:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{ \"title\": \"My App\", ...}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"$uri:user","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/api/uris#user-uri"}}]}]},{"type":"paragraph","content":[{"text":"This uri is handy to load a user object given by a username or uuid.","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:user:","type":"text"}]},{"type":"paragraph","content":[{"text":"or","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:user:uuid=","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - body.set:\n value: ${@resolve.uri('$uri:user:maria')}","type":"text"}]},{"type":"paragraph","content":[{"text":"or","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - resolve: $uri:user:maria","type":"text"}]},{"type":"paragraph","content":[{"text":"This will return the user-info data similar to this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"uuid\": \"someUuid\",\n \"username\": \"maria\",\n \"email\": \"some@email.tld\",\n \"firstName\": \"Maria\",\n \"lastName\": \"Meyer\",\n ...\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The same is true when using the uuid of the user:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - body.set:\n value: ${@resolve.uri('$uri:user:uuid=someUuid')}","type":"text"}]},{"type":"paragraph","content":[{"text":"or","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - resolve: $uri:user:uuid=someUuid","type":"text"}]},{"type":"paragraph","content":[{"text":"As an alternative you can also use these approaches if required:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:user:username=","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:user:?username=","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:user:?uuid=","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported