Batch process create/import data
Create a batch-job
To generate a new batch-job it is essential to upload the address-files. This will be made by a POST-Request with enctype "multipart/form-data" and the action init.
The CSV-Data will be send as file with the POST-parameter "customer" and/or "shop" to upload the addresses. All for the batch-job nessesary addresses must be send by the first batch-job initialization!
Define your own batch-job-name
When you create a batch-job there is automatically created a request-Id for internal use for the system. Each batch job can be addressed by these request-Id.
Additional it is possible to generate a user-defined name. The name must be CLEARLY for all given batch jobs of a user.
If the parameter "name" is used, you can continue to work after a successful batch-job generation, with this name.
Define the data structure
If in the first line from the CSV file the header field names are parameters, they must be defined by following parameter. (false = default).
If these field names correspond to locr field names "id, country, city, street, postal, house", so theses will be automatically to assign the fields.
If the first line of the address file does not correspond to field names or those of locr default, the fields must be separately allocated in the correct order and separated by a comma! This is done by the parameters:
Field1 = id
Field2 = -
Field3 = country
Field4 = -
Field5 = city
Field6 = -
Field7 = postal
Field8 = street
Field9 = house
Define the map type
There are two different map the LOCALmaps and the NAVImaps:
Define a country for the address-lists
It is possible to define the country internally of an address list. If all the addresses are from one county, you can define them by extra parameter.
Countries must be defined by the standard ISO 3166-1 ALPHA-2 or ISO 3166-1 ALPHA-3 code.
Minimum requirements for GEOcoding
To make geocoding for an address list the fields of the country and the city must be defined, these are the minimal information to get an results.
To obtain the most accurate positioning, all 5 fields COUNTRY, CITY, POSTAL, STREET, NUMBER are specified!
Addresses existing GEOcoding
If the addresses are already geocoded, that means that for all addresses the latitude/longitude values are in a list are available, it can be imported by the parameters:
Use this parameter additional in the variables customer_columns/shop_columns.
Example return by an successful generation and import
If the import worked, you get an XML with the number of records and a requestId back.
Return by incorrect import