The Data Source tab contains information about the data set that will be imported.
Data Source Type
Lists the types of data sources the import program can use: Microsoft Access, ODBC, OLE, Oracle, SQL Server, Text File, Web Service, or XML.
Data Source
Identifies the location of the data to be imported.
The following field appears if the Data Source is set to Access, ODBC, OLE, Oracle, or SQL Server.
Data Select SQL
Enables the user to select a SQL statement to tell the import which records from the data source should be imported.
The following fields appear if the Data Source is set to Text File.
Data Delimiter
Indicates which delimiter the data source uses to indicate breaks in data. Select either Tab, Space, or Other. If you select other type the delimiter into the provided field.
First Row Contains Header Information
Indicates that the first row of data in the data source is header information and should not be imported.
Fixed Width Schema
Some data sources do not use delimiters. Instead, they contain a continuous string of data, in which each piece of data is a standardized length. This section is used to break up such data into columns.
The following fields appear if the Data Source is set to XML.
XML File Schema
Displays the data columns included in the .xml file.
Retrieve Schema
Reads the .xml file selected in the Data Source field and displays the columns of data it stores in the XML File Schema.
The following fields appear if the Data Source is set to Web Service.
Raw Web Request
Displays the request that will be sent to the web service.
Build
Opens a dialog allowing you to build a web request using several components.
Web Service Schema
Displays the data columns returned by the Raw Web Requests.
Retrieve Schema
Runs the Raw Web Request Collects the columns returned by the Raw Web Request.
Using the Data Source Type drop-down, select the type of database connection to be used for this import.
Choose either Access, ODBC, OLE, Oracle, or SQL Server.
Click the ... button next to the Data Source field. The following pop-up appears:
Complete all available fields; or, if a field you need isn't editable, change the DBMS Type.
Click Test to check if the program can connect to the database.
Click Ok to accept the settings and close the pop-up.
In the Data Select Sql field, enter a SQL statement to select a set of records. Only the records that are part of the SELECT statement will be considered for import.
Example:SELECT * FROM dbo.Hydrants WHERE Imported = 0
In the Data Source Type drop-down menu, select XML.
Click the ... button next to the Data Source field. Browse to the location of the .xml file and select it.
Note: When configuring this it is suggested that you select an .xml file that contains all of the types of data that you will ever need to import using this template. Doing so ensures that the schema takes into account all the possible fields you will need to import even if any given xml file might not include all of those fields.
Click the Retrieve Schema button. This loads and locks the schema that the import will used.
The Fixed Width Schema grid will be filled out with all the fields found within the selected .xml file.
Note: If the XML file is complicated you may see Root items duplicated to display child collections. If this is the case it is suggested to not use the Check For Duplicates function on the General Tab.
In the Data Source Type drop-down menu, select Web Service.
Paste a web request into the Raw Web Request field
OR
Click the Build button to the right of the Raw Web Request field. The following pop-up will appear:
Select the Method your request will use.
Enter the URI to connect to.
Select the Protocol to use.
Enter the Header and Body to your request.
Note: The values in these fields will vary depending on the web service you are accessing.
Click Ok.
Note: When configuring this it is suggested that you select a web service that contains all of the types of data that you will ever need to import using this template. Doing so ensures that the schema takes into account all the possible fields you will need to import even if any given service call might not return all of those fields.
Click the Retrieve Schema button. This loads and locks the schema that the import will used.
The Web Service Schema grid will be filled out with all the fields found within the selected .xml file.
Note: If the web service supports it request the data in XML format. This is done by including something like Accept: application/xml in the Header.
Note: JSON is supported If the web service does not support XML format. However if the returned object does not indicate it is JSON the Import and Update will assume it is XML. In this case include something like Accept: application/json in the Header. ESRI services are an example of this.