Getting started

What are solution templates? A video course for tenant administrators

A 6-minute video course with a transcript: what a solution template is, the gallery, the wizard, the review, the install and what to do after.

By The Kav team Published 10 min read

This is the first course of the Kav Studio Academy for tenant administrators. It answers one question, what is a solution template, and follows one template from the gallery to the installed result in about 6 minutes.

Every screen is the Studio of Kav's own organization on a test copy, with example data only.

Use the chapter menu beside the video (below it on a phone) to jump to a topic, or the Transcript tab to read along.

What you will learn

Each item starts the video at that chapter.

  1. What a template is (0:00): Understand what a solution template is, what it creates for you, and why it exists.
  2. The gallery (0:56): Find a template in the Solutions gallery and know what to have ready before you start.
  3. The wizard (1:37): Answer a template's questions in the wizard, part by part, and watch the preview.
  4. Review before anything changes (2:50): Read the review, understand each action, and know why it is safe to continue.
  5. Install and the result (3:52): Install the template and read the result table.
  6. After the install (4:26): Manage an installed template: edit it, upgrade it, understand drift, and uninstall safely.
  7. Recap and what comes next (5:38): Remember the shape of every template, and where the next course goes.

Before you start

  • Who this is for. Administrators who set up the assistant for an organization in the Studio.
  • What you need. A staff account that holds registry.solution.read to see the gallery and registry.solution.apply to install.
  • Have ready. For the calendar template, a department that takes the appointments. A connected calendar account is optional and is the subject of the next course.
  • Nothing is overwritten. Rows you edited by hand are left alone, and uninstalling switches rows off instead of deleting them.

Chapter by chapter

1. What a template is

Play this chapter (0:00, 0:56 long)

Goal: Understand what a solution template is, what it creates for you, and why it exists.

  • A solution template is a ready-made set-up for one kind of job, such as taking appointments. You answer a few questions and the platform creates the pieces.
  • It is not code: a versioned file written by the platform team, holding the questions to ask and a recipe of what to create. One wizard draws any template.
  • The calendar template creates the booking form, the calendar capabilities, your appointment types and the routing that tells the assistant when to offer a booking. A Google calendar link is optional.

2. The gallery

Play this chapter (0:56, 0:40 long)

Goal: Find a template in the Solutions gallery and know what to have ready before you start.

  • Open Solutions in the Studio menu. The Available tab lists templates as cards; search by name, description or category, or use the category chips.
  • Each card shows the name, category, version and what it does, plus what you need first: for this template a department, and an optional calendar account.
  • Seeing the gallery needs registry.solution.read. Installing needs registry.solution.apply.

3. The wizard

Play this chapter (1:37, 1:13 long)

Goal: Answer a template's questions in the wizard, part by part, and watch the preview.

  • Three steps: Questions, Review and Install. Nothing is created until Install.
  • The questions come in parts: where bookings go, your services, how bookings look, and what the assistant says. Every question has an information mark.
  • A live panel shows what customers will experience. The scoping note, one short sentence about what booking is for and not for, is required.

4. Review before anything changes

Play this chapter (2:50, 1:02 long)

Goal: Read the review, understand each action, and know why it is safe to continue.

  • The review, called What will change, is a preview only: the server works out the exact plan and writes nothing.
  • The plan is grouped by owner. Actions are Create, Already present, Edited by hand, Switch off and Blocked. Rows edited by hand are never overwritten.
  • The licence line and the routing checks sit below. A failing routing check blocks the install.

5. Install and the result

Play this chapter (3:52, 0:33 long)

Goal: Install the template and read the result table.

  • The install request is accepted at once and runs in the background, with a result table that follows each item from Waiting to Applied.
  • Install is safe to repeat. If an item needs attention or fails, apply again; finished items are not done twice.
  • When everything is applied, Next steps point to the widget, the calendar connection and the bookings.

6. After the install

Play this chapter (4:26, 1:12 long)

Goal: Manage an installed template: edit it, upgrade it, understand drift, and uninstall safely.

  • The Installed tab lists every template in the environment with version, status and last change. Open returns to the wizard in edit mode with your answers filled in.
  • Everything created is ordinary Studio content, such as the booking form in Forms. A row you edit by hand is shown as edited by hand, with the differences, at the next review.
  • Upgrade asks only the new questions. Uninstall switches the rows off and deletes nothing; it is blocked while future confirmed bookings exist.

7. Recap and what comes next

Play this chapter (5:38, 0:34 long)

Goal: Remember the shape of every template, and where the next course goes.

  • A template is data, not code: questions plus a recipe.
  • The wizard asks, the review shows, the install creates, safely and repeatably.
  • More templates will follow the same wizard.

Full transcript

Full transcript of the video

The words of the video, in order. Use the chapter list above to watch a part instead.

Chapter 1. What a template is

Goal: Understand what a solution template is, what it creates for you, and why it exists.

Welcome to the Kav Studio Academy. This first course answers one question: what is a solution template? A template is a ready-made set-up for one kind of job, such as taking appointments. You answer a few questions, and the platform creates the pieces for you. It is not code. A template is a versioned file, written by the platform team: the questions to ask, and a recipe of what to create. One wizard can draw any template, so every template feels the same to use. Take the calendar template. From your answers it creates the booking form, the calendar capabilities that find times and book them, your appointment types, and the routing that tells the assistant when to offer a booking. It can also link a Google calendar. All of it stays editable afterwards. The result is consistent, and much faster than building by hand.

Chapter 2. The gallery

Goal: Find a template in the Solutions gallery and know what to have ready before you start.

Open Solutions in the Studio menu. This is the gallery of templates available to you. The Available tab lists them as cards. Search by name, description or category, or use the category chips to narrow the list. Each card shows the name, the category, the version, and what the template does. Under it is what you need first. Here: a department that takes the appointments, and a calendar account, which is optional. Each item says whether it is ready. Choose Set up to open the wizard. Seeing the gallery needs the solution read permission. Installing needs solution apply.

Chapter 3. The wizard

Goal: Answer a template's questions in the wizard, part by part, and watch the preview.

The wizard opens on the template's own page: its name, its version, and the environment you are in. Three steps run along the top: Questions, Review and Install. Nothing is created until the last one. Open What this solution sets up to read, in plain words, everything your answers will create. The questions come in four parts here: where bookings go, your services, how bookings look, and what the assistant says. A button at the bottom moves you on. First, choose the department that takes the appointments. Its opening hours decide when people can book. The calendar account is optional, so we skip it. Connecting one is the next course. Now a service: a name, and a length in minutes. Booking hours are optional; left empty, the department's hours apply. Every question has an information mark, with an explanation, an example and the limits. On the right, the panel shows what your customers will experience, and it updates as you type. The last part is the scoping note: one short sentence about what booking is for, and what it is not for.

Chapter 4. Review before anything changes

Goal: Read the review, understand each action, and know why it is safe to continue.

The second step is the review, called What will change. This is the safety net. It is a preview only. The server checks your answers and works out the exact plan. Nothing is written yet. The plan is grouped by the part of the platform that owns each item: assistant, routing and forms; appointments; and connections. Every row has an action. Create means a new row. Already present means nothing to do. Edited by hand means someone changed that row, so the template leaves it alone and shows the differences. Blocked means the row belongs to something else. The licence line tells you whether your plan includes this template. Further down are the routing checks: sample sentences, like I want to book an appointment, that must reach the right capability. A failing check blocks the install. Here, they all passed. If anything surprises you, go back and change your answers. When you are happy, choose Next: install.

Chapter 5. Install and the result

Goal: Install the template and read the result table.

On the Install step you apply the plan. The request is accepted at once, and the work continues in the background. A result table follows each item, from Waiting to Applied. The other outcomes are Already present, Needs your attention, and Failed. Install is safe to repeat. If an item needs attention or fails, apply again, and finished items are not done twice. When everything is applied, Next steps appear: try it in the widget, connect your calendar, and see bookings.

Chapter 6. After the install

Goal: Manage an installed template: edit it, upgrade it, understand drift, and uninstall safely.

After installing, open the Installed tab. It lists every template in this environment, with its version, its status, and when it last changed. Open takes you back into the wizard in edit mode, with your earlier answers filled in. Change one, and the review shows exactly what would change. Everything the template created is ordinary Studio content. Here is the booking form it made, in Forms. You can edit it like any other form. If you edit a row by hand, the template respects that. At the next review the row is shown as edited by hand, with the differences, and it is never overwritten. When a newer version of a template is released, the Installed tab shows Upgrade. Upgrade asks only the new questions, and summarises what is new, changed or removed. You can still choose to edit all the answers. Uninstall switches off the rows the template created. It deletes nothing. Rows you edited by hand stay as they are, and your answers are kept, so you can install again at any time. Uninstall is blocked while there are future confirmed bookings, so nobody's appointment disappears. We will cancel this one and keep the template.

Chapter 7. Recap and what comes next

Goal: Remember the shape of every template, and where the next course goes.

Let's recap. A template is a versioned, ready-made set-up: questions, and a recipe of what to create. It is data, not code. The wizard asks, the review shows what will change, and the install creates it, safely and repeatably. What you edit by hand is never overwritten, and uninstalling switches rows off instead of deleting them. More templates will follow the same wizard, so what you learned here applies to each of them. Next course: connecting a calendar. Thank you for watching.