{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This configuration enables users to create and add custom actions to S-Drive. Please refer to ","type":"text"},{"text":"S-Actions (Custom Actions)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"/wiki/spaces/PS214D/pages/1677001886"}}]},{"text":" for more information on this feature. ","type":"text"}]},{"type":"paragraph","content":[{"text":"To add a new S-Action, click Add S-Action button","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":900,"id":"d8241727-7f3a-46d2-bb1f-a9e12f44931d","collection":"contentId-1677001747","type":"file","height":306}}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":908,"id":"26ce6e1e-3ae7-4a35-96ae-4f50cb0393f3","collection":"contentId-1677001747","type":"file","height":664}}]},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Your custom action name should be action definition without space and special characters (i.e. \"deployToWebsite\"). This will be sent to the Action code blocks as a URL parameter.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Label","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Label will be listed on \"Action Menu\" and Toolbar S-Actions menu button. (i.e. \"Deploy To Website\")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Is Active","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"This Boolean field holds S-Action is currently active or not. If it is set to unchecked, it won't be listed on Actions menu.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Multiple","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"This Boolean flag determines whether the action is for multiple files or not. If it is just for single files, it will not be listed in Toolbar S-Actions menu button.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"URL","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"This field holds URL information of you VF pages, Static Resource Scripts, Lightning Component name or URL to Redirect. For;","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VF Pages","type":"text","marks":[{"type":"strong"}]},{"text":": \"/apex/[YourPrefix_","type":"text"},{"text":"YourVFPageName]\" i.e. \"/apex/cgCustomActionSampleVF\". If your organization does not have any prefix, please write \"c\" prefix on it i.e. \"/apex/c","type":"text","marks":[{"type":"em"}]},{"text":"_CustomActionSampleVF\".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Static Resource Scripts","type":"text","marks":[{"type":"strong"}]},{"text":": \"/resource/[ResourceName]/[ScriptFile]\". i.e. \"/resource/cg_","type":"text"},{"text":"caDeployFrame/caDeployFrame.html\"If your organization does not have any prefix, please write \"c\" prefix on it i.e. \"/resource/c","type":"text","marks":[{"type":"em"}]},{"text":"_caDeployFrame/caDeployFrame.html\".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Lightning Component","type":"text","marks":[{"type":"strong"}]},{"text":": \"[YourOrganizationPrefix]:[YourComponentName]\" i.e. \"cg:MyCustomActionComponent\".If your organization does not have any prefix, please write \"c\" prefix on it i.e. \"c:MyCustomActionComponent\".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"URL to Redirect","type":"text","marks":[{"type":"strong"}]},{"text":": It is simple web URL of your service. i.e. \"","type":"text"},{"text":"https://cgsdrive-dev-ed.lightning.force.com/one/one.app","type":"text","marks":[{"type":"link","attrs":{"href":"https://cgsdrive-dev-ed.lightning.force.com/one/one.app"}}]},{"text":"\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"text":"! For VF Pages, Static Resource Scripts and URL Redirect options, selected file Ids and action name are sent as URL parameters. For example, if you have ","type":"text"},{"text":"deploy","type":"text","marks":[{"type":"em"}]},{"text":" action on VF page, and URL is set to \"","type":"text"},{"text":"/apex/cgdeployPage","type":"text","marks":[{"type":"em"}]},{"text":"\". On action fire, URL will be similar to this example: \"/apex/cg__ deployPage?","type":"text"},{"text":"actionName","type":"text","marks":[{"type":"strong"}]},{"text":"=deplotToWebsite&","type":"text"},{"text":"XXXields","type":"text","marks":[{"type":"strong"}]},{"text":"=a038000000mqyR6AAI,a038000000sx1QDAAY\".","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Display","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"There are four display types bond to script type and behavior of S-Action. You can set an action work on background with nothing to display except for informational toaster message, or you can embed your custom action scripts within Iframe.","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Hidden","type":"text"},{"type":"hardBreak"},{"text":"On this type of S-Actions, your VF Pages or Static Resources can be embedded to S-Drive Component as a hidden Iframe. This type of S-Actions is suit for running on background process without any feedback of users. For example, you want to upload selected files to your personal website by one click. After you write your apex code and VF page, just select files on the list and click your custom action on the toolbar. And it will work on background to complete process, after completed it will inform user by a toaster message.","type":"text"},{"type":"hardBreak"},{"text":"S-ACTION URL:","type":"text","marks":[{"type":"strong"}]},{"text":" When a hidden type action is clicked this URL will be created: ","type":"text"},{"text":"[YOUR_S-ACTION_URL]","type":"text","marks":[{"type":"strong"}]},{"text":" + ?actionName=","type":"text"},{"text":"[S-ActionName]","type":"text","marks":[{"type":"strong"}]},{"text":"&componentId=1&XXXields=","type":"text"},{"text":"[selectedFile1Id, selectedFile2Id]","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"\"/apex/uploadToServer?actionName=uploadToServer&componentId=1&XXXields=0018000001UeY2TAAV,0018000001UeR44EE\"","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Display","type":"text"},{"type":"hardBreak"},{"text":"For this one VF Page is shown on the component main screen within Iframe.","type":"text"},{"type":"hardBreak"},{"text":"After S-Action is done, you can give information to users by postmessage method. You can close Iframe by using Back button","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":900,"id":"94fab7db-29c5-4dfe-9989-d34b99e4061c","collection":"contentId-1677001747","type":"file","height":494}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"S-ACTION URL:","type":"text","marks":[{"type":"strong"}]},{"text":" When a hidden type action is clicked this URL will be created: ","type":"text"},{"text":"[YOUR_S-ACTION_URL]","type":"text","marks":[{"type":"strong"}]},{"text":" + ?fileIds=","type":"text"},{"text":"[selectedFile1Id, selectedFile2Id]","type":"text","marks":[{"type":"strong"}]},{"text":"&actionName=","type":"text"},{"text":"[S-ActionName]","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"\"/apex/uploadToServer?fileIds=0018000001UeY2TAAV,0018000001UeR44EEY&actionName=uploadToServer\"","type":"text"}]},{"type":"paragraph","content":[{"text":"VISUALFORCE PAGE SAMPLE:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"\n\n\n\n\n\n\n\n\n\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"hardBreak"},{"text":"CONTROLLER:","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"public class CustomActionSampleController {\npublic String actionName {get;set;}\npublic List fileIds {get;set;}\npublic String componentId {get;set;}\npublic String actionResult {get;set;}\npublic String actionMessage {get;set;}\npublic CustomActionSampleController(){\nactionName =\nApexPages.currentPage().getParameters().get('actionName');\ncomponentId =\nApexPages.currentPage().getParameters().get('componentId');\nfileIds = new List();\nString fileIdsStr =\nApexPages.currentPage().getParameters().get('fileIds');\nif (!String.isEmpty(fileIdsStr))\nfileIds = fileIdsStr.split(',');\n}\npublic PageReference updateFiles() {\nactionMessage = '';\nif (fileIds.size() >= 1 ) {\nString queryStr = 'SELECT id, cg__File_Name__c,\ncg__Description__c FROM cg__AccountFile__c WHERE id = :fileIds';\nList files =\nDatabase.query(queryStr);\nfor (cg__AccountFile__c file: files)\nfile.cg__Description__c = 'S-Action';\ntry {\nupdate files;\nactionResult = 'Success';\nactionMessage = 'Files are updated\nsuccessfully!';\n}\ncatch (Exception e) {\nactionResult = 'Error';\nactionMessage = e.getMessage();\n}\n}\nreturn null;\n}\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"As you can see, after CustomActionSampleController instantiated, we get parameters from page URL. On VF Page output panel renders if action name is right, and it executes the Action Function named \"updateFilesAF\". After action is completed, \"actionResults\" panel is re-rendered to inform S-Drive component on parent page via parent.postMessage(). S-Drive component catches message and do necessary reaction.","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Redirect","type":"text"},{"type":"hardBreak"},{"text":"In this option, you can redirect users to given URL in a new tab with parameters ","type":"text"},{"text":"XXXields","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"actionName","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"URL","type":"text","marks":[{"type":"strong"}]},{"text":" will be: ","type":"text"},{"text":"[YOUR_S-ACTION_URL]","type":"text","marks":[{"type":"strong"}]},{"text":" + ?fileIds=","type":"text"},{"text":"[selectedFile1Id, selectedFile2Id]","type":"text","marks":[{"type":"strong"}]},{"text":"&actionName=","type":"text"},{"text":"[S-ActionName]","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"i.e. ","type":"text"},{"text":"https://cgsdrive-dev-ed--cg.na6.visual.force.com/apex/TestSActionPage?","type":"text","marks":[{"type":"link","attrs":{"href":"https://cgsdrive-dev-ed--cg.na6.visual.force.com/apex/TestSActionPage?actionName=redirectSample&fileIds=a038000000mqyR6AAI,a038000000sx1QDAAY,a038000000sx1iEAAQ"}}]},{"text":"actionName","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://cgsdrive-dev-ed--cg.na6.visual.force.com/apex/TestSActionPage?actionName=redirectSample&fileIds=a038000000mqyR6AAI,a038000000sx1QDAAY,a038000000sx1iEAAQ"}}]},{"text":"=redirectSample&","type":"text","marks":[{"type":"link","attrs":{"href":"https://cgsdrive-dev-ed--cg.na6.visual.force.com/apex/TestSActionPage?actionName=redirectSample&fileIds=a038000000mqyR6AAI,a038000000sx1QDAAY,a038000000sx1iEAAQ"}}]},{"text":"fileIds","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://cgsdrive-dev-ed--cg.na6.visual.force.com/apex/TestSActionPage?actionName=redirectSample&fileIds=a038000000mqyR6AAI,a038000000sx1QDAAY,a038000000sx1iEAAQ"}}]},{"text":"=a038000000mqyR6AAI,a038000000sx1QDAAY,a038000000sx1iEAAQ","type":"text","marks":[{"type":"link","attrs":{"href":"https://cgsdrive-dev-ed--cg.na6.visual.force.com/apex/TestSActionPage?actionName=redirectSample&fileIds=a038000000mqyR6AAI,a038000000sx1QDAAY,a038000000sx1iEAAQ"}}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Lightning Component","type":"text"},{"type":"hardBreak"},{"text":"You can also embed your custom Lightning Component into S-Drive by S-Actions. Please be sure you map your S-Action URL correctly for Lightning Component (Please see URL Section).","type":"text"},{"type":"hardBreak"},{"text":"For lightning component FileIds and ActionName parameters are sent to component as component attribute. Here is an S-Action Lightning Component sample:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"\n\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"NOTE!","type":"text","marks":[{"type":"strong"}]},{"text":" Make sure your Lightning component and ","type":"text"},{"text":"XXXields","type":"text","marks":[{"type":"em"}]},{"text":" & ","type":"text"},{"text":"actionName","type":"text","marks":[{"type":"em"}]},{"text":" attributes are set to ","type":"text"},{"text":"access=\"global\".","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"File Types","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"You can limit your S-Action to work defined file types only. If leave this field empty, it means action is available for all file types and Folders. If you write file extensions comma separated, it will be shown only these file types. i.e. if you put \"jpg,png,gif,folder\", the action will be listed only these file types' action menu. As you can see on the example, you can define folders as \"folder\" text.","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Allow All Internal Users (checked by default)","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Checking this box allows all internal users to see the S-Action. They must have profile permission for the SDriveCustomAction object. ","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Allow All External Users (unchecked by default)","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Checking this box allows all external users to see the S-Action. They must have profile permission for the SDriveCustomAction Objects","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Objects","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"You can limit your S-Action to work with only selected file object types. If you leave this field empty, it will mean the action is available for all object types.","type":"text"},{"type":"hardBreak"},{"text":"On the left box, named ","type":"text"},{"text":"Available Object","type":"text","marks":[{"type":"em"}]},{"text":", you can see all file objects that are related to S-Drive component. For example, if you have an action which is only for Case File, you should move Case File option to the right box named ","type":"text"},{"text":"Selected Objects","type":"text","marks":[{"type":"em"}]},{"text":". ","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":436,"id":"9512df6f-b362-4945-abcb-d460ff5d6523","collection":"contentId-1677001747","type":"file","height":291}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Users","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"If you want to limit the users that can use the S-Action, you can leave the “Allow All Internal Users” and/or “Allow All External Users” checkboxes unchecked, and select specific users instead. Use the Search to search by profile and or user’s name, move your chosen users to the Selected Users list, and click Save. Users must also have profile permission for SDriveCustomAction. ","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":444,"id":"abc7bf72-bed3-40ba-a873-b8338ade9504","collection":"contentId-1677001747","type":"file","height":285}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"In order for a user to access an S-Action:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User needs profile permission for SDriveCustomAction","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OWD for SDriveCustomAction is “public read” or a sharing rule is in place to share SDriveCustomActions with the user","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Either All Internal Users (or All External Users) checkbox is checked or the user is on the list of Selected Users","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph"}],"version":1}