Skip to main content

Adding a playbook to the workspace

Amandas team is growing and the workspace that she uses to manage and report on telework cases is now used by more of her direct reports. She has noticed some of the direct reports aren't always aware of what to validate on the requests and Amanda would like a way for anyone who views the Telework Cases to be guided through what to look for, ensure the process is followed and all cases are treated equally.

The solution for this is to implement a playbook into the workspace.

Playbooks allow workspace users to interact with a business workflow in real time from within Workspace. Agents can use Playbook to update records, upload attachments, and complete tasks across multiple workflow activities.
Click Here for More Info

Example of a playbook in a workspace:

Steps to Adding a Playbook

Design your playbook in Process Automation Designer
Test and Publish your playbook
Add playbook to your workspace in workspace builder
If you want to change the order of where the tab appears, use UI Builder

Let's get started

Design your playbook in Process Automation Designer

  1. Go to 'All'
    Type in 'Process Automation Designer'
    Click on 'Process Automation Designer' (this will open up in a new tab in your browser)

You are now in the Process Automation Designer list view showing you all the processes that have been completed.

  1. Click on 'Create a new process'

  1. Give your process a label and description (note: your application name should be the name of your Telework Case Management application, might be different than the one in the screenshot)

    Steps
    LabelTelework Case Playbook
    Descriptionused to ensure completeness of telework cases, triggered when case is created
    ClickSelect a Trigger

info

This is going to feel a lot like flow designer – in the background, flows are being triggered and used as we put together our process.

  1. Select a trigger

    Steps
    Choose the first option, "Define your own conditions for when your process runs"
    Choose "Record Create"
    Click on 'Set your trigger condition'

  1. Finally, choose your table and conditions – we aren't going to have any conditions on types of records but that is an option.

    Steps
    TableTelework Case
    Click"Go to Designer"

    Switch to 'Board View'

You should now be on this page:

Next we will add 2 stages

  1. Adding the First Stage

    Steps
    Click+ Add Stage
    LabelCompleteness of Request
    Descriptionensure all the information is provided
    When to startWhen process starts
    Click'Save and close'
  1. Adding the Second Stage

    Steps
    Click+ Add Stage (next to the stage you created)
    LabelFinalizing Request
    Descriptionensure all approvals and tasks have been created and completed
    When to startAfter specific stages
    Click'Save and close'

Your screen should now look like this:

In Column 1, Completeness of Request, we are going to add 3 activities

Completeness of Request
Activity  Check the opened_by has a manager, the reason field is filled out and set the priority
Activity  See if the opened_by has any telework cases already submitted
Activity  Give the workspace user the telework guidelines knowledge article if they want to attach it

**Completeness of Request – Activity **

  1. Click+ Add Activity

**Take A Break** Explore the Activity Screen

  • 'Search Activities'
  • 'Create a new activity' – to learn more about this, go here

(the boxes have been outlined with color to differentiate them. In your instance, there will not be color around each section)

  • Red box: These are your bundled activities; in flow designer these would be your 'spokes'
  • Purple box: In each Bundled activity, are the activities you can assign to your process. These can include interactive and non-interactive activities.
  • Green box: For each activity, this box outlines what necessary info is needed for the activity to work.

More Info, Click Here

**Back to Lab and Adding Activity 1**

Note: We'll be using the 'Common Activities' bundle. Feel free to see what is under 'Global' and 'Process Automation Content' for ideas on what else you can add to a playbook.

  1. Choose
    Common Activities
    User Form

    You should now be here:


On the right hand side, is the activity properties. This is where we give the necessary info for the activity to work.

  1. Fill out the form (Edit activity properties):

    Choose
    LabelReview Form
    DescriptionCheck the requestor has a manager, the reason field is filled out and the priority is set to correct level.
    Click'Automation' TAB (DO NOT click on 'Save and Close')



  1. This activity has some inputs it needs

    Choose
    TableTelework Case
    Recorduse the data pill picker to choose the trigger record, just like in flow designer
    Form Fieldsmust type in string field: opened_by,justification,priority
    ClickSave and close

Before we go any further, let's test this out so you can see how this all will look to the workspace user.

Click on 'Test' in upper right corner near activate: Test

  1. TEST
    Choose Telework Case record – the pictures below will be using TEL0001002
    Click Run Test

  2. Choose the 'Playbook preview' – click on: View (it will open in a new browser tab)

    Give this screen a moment to load – when it's done, it should look like this:

  3. Try adding something for 'Justification' then 'Update' then 'Mark Complete'

  4. In the bottom right corner is a 'cog' – you can open this up and try some of the extra settings. These can be configured in the experience tab for your playbook (not doing in this lab).

  5. If everything looks good, you can close this browser tab then click Done and you should be back to your playbook designer here:


**Completeness of Request – Activity **

After the workspace user has reviewed the form, we would like them to see a list of any telework cases that have already been opened by the requestor. That will be our next activity – adding a list of telework cases opened by the requestor.

  1. Underneath 'Review Form'
    Click+ Add Activity
  2. Choose
    Process Automation Content
    Show list of records

  3. In the 'Edit activity properties' on the right hand side

    LabelRequestors Telework Case
    DescriptionIf the requestor has submitted any other telework case requests, they will be listed below
    ClickUI Layout

  4. Fill out the 'UI Layout' tab

    List TitleRequestors Case
    TableTelework Case
    ColumnsNumber,state,created,opened_by
    Click'Add Condition' next to 'List Query'

    Condition: opened_by is opened_by


    'Add Condition' will look like this (then click Modify ):

    Before clicking on 'Save and close' your form will look like this:

  5. ClickSave and Close


**Completeness of Request – Activity **

The last activity in this lane will be to show the workspace user the knowledge article on telework guidelines – many have asked to have this handy in case they need it at during the process or to attach for the requestor to review.

  1. Underneath 'Requestors Telework Cases'
    Click+ Add Activity
  2. Choose
    Common Activities
    Show Knowledge Article

  3. In the 'Edit activity properties' on the right hand side

    LabelShow Telework Guidelines KA
    DescriptionThis will give the requestor the telework guidelines knowledge article so they can use it if needed in the process
    Start ruleWhen stage starts (we want this to be available right away)
    ClickAutomation Tab (next to details tab)

  4. Fill out the 'Automation' tab

    TitleTelework Guidelines
    Knowledge ArticleKB0050185
    ClickSave and Close

Super – your process should look like this now:

If you have an error regarding an 'end connection' for step 2

  • Go to 'Diagram View'
  • Connect Activity 1.2 to Stage 2
  • It should look like this:

  • then go back to Board view

Feel free to take a break and test out your process like we did earlier



For the second column, 'Finalizing Request' stage, we will be adding just one activity.

  1. Under the 'Finalizing Request' column

    Click+ Add Activity
  2. Choose
    Common Activities
    Instructions
  3. In the 'Edit activity properties' on the right hand side

    LabelCheck for approval and IT Task
    Descriptionensure approval was done and the IT Task was assigned to the right group
    Start ruleWhen stage starts
    ClickSave and Close

That's it! If you look under the 'Automation' tab it automatically puts the description as your instruction. Your form should look like this:

Now, you're all set with version one of your Playbook! It's time to click on Activate

  • What else would you add to the process?

  • Did you notice an activity for manager approval? Some great activities are already in there, out of the box!


Now that we have published the playbook, we need to add the playbook to our workspace in app engine studio.


  1. Open 'App Engine Studio'
    Open your 'Telework Case Management' application

    You should now be here:

  2. Edit the 'Telework' workspace

    (if 'Get Started' pops up, go ahead and click on that)

You should now be in the workspace builder, your screen should look something like this (some of the reports may differ)

  1. At the top of the page:

    Click'Record pages'
    Choose'Telework Case Record Page'

  2. On the left hand side, choose 'Record details' on the left navigation bar

  3. On the far right side, is the Record details configuration pane

    Click on+ Add playbook

  4. Enter in these fields:

    Tab nameTelework Playbook
    Playbook experienceGlobal Playbook Experience
    ClickAdd

So, what is a playbook experience?

After creating your process in the process automation designer, you can either use the out of the box experience "Global Playbook Experience" which is great if you used all out of the box activities and like the way it looks in the workspace.

The other option is you can create your own experiences and components which can give you even more flexibility for the user to work. You can even use UI Builder to create new components and further create the exact experience your workers need.

For more on using playbook experiences, there are a lot of resources – here are a couple:

Now that you have added the playbook to the workspace, take note of how it's showing up as a tab on the record page at the very end, the last tab.
Let's move it to the very beginning. This is how it looks now – go ahead and click on the link in the upper right 'open in UI Builder' (and if there's a pop up, continue to UI Builder)

Now that you're in UI Builder – it takes a minute to load. Soon, you will see the pages and sections on the left.

  1. On the left go to: (these should already be expanded)

Body

  • Resizable panes
    • Left
      • Click on "Main Tab"

  1. On the right side pane of UI Builder
    Drag the Telework Playbook tab so it's on top of the Details tab.

    It should look like this and then Click Save:

You're done! When the 'Save' button in the upper right is greyed out, you're good to close this tab and now we'll test in your workspace.

Go back to the platform view and under workspaces, find 'Telework':

The playbook runs when a new Telework case is created, so we'll need to do that in order to see our playbook in action.

  1. When the workspace opens:

    Choose 'List' Menu on far left
    Choose 'New'

  1. Fill in the fields:

    ArrangementRemote
    JustificationDependent Care
    ClickSave

    (if it doesn't show up right away, refresh browser – this might happen the first time you run it)

Here's your playbook

  • Walk through it and check out the experience –
  • What would you do differently?
  • What else would be helpful?

Congrats!