Merge pull request #5 from Senzing/issue-4.dockter.1

#4 Refactor to template

Author: docktermj

.project

@@ -1,4 +1,4 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <projectDescription>
-	<name>mapper-dnb-ubo</name>
+	<name>mapper-dnb</name>
 </projectDescription>

CHANGELOG.md

@@ -6,24 +6,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 [markdownlint](https://dlaa.me/markdownlint/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
-
-- Thing 5
-- Thing 4
-
-## [1.0.1] - yyyy-mm-dd
-
-### Added to 1.0.1
-
-- Thing 3
-
-### Fixed in 1.0.1
-
-- Thing 2
-
 ## [1.0.0] - yyyy-mm-dd
 
 ### Added to 1.0.0
 
-- Thing 2
-- Thing 1
+- Initial content

CONTRIBUTING.md

@@ -83,7 +83,7 @@ The variables are used throughout the installation procedure.
 
 ```console
 export GIT_ACCOUNT=senzing
-export GIT_REPOSITORY=senzing-repository-template
+export GIT_REPOSITORY=mapper-dnb
 ```
 
 Synthesize environment variables.

PULL_REQUEST_TEMPLATE.md

@@ -2,7 +2,7 @@
 
 ## Which issue does this address
 
-ISSUE-???
+Issue number: #nnn
 
 ## Why was change needed
 

README.md

@@ -3,18 +3,20 @@
 ## Overview
 
 The [dnb_mapper.py](dnb_mapper.py) python script converts Dun & Bradstreet (DNB) files to json files ready to load into Senzing.  This includes the following formats ...
+
 - Companies and their principles **(CMPCVF)** json format
 - Global contacts **(GCA)** tab delimited csv format
 - Ultimate beneficial owners **(UBO)** tab delinited csv format
 
-Normally these are provided by DNB on request and placed on an FTP server for you to download.  
+Normally these are provided by DNB on request and placed on an FTP server for you to download.
 
 *Warning: the [dnb_formats.json](dnb_formats.json) file contains the exact structure of these files.   You may need to send these formats to DNB so they know exactly how to create them!*
 
-Loading DNB data into Senzing requires additional features and configurations. These are contained in the 
+Loading DNB data into Senzing requires additional features and configurations. These are contained in the
 [dnb_config_updates.json](dnb_config_updates.json) file.
 
 Usage:
+
 ```console
 python3 dnb_mapper.py --help
 usage: dnb_mapper.py [-h] [-f DNB_FORMAT] [-i INPUT_SPEC] [-o OUTPUT_PATH]
@@ -35,30 +37,35 @@ optional arguments:
 
 ## Contents
 
-1. [Prerequisites](#Prerequisites)
-2. [Installation](#Installation)
-3. [Configuring Senzing](#Configuring-Senzing)
-4. [Running the mapper](#Running-the-mapper)
-5. [Loading into Senzing](#Loading-into-Senzing)
+1. [Prerequisites](#prerequisites)
+1. [Installation](#installation)
+1. [Configuring Senzing](#configuring-senzing)
+1. [Running the mapper](#running-the-mapper)
+1. [Loading into Senzing](#loading-into-senzing)
 
 ### Prerequisites
+
 - python 3.6 or higher
 - Senzing API version 1.7 or higher
-- https://github.com/Senzing/mapper-base
+- [Senzing/mapper-base](https://github.com/Senzing/mapper-base)
 
 ### Installation
 
 Place the the following files on a directory of your choice ...
+
 - [dnb_mapper.py](dnb_mapper.py)
 - [dnb_config_updates.json](dnb_config_updates.json)
 - [dnb_formats.json](dnb_formats.json)
 
 *Note: Since the mapper-base project referenced above is required by this mapper, it is necessary to place them in a common directory structure like so ...*
+
 ```Console
 /senzing/mappers/mapper-base
 /senzing/mappers/mapper-dnb  <--
 ```
+
 You will also need to set the PYTHONPATH to where the base mapper is as follows ... (assumuing the directory structure above)
+
 ```Console
 export PYTHONPATH=$PYTHONPATH:/senzing/mappers/mapper-base
 ```
@@ -68,40 +75,46 @@ export PYTHONPATH=$PYTHONPATH:/senzing/mappers/mapper-base
 *Note:* This only needs to be performed one time! In fact you may want to add these configuration updates to a master configuration file for all your data sources.
 
 From the /opt/senzing/g2/python directory ...
+
 ```console
 python3 G2ConfigTool.py <path-to-file>/dnb_config_updates.json
 ```
+
 This will step you through the process of adding the data sources, entity types, features, attributes and other settings needed to load this watch list data into Senzing. After each command you will see a status message saying "success" or "already exists".  For instance, if you run the script twice, the second time through they will all say "already exists" which is OK.
 
 Configuration updates include:
+
 - addDataSource **DNB-COMPANY** used when when mapping companies from CMPCVF json files
 - addDataSource **DNB-PRINCIPLE** used when when mapping principles from CMPCVF json files
 - addDataSource **DNB-OWNER** used when when mapping owners from UBO csv files
 - addDataSource **DNB-CONTACT** used when when mapping contacts from GCA csv files
 - addEntityType **PERSON**
 - addEntityType **ORGANIZATION**
 - add features and attributes for ...
-    - **DNB_OWNER_ID** This is used to help prevent owners from resolving to each other and so that you can search on it.
+  - **DNB_OWNER_ID** This is used to help prevent owners from resolving to each other and so that you can search on it.
 
 ### Running the mapper
 
 First, download the DNB files you want to load from the DNB FTP site.  Since the data files are so large, these are normally split into multiple files.
 
 Second, run the mapper. Example usage:
+
 ```console
-python3 dnb_mapper.py -f CMPCVF -i "./input/CMPCVF*.txt" -o ./output -l cmpcvf_stats.json 
+python3 dnb_mapper.py -f CMPCVF -i "./input/CMPCVF*.txt" -o ./output -l cmpcvf_stats.json
 
-python3 dnb_mapper.py -f GCA -i "./input/GCA*.txt" -o ./output -l gca_stats.json 
+python3 dnb_mapper.py -f GCA -i "./input/GCA*.txt" -o ./output -l gca_stats.json
 
-python3 dnb_mapper.py -f UBO -i "./input/UBO*.txt" -o ./output -l ubo_stats.json 
+python3 dnb_mapper.py -f UBO -i "./input/UBO*.txt" -o ./output -l ubo_stats.json
 ```
+
 The output file defaults to the same name and location as the input file and a .json extension is added.
 
 *It is critical that the -f file format match the input files exactly!*
 
 ### Loading into Senzing
 
 If you use the G2Loader program to load your data, its best to list the mapped json files you want to load in a project file.  There is an example of one in your senzing instalation here: /opt/senzing/g2/python/demo/sample/project.csv.  Then from from the /opt/senzing/g2/python directory ...
+
 ```console
 python3 G2Loader.py -p <name of project file>