{"__v":9,"_id":"575818008abb520e00ea7b6f","category":{"project":"55f0432035803d230000a9c2","version":"575818008abb520e00ea7b61","_id":"57584d29f71f5c19002d17ef","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-06-08T16:51:53.330Z","from_sync":false,"order":6,"slug":"actions-and-automations","title":"Actions and Automations"},"parentDoc":null,"project":"55f0432035803d230000a9c2","user":"55f0431435803d230000a9c1","version":{"__v":11,"_id":"575818008abb520e00ea7b61","project":"55f0432035803d230000a9c2","createdAt":"2016-06-08T13:05:04.736Z","releaseDate":"2016-06-08T13:05:04.736Z","categories":["575818008abb520e00ea7b62","575818008abb520e00ea7b63","575818008abb520e00ea7b64","575818008abb520e00ea7b65","57582f278abb520e00ea7c10","575838ddf71f5c19002d1787","57584357163a4f2b002c75ed","57584d29f71f5c19002d17ef","575850cc163a4f2b002c7621","575850f1f71f5c19002d17fa","575851066a65ec0e004153e7","575a923ad5797e0e007518cf","575eae598be8aa0e00f59ceb","575eb065e7089c0e006d0cdf"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2.0"},"updates":["56de3d00752c84290014253f"],"next":{"pages":[],"description":""},"createdAt":"2015-11-29T15:01:55.569Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":8,"body":"### Input and Output\nActions that work with content, such as Text, feature the ability to get or pass information from and to another action.\n\nLet's make a concrete example to understand how this works, and create a classic action that pastes a snippet of text.\n\nTo do this, add a `Set text` action followed by a `Paste to computer`. The `Set text` action just passes some text to the next action, so we need the `Paste to computer` action to get it pasted wherever you are in that moment. (If you needed to paste to a specific application, you would have used a shortcut with the app specified as target, typically CMD+V on a Mac, CTRL+V on Windows)\n[block:image]\n{\n  \"images\": [\n    {\n      \"caption\": \"Snippet action with Set text and Paste to computer\",\n      \"image\": [\n        \"https://files.readme.io/YMVEE2xTY6zUhRkkG0pm_IMG_0084.PNG.jpeg\",\n        \"IMG_0084.PNG.jpeg\",\n        \"703\",\n        \"497\",\n        \"#8c641c\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nTry it out providing a sample text in the `Set text`action. The same way a specific string is passed to the `Paste to computer` which ultimately, with great surprise, pastes it to the computer, other actions exchange data.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"You can now use the \\\"Paste text\\\" action on the top of the Text category in Quadro, which is a direct action that combines the \\\"Set text\\\" and the \\\"Paste to computer\\\".\\n\\nWith this direct action we also introduced the ability to paste the predefined text in an advanced manner:\\nBy opening the panel of the \\\"Advanced Options\\\" you will find the option \\\"Single characters\\\" enabled by default. This allows you to emulate the insertion of the text directly in the target application, character by character, as if you were manually typing on your keyboard, and therefore to paste in a more secure way portions of text in the search box or generic text on applications or web apps.\\n\\nIn some cases, however, you may prefer to disable this mode. For example, if you have to copy and paste long text strings and do not want to wait in front of the display until the slow insertion of character by character is completed.\",\n  \"title\": \"Direct Action\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"caption\": \"Paste text action\",\n      \"image\": [\n        \"https://files.readme.io/IrQEvTsiQNCVetKJvFlv_IMG_0087.PNG.jpeg\",\n        \"IMG_0087.PNG.jpeg\",\n        \"728\",\n        \"641\",\n        \"#f0eeea\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"caption\": \"Advanced options: Single characters\",\n      \"image\": [\n        \"https://files.readme.io/T1s868xcQpy7CvAI93d2_single.jpg\",\n        \"single.jpg\",\n        \"729\",\n        \"817\",\n        \"#1a1e1e\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"To find out more about the behavior of specific actions check out their description inside Quadro.\"\n}\n[/block]\n### Text input modes\nAlmost any text field has 3 operational modes: *default*, *ask me* and *get from input*.\nThe default is simply when you enter a specific text, which will be used anytime the action runs. \n\nUse the *Ask me* mode to insert the text manually each time, via a cute prompt on your computer we call *Query strip*. \n\n[block:image]\n{\n  \"images\": [\n    {\n      \"caption\": \"Query strip\",\n      \"image\": [\n        \"https://files.readme.io/PKFIDYNaSyinPpjRLysl_Schermata%202016-05-18%20alle%2013.24.56.png\",\n        \"Schermata 2016-05-18 alle 13.24.56.png\",\n        \"670\",\n        \"79\",\n        \"#2895a3\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nUse *Get from input* to use data given by the preceding action.\n\nText modes can be selected by tapping on the text field, at the top left of the keyboard.\n[block:image]\n{\n  \"images\": [\n    {\n      \"caption\": \"Where to select \\\"ASK ME\\\" and \\\"GET FROM INPUT\\\"\",\n      \"image\": [\n        \"https://files.readme.io/II2ERSFzRt6HLRxJLm6A_IMG_0089.PNG.jpeg\",\n        \"IMG_0089.PNG.jpeg\",\n        \"2046\",\n        \"793\",\n        \"#5c2e1f\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"You can also quickly fill any action’s text field with the content of your computer's clipboard, to speed up function editing\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ylRCUVAvRkaqkd2ydeU2_IMG_0086.PNG.jpeg\",\n        \"IMG_0086.PNG.jpeg\",\n        \"2035\",\n        \"847\",\n        \"#db6e8b\",\n        \"\"\n      ],\n      \"caption\": \"Fill any action’s text field with the content of your computer's clipboard\"\n    }\n  ]\n}\n[/block]\n### Variables\n\nIn some cases you may need to work with several chunks of text, and since the actions can pass along a single one, our friends *Variables* come to the rescue.\n\nUse the Store variable to save the text passed from the previous action for later use. To recall the value of the variable, that is the stored text, you have 2 options:\n\n- using the `Recall variable` action, which will pass the text to the next action\n- using the variable name (in the form of $VARIABLE) inside a text, which will be substituted by the name of the variable","excerpt":"Edit, manage and transform text","slug":"text-actions","type":"basic","title":"Text"}

Text

Edit, manage and transform text

### Input and Output Actions that work with content, such as Text, feature the ability to get or pass information from and to another action. Let's make a concrete example to understand how this works, and create a classic action that pastes a snippet of text. To do this, add a `Set text` action followed by a `Paste to computer`. The `Set text` action just passes some text to the next action, so we need the `Paste to computer` action to get it pasted wherever you are in that moment. (If you needed to paste to a specific application, you would have used a shortcut with the app specified as target, typically CMD+V on a Mac, CTRL+V on Windows) [block:image] { "images": [ { "caption": "Snippet action with Set text and Paste to computer", "image": [ "https://files.readme.io/YMVEE2xTY6zUhRkkG0pm_IMG_0084.PNG.jpeg", "IMG_0084.PNG.jpeg", "703", "497", "#8c641c", "" ] } ] } [/block] Try it out providing a sample text in the `Set text`action. The same way a specific string is passed to the `Paste to computer` which ultimately, with great surprise, pastes it to the computer, other actions exchange data. [block:callout] { "type": "success", "body": "You can now use the \"Paste text\" action on the top of the Text category in Quadro, which is a direct action that combines the \"Set text\" and the \"Paste to computer\".\n\nWith this direct action we also introduced the ability to paste the predefined text in an advanced manner:\nBy opening the panel of the \"Advanced Options\" you will find the option \"Single characters\" enabled by default. This allows you to emulate the insertion of the text directly in the target application, character by character, as if you were manually typing on your keyboard, and therefore to paste in a more secure way portions of text in the search box or generic text on applications or web apps.\n\nIn some cases, however, you may prefer to disable this mode. For example, if you have to copy and paste long text strings and do not want to wait in front of the display until the slow insertion of character by character is completed.", "title": "Direct Action" } [/block] [block:image] { "images": [ { "caption": "Paste text action", "image": [ "https://files.readme.io/IrQEvTsiQNCVetKJvFlv_IMG_0087.PNG.jpeg", "IMG_0087.PNG.jpeg", "728", "641", "#f0eeea", "" ] } ] } [/block] [block:image] { "images": [ { "caption": "Advanced options: Single characters", "image": [ "https://files.readme.io/T1s868xcQpy7CvAI93d2_single.jpg", "single.jpg", "729", "817", "#1a1e1e", "" ] } ] } [/block] [block:callout] { "type": "info", "body": "To find out more about the behavior of specific actions check out their description inside Quadro." } [/block] ### Text input modes Almost any text field has 3 operational modes: *default*, *ask me* and *get from input*. The default is simply when you enter a specific text, which will be used anytime the action runs. Use the *Ask me* mode to insert the text manually each time, via a cute prompt on your computer we call *Query strip*. [block:image] { "images": [ { "caption": "Query strip", "image": [ "https://files.readme.io/PKFIDYNaSyinPpjRLysl_Schermata%202016-05-18%20alle%2013.24.56.png", "Schermata 2016-05-18 alle 13.24.56.png", "670", "79", "#2895a3", "" ] } ] } [/block] Use *Get from input* to use data given by the preceding action. Text modes can be selected by tapping on the text field, at the top left of the keyboard. [block:image] { "images": [ { "caption": "Where to select \"ASK ME\" and \"GET FROM INPUT\"", "image": [ "https://files.readme.io/II2ERSFzRt6HLRxJLm6A_IMG_0089.PNG.jpeg", "IMG_0089.PNG.jpeg", "2046", "793", "#5c2e1f", "" ] } ] } [/block] [block:callout] { "type": "info", "body": "You can also quickly fill any action’s text field with the content of your computer's clipboard, to speed up function editing" } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/ylRCUVAvRkaqkd2ydeU2_IMG_0086.PNG.jpeg", "IMG_0086.PNG.jpeg", "2035", "847", "#db6e8b", "" ], "caption": "Fill any action’s text field with the content of your computer's clipboard" } ] } [/block] ### Variables In some cases you may need to work with several chunks of text, and since the actions can pass along a single one, our friends *Variables* come to the rescue. Use the Store variable to save the text passed from the previous action for later use. To recall the value of the variable, that is the stored text, you have 2 options: - using the `Recall variable` action, which will pass the text to the next action - using the variable name (in the form of $VARIABLE) inside a text, which will be substituted by the name of the variable