⚙️1. Mapping configuration
Learn how to create your first Skin CMS Mapping
What will you need before you start
An account and a base in Airtable
Airtable personal access tokens for the base you want to connect
you must have
OwnerorCreatorrole for the given base in Airtable
3DVista virtual tour
Skin CMS Mapper
Once you purchase a Skin CMS plan on 360creators.com, you will gain an access to the Skin CMS Mapper. Skin CMS Mapper is a simple tool you will be using to create and manage your mappings.
What is a mapping?
Mapping is essentially the connection between the Airtable table and your 3DVista virtual tour.
Mapping contains the information of which Airtable field (column) is mapped to which 3DVista component (skin element).
Mapping configuration
When you create a new mapping, first you need to set up the configuration:
1. Mapping name
Name of the Mapping. We recommend using something related to the project you are working on.
2. Airtable personal tokens
You can create Airtable personal tokens on Airtable's Personal access token management page. In order to create a mapping you need to create two personal access tokens - one for Mapper and one for 3DVista.
2.1. Airtable personal access token for mapper
This personal token will be used by the Skin CMS Mapper to read your Airtable table's schema (structure) in order to access the names of the fields (columns), their types and configurations which are necessary for creating the mappings.
Create a personal access token with the following scope:
schema.bases:read
2.2. Airtable personal access token for 3DVista
This personal token will be used in the virtual tour to fetch the data from the Airtable table. Therefore, as it's publicly available, it is extremely important to select the correct scope which in this case is:
data.records:read
With the data.records:read scope the virtual tour visitors will be able to read the data from all tables within the base for which the personal token is created (on the example above the base is: Skin CMS - Matej demos). This might include giving away an access to other tables that are not being used in the virtual tour but are part of the base. That's why we recommend making sure that the base does not contain any sensitive information. Users won't be able to edit nor delete the data, only read it.
3. Airtable base ID
An Airtable link to your table looks something like this:
We are only interested in the first part after the https://airtable.com/ which in the example above is apphSS5HBXphqjWYw - that's the base ID.
4. Airtable table name
The Airtable table name in the example is Table 1:
Save and connect Airtable
Once you are done, you can hit the Save and connect Airtable button and continue to the 2nd step.
Whenever you change your Airtable structure, you will need to Save and connect Airtable to see the updated fields in the Field Mappings section.
Last updated
