License key
Once you have installed the program, you can install the data to use with Batch API. To ensure that your data is compatible, all data for a country must be the same version and should be installed at the same time.
Each dataset has an expiry date and must be updated periodically. We provide regular updates of the datasets as and when updated data is available. Each update should be applied promptly, otherwise the data may expire, and the product will become unusable.
To install or update data on Windows, we recommend that you use Electronic Updates, which automatically ensures that your products are using the latest data available.
If you have chosen to install or update your data using Electronic Updates, follow these steps:
Windows Batch API has been supplied to you and comes with an installation program called setup.exe. When you run setup.exe, the Batch API libraries and associated files are installed to the location of your choice (the default is C:/Program Files/Experian/Batch API).
To run the installation program:
GBR data only
According to the terms of your third-party license agreements, once you have performed an initial clean of your data using Batch API, NCOA Update and NCOA Suppress data are tied to the machine that Batch API is installed on.
If you do need to move these datasets to a different machine after you have performed an initial clean, you should contact us who will guide you through the process.
If you wish to use TPS or monthly pointer data, you must install and use Electronic Updates (EU) to do so, due to the fortnightly data update cycle.
The Batch API image contains both shared object and static library compiles of Batch API. Copy the contents of the relevant folder from the image to the location of your choice, for example /opt/ batch/.
You can choose to install Batch API as a 32-bit or 64-bit version. You should select the version that is correct for your integration.
When you wish to run your integrated application, you should ensure that the following files are in the same directory as the application executable:
The first time you install a dataset you must do the following:
Copy the data files from the data CD / DVD to a suitable location.
multiple disks
Go to /opt/qasBatch/ (or wherever you installed Batch API) and open the qawserve.ini configuration file in a text editor such as vi.
Under the [QADefault] section add a line to the InstalledData
setting, specifying the location of the data you just copied. The setting is in the format:
InstalledData={dataset identifier},{path}
For example, if you had just copied the GBR dataset to /opt/qasData/gbr/ the line would read:
InstalledData=GBR,/opt/qasData/gbr
In the same section add at least one line to the DataMappings setting, to specify the combinations of additional datasets you wish to use. The setting is in the format:
DataMappings={data mapping identifier},{dataset/group name},{dataset+additional datasets}
For example, if you had the United Kingdom With Names additional dataset to enhance your GBR dataset you might add two lines, one without the additional dataset and one including it:
DataMappings=GBR,United Kingdom,GBR
+GBN,United Kingdom With Names,GBR+GBRNAM
If you are installing the USA dataset you must also specify the location of the supplementary USA Batch data and libraries which are supplied on separate disks to the USA data. In the same section of qawserve.ini, add the CorrectADataLocUSA
setting and the CorrectAAPILoc
setting. For example:
CorrectADataLocUSA=/opt/qasData/USA
CorrectAApiLoc=/opt/qasData/USA
You do not need to use the CorrectAApiLoc
setting if you installed the supplementary libraries to the same location as your core Batch API libraries, or to a location specified in your environment variable.
If you are installing the CAN dataset you must also specify the location of the supplementary CAN Batch data and library which are supplied on separate disks to the CAN data. In the same section of qawserve.ini, add the CorrectADataLocCAN
setting and the CorrectAApiLoc
setting. For example:
CorrectADataLocCAN=/opt/qasData/CAN
CorrectAApiLoc=/opt/qasData/CAN
You do not need to use the CorrectAApiLoc
setting if you installed the supplementary library to the same location as your core Batch API libraries, or to a location specified in your environment variable.
Open the qalicn.ini configuration file in a text editor such as vi. Add all of your supplied license keys for your purchased Experian Data Quality datasets to the end of this file.
FTP
To update a previously installed dataset, overwrite your existing files with those provided on the data update CD / DVD. To ensure that your datasets are compatible, all data for a country must be the same version and should be installed at the same time. The supplementary data and libraries for the USA and CAN datasets must also be copied from the Batch data disks. The following section details the files which comprise each dataset.