{"_id":"5949a733a18495002e3ae24e","project":"55d535ca988e130d000b3f5c","version":{"_id":"55d535cb988e130d000b3f5f","__v":12,"project":"55d535ca988e130d000b3f5c","hasDoc":true,"hasReference":false,"createdAt":"2015-08-20T02:04:59.052Z","releaseDate":"2015-08-20T02:04:59.052Z","categories":["55d535cc988e130d000b3f60","55d6b238d2a8eb1900109eef","55d6b4f3250d7d0d004274cd","55d7967960fc730d00fc2852","55da9804e835f20d009fc5d0","55e75b1de06f4b190080dbfd","55e75b39e06f4b190080dbfe","55e75b7ae06f4b190080dbff","564f5a4e33082f0d001bb709","570fb64aa38d470e0060cbff","586d0dd89a854123001acd65","586d0e3b9a854123001acd66"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"55e75b39e06f4b190080dbfe","project":"55d535ca988e130d000b3f5c","__v":10,"pages":["56959043fe18811700c9c09e","569590bfcb14e11700f8a877","569590f7fcb1032d0089e033","5695917dfcb1032d0089e035","5695964a77ba0d2300cf3912","5695967edcaf0d1700cb8752","569618eccb14e11700f8a910","56961d937596a90d0014e571","5696ba13480534370022a37a","56dd002ee5c8570e00a79865"],"version":"55d535cb988e130d000b3f5f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-02T20:25:29.622Z","from_sync":false,"order":3,"slug":"frame-for-business","title":"Frame for Business"},"user":"5910f1a2657bf91b00bf9d41","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-06-20T22:52:35.174Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":22,"body":"Clipboard integration lets users move text/data between their local machine and their application session.  By enabling \"Clipboard integration\" on your \"Session Settings\" page in the \"Settings\" tab, your users get two new features:  text clipboard integration and file upload capability.\n\n \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9a6f881-enable1.png\",\n        \"enable1.png\",\n        1305,\n        398,\n        \"#4478ad\"\n      ],\n      \"caption\": \"You can choose to edit your default session settings or any other custom settings.\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4e4eaf5-enabling2.png\",\n        \"enabling2.png\",\n        724,\n        804,\n        \"#e2e9e9\"\n      ]\n    }\n  ]\n}\n[/block]\nWith Clipboard Integration enabled for your session, you'll see two new icons in the lower right corner of the app window -- an upload icon and a clipboard icon:\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/b14ecf5-clipboardicon.png\",\n        \"clipboardicon.png\",\n        302,\n        79,\n        \"#2c3a4f\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Text Clipboard\"\n}\n[/block]\nThis feature is great for passing text between your local machine and the remote application session. Note that this integration requires an interim step when copying and pasting, simply because a browser alone can't insert data into your local machine's clipboard without your direct acknowledgment (otherwise if you landed on a web page and it could insert data locally - that would be a security risk).  To make the process easy, instructions for how to use the clipboard are essentially built-in.  Here's how it works:\n\n[block:api-header]\n{\n  \"title\": \"Copy/Paste from Local to your Frame session:\"\n}\n[/block]\nStart by copying the text you want from your local machine to the local clipboard (e.g. Command+C on Mac or CTRL+C on a PC). \n\nGo to your Frame session and click on the clipboard icon at the lower right, you'll then see this pop-up:\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4490d4a-clipboard.png\",\n        \"clipboard.png\",\n        769,\n        640,\n        \"#ebf3f3\"\n      ]\n    }\n  ]\n}\n[/block]\nClick in the box on the left side and hit the Command+V keys (Mac) or CTRL+V keys (PC) to paste into your Frame clipboard in the remote application session (you can also right click and select \"Paste\").  As soon as you do this you'll see this confirmation screen:\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/b2429b7-pasted.png\",\n        \"pasted.png\",\n        766,\n        639,\n        \"#3b3b3b\"\n      ]\n    }\n  ]\n}\n[/block]\nNow the text from your local clipboard is in your Frame clipboard. You can now use CTRL+V (or Command+V) to paste it wherever you need it, as usual. \n \n[block:api-header]\n{\n  \"title\": \"Copy/Paste from Frame to Local\"\n}\n[/block]\nStart by copying text in your app session into the Frame clipboard by using CTRL+C.  As soon as you do this, you'll see an automatic tool tip come from the clipboard icon:\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/6ea93d3-popup.png\",\n        \"popup.png\",\n        229,\n        108,\n        \"#303f54\"\n      ]\n    }\n  ]\n}\n[/block]\nThis tool tip guides a first-time user to the clipboard icon, which (when clicked) brings up the same clipboard pop-up as shown below.  The copied text will already be placed in the box on the right side:\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c34afbc-clipboard.png\",\n        \"clipboard.png\",\n        769,\n        640,\n        \"#ebf3f3\"\n      ]\n    }\n  ]\n}\n[/block]\nNow click inside the box and hit Command+C (Mac) or CTRL+C (PC) to copy the text into your local machine's clipboard.  As soon as you do this, you'll see the following confirmation:\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/62c0081-clipboardconfirm.png\",\n        \"clipboardconfirm.png\",\n        766,\n        637,\n        \"#3b3b3c\"\n      ]\n    }\n  ]\n}\n[/block]\nThe text is now in your local clipboard -- available to use in your local machine, wherever it may be needed.\n \n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"When you access your Frame session in Firefox, the \\\"click here to copy your clipboard data\\\" informational popup only appears on the first copy operation when using the Ctrl + C shortcut.  When using right-click and selecting \\\"Copy\\\" from the context menu, it appears every time.\\n\\n If you are accessing your Frame session from Chrome, it appears every time Ctrl + C is used.\",\n  \"title\": \"\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"File Upload\"\n}\n[/block]\nThis feature is a convenient way for users to bring their files into an application if they don't already have it in their cloud storage (e.g. Dropbox).  You can also use this in the Sandbox to upload files directly within the session.  \n\nWhen you click on the file upload icon (arrow with circle around it), the following pop-up explains what to do next: \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7219d9d-upload1.png\",\n        \"upload1.png\",\n        321,\n        310,\n        \"#8c8e8f\"\n      ]\n    }\n  ]\n}\n[/block]\nClicking in the upload square will bring up the local computer's file system (e.g. Finder on a Mac), where you can select a file that will then be uploaded to the \"Uploads\" folder inside your application session. \n\nYou may also upload a file by simply dragging and dropping it from your local machine into your Frame session. When the file is done uploading, you will see a notification:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d28185f-popupupload.png\",\n        \"popupupload.png\",\n        175,\n        102,\n        \"#2e3d53\"\n      ]\n    }\n  ]\n}\n[/block]\nOnce uploaded, you can access the file in your application by using the app's file>open dialogue and navigating to the \"Uploads\" folder.","excerpt":"","slug":"clipboard-integration","type":"basic","title":"Clipboard Integration"}

Clipboard Integration


Clipboard integration lets users move text/data between their local machine and their application session. By enabling "Clipboard integration" on your "Session Settings" page in the "Settings" tab, your users get two new features: text clipboard integration and file upload capability. [block:image] { "images": [ { "image": [ "https://files.readme.io/9a6f881-enable1.png", "enable1.png", 1305, 398, "#4478ad" ], "caption": "You can choose to edit your default session settings or any other custom settings." } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/4e4eaf5-enabling2.png", "enabling2.png", 724, 804, "#e2e9e9" ] } ] } [/block] With Clipboard Integration enabled for your session, you'll see two new icons in the lower right corner of the app window -- an upload icon and a clipboard icon: [block:image] { "images": [ { "image": [ "https://files.readme.io/b14ecf5-clipboardicon.png", "clipboardicon.png", 302, 79, "#2c3a4f" ] } ] } [/block] [block:api-header] { "title": "Text Clipboard" } [/block] This feature is great for passing text between your local machine and the remote application session. Note that this integration requires an interim step when copying and pasting, simply because a browser alone can't insert data into your local machine's clipboard without your direct acknowledgment (otherwise if you landed on a web page and it could insert data locally - that would be a security risk). To make the process easy, instructions for how to use the clipboard are essentially built-in. Here's how it works: [block:api-header] { "title": "Copy/Paste from Local to your Frame session:" } [/block] Start by copying the text you want from your local machine to the local clipboard (e.g. Command+C on Mac or CTRL+C on a PC). Go to your Frame session and click on the clipboard icon at the lower right, you'll then see this pop-up: [block:image] { "images": [ { "image": [ "https://files.readme.io/4490d4a-clipboard.png", "clipboard.png", 769, 640, "#ebf3f3" ] } ] } [/block] Click in the box on the left side and hit the Command+V keys (Mac) or CTRL+V keys (PC) to paste into your Frame clipboard in the remote application session (you can also right click and select "Paste"). As soon as you do this you'll see this confirmation screen: [block:image] { "images": [ { "image": [ "https://files.readme.io/b2429b7-pasted.png", "pasted.png", 766, 639, "#3b3b3b" ] } ] } [/block] Now the text from your local clipboard is in your Frame clipboard. You can now use CTRL+V (or Command+V) to paste it wherever you need it, as usual. [block:api-header] { "title": "Copy/Paste from Frame to Local" } [/block] Start by copying text in your app session into the Frame clipboard by using CTRL+C. As soon as you do this, you'll see an automatic tool tip come from the clipboard icon: [block:image] { "images": [ { "image": [ "https://files.readme.io/6ea93d3-popup.png", "popup.png", 229, 108, "#303f54" ] } ] } [/block] This tool tip guides a first-time user to the clipboard icon, which (when clicked) brings up the same clipboard pop-up as shown below. The copied text will already be placed in the box on the right side: [block:image] { "images": [ { "image": [ "https://files.readme.io/c34afbc-clipboard.png", "clipboard.png", 769, 640, "#ebf3f3" ] } ] } [/block] Now click inside the box and hit Command+C (Mac) or CTRL+C (PC) to copy the text into your local machine's clipboard. As soon as you do this, you'll see the following confirmation: [block:image] { "images": [ { "image": [ "https://files.readme.io/62c0081-clipboardconfirm.png", "clipboardconfirm.png", 766, 637, "#3b3b3c" ] } ] } [/block] The text is now in your local clipboard -- available to use in your local machine, wherever it may be needed. [block:callout] { "type": "info", "body": "When you access your Frame session in Firefox, the \"click here to copy your clipboard data\" informational popup only appears on the first copy operation when using the Ctrl + C shortcut. When using right-click and selecting \"Copy\" from the context menu, it appears every time.\n\n If you are accessing your Frame session from Chrome, it appears every time Ctrl + C is used.", "title": "" } [/block] [block:api-header] { "title": "File Upload" } [/block] This feature is a convenient way for users to bring their files into an application if they don't already have it in their cloud storage (e.g. Dropbox). You can also use this in the Sandbox to upload files directly within the session. When you click on the file upload icon (arrow with circle around it), the following pop-up explains what to do next: [block:image] { "images": [ { "image": [ "https://files.readme.io/7219d9d-upload1.png", "upload1.png", 321, 310, "#8c8e8f" ] } ] } [/block] Clicking in the upload square will bring up the local computer's file system (e.g. Finder on a Mac), where you can select a file that will then be uploaded to the "Uploads" folder inside your application session. You may also upload a file by simply dragging and dropping it from your local machine into your Frame session. When the file is done uploading, you will see a notification: [block:image] { "images": [ { "image": [ "https://files.readme.io/d28185f-popupupload.png", "popupupload.png", 175, 102, "#2e3d53" ] } ] } [/block] Once uploaded, you can access the file in your application by using the app's file>open dialogue and navigating to the "Uploads" folder.