Difference between revisions of "Importing a New Data Source"

From TaticView
Jump to: navigation, search
 
(55 intermediate revisions by 5 users not shown)
Line 1: Line 1:
To import a new data source:
+
<languages/>
  
  
* Select the ''Import/Update data'' option in the [[Main Page Overview#Menu (Sidebar)|Menu (Sidebar)]] in the [[Main Page Overview|Main Page]];
+
<translate>
  
 +
<!--T:1-->
 +
'''This section will show you how to import a new datasource.'''
  
* In the dialog window, select the ''Add new data source'' option;
+
<!--T:20-->
 +
See also:
 +
* [[Importing a New Data Source Tutorial|See a Tutorial]]
 +
* [[Excel Importing Guide|Excel Importing Guide]]
 +
* [[CSV Importing Guide|CSV/Text Importing Guide]]
 +
* [[Importing Problems|Check Importing Problems]]
 +
* [[Import/Update_data|Update Data]]
 +
* [[Automate_Update_data|Data Update Automation]]
 +
* Download a sample file here: '''[[Special:FilePath/Sales.xlsx|Sales.xlsx]]'''
  
[[File:data_source_imp_upt.png]]
 
  
 +
<!--T:35-->
 +
<span style="color: red;">'''Important:'''</span> Data import is not allowed through tablets and smartphones.
  
  
See [[File and identification]] for information on how to continue.
+
<!--T:2-->
 +
First select the ''New datasource'' option in the [[Main Page Overview#Menu|Menu]] in the [[Main Page Overview#Datasource Tab|Main Page]]:
  
  
'''Important'''
+
<!--T:21-->
 +
[[File:Barra_Lateral+en-US.PNG|link=]]
  
To maintain the correct operation of the created dashboards, some definitions and settings can not be changed latter in the data source and its import file:
 
  
 +
<!--T:22-->
 +
On the next screen:
  
* Columns can not be added between the original columns in the file;
+
<!--T:3-->
** It is possible to add column to the end of the file;
+
[[File:Novo_arquivo+en-US.PNG|800px|link=]]
* Columns names can not be changed in the file header;
 
** Column names can be changed in the [[Input Data Format]] step, but objects that already use this column will keep the previous name.
 
** To update, remove and add again the column to the object;
 
* Columns can not be removed from the file;
 
* Columns must maintain its original order in the file;
 
* Columns data type can not be changed;
 
  
  
'''Tutotial'''
+
<!--T:23-->
 +
* '''File''': Choose the file to be imported. Click on the ''Browser'' button to search your computer for files. See [[Supported File Formats]] for more information;
 +
* '''Name''': Datasource name. This is the name that will be displayed on the '''[[Main Page Overview|main page]]''';
 +
* '''Description''': An optional description for the new datasource.
  
<videoflash>ajezx84EaT4|855|510</videoflash>
+
 
 +
<!--T:24-->
 +
If you have doubts, click on the links "''Tutorial Video''", "''A sample spreadsheet''" and other "''Importing Tips''".
 +
 
 +
 
 +
<!--T:31-->
 +
'''Spreadsheet sample'''
 +
 
 +
<!--T:32-->
 +
[[File:Exemplo_en-US.PNG||1000px|link=]]
 +
 
 +
 
 +
<!--T:25-->
 +
Click '''Send File''' button to continue.
 +
 
 +
 
 +
<!--T:26-->
 +
On the next screen, you must inform the file specifications:
 +
 
 +
<!--T:4-->
 +
[[File:Formatação dos dados+en-US.PNG|800px|link=]]
 +
 
 +
 
 +
<!--T:5-->
 +
* '''Charset''': Specifies the file charset. Usually, the correct option is automatically selected. For CSV files only;
 +
 
 +
<!--T:6-->
 +
* '''Start row''': Specifies which row of the file the import process should start reading. Headings should be included if the ''Header row'' option is checked. For CSV files only;
 +
 
 +
<!--T:7-->
 +
* '''Date mask''': Choose the [[Date]] fields mask in the file. The selected mask must be exactly equal to the format used by dates in the file.;
 +
 
 +
<!--T:8-->
 +
* '''Delimited by''': Specifies the columns delimiter character. Select between ''Tab'', ''Semicolon'', ''Collon'' or ''Another character'' (for ''Other'' type the desired delimiter in the field). Usually, the correct option is selected automatically. For CSV files only;
 +
 
 +
<!--T:9-->
 +
* '''Header''': Check if the file has a ''Header row'' that identifies the columns. The header will be used as the default name for the columns in the datasource;
 +
 
 +
<!--T:10-->
 +
* '''Decimal Separator''': Specifies the decimal separator used in the file.
 +
 
 +
<!--T:11-->
 +
* '''Columns options''': Click the column header in the preview table to select and change its options:
 +
** '''Column data type''': Specifies the column data type: [[Date]], [[Text]] or [[Value]];
 +
** '''Column name''': Specifies the column name.;
 +
** '''Decimal places''': Specifies how many decimal places. For [[Value]] columns only;
 +
 
 +
 
 +
<!--T:27-->
 +
'''Notes:'''
 +
* Is very important to set the right type for each column. When the type is not right, the word NULL will be shown in the cells.
 +
* The Formula columns show the expression used in the spreadsheet or text file.
 +
* You can´t delete existing columns in the datasource.
 +
* In value columns, empty cells (NULL) will be converted to "0".
 +
* In date columns, empty cells or not valid dates will be converted to NULL.
 +
* In text columns, empty cells will be converted to NULL.
 +
 
 +
 
 +
<!--T:36-->
 +
If you made a sctructure change the header collums apper whit different collors an extra screen will show you the alterations to confirm the changes.
 +
* New columns in the imported file, the header color will be yellow.
 +
* Probably wrong columns the header collor will be red.
 +
 
 +
<!--T:37-->
 +
'''Attention:''' After you confirm this screen and process the importation you can't undo the changes.
 +
 
 +
 
 +
<!--T:38-->
 +
[[File:newfields+en-US.PNG|800px|link=]]
 +
 
 +
 
 +
<!--T:39-->
 +
[[File:newfields1+en-US.PNG|800px|link=]]
 +
 
 +
 
 +
<!--T:12-->
 +
Click the '''Next''' button to continue.
 +
 
 +
<!--T:13-->
 +
If you are [[Import/Update data|updating]] a datasource, go directly to the [[New Data Source Summary|import summary]].
 +
 
 +
 
 +
<!--T:14-->
 +
On the next screen, you can automatically generate a set of dashboards with your imported data:
 +
 
 +
<!--T:28-->
 +
The process will try to find compatible dashboards with the information you provided.
 +
 
 +
 
 +
<!--T:29-->
 +
[[File:Colunas geração+en-US.PNG|800px|link=]]
 +
 
 +
 
 +
<!--T:15-->
 +
Select the main [[Date]], [[Text]] and [[Value]] columns that TaticView will use to automatically generate dashboards.
 +
 
 +
<!--T:30-->
 +
Click the '''Next''' button. To skip the automatic dashboards generation, click '''Skip step'''. You can do this later. See [[Generate dashboards]].
 +
 
 +
 
 +
<!--T:17-->
 +
[[File:Resumo importação+en US.PNG|800px|link=]]
 +
 
 +
 
 +
<!--T:18-->
 +
Check the summary information and click the '''Finish''' button to complete the operation and schedule the data import.
 +
 
 +
 
 +
<!--T:33-->
 +
[[File:progresso_importacao+en-US.PNG|800px|link=]]
 +
 
 +
 
 +
<!--T:34-->
 +
Wait for TaticView to create/update the required structures and schedule the data import. If everything is ok, click the '''Done!''' button.
 +
 
 +
 
 +
<!--T:19-->
 +
When the datasource import/update is completed, TaticView will automatically update the status on the [[Main_Page_Overview|main page]].
 +
 
 +
 
 +
 
 +
 
 +
</translate>

Latest revision as of 14:16, 30 September 2022

Other languages:
English • ‎português do Brasil


This section will show you how to import a new datasource.

See also:


Important: Data import is not allowed through tablets and smartphones.


First select the New datasource option in the Menu in the Main Page:


Barra Lateral+en-US.PNG


On the next screen:

Novo arquivo+en-US.PNG


  • File: Choose the file to be imported. Click on the Browser button to search your computer for files. See Supported File Formats for more information;
  • Name: Datasource name. This is the name that will be displayed on the main page;
  • Description: An optional description for the new datasource.


If you have doubts, click on the links "Tutorial Video", "A sample spreadsheet" and other "Importing Tips".


Spreadsheet sample

Exemplo en-US.PNG


Click Send File button to continue.


On the next screen, you must inform the file specifications:

Formatação dos dados+en-US.PNG


  • Charset: Specifies the file charset. Usually, the correct option is automatically selected. For CSV files only;
  • Start row: Specifies which row of the file the import process should start reading. Headings should be included if the Header row option is checked. For CSV files only;
  • Date mask: Choose the Date fields mask in the file. The selected mask must be exactly equal to the format used by dates in the file.;
  • Delimited by: Specifies the columns delimiter character. Select between Tab, Semicolon, Collon or Another character (for Other type the desired delimiter in the field). Usually, the correct option is selected automatically. For CSV files only;
  • Header: Check if the file has a Header row that identifies the columns. The header will be used as the default name for the columns in the datasource;
  • Decimal Separator: Specifies the decimal separator used in the file.
  • Columns options: Click the column header in the preview table to select and change its options:
    • Column data type: Specifies the column data type: Date, Text or Value;
    • Column name: Specifies the column name.;
    • Decimal places: Specifies how many decimal places. For Value columns only;


Notes:

  • Is very important to set the right type for each column. When the type is not right, the word NULL will be shown in the cells.
  • The Formula columns show the expression used in the spreadsheet or text file.
  • You can´t delete existing columns in the datasource.
  • In value columns, empty cells (NULL) will be converted to "0".
  • In date columns, empty cells or not valid dates will be converted to NULL.
  • In text columns, empty cells will be converted to NULL.


If you made a sctructure change the header collums apper whit different collors an extra screen will show you the alterations to confirm the changes.

  • New columns in the imported file, the header color will be yellow.
  • Probably wrong columns the header collor will be red.

Attention: After you confirm this screen and process the importation you can't undo the changes.


Newfields+en-US.PNG


Newfields1+en-US.PNG


Click the Next button to continue.

If you are updating a datasource, go directly to the import summary.


On the next screen, you can automatically generate a set of dashboards with your imported data:

The process will try to find compatible dashboards with the information you provided.


Colunas geração+en-US.PNG


Select the main Date, Text and Value columns that TaticView will use to automatically generate dashboards.

Click the Next button. To skip the automatic dashboards generation, click Skip step. You can do this later. See Generate dashboards.


Resumo importação+en US.PNG


Check the summary information and click the Finish button to complete the operation and schedule the data import.


Progresso importacao+en-US.PNG


Wait for TaticView to create/update the required structures and schedule the data import. If everything is ok, click the Done! button.


When the datasource import/update is completed, TaticView will automatically update the status on the main page.