{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"launch(appAlias, options, onError, onSuccess)","type":"fn","slug":"cloudapp-js-launch","excerpt":"","body":"Applications are launched in the cloud using `rollAppCloud.launch()`.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"rollAppCloud.launch(\\\"localc\\\", {userId: \\\"1a2b3c4d5e6f\\\"});\",\n      \"language\": \"javascript\"\n    }\n  ]\n}\n[/block]\nWith this call application will open in a separate window. User will then be able to interact with the applications and use all of its features.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"To prevent pop-up blocker from interfering with application launch this method has to be called from an event handler for click or key press.\\n\\nMore about pop-up blocker [from Mozilla developers][0].\\n\\n[0]: https://support.mozilla.org/en-US/kb/pop-blocker-settings-exceptions-troubleshooting\",\n  \"title\": \"Avoiding Pop-up Blocker\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Parameters\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Parameter\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"appAlias\",\n    \"1-0\": \"options\\n*optional*\",\n    \"2-0\": \"onError\\n*optional*\",\n    \"3-0\": \"onSuccess\\n*optional*\",\n    \"0-1\": \"Alias of the application to be launched. The alias also identifies specific build, version or configuration of the application.\",\n    \"1-1\": \"Optional set of additional options for launching the application.\",\n    \"2-1\": \"Called when attempt to the application failed for any reason.\",\n    \"3-1\": \"Called after the app was launched successfully.\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\nSupported options are following:\n[block:parameters]\n{\n  \"data\": {\n    \"0-1\": \"User ID is used to load preserved application settings and to route launch request to the instance of the application, which is already running for this user.\",\n    \"h-1\": \"Description\",\n    \"h-0\": \"Option\",\n    \"0-0\": \"userId\\n*optional*\",\n    \"1-1\": \"A string that is appended to configured application launch command as additional command line parameters.\",\n    \"1-0\": \"commandLine\\n*optional*\",\n    \"2-1\": \"Size of the application slot to be used for launching the application.  Supported values are 'xs', 's', 'm', 'l', 'xl'. If the slot size is not specified, the default slot size configured for the application will be used.\",\n    \"2-0\": \"slotSize\\n*optional*\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]","updates":[],"order":3,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ca0d9153101e900512259a8","project":"54523fec04160008005b1cc8","version":{"version":"3.0","version_clean":"3.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ca0d9153101e9005122599a","5ca0d9153101e9005122599b","5ca0d9153101e9005122599c"],"_id":"5ca0d9153101e900512259aa","project":"54523fec04160008005b1cc8","__v":0,"forked_from":"57b557f0d3092517007cfac3","createdAt":"2016-08-18T06:38:40.018Z","releaseDate":"2016-08-18T06:38:40.018Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Cloud App JavaScript API","slug":"cloud-app-javascript-api","order":9999,"from_sync":false,"reference":false,"_id":"5ca0d9153101e9005122599c","project":"54523fec04160008005b1cc8","version":"5ca0d9153101e900512259aa","createdAt":"2017-09-22T09:26:20.780Z","__v":0},"user":"54523f0604160008005b1cc0","createdAt":"2017-09-22T11:09:05.930Z","githubsync":"","__v":0,"parentDoc":null}

launch(appAlias, options, onError, onSuccess)


Applications are launched in the cloud using `rollAppCloud.launch()`. [block:code] { "codes": [ { "code": "rollAppCloud.launch(\"localc\", {userId: \"1a2b3c4d5e6f\"});", "language": "javascript" } ] } [/block] With this call application will open in a separate window. User will then be able to interact with the applications and use all of its features. [block:callout] { "type": "warning", "body": "To prevent pop-up blocker from interfering with application launch this method has to be called from an event handler for click or key press.\n\nMore about pop-up blocker [from Mozilla developers][0].\n\n[0]: https://support.mozilla.org/en-US/kb/pop-blocker-settings-exceptions-troubleshooting", "title": "Avoiding Pop-up Blocker" } [/block] [block:api-header] { "type": "basic", "title": "Parameters" } [/block] [block:parameters] { "data": { "h-0": "Parameter", "h-1": "Description", "0-0": "appAlias", "1-0": "options\n*optional*", "2-0": "onError\n*optional*", "3-0": "onSuccess\n*optional*", "0-1": "Alias of the application to be launched. The alias also identifies specific build, version or configuration of the application.", "1-1": "Optional set of additional options for launching the application.", "2-1": "Called when attempt to the application failed for any reason.", "3-1": "Called after the app was launched successfully." }, "cols": 2, "rows": 4 } [/block] Supported options are following: [block:parameters] { "data": { "0-1": "User ID is used to load preserved application settings and to route launch request to the instance of the application, which is already running for this user.", "h-1": "Description", "h-0": "Option", "0-0": "userId\n*optional*", "1-1": "A string that is appended to configured application launch command as additional command line parameters.", "1-0": "commandLine\n*optional*", "2-1": "Size of the application slot to be used for launching the application. Supported values are 'xs', 's', 'm', 'l', 'xl'. If the slot size is not specified, the default slot size configured for the application will be used.", "2-0": "slotSize\n*optional*" }, "cols": 2, "rows": 3 } [/block]