{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"30056e38-56d5-4e69-9112-635966a981d9"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"42c47f9f-ce7f-4503-8daa-1e992ce45608"}},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP Rest Manager enables the user to send requests to a server and save the returned answer in a variable and can work with the values in JS.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following documentation shows how to call the service via different ways (variant 1 and 2). By using the functionality, the request gets forwarded via the server to prevent Cross Site Scripting and e.g. Google Chrome browser from blocking the request data due to the CORS policy. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Requirement: The execution user/server of the application (operating system user, not the currently logged-in user) must be able to reach the desired endpoint.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"All these characters ","type":"text"},{"text":":/?#[]@","type":"text","marks":[{"type":"code"}]},{"text":" are part of the generic syntax for a URI (defined in RFC 3986) and must be replaced with there corresponding URL / percent encoded value. In our example [ and ] got replaced by %5B and %5D. Check out ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.w3schools.com/tags/ref_urlencode.ASP"}},{"text":" if you want to check your URI","type":"text"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Variant 1: REST CALL in JS","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"The REST CALL will be managed completely in the JS File. For changes, you have to update the custom-project.js file in your resource folder.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JavaScript","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"jqxhr = jQ.ajax({ \n\t\t\turl: '/loom-portal/rest/HttpRestManager?<>', \n\t\t\ttype: 'GET', \n\t\t}).success(function(data){ \n\t\t\t//Function to be called if the request succeeds \n\t\t}).fail(function(data){ \n\t\t\t//Error Handling \n\t\t});","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"When calling the HttpRestManager via JavaScript, the type of the REST CALL must be 'GET'. ","type":"text"}]},{"type":"paragraph","content":[{"text":"(The parameter 'method' can also be e.g. 'POST')","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"URL (HTTPRestManager)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"actionscript"},"content":[{"text":"URL: '/loom-portal/rest/HttpRestManager?<>","type":"text"}]},{"type":"paragraph","content":[{"text":"The first parameter starts with a <> all others will be added by an <<&>>.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example URL","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"$.ajax({\n url: '/loom-portal/rest/HttpRestManager?hostName='+URL+\"&method=GET&additionalHeaders=%5B\" + \"NAME_OF_VARIABLE=\" + variable + \";\" + \"NAME_OF_VARIABLE2=\" + variable2 + \"%5D\",\n type: 'GET',\n success: function(data) {\n if (data.status && data.status == \"200\") {\n console.log(data);\n }\n }\n});","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Parameter","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"16341f58-3285-481c-9525-986191226cb4"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"Valid examples","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"hostName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter contains the URl of the requested server.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"https://demo.com/interface/getExampleData","type":"text","marks":[{"type":"link","attrs":{"href":"https://demo.com/interface/getExampleData"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"“POST”","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter determines which method will be remotely invoked. “Post” means that the server expects an input in XML format, which it will process and return. “Get” on the other hand means that the Server will send data without requiring an input.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"Other possibilities are “delete”, “get”, “head”, “options”, “patch”, “post”, “put”.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"postParameter","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter contains the input for the server in JSON-Format.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"\"json\", \"XML\", \"HTML\", \"text\", \"auto\"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"responseVariable","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"\"SYS.HttpRestManager_response\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter contains the process variable into which the server response should be saved.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"demoResponseVariable","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"user","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter is only required if the server requires identification and contains the username of the user.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"demoUser","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"pass","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter is only needed if the server requires an identification and contains the user's password.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"demoPassword","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"authMethod","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"\"basic\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter is only needed if the server requires identification and contains the encryption which should be applied. One possible encryption is base64, which will be applied by setting this parameter to “basic”.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"\"oauth\"","type":"text"}]},{"type":"paragraph","content":[{"text":"\"basic\"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"oAuthTokenUrl","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"Required only if authMethod = \"oauth\"","type":"text"}]},{"type":"paragraph","content":[{"text":"URL from where to retrieve the oauth token from.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"access","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"\"\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"Defines which groups or users are able to call the interface and retrieve data from it. All other calls from not authorized users/groups will be denied. Multiple users/groups can be seperated via ','.","type":"text"},{"type":"hardBreak"},{"text":"Per default, the interface is callable for all users.","type":"text"},{"type":"hardBreak"},{"text":"Leave the parameter empty/undefined for unrestricted access.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"group(exampleGroup), user(exampleUser)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[145.0]},"content":[{"type":"paragraph","content":[{"text":"additionalHeaders","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[293.0]},"content":[{"type":"paragraph","content":[{"text":"adding additonal Headers to the Rest call","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"\"&method=GET&additionalHeaders=%5B\" + \"NAME_OF_VARIABLE=\" + variable + \";\" + \"NAME_OF_VARIABLE2=\" + variable2 + \"%5D\"","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"JavaScript","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"var URL = \"https://demo.com/interface/getExampleData\"; \nvar USER = \"$enc$-605bc19777d129d182d0c467a54b129\"; \nvar PASSWORD = \"$enc$-eda084ca7ea688d6454add9f9e4bd84\"; \n\njqxhr = jQ.ajax({ \n\t\t\turl: '/loom-portal/rest/HttpRestManager?hostName=' + URL + '&method=GET&authMethod=basic&user=' + USER + '&pass=' + PASSWORD + &postParameter=json, \n\t\t\ttype: 'GET', \n\t\t\t}).done(function(data){ \n\t\t\t\t//todo!\n\t\t\t}).success(function(data) { \n\t\t\tvar response = \tdata; \n\t\t\tif (checkIfVariableIsNotNullAndNotUndefinedAndNotEmpty(response)) { \n\t\t\t\tvar parsedResponse = data; \n\t\t\t\tif (typeof parsedResponse === \"string\") { \n\t\t\t\t\tparsedResponse = JSON.parse(data); \n\t\t\t\t} \n\t\t\t\tthisPointer.entity.setValue('variable', JSON.stringify(data.response)); \n\t\t\t\tthisPointer.entity.mergeLocal(true); \n\t\t\t} \n\t\t}).fail(function(data) { //Error Handling });","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Do not save the user & password in the JS files without masking!","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the encoder module to mask the data.","type":"text"}]},{"type":"paragraph","content":[{"text":"Url: <>/encoder/ (If not available, please reach out to the defined contact person)","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":5},"content":[{"text":"Function checkIfVariableIsNotNullAndNotUndefinedAndNotEmpty \\[polyfill\\]","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"/** checkIfVariableIsNotNullAndNotUndefinedAndNotEmpty - returns true, if given variable is not empty and not null and not undefined - else it returns false**/ \n\nfunction checkIfVariableIsNotNullAndNotUndefinedAndNotEmpty(variable) { \n\tif(variable !== null && variable !== undefined && variable !== \"\") { \n\t\treturn true; } \n\treturn false; \n}","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Output Console","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"JSON.parse(thisPointer.entity.getValue('variable')); { name: \"Name\", id: \"id_val\" }","type":"text"}]},{"type":"paragraph"},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Variant 2: REST CALL with tim.properties","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"The difference to variant 1 is that you have to configure the REST CALL in the tim.properties file located in the super resource folder (accessible with a super admin) or server file system (accessible via file access to the server). In this case, you don't have to touch the JS file if you want to change e.g. the password or other configurable parameters. As long as the REST CALL is already implemented at the JS file. The advantage of this variant is that you do not have to store passwords or usernames in the JavaScript file.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"tim.properties","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"third-party-endpoint-getRESTCall={ \n\t\"hostName\":\"https://demo.com/interface/getExampleData\", \n\t\"method\":\"GET\"\n\t\"authMethod\":\"basic\", \n\t\"responseVariable\":\"demoVariable\", \n\t\"user\":\"user\", \n\t\"pass\":\"password\",\n\t\"postParameter\": \"json\" \n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JavaScript","type":"text"}]},{"type":"paragraph","content":[{"text":"This method is only available in the extended framework (custom, no standard):","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"DATA_SOURCE_CATALOGUE['getExampleData'] = { \n\tsrc: Gadget.HOST + 'loom-portal/rest/HttpRestManager/getExampleData', \n\ttype: \"json\", \n\tkey: \"key\", \n\tlabel: \"label\", \n\trequestDataType: \"application/json\", \t\n\trequestType: \"GET\", \n\ti18n: false, \n}; \n\nvar callbackAfterFramework = function (thisPointer) { \n\n\tvar loadDone = $.Deferred(); \n\tgadget.functions.loadAjaxDataForDropdownPromiseBased(thisPointer, $('#<>')[0], $('#<>').attr(\"data-timdatasource\"), loadDone); \n\n\tloadDone.done(function() { \n\t\tvar variable = myTKDropdownDataSet[\"getExampleData\"]; \n\t\t//todo! \n\t}); \n}","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"jQ.ajax({\n\t\turl: \"/loom-portal/rest/HttpRestManager/getRESTCall,\n\t\ttype: \"GET\",\n\t}).done(function (data) {\n\t\tconsole.log('Date from interface is done loading:' + data);\n\t}).success(function (data) {\n\t\t// YOUR CUSTOM CODE HERE\n\t}).fail(function (data) {\n\t\tconsole.log('There has been an error loading the data from the interface:' + data);\n\t}).always(function () {\n\t\tconsole.log('The interface call is completed.);\n\t});","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"When calling the HttpRestManager via JavaScript, the type of the REST CALL must be 'GET'. ","type":"text"}]},{"type":"paragraph","content":[{"text":"(The parameter 'method' can also be e.g. 'POST')","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"URL (HTTPRestManager)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"actionscript"},"content":[{"text":"URL: '/loom-portal/rest/HttpRestManager/<>","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Parameter","type":"text"}]},{"type":"table","attrs":{"layout":"wide","width":960.0,"localId":"4cd5cc4e-52fb-490a-bbc2-289658981414"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[454.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"Valid examples","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"hostName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[454.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter contains the URl of the requested server.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"https://demo.com/interface/getExampleData","type":"text","marks":[{"type":"link","attrs":{"href":"https://demo.com/interface/getExampleData"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"\"POST\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[454.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter determines which method will be remotely invoked. “Post” means that the server expects an input in XML format, which it will process and return. “Get” on the other hand means that the Server will send data without requiring an input.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"Other possibilities are “delete”, “get”, “head”, “options”, “patch”, “post”, “put”.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"postParameter","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[454.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter contains the input for the server in JSON-Format.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"\"json\", \"xml\", \"html\", \"text\", \"auto\"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"responseVariable","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"\"SYS.HttpRestManager_response\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[454.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter contains the process variable into which the server response should be saved.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"demoResponseVariable","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"user","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[454.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter is only required if the server requires identification and contains the user name of the user.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"demoUser","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"pass","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[454.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter is only needed if the server requires an identification and contains the user's password.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"demoPassword","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"authMethod","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"\"basic\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[454.0]},"content":[{"type":"paragraph","content":[{"text":"This parameter is only needed if the server requires identification and contains the encryption which should be applied. One possible encryption is base64, which will be applied by setting this parameter to “basic”.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"\"oauth\"","type":"text"}]},{"type":"paragraph","content":[{"text":"\"basic\"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"oAuthTokenUrl","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[454.0]},"content":[{"type":"paragraph","content":[{"text":"Required only if authMethod = \"oauth\"","type":"text"}]},{"type":"paragraph","content":[{"text":"URL from where to retrieve the oauth token from.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"access","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"\"\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[454.0]},"content":[{"type":"paragraph","content":[{"text":"Defines which groups or users are able to call the interface and retrieve data from it. All other calls from not authorized users/groups will be denied. Multiple users/groups can be seperated via ','.","type":"text"},{"type":"hardBreak"},{"text":"Per default, the interface is callable for all users.","type":"text"},{"type":"hardBreak"},{"text":"Leave the parameter empty/undefined for unrestricted access.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"group(exampleGroup), user(exampleUser)","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"JavaScript","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"jQ.ajax({\n\t\turl: \"/loom-portal/rest/HttpRestManager/getRESTCall,\n\t\ttype: \"GET\",\n\t}).done(function (data) {\n\t\tconsole.log('Date from interface is done loading:' + data);\n\t}).success(function (data) {\n\t\t// YOUR CUSTOM CODE HERE\n\t}).fail(function (data) {\n\t\tconsole.log('There has been an error loading the data from the interface:' + data);\n\t}).always(function () {\n\t\tconsole.log('The interface call is completed.);\n\t});","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Do not save the user & password in the JS files without masking!","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the encoder module to mask the data.","type":"text"}]},{"type":"paragraph","content":[{"text":"Url: <>/encoder/ (If not available, please reach out to the defined contact person)","type":"text"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Customizing: REST CALL with custom variables (via template file) (JS and tim.properties)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"The following example shows how to use custom variables in relation with a REST CALL via JSON template file. In this case, you have to add the parameter \"templatePath\" and \"customVariables\" in the REST CALL URL. In this way, you can customize your call.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JavaScript","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"JavaScript","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"var URL = \"https://demo.com/interface/getExampleData\"; \nvar USER = \"$enc$-605bc19777d129d182d0c467a54b129\"; \nvar PASSWORD = \"$enc$-eda084ca7ea688d6454add9f9e4bd84\";\nvar demoVariable = \"Demo\";\n\njQ.ajax({ \n\turl: '/loom-portal/rest/HttpRestManager' +\n\t\t '?hostName=' + URL + \n\t\t '&method=POST' +\n\t\t '&authMethod=basic' + \n\t\t '&user=' + USER + \n '&pass=' + PASSWORD + \n\t\t '&responseVariable=variableNameToSaveResponseTo' +\n\t\t '&templatePath=httpBodyGetHeadDataByDemoVariables.json' +\n\t\t '&customVariables=%5B' + 'custom_variable_name=' + demoVariable + ',custom_variable_name_two=' + demoVariableTwo + '%5D',\n\ttype: 'GET', \n}).done(function(data){ \n\t//todo!\n}).success(function(data) { \n\t//todo!\n}).fail(function(data) { //Error Handling });","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JSON File - httpBodyGetHeadDataByDemoVariables.json (Parameter: templatePath)","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"JSON","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"search\": [{\n \"field\": \"demoField\",\n \"value\": \"${custom_variable_name}\",\n \"operator\": \"startsWith\"\n }]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The parameter templatePath refers to the root folder of the client resources (accessible via the Administration Client).","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported