Installing Ichicraft Boards

Installing Ichicraft Boards is easy, just follow the steps and you’ll be up and running in no time. First follow the general installation steps (part 1), then follow the steps to install in SharePoint Online (part 2). If you want to offer Ichicraft Boards as a personal app in Microsoft Teams, you must also follow the steps in (part 3).

Installing the solution in your environment

Part 1: Install

1: Browse to the tenant-wide App Catalog or Site Collection App Catalog

You must have set up and configured the tenant-wide App Catalog OR a Site Collection App Catalog in your Microsoft 365 tenant. Please see Set up your Office 365 tenant and follow the Create app catalog site section OR if you want a scoped deployment to a Site Collection App Catalog see Create a Site Collection App Catalog and follow Create a site collection app catalog.

If your tenant-wide or Site Collection App Catalog has already been provisioned you will need (access to) an account that has permissions to upload a package to complete the installation process.

If you do not know how to locate the App Catalog, try browsing to the following link (replace {your-tenant-name} with your tenant name from your SharePoint url):

Tenant-wide App Catalog:
https://{your-tenant-name}-admin.sharepoint.com/_layouts/15/online/ManageAppCatalog.aspx

Site Collection App Catalog:
https://{your-tenant-name}/{your-site-collection-name}/AppCatalog

2: Click on the gear icon in the top right corner and select Add an app.

3: Open the SharePoint Store from the top navigation.

4: Type "ichicraft" in the search box to find the Ichicraft Boards App and click on the app.

5: Click on "Add to app catalog" button

6: A dialog will be presented with more details about app permissions and data access, click on "Add".

7: A following dialog is presented to help you find the API access page, click on "Go to API access page" to review the API permissions needed to use Ichicraft Boards.

8: On the API access page approve the Ichicraft Boards related permissions as shown (User.ReadWrite.All and Directory.Read.All) in the picture.

9: Continue with steps in Part 2 (Add Ichicraft to your modern SharePoint intranet)

Adding the solution in your modern SharePoint intranet

Part 2: Add to your intranet

To install and configure the web part and site collection you will need to complete the following steps:

1: Provision/Identify Modern Communication Site

Either identify an existing SharePoint communication site or provision a new one in your SharePoint Online tenant. For more information about how to provision a communication site see Create a communication site in SharePoint Online and follow the instructions.

2: Activate Ichicraft Boards App

On the site where you want to add Ichicraft Boards, push the Office 365 Settings button on the navigation bar at the top of the screen and then click Add an app.

On the Your Apps page you should see something like this:

Click on “Add” to activate the app in your site, making the Ichicraft Boards web part available

3: Add Ichicraft Boards web part to the page and start configuration

Navigate to the respective modern page where you would like to add the Ichicraft Boards web part and click on + sign. You should see something like this:

Click on “Ichicraft Boards” to add it to the page.

Save or Publish the page.

Start the Widget Board configuration by clicking on Start configuration.

4: You have successfully installed Ichicraft Boards.

5: If you want to offer Ichicraft Boards as a personal app in Teams continue with steps in Part 3 (Teams).

Adding the solution to Microsoft Teams

Part 3: Add to Teams

To install and configure Ichicraft Boards for your Teams client you will need to complete the following steps:

1: Generate a Teams package from the Widget Board Administration

Go to the site collection where you have installed Ichicraft Boards in Part 2.

Open the Widget Board Administration and select Teams from the left navigation, you should see something like this:

Update the configuration if needed and click on Generate Teams package.

2: Go to the Microsoft Teams tenant app catalog and add the Teams package

Start Teams and sign in using your global or teams service admin credentials. Select Apps on the (bottom) left side of the app.

On the Apps page, select Upload a custom app > Upload for [your tenant name]. You should see something like this:

3: When you go back to your tenant app catalog, Ichicraft Boards is available to add to your Teams client. Click on the deployed app

4: To add the Teams App click on Add, you should see something like this:

5: You have successfully installed the Ichicraft Boards Teams package! You can start the configuration wizard.

Questions?

We are happy to help! Feel free to get in touch with us.