Installing and Configuring Collaboration Extension

the collaboration extension integrates and works well with soc solutions bundle and the case and incident management (cim) application this user guide uses the soc solutions bundle and cim application in examples to instruct how to utilize the collaboration solution to best understand the documentation and examples, you can install and configure the soc solutions bundle and the cim application for assistance in soc solutions bundle and setup, contact your swimlane professional services point of contact the collaboration extension is a collection of bundled components to create context aware messages from predefined templates to send to external messaging systems, such as email, slack, and/or microsoft teams for processing by swimlane, or non swimlane, users for an additional information, navigate to collaboration extension docid\ idzp2ews0ggvlzen4ezsv start by installing the extension go to marketplace navigate to the turbine marketplace follow these steps log in to turbine in the navigation pane, click tenants select the desired tenant in the navigation pane, click library in the library navigation pane, click swimlane content install now, you can install the collaboration extension from the swimlane content library, under solutions , click collaboration extension click install on the right bottom of the solution the collaboration extension details open the overview tab shows each individual solution that composes the collaboration extension and their capabilities the content tab shows how many and which workspaces, applications, dashboards, and/or reports are included in the collaboration extension the documentation tab has a link to the collaboration extension topic in this user guide on the right hand side of the window, click +install again from the install collaboration extension window, choose which content you’d like to install all content is pre selected as a default click check marks to deselect any content you may see the following warning, if content already exists in your environment you can avoid overwriting content by deselecting the items you do not wish to overwrite, and it will still work but if you deselect too many items that are not being overwritten, you will not import the full solution if prompted to overwrite existing content, click and hold the mouse icon until the circle is complete and the dialog box disappears you will see importing … if there are no issues, the import success window opens you can import successfully and still have potential issues if that's the case, the review potential issues window opens review the potential issues by clicking import more to import more ssps; or clicking go to application to address issues, if the issues are in your application if the issues are with assets or playbooks, navigate to their respective locations in turbine to edit; or clicking close to close the window if there are issues, you see the import error window you must address the errors to import successfully you cannot continue installation without resolving the errors you must start over and re install from the collaboration solution from the integrated marketplace, or import as an ssp file configure custom assets configuring the collaboration solution is a one time task you need to configure two assets the first is a mostly pre defined collaboration extension configuration asset where you can figure certain inputs the second is the email provider asset that you choose configure collaboration extension configuration asset to configure custom assets, follow these steps in the navigation pane, click orchestration and click assets search for and click collaboration extension configuration fill the following fields based on descriptions asset input field information email medium options gmail , o365 , or smtp enter one of the email options the field is not case sensitive post interaction webhook url grab the webhook url from the post interaction trigger in the collaboration extension playbook and paste it here slack webhook url this field defaults as empty only configure if you want to use slack success response default text "thank you for your response!" reject response default text "a previous response has been recorded for this message your response has not been applied please contact your administrator if you feel this is in error " configure email provider based on the chosen email medium in the previous step, the appropriate email provider configuration asset must be set use the table below to determine which asset should be configured email medium email provider configuration asset name gmail collaboration google settings o365 collaboration microsoft exchange settings smtp collaboration smtp settings each of the assets above must be provided with their own unique configuration parameters to facilitate communication with the email provider configure applet the example in this guide uses the case and incident management (cim) application that was installed during the soc solutions bundle configuration process however, you can use the following steps within your desired application to configure for the collaboration applet, follow these steps in the navigation pane, click applications & applets click case and incident management the cim application opens drag the collaboration extension applet into the application at a desired location a confirmation dialog opens add collaboration extension applet here? click add under select template section, create a new playbook button and enter the title load template map the playbook button to the collaboration extension playbook from the select a flow drop down menu, you can select an existing flow or create a new one using create new under collaboration template selected , create a new playbook button and enter the title send message map the playbook button to the collaboration extension playbook from the select a flow drop down menu, you can select an existing flow or create a new one using create new click save to save the application to finish configuring the applet, let's enable some of the application workflow actions from the application toolbar, click the workflow icon the application workflow opens click the collaboration hide default sections action and from the action panel, toggle the status to enable click the collaboration set application name action and replace the value with the name of the application in which the applet was installed and from the action panel, toggle the status to enable click the if collaboration selected template not blank action and from the action panel, toggle the status to enable click save configure playbook triggers now it is time to configure your newly created playbook trigger from the previous step navigate to the orchestration section and select playbooks search for and click the playbook titled collaboration extension find the new trigger for your newly created playbook button titled load template under the add section, click components and find the component named write load template drag and drop the write load template component under the load template playbook trigger with the component clicked, under the data section on the right, click configure this is where you’ll map application record data to the component interface inputs map data according to this chart component input choose this field to map your inputs to applet application name application name applet tracking id current record values values tracking id selected template current record values values collaboration selected template application record current record values values find the new trigger for your newly created playbook button titled send message drag and drop the write create record in message sender component under the send message playbook trigger with the component clicked, under the data section on the right, click configure with the component clicked, under the data section on the right, click configure component input choose this field to map your inputs to invoking record tracking id current record values values tracking id applet application name application name click save to save to playbook configure automated loading and sending you can configure templates to automatically load and send without any practitioner interaction to do this, create a new application workflow condition and two actions and configure them to the scenario you desire to initiate the automation for this example, let's use the scenario if signal source equals alert from the collaboration solution applet's workflow, click on the root of the workflow that has the name of the "host" application for example, case and incident management and click create a new condition the best practice is to name the condition after the scenario since we are using the if signal source equals alert scenario, follow the steps to configure the condition in the name field, enter automate collaboration extension alert in the field type drop down menu, select signal source in the operator drop down menu, select equals in the value drop down menu, select alert the condition is enabled by default click the automate collaboration extension incoming alert condition to show the condition icons and click the create a new action icon the action panel opens configure the new action in the name field, enter set collaboration selected template in the action type drop down menu, select set field value from the field drop down menu, select collaboration selected template in the value field, enter the name of the template title that you want to load and automate sending this will come from your collaboration template manager application this example has incoming high priority alert as a template name repeat step 6 to create another new action from the automate collaboration extension incoming alert condition in the name field, enter set automated collab to true in the action type drop down menu, select set field value in the field drop down menu, select collaboration automate template selection in the value drop down menu, select true click save multiple conditions can be created to automate the loading and sending of different templates based on your desired use case set the application trigger for the application to initiate, you need to set up the application trigger to set up the trigger, follow these steps from the navigation pane, click orchestration and click playbooks search for and open the collaboration extension playbook click add a trigger and select record event from the trigger panel, drag a drop a new record event trigger onto the playbook canvas click on the new trigger and from the application drop down menu, select the application name in which the collaboration extension applet was installed select if the trigger should run on record create, record update, or both if you select record update, this may result in duplicate messages being sent if there are many record actions taking place in a short period of time only use this option if record updates are infrequent at the point where an automated message should be sent using collaboration extension navigate to the components tab and search for the component named execute automate collaboration message send drag and drop the component under the created record event trigger with the component clicked, under the data section on the right, click configure this is where you’ll map application record data to the component interface inputs map data according to this chart component input choose this field to map your inputs to applet application name application name applet tracking id current record values values tracking id click apply click save to save the playbook