Page Comparison

After you add raw data files items in the Stream section of your database, each column of data has a red dot above it, to indicate that it is not mapped to the database. The next step in the design process is to map (match) these data columns to their respective component (Dimensions, Properties, Measures or Date) in the database.

When you map a data column to the appropriate database component, the dot turns blue and an initial displays in it, to show what it has been mapped to (for example, ‘D' for dimension, 'P’ for property and so on). The name of the mapped item displays next to the dot.

Image Removed

Image Added

Notes about mapping

• If you are using a pre-loaded design, there will be some placeholder items in the Dimensions and Measures sections. These items will guide you when you start mapping the data in your transaction file.If no date is mapped, Designer will default to today's date.

• If no measures are mapped, designer creates a single 'value' measure (with a value of 1)the whole item is skipped, in other words, it is not included when the database is built.

• A property cannot have the same name as a measure.

• The order in which properties are mapped, and their naming convention, will affect the results that users see when using the Map charts (Marker, Circle and Heat) in Analytics. Notes about naming: With regards to names, Country 'AUS' does not map. Use , so use 'AU' or 'Australia' instead. Use Similarly, use 'Due date' not 'Date due'. To test mappable properties enter the string into https://www.openstreetmap.org.

Map the date

1. Drag and drop the applicable Moment (Date) column heading into the Date section.

   Image RemovedImage Added

   Designer checks the data type of the Moment (Date) column in the data fileitem:
   If it the data type is correct, the Edit button on the Date component is disabled. Skip to step 3.
   If the data type is NOT correct, the Edit button on the Date component is enabled. You need to change the date format to match the format of the Moment (Date) column. Proceed to step 2.

2. (If applicable, see previous step) Change the date format: Click the Edit button on the Date component, then select the required date format from the list and click Save. For example, if the dates in the file item are in the format of date/month/year, such as 01/03/2020, you need to select the corresponding date format in Designer, which is dd/mm/yyyy.

   Image RemovedImage Added

3. Set how much data you want to include in each database build:

   • All time - All of the historical data that is available.

   • The past - Apply a filter to the historical data to determine how much data is included. For example, you might want to maintain only 2 years or 6 months of historical data at all times. This filter works on the calendar year (Jan - Dec), so the current period is added to that selected timeframe. For example, if you select 2 Years and today is June, you will get the full two prior calendar years plus the 6 months of the current calendar year.

     Image RemovedImage Added

Map the dimensions, properties and measures (manually)

Drag and drop each* data column heading into the appropriate section: Dimensions, Properties or Measures.

For example, in the following image, the first four data columns have been mapped and the Value data column is being mapped to the Measures section.

Image Removed

Image Added

*With the exception of the Date column. You can map all the columns now or do some later, depending on how much information you need in your database initially.

Use existing mappings for a new

item

If you already have mapped data in your database, when you can add more data files to the databases taking items, you can take advantage of some time-saving options. See Add (connect) data to a database..

Usually, the data from the second and subsequent items needs to match the mapping structure that was already created from the first item. If that’s the case, you can drag data columns on top of the corresponding mapped items. The X turns blue to indicate the mapping was successful.

Image Added

If you drop a data column onto the wrong measure, click the X to remove the mapping.  

Unmap or delete mapped items

The act of dragging and dropping a column creates both the structure and mapping at the same time. If you make a mistake or change your mind, you can remove the mapping (unmap the item). Depending on the situation, if you unmap an item, the structure still remains. You can delete the structure, unless the value has a foreign mapping. The results are explained in the following example. 

Unmap an item	The blue border around an item means that Value has been mapped from the raw data file item that displays in the stream section at the bottom of your screen. Click the X on the item to remove the mapping. There are three potential outcomes for the item: It becomes unmapped and deleted; it will disappear completely. It becomes unmapped but the structure remains (see point 2 below). It becomes unmapped but a foreign mapping remains - see point 3 below. Image Removed Note Ensure you click the X on the mapped database component, as this only removes the mapping between the data column and that database component. If you click the X on a stream tab, you delete the entire stream, and therefore, all your mapping.	Image Added
Delete the structure	In this situation, the blue border is gone, signifying that the item is not mapped (you won't see it in Phocas after building the database). Value exists only as a structural element. This is often the case when a template or a previous design is used. The structure serves as a placeholder, awaiting a future mapping. Click the Delete button to permanently delete the structure.
Identify foreign mapping	A blue dot next to an item name means it is mapped from a different raw data source item - not the one that currently displays in the stream section at the bottom of your screen. There is no ability to unmap or delete this foreign mapping here. You need to locate the correct raw data file item (it could be in another stream, or a different raw data file item tab in the current same stream or in another stream tab).

Troubleshooting: Mapping warnings

Designer expects all dimensions and properties to be Text and all measures to be a Number but that might not always be the case for your data filesitems. If the data types do not match, you will get a warning in the data column header. You can click this warning icon to display the message.

To resolve the issue, click the Edit button in the mapped item and change the data type.

For example, the PhoneCall data is a number but when it was mapped to the Properties section, the system expected the data type to be Text, so you change it to Number.

Troubleshooting: Missing raw data

Even if you have the ideal database design, it is possible for raw data files items to get moved, deleted or renamed, which could cause a build error. In Designer, if there is a mismatch between the design and raw data, the streams that have missing raw data will be red and an error similar to that in the following image will display.

Image Removed

Image Added

Click OK to close the error message. Hover over the data file item tabs to display the name of the missing data.

Image Removed

Image Added

To resolve the issue, you have the following options:

• Restore: Put the missing raw data item back. This could mean re-uploading it, re-syncing it and checking the file item name.  

• Replace: Drag a new raw data file item on top of the missing red fileitem. The file item will turn blue again and any existing mappings will be retained. See Replace.

• Remove: If it is no longer needed, you can remove the red raw data file item by clicking the X.