0
Statement of Confidentiality The information contained in this document is confidential and proprietary to Dow Jones and/or its licensors. Dow Jones submits this information with the understanding that you will hold it in strict confidence. The contents are not to be disclosed, duplicated or used, in whole or in part, for any purpose without Dow Jones's permission.
USER GUIDE Watchlist - State Owned Companies
“Combo” XML Feed
1 © Copyright 2016 Dow Jones & Company
2 © Copyright 2016 Dow Jones & Company
CHAPTER 1: Introduction to Dow Jones WL-‐SOC XML Feeds A B O U T D O W J O N E S W L -‐ S O C X M L F E E D S Dow Jones Watchlist-‐State Owned Companies “combo” feed is a detailed eXtensible Mark-‐up Language(XML) feed that contains data from our flagship Watchlist and State Owned Companies datasets as one single file delivery and is designed to assist financial institutions with due diligence and statutory duties and aid in the fight against money laundering, illicit payments, and other illegal activities. D O W J O N E S B R A N D I N G G U I D E L I N E S Correct branding of Dow Jones content is a contractual obligation and customers should refer to the latest Dow Jones Risk & Compliance Branding Guidelines available on the Dow Jones Customer Support Developer Portal
P R O D U C T S U P P O R T
Answers to all your Questions and Issues regarding Dow Jones WL-SOC XML Feeds are
available on Dow Jones Customer Support site.
To Connect to Dow Jones Customer Support site you would require Internet Access and a Valid Dow Jones login.
3 © Copyright 2016 Dow Jones & Company
Chapter 2: Dow Jones WL-‐SOC XML Feeds Details
This section provides information about Dow Jones WL-SOC XML feeds, including feed
requirements, distribution schedule; file formats, document retrieval, and processing.
D O W J O N E S W L -‐ S O C F E E D F R E Q U E N C I E S
This section describes the various Feed Frequencies currently offered within Dow Jones WL-
SOC.
Dow Jones WL-SOC Feed Frequencies:
o Dow Jones WL-SOC Daily Full & Split Feed. The Daily Full feed consists of a single
XML full feed file provided on a Daily basis that contains a full refresh of profiles within
the Dow Jones Watchlist and State Owned Companies Content.
The Full Refresh of Dow Jones WL-SOC content is also available on a daily basis in a
split version in which the full feed is divided into a number of smaller files to facilitate
processing.
The Daily Full Feed and Split Feeds are provided everyday, 365 days a year.
o Dow Jones WL-SOC Daily Incremental Feed. The Daily Incremental XML feed files
contains delta updates of all changes, additions and deletions made to Dow Jones
Watchlist and State Owned Companies content during the day since the last Daily
Incremental Feed.
The Daily Incremental Feed is provided everyday, 365 days a year.
L O C A T I O N S F O R D O W J O N E S W L -‐ S O C F E E D F I L E S
The Dow Jones WL-SOC Feed Files can be downloaded from the below locations:
Dow Jones WL-SOC Feed Files:
• Daily Incremental, Daily Full & Split Feed Files are available here:
https://djrcfeed.dowjones.com/WL-SOC/xml
4 © Copyright 2016 Dow Jones & Company
L O C A T I O N S F O R D O W J O N E S W L -‐ S O C C H E C K S U M A N D F E E D L O G F I L E S
The Checksums and Feed log files for each of the Dow Jones WL-SOC Feed Files can be
downloaded from the below location:
https://djrcfeed.dowjones.com/WL-SOC/xml/feedlogs
Checksums Checksum is a common and most powerful method to ensure the content received from Dow
Jones is both secure and downloaded in its entirety and that there have been no content losses
during the transfer of the Feed Files from the Dow Jones location to the users Individual storage
or processing locations.
For this purpose, a new Checksum text file is posted to the respective Dow Jones locations,
which contains the unique MD5 Hash Code associated with each of the Feed files.
The MD5 Hash Code is generated at the point of uploading the files to the Dow Jones locations.
Users Can use their own solutions or any one of the freely available MD5 verification tools to
check that the MD5 Hash Code of the received File is equal to the MD5 Hash Code of the
generated file or not.
If the MD5 Hash Code of the received file is equal to the MD5 Hash Code provided by Dow Jones
in the Checksum File, the File has been downloaded without any transmission errors.
Free ware Checksum Tools Available: Below is the list of a few tools that can be used to compare the MD5.
1. Exact File (http://www.exactfile.com)
2. Microsoft (R) File Checksum Integrity Verifier V2.05 (FCIV)
(http://support.microsoft.com/kb/841290)
3. EF Checksum (http://www.efsoftware.com/cm/e.htm)
4. FastSum – (www.fastsum.com)
5. MD5Checker (http://getmd5checker.com/)
6. MD5 Checksum tool (http://www.brothersoft.com/md5-checksum-tool-176270.html)
7. MD5Sums (http://www.pc-tools.net/win32/md5sums/)
8. FSum 2.5.2 (www.slavasoft.com)
5 © Copyright 2016 Dow Jones & Company
9. MD5 (http://www.fourmilab.ch/md5/)
10. HashCalc (www.slavasoft.com)
Please note: These tools are to be used at the User’s own discretion and Dow Jones would not responsible for the support and maintenance on issues arising due to the use of these tools.
R E Q U I R E M E N T S F O R D O W J O N E S W L -‐ S O C X M L F E E D S
Any implementation of the Dow Jones WL-SOC XML Feeds must meet the Following Criteria:
Requirement Rules/Description Document Retrieval All Feed Files are delivered
1. Over the Internet. Use Hyper Text Transfer Protocol over Secure Socket Layer (HTTPS) to retrieve files via the Internet.
2. Via File Transfer Methods: Use Secure File Transfer Protocol(SFTP) to retrieve files file this method
Document Processing 1. For Initial Uploads, always Process Full Feed Files before processing Incremental Feed.
2. It is recommended that a Full Refresh is processed once or twice a month.
3. Incremental Feeds should always be processed in ascending order.
All Feed Files are Date time stamped and should be processed in ascending order. If you detect any problems with the Feed Files please contact Dow Jones before attempting to process the Feed File.
D O W J O N E S W L -‐ S O C F E E D D I S T R I B U T I O N S C H E D U L E S
This section lists the Feed Distribution Schedules for Dow Jones WL-SOC XML Feeds.
Dow Jones Standard Feed Schedules:
Feed Frequency Feed Schedule Daily Incremental • Available by 01:00 GMT, 365
days per year Daily Full & Split Feed • Available by 01:00 GMT, 365
6 © Copyright 2016 Dow Jones & Company
days per year
All XML feed files are available for download for up to 60 days. To access to XML feed
files that are older than 60 days, please contact Dow Jones Customer Services.
D O W J O N E S W L -‐ S O C X M L F E E D F I L E N A M E S
All Dow Jones WL-SOC feed files are supplied in .ZIP file format. The following table identifies the various feed file formats for each feed type:
File Format Description DJRC_WL-SOC_XML_CCYYMMDD2359_D.zip • Represents daily incremental
files, each complete with date and timestamp.
• File name ends with the letter “D” (designating each daily incremental file).
DJRC_WL-SOC_XML_CCYYMMDD2359_F.zip • Represents the full feed file, complete with date and timestamp.
• File name ends in the letter “F” (designating the full feed).
DJRC_WL-SOC_XML_CCYYMMDD2359_Splits.zip
• Represents the folder name containing the split files of the full feed.
• File name ends as “Splits” (designating the Split Feed)
N A M I N G C O N V E N T I O N S F O R C H E C K S U M F I L E S The naming convention of the Checksum file is similar to the Feed file name with only “checksum_” prefixed to the Feed file naming convention. The Below Table gives the Details about the Checksum Files Naming Convention for Each Type of Feed Service:
File Format Description checksum_DJRC_WL-SOC_CCYYMMDD2359_D.txt
• Represents the Checksum File for the Daily Incremental Feed File, each Complete with date and time stamp.
• File name ends with the letter “D” (designating each daily incremental file).
checksum_DJRC_WL-SOC_XML_CCYYMMDD2359_F.txt
• Represents the Checksum File for the Full Feed File, each Complete with date and time
7 © Copyright 2016 Dow Jones & Company
stamp. • File name ends in the letter “F”
(designating the full feed). checksum_DJRC_WL-SOC_XML_CCYYMMDD2359_Splits.txt
• Represents the Checksum File for the Full Split Feed File, each Complete with date and time stamp.
• File name ends as “Splits” (designating the Split Feed)
D O C U M E N T R E T R I E V A L Dow Jones WL-SOC XML Feed Files can be retrieved via the Internet using the Hyper Text
Transfer Protocol over Secure socket Layer (HTTPS) or via Secure File Transfer Protocol
(SFTP).
To Retrieve the Files via the Internet
1. Log on to the Dow Jones Feed servers, located at https://djrc.dowjones.com (The
Exact Directory Locations have been mentioned under ‘Locations for WL-SOC XML
Feeds’)
2. Use the User name and Password provided by your Dow Jones representative. If you do
not have a User name and Password contact Dow Jones Customer Services.
3. Passwords are case sensitive and asterisks (*) are displayed in place of the Password.
4. After providing your Username and password, Click OK. A Comma Separated File list
displays all available Feed Files.
5. Retrieve the appropriate File using HTTPS GET:
o For Daily full feed files, retrieve the full feed file that contains a date-time stamp
closest to the current date. It is recommended that you retrieve the latest full feed
file (to replace those previously processed incremental feeds).
o For Daily Incremental feed files, retrieve all incremental files that contain a date
and timestamp that is greater than the previously processed full or daily
incremental feed files.
6. To manually download a Dow Jones WL-SOC Feed File after successfully logging on,
simply copy the feed file name from the displayed list of feed files and then paste it into
the address bar.
Example:https://djrc.dowjones.com/WL-SOC/xml/DJRC_WL-
SOC_XML_201512132359_D.zip
8 © Copyright 2016 Dow Jones & Company
To Retrieve the Files via the SFTP 1. To establish a connection to the Dow Jones Feeds Servers, you would need the
following details: Host Name: djrcfeed.dowjones.com Port Number: 22 User Credentials: these are provided as part of your welcome package 2. Open the SFTP tool by clicking on the icon. (For illustration purposes “WINSCP” has been used across this document) 3. Furnish the details in the login page.
4. WINSCP offers you a feature to save the session. You can click on Save to save the
details for future logins or simply click on Login to establish the connection without saving.
5. You will see a Welcome banner. If you do not want to see this again – click on “Never
Show this banner again” and then click on “Continue”
9 © Copyright 2016 Dow Jones & Company
6. After you login, you will be presented with an Explorer Window as shown below.
7. Double Click on the folder called “WL-SOC”.
Navigate through the path /WL-SOC/XML
10 © Copyright 2016 Dow Jones & Company
8. To download any file, select the file you wish to copy and then click on “Copy” or press
F5. Please note; different tools provide different methods/options of downloading files to local systems.
You can also automate the feeds download by using the automation techniques provided by the software vendor. Please make sure you contact the particular SFTP software vendor for any assistance.
All Files are scanned for Viruses and Trojans before being uploaded to the Dow
Jones Feeds servers.
S U G G E S T I O N F O R A U T O M A T I N G F E E D F I L E D O W N L O A D If you wish to automate the process of feed file retrieval from Dow Jones, you may wish to
consider the following options:
1. Create a Windows Service that runs at on a scheduled basis to (i) check the availability of
the required feed file and (ii) securely retrieve files via HTTPS. This may involve
implementing code or applications that will enable files to be downloaded without manual
intervention.
11 © Copyright 2016 Dow Jones & Company
Web References/Source Code Samples for automation can be found at:
http://www.example-code.com/vbdotnet/ftp.asp
http://www.vbdotnetheaven.com/UploadFile/bfarley/FileDownload04182005043858AM/F
eDownload.aspx
http://www.codeproject.com/KB/vb/downloadFileswProgressbar.aspx
2. Implement a commercial file retrieval application that will securely retrieve feed files using
automated scheduled processes
C H E C K T H E I N T E G R I T Y O F T H E D O W N L O A D E D F I L E To ensure the content received from Dow Jones is both secure and downloaded in its entirety
and that there have been no content losses during the transfer of the Feed Files from the Dow
Jones location to the users’ individual storage or processing locations, you can use your own
solutions or any one of the available MD5 verification tools to check that the MD5 Hash Code of
the received File is equal to the MD5 Hash Code of the generated file or not.
If the MD5 Hash Code of the received file is equal to the MD5 Hash Code provided by Dow Jones
in the Checksum File, the File has been downloaded without any transmission errors.
However, if you face any Mismatch in the MD5 codes please Download the File again and if you
continue receiving the Same MD5 Mismatch Error, please Contact Dow Jones Customer Service.
P R O C E S S I N G D A T A F R O M T H E X M L F E E D F I L E S
After retrieving the desired files, you should be ready to process your feeds into a relational
database (or another data store).
Processing XML data involves backing up your existing data (to protect against data loss),
followed by importing and updating Country lists, Relationship lists, Occupation lists, Sanctions
References list, Description1list, Description2list, Description3list, Date Type list, Name Type list,
Role Type list, and then processing people lists, entity lists, person associates and entity
associates.
A Monthly or Daily full feed must be processed before Weekly or Daily incremental feeds; and all
incremental feeds must be processed in ascending date order.
12 © Copyright 2016 Dow Jones & Company
It is recommended a Full Feed refresh is subsequently taken once or twice a month.
In addition, you must distinguish the feed handling of people lists and entity lists (since full feeds
differ from incremental feeds), and recognise that people data comprises of multiple person and
entity elements, each with an unique ID and an action attribute that identifies the transformation
of each ID.
After integrating Dow Jones WL & SOC content in your environment, use the exact Set
List Values (provided by Dow Jones) to perform a search. For example, if Dow Jones
provides Myanmar as Country name, you must use that name (not Burma) to recover
citizens of that country.
What Do I do next?
o Process data from a full feed
o Process data from an incremental feed
o Process data, changing from a full feed to a daily incremental feed
Process data from a full feed
1. Backup your existing data to a more stable storage area, such as another machine or
tape drive.
Backups are a simple and essential component of any installation. It is good practice to
produce daily backup copies of production data, and to transfer those backups away from
the current environment.
2. Choose from the following:
To process... Follow these steps... Country Lists Occupation Lists, Relationship Lists , Special References List , Description1 list, Description2 List, Description3 List, Name Type list, Date Type List, Role Type List
1. Delete the appropriate data list(s) from your data store (if any).
2. Load the data from the latest full feed into your data store.
Records For all Profile (Person/Entity) IDs where action=add:
1. Delete all corresponding profile data and associations
13 © Copyright 2016 Dow Jones & Company
from your data store.
2. Load the profile data from the latest full feed into your data store.
Full feed files only contain Profile IDs with action=add.
Associations List Load the data from the latest full feed into your data store.
Process data from an incremental feed
1. Backup your existing data to a more stable storage area, such as another machine or
tape drive.
Backups are a simple and essential component of any installation. It is good practice to
produce daily backup copies of production data, and to transfer those backups away from
the current environment.
2. Choose from the following (completing your actions in ascending date order):
To process... Follow these steps... Country Lists Occupation Lists, Relationship Lists , Special References List , Description1 list, Description2 List, Description3 List, Name Type list, Date Type List, Role Type List
1. Delete the appropriate data list(s) from your data store.
2. Load the data from the latest full feed into your data store.
Records For all Profile (person/Entity) IDs where action=add:
1. Load the profile data from the latest incremental feed into your data store.
For each Profile (person/Entity) ID where action=chg:
1. Delete all corresponding associations from your data store.
2. Next, delete all corresponding profile data from your data store.
3. Load the modified profile data from the latest incremental feed into your data store.
For each Profile (person/Entity) where action=del:
1. Delete all corresponding associations from your data store.
2. Delete all corresponding profile
14 © Copyright 2016 Dow Jones & Company
data from your data store.
Associations List Load the new association data from the latest incremental feed into your data store.
Process data, changing from a full feed to a daily incremental feed
1. Backup your existing data to a more stable storage area, such as another machine or tape drive. Backups are a simple and essential component of any installation. It is good practice to produce daily backup copies of production data, and to transfer those backups away from the current environment.
2. Process the latest available full feed (_F) files date time stamped closest to the current day. (See "Process data from a full feed.")
3. Next, process the daily incremental (_D) file, date stamped closest to the current day.(See “Process data from an Incremental Feed”)
4. Subsequently, and from this point forward, process only daily incremental files, in ascending date order.
Although Full Feeds are available on a Daily basis, it is not necessary to re-process full feed files at this frequency, unless you plan to rebuild the database on every day. However a Full refresh should be taken at least once a month, as best practice.
15 © Copyright 2016 Dow Jones & Company
CHAPTER 3: Dow Jones WL-‐SOC XML Feed Elements This section provides information about the individual XML elements found in the feeds.
Dow Jones WL-SOC XML feeds include XML elements in the form of containers (tags/elements) that hold other containers. P R I M A R Y X M L E L E M E N T S F O R S T A N D A R D F E E D S :
• PFA • CountryList • OccupationList • RelationshipList • SanctionsReferencesList • Description1List • Description2List • Description3List • DateTypeList • NameTypeList • RoleTypeList • Records • Associations
Where, <PFA> is the root element.
<PFA>……… </PFA>
16 © Copyright 2016 Dow Jones & Company
Diagram
Description This is the top level container (root element) for the Dow Jones WL-SOC Feeds.
Please follow the sequence of elements as shown in the figure above, top to bottom.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes Attribute Name
Attribute Description Type Use Max length
date Represents the Date of the Feed File
xs: string
required 12 characters
17 © Copyright 2016 Dow Jones & Company
generation.
Format is: ccyymmddhhmm (GMT) where,
Value Description
Ccyy Represents the year
Mm Represents a month
Dd Represents a day
Hh Represents an hour
Mm Represents minutes
type Represents the Type (Frequency) of Feed File.
Possible Values are:
Value Description
daily Represents a daily file
full Represents a full file
xs: string
required 11 characters
Children • CountryList • OccupationList • RelationshipList • SanctionsReferencesList • Description1List • Description2List • Description3List • DateTypeList • NameTypeList • RoleTypeList
Source Schema
<xs:element name="PFA"> <xs:complexType> <xs:sequence>
18 © Copyright 2016 Dow Jones & Company
<xs:sequence> <xs:element ref="CountryList"/> <xs:element ref="OccupationList"/> <xs:element ref="RelationshipList"/> <xs:element ref="SanctionsReferencesList"/> <xs:element ref="Description1List"/> <xs:element ref="Description2List"/> <xs:element ref="Description3List"/> <xs:element ref="DateTypeList"/> <xs:element ref="NameTypeList"/> <xs:element ref="RoleTypeList"/> <xs:element ref="Records"/> <xs:element ref="Associations"/> </xs:sequence> </xs:sequence> <xs:attribute name="date" type="xs:string" use="required"/> <xs:attribute name="type" type="xs:string" use="required"/> </xs:complexType>
</xs:element> Sample Code <PFA date="20151215" type="daily">
+<CountryList> +<OccupationList> +<RelationshipList> +<SanctionsReferencesList> +<Description1List> +<Description2List> +<Description3List> +<DateTypeList> +<NameTypeList> +<RoleTypeList> +<Records> +<Associations> </PFA>
<CountryList>……… </CountryList>
Diagram
Description This is the container of the Masters List for Countries specified in Dow Jones WL-SOC feed.
The Country master list is an extensible list and has a potential to change regularly. Updates to this list will be supplied in the look-up table supplied in every feed.
Use Required
Type None
19 © Copyright 2016 Dow Jones & Company
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children CountryName
Source Schema
<xs:element name="CountryList"> <xs:complexType> <xs:sequence> <xs:element ref="CountryName" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <CountryList> <CountryName code="AARCT" name="Antarctica" IsTerritory="True"/> <CountryName code="AFGH" name="Afghanistan" IsTerritory="False" ProfileURL="afghanistan.doc"/> <CountryName code="ALB" name="Albania" IsTerritory="False" ProfileURL="albania.doc"/></CountryList>
<CountryName>……… </CountryName>
Diagram
Description Contains the Country Details
Use Required
Type None
Max Length NA
20 © Copyright 2016 Dow Jones & Company
Occurrences Min Occurrence Max Occurrence
1 unbounded
Attributes Attribute Name
Attribute Description Type Use Max length
code Represents the DJII Country Code Associated with the Country.
xs: string required 13 characters
name Represents the country name (descriptor) associated with the corresponding code.
xs: string required 255 characters
IsTerritory Represents whether a country is a territory.
Possible values are:
Value Description
True Specifies that the Country is a Territory of another Country
False Specifies that the Country is not a Territory of another Country
xs:NMTOKEN required 5 characters
ProfileURL Represents the country URL of the associated Dow Jones Country Profile document
xs: string optional 255 characters
Children None
Source Schema
<xs:element name="CountryName"> <xs:complexType> <xs:attribute name="code" type="xs:string" use="required"/> <xs:attribute name="name" type="xs:string" use="required"/> <xs:attribute name="IsTerritory" use="required"> <xs:simpleType>
21 © Copyright 2016 Dow Jones & Company
<xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="True"/> <xs:enumeration value="False"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name="ProfileURL" type="xs:string"/> </xs:complexType> </xs:element>
Sample Code <CountryName code="AARCT" name="Antarctica" IsTerritory="True"/> <CountryName code="AFGH" name="Afghanistan" IsTerritory="False" ProfileURL="afghanistan.doc"/> <CountryName code="ALB" name="Albania" IsTerritory="False" ProfileURL="albania.doc"/>
<OccupationList>……… </OccupationList>
Diagram
Description This is the container of the Masters List for Occupation Categories specified in Dow Jones WL-SOC feed.
The Occupation master list is an extensible list and has a potential to change regularly. Updates to this list will be supplied in the look-up table supplied in every feed.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • Occupation
Source Schema
<xs:element name="OccupationList"> <xs:complexType> <xs:sequence> <xs:element ref="Occupation" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
22 © Copyright 2016 Dow Jones & Company
Sample Code <OccupationList> <Occupation code="1" name="Heads & Deputies State/National Government"/> <Occupation code="2" name="National Government Ministers"/> <Occupation code="3" name="Members of the National Legislature"/> </OccupationList >
<Occupation>……… </Occupation>
Diagram
Description Contains the Occupation Category (Profession) Details
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 Unbounded
Attributes Attribute Name
Attribute Description Type Use Max length
code Represents Code Value Associated with a Profession.
xs: string required 2 characters
name Represents the profession (occupation) associated with the corresponding code.
xs: string required 255 characters
Children None
Source Schema
<xs:element name="Occupation"> <xs:complexType> <xs:attribute name="code" type="xs:string" use="required"/> <xs:attribute name="name" type="xs:string" use="required"/>
23 © Copyright 2016 Dow Jones & Company
</xs:complexType> </xs:element>
Sample Code <Occupation code="1" name="Heads & Deputies State/National Government"/> <Occupation code="2" name="National Government Ministers"/> <Occupation code="3" name="Members of the National Legislature"/>
<RelationshipList>……… </RelationshipList>
Diagram
Description This is the container of the Masters List for Relationship Categories specified in Dow Jones WL-SOC feed.
The Relationship master list is an extensible list and has a potential to change regularly. Updates to this list will be supplied in the look-up table supplied in every feed.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • Relationship
Source Schema
<xs:element name="RelationshipList"> <xs:complexType> <xs:sequence> <xs:element ref="Relationship" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <RelationshipList> <Relationship code="1" name="Wife"/> <Relationship code="2" name="Husband"/> <Relationship code="3" name="Brother"/> <Relationship code="4" name="Sister"/> <Relationship code="5" name="Son"/> </ RelationshipList>
24 © Copyright 2016 Dow Jones & Company
<Relationship>……… </Relationship>
Diagram
Description Contains the Relationship Details
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 unbounded
Attributes Attribute Name
Attribute Description Type Use Max length
code Represents Code Value Associated with a Relationship Category.
xs: string required 2 characters
name Represents the type of relationship (family connection or business association).
xs: string required 255 characters
Children None
Source Schema
<xs:element name="Relationship"> <xs:complexType> <xs:attribute name="code" type="xs:string" use="required"/> <xs:attribute name="name" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <Relationship code="1" name="Wife"/> <Relationship code="2" name="Husband"/> <Relationship code="3" name="Brother"/> <Relationship code="4" name="Sister"/> <Relationship code="5" name="Son"/>
25 © Copyright 2016 Dow Jones & Company
<SanctionsReferencesList>……… </SanctionsReferencesList>
Diagram
Description Contains the master list of Sanctions Reference Lists available in Dow Jones content
The Sanctions Reference master list is an extensible list and has a potential to change regularly. Updates to this list will be supplied in the look-up table supplied in every feed.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • ReferenceName
Source Schema
<xs:element name="SanctionsReferencesList"> <xs:complexType> <xs:sequence> <xs:element ref="ReferenceName" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <SanctionsReferencesList> <ReferenceName code="1" name="OFAC - Specially Designated National List" status="Current" Description2Id="1"/> <ReferenceName code="2" name="OFAC - Specially Designated National List" status="Current" Description2Id="3"/> <ReferenceName code="3" name="OFAC - Specially Designated Terrorist List" status="Current" Description2Id="1"/> <ReferenceName code="4" name="OFAC - Specially Designated Terrorist List" status="Current" Description2Id="3"/> </SanctionsReferencesList>
26 © Copyright 2016 Dow Jones & Company
<ReferenceName>……… </ReferenceName>
Diagram
Description Contains sanctions/official list details.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 Unbounded
Attributes Attribute Name
Attribute Description Type Use Max length
code Represents the code value associated with a sanctions/official list reference.
xs:string required 4 characters
name Represents the name of sanctions/official list reference.
xs:string required 255 characters
status Represents the status of the list, whether Current or Suspended.
Possible values are:
Value Description
Suspended
Specifies that the Lists is Suspended
Curre Specifies that the List
xs:NMTOKEN required 9 characters
27 © Copyright 2016 Dow Jones & Company
nt is Current.
Description2Id
Represents the record type Description 2 Id classification of the sanctions/official list reference
xs: string required 4 characters
Children None
Source Schema
<xs:element name="ReferenceName"> <xs:complexType> <xs:attribute name="code" type="xs:string" use="required"/> <xs:attribute name="name" type="xs:string" use="required"/> <xs:attribute name="status" use="required"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="Suspended"/> <xs:enumeration value="Current"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name="Description2Id" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <ReferenceName code="1" name="OFAC - Specially Designated National List" status="Current" Description2Id="1"/> <ReferenceName code="2" name="OFAC - Specially Designated National List" status="Current" Description2Id="3"/> <ReferenceName code="3" name="OFAC - Specially Designated Terrorist List" status="Current" Description2Id="1"/> <ReferenceName code="4" name="OFAC - Specially Designated Terrorist List" status="Current" Description2Id="3"/>
<Description1List>……… </Description1List>
Diagram
Description Contains the master list of Description1 classification applicable to WL and SOC content available in Dow Jones WL-SOC feed.
The Description1 master list is an extensible list and has a potential to change regularly. Updates to this list will be supplied in the look-up table
28 © Copyright 2016 Dow Jones & Company
supplied in every feed.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • Description1Name
Source Schema
<xs:element name="Description1List"> <xs:complexType> <xs:sequence> <xs:element ref="Description1Name" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <Description1List> <Description1Name Description1Id="1" RecordType="Person">Politically
Exposed Person (PEP)</Description1Name> <Description1Name Description1Id="2" RecordType="Person">Relative or
Close Associate (RCA)</Description1Name> - <Description1Name Description1Id="3" RecordType="Person">Special Interest
Person (SIP)</Description1Name> <Description1Name Description1Id="4" RecordType="Entity">Special Interest
Entity (SIE)</Description1Name> <Description1Name Description1Id="5" RecordType="Entity">Entity
(SO)</Description1Name> <Description1Name Description1Id="6" RecordType="Person">Person
(SO)</Description1Name> </Description1List>
<Description1Name>……… </Description1Name>
Diagram
29 © Copyright 2016 Dow Jones & Company
Description Contains the Description1 Details
Use Required
Type Extension of xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
1 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
Description1Id Represents the code value associated with a Description1 value.
xs:string required 4 characters
RecordType Represents the Record Type value associated with a Description1. Possible Values are:
Value Description
Person Specifies that the record is of a person type
Entity Specifies that the record is of an entity type.
xs:NMTOKEN required 6 characters
Children None
Source Schema
<xs:element name="Description1Name"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> <xs:attribute name="Description1Id" type="xs:string" use="required"/> <xs:attribute name="RecordType" use="required"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN">
30 © Copyright 2016 Dow Jones & Company
<xs:enumeration value="Person"/> <xs:enumeration value="Entity"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element>
Sample Code <Description1Name Description1Id="1" RecordType="Person">Politically Exposed Person (PEP)</Description1Name> <Description1Name Description1Id="2" RecordType="Person">Relative or Close Associate (RCA)</Description1Name> <Description1Name Description1Id="3" RecordType="Person">Special Interest Person (SIP)</Description1Name> <Description1Name Description1Id="4" RecordType="Entity">Special Interest Entity (SIE)</Description1Name>
<Description2List>……… </Description2List>
Diagram
Description Contains the master list of Description2 classification applicable to WL and SOC content available in Dow Jones WL-SOC feed.
The Description2 master list is an extensible list and has a potential to change regularly. Updates to this list will be supplied in the look-up table supplied in every feed.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • Description2Name
Source Schema
<xs:element name="Description2List"> <xs:complexType> <xs:sequence>
31 © Copyright 2016 Dow Jones & Company
<xs:element ref="Description2Name" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <Description2List> <Description2Name Description2Id="1" Description1Id="3">Sanctions Lists</Description2Name> <Description2Name Description2Id="2" Description1Id="3">Other Official Lists</Description2Name> <Description2Name Description2Id="3" Description1Id="4">Sanctions Lists</Description2Name> <Description2Name Description2Id="4" Description1Id="4">Other Official Lists</Description2Name> <Description2Name Description2Id="5" Description1Id="4">Associated Entity</Description2Name> </Description2List>
<Description2Name>……… </Description2Name>
Diagram
Description Contains the Description2 Details.
Use Required
Type Extension of xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
1 Unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
Description2Id Represents the code value associated with a Description2 value.
xs:string required 4 characters
Description1Id Represents the code value associated with a Description1
xs:string required 4 characters
32 © Copyright 2016 Dow Jones & Company
value.
Children None
Source Schema
<xs:element name="Description2Name"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> <xs:attribute name="Description2Id" type="xs:string" use="required"/> <xs:attribute name="Description1Id" type="xs:string" use="required"/> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element>
Sample Code <Description2Name Description2Id="1" Description1Id="3">Sanctions Lists</Description2Name> <Description2Name Description2Id="2" Description1Id="3">Other Official Lists</Description2Name> <Description2Name Description2Id="3" Description1Id="4">Sanctions Lists</Description2Name> <Description2Name Description2Id="4" Description1Id="4">Other Official Lists</Description2Name> <Description2Name Description2Id="5" Description1Id="4">Associated Entity</Description2Name>
<Description3List>……… </Description3List>
Diagram
Description Contains the master list of Description3 classification applicable to WL and SOC content available in Dow Jones WL-SOC feed.
The Description3 master list is an extensible list and has a potential to change regularly. Updates to this list will be supplied in the look-up table supplied in every feed.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
33 © Copyright 2016 Dow Jones & Company
Attributes None
Children • Description3Name
Source Schema
<xs:element name="Description3List"> <xs:complexType> <xs:sequence> <xs:element ref="Description3Name" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <Description3List> <Description3Name Description3Id="1" Description2Id="3">Ship</Description3Name> <Description3Name Description3Id="2" Description2Id="3">Company</Description3Name> <Description3Name Description3Id="3" Description2Id="3">Shell Bank</Description3Name> <Description3Name Description3Id="4" Description2Id="3">Government Entity</Description3Name> </Description3List>
<Description3Name>……… </Description3Name>
Diagram
Description Contains the Description3 Details
Use Required
Type string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
1 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
Description3Id Represents the code value associated with a Description3
xs:string required 4 characters
34 © Copyright 2016 Dow Jones & Company
value.
Description2Id Represents the code value associated with a Description2 value.
xs:string required 4 characters
Children None
Source Schema
<xs:element name="Description3Name"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> <xs:attribute name="Description3Id" type="xs:string" use="required"/> <xs:attribute name="Description2Id" type="xs:string" use="required"/> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element>
Sample Code <Description3Name Description3Id="1" Description2Id="3">Ship</Description3Name> <Description3Name Description3Id="2" Description2Id="3">Company</Description3Name> <Description3Name Description3Id="3" Description2Id="3">Shell Bank</Description3Name> <Description3Name Description3Id="4" Description2Id="3">Government Entity</Description3Name>
<DateTypeList>……… </DateTypeList >
Diagram
Description Contains the master list of Date Types available in Dow Jones content applicable to Watchlist and State Owned Company content.
The Date Type master list is an extensible list and has a potential to change regularly. Updates to this list will be supplied in the look-up table supplied in every feed.
Use Required
Type None
Max Length NA
35 © Copyright 2016 Dow Jones & Company
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • DateType
Source Schema
<xs:element name="DateTypeList"> <xs:complexType> <xs:sequence> <xs:element ref="DateType" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <DateTypeList> <DateType RecordType="Person" Id="1" name="Date of Birth"/> <DateType RecordType="Person" Id="2" name="Deceased Date"/> <DateType RecordType="Entity" Id="3" name="Date of Registration"/> </DateTypeList>
<DateType>……… </DateType>
Diagram
Description Contains the Date Type Details
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 Unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
RecordType Represents the Record Type value associated with the Date Type.
xs:NMTOKEN required 6 characters
36 © Copyright 2016 Dow Jones & Company
Value Description
Person Specifies that the record is of a person type
Entity Specifies that the record is of an entity type.
Id Represents the code value associated with a Date Type value.
xs:string required 4 characters
name Represents the date Type name (descriptor) associated with the corresponding ID.
xs:string required 255 characters
Children None
Source Schema
<xs:element name="DateType"> <xs:complexType> <xs:attribute name="RecordType" use="required"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="Person"/> <xs:enumeration value="Entity"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name="Id" type="xs:string" use="required"/> <xs:attribute name="name" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <DateType RecordType="Person" Id="1" name="Date of Birth"/> <DateType RecordType="Person" Id="2" name="Deceased Date"/> <DateType RecordType="Entity" Id="3" name="Date of Registration"/>
<NameTypeList>……… </NameTypeList >
37 © Copyright 2016 Dow Jones & Company
Diagram
Description Contains the master list of Name Types available in Dow Jones content.
The Name Type master list is an extensible list and has a potential to change regularly. Updates to this list will be supplied in the look-up table supplied in every feed.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • NameType
Source Schema
<xs:element name="NameTypeList"> <xs:complexType> <xs:sequence> <xs:element ref="NameType" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <NameTypeList> <NameType NameTypeID="1" RecordType="Person">Primary Name</NameType> <NameType NameTypeID="2" RecordType="Person">Also Known As</NameType> <NameType NameTypeID="3" RecordType="Person">Low Quality AKA</NameType> <NameType NameTypeID="4" RecordType="Person">Maiden Name</NameType> </NameTypeList>
<NameType>……… </NameType>
38 © Copyright 2016 Dow Jones & Company
Diagram
Description Contains the Name Type Details
Use Required
Type Extension of xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
1 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
RecordType Represents the Record Type value associated with the Name Type. Possible Values are: Value Description
Person Specifies that the record is of a person type
Entity Specifies that the record is of an entity type.
xs:NMTOKEN required 6 characters
NameTypeId Represents the code value associated with a Name Type value.
xs:string required 4 characters
Children None
Source Schema
<xs:element name="NameType"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> <xs:attribute name="NameTypeID"
39 © Copyright 2016 Dow Jones & Company
type="xs:string" use="required"/> <xs:attribute name="RecordType" use="required"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="Person"/> <xs:enumeration value="Entity"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element>
Sample Code <NameType NameTypeID="1" RecordType="Person">Primary Name</NameType> <NameType NameTypeID="2" RecordType="Person">Also Known As</NameType> <NameType NameTypeID="3" RecordType="Person">Low Quality AKA</NameType>
<RoleTypeList>……… </RoleTypeList >
Diagram
Description Contains the master list of Role Types available in Dow Jones content.
The Role Type master list is an extensible list and has a potential to change regularly. Updates to this list will be supplied in the look-up table supplied in every feed.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • RoleType
Source Schema
<xs:element name="RoleTypeList"> <xs:complexType> <xs:sequence> <xs:element ref="RoleType" maxOccurs="unbounded"/> </xs:sequence>
40 © Copyright 2016 Dow Jones & Company
</xs:complexType> </xs:element>
Sample Code <RoleTypeList> <RoleType Id="1" name="Primary Occupation"/> <RoleType Id="2" name="Other Roles"/> <RoleType Id="3" name="Previous Roles"/> </RoleTypeList>
<RoleType>……… </RoleType>
Diagram
Description Contains the Role Type Details
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
Id Represents the Id value associated with a role Type
xs:string required 4 characters
name Represents the Role Type name (descriptor) associated with the corresponding Id.
xs:string required 255 characters
Children None
Source Schema
<xs:element name="RoleType"> <xs:complexType> <xs:attribute name="Id" type="xs:string" use="required"/> <xs:attribute name="name" type="xs:string" use="required"/> </xs:complexType> </xs:element>
41 © Copyright 2016 Dow Jones & Company
Sample Code <RoleType Id="1" name="Primary Occupation"/> <RoleType Id="2" name="Other Roles"/> <RoleType Id="3" name="Previous Roles"/>
<Records>……… </Records>
Diagram
Description The outer container for all elements pertaining to a Person or an Entity falling under WL-SOC content.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • Person
• Entity Source Schema
<xs:element name="Records"> <xs:complexType> <xs:sequence> <xs:sequence> <xs:element ref="Person" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="Entity" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <Records> +<Person id="14245" action="chg" date="24-Jun-2015"> +<Entity id="135133" action="chg" date="17-Oct-2015"> </Records>
42 © Copyright 2016 Dow Jones & Company
<Person>……… </Person>
Diagram
Description Contains a list of specific information pertaining to Person profiles falling under WL-SOC content.
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
43 © Copyright 2016 Dow Jones & Company
0 unbounded
Attributes Attribute Name
Attribute Description Type Use Max length
id Represents a unique identifier for a Dow Jones Profile
xs:string required 4 bytes (integer)
action Represents an action value. Possible values are:
Value Description
Add Newly added Profile
Del Deleted Profile
Chg Modified Profile
For a Deleted person record only the Descriptions Tag would be mandatory.
xs:NMTOKEN required 3 characters
date Represents the date value when the record was created/modified/deleted.
*This is derived based on the rules below:
a) If the record is a WL+SOC record, the date will be the max value of WL and SOC LRD dates.
b) If the record is pure WL, the date will be
xs:string required 12 characters
44 © Copyright 2016 Dow Jones & Company
WL LRD date.
c) If the record is pure SOC, the date will be SOC LRD date.
Format is dd-mmm-ccyy where,
Value Description
ccyy Represents the year
mmm Represents the name of the month
Dd Represents a day
Children • Gender • ActiveStatus • Deceased • NameDetails • Descriptions • RoleDetail
• DateDetails • BirthPlace
• SanctionsReferences • Address • CountryDetails • IDNumberTypes • ProfileNotes • SourceDescription
• Images
Source Schema
<xs:element name="Person"> <xs:complexType> <xs:sequence> <xs:element ref="Gender" minOccurs="0"/> <xs:element ref="ActiveStatus" minOccurs="0"/> <xs:element ref="Deceased" minOccurs="0"/> <xs:element ref="NameDetails" minOccurs="0"/> <xs:element ref="Descriptions" minOccurs="0"/> <xs:element ref="RoleDetail" minOccurs="0"/> <xs:element ref="DateDetails" minOccurs="0"/> <xs:element ref="BirthPlace" minOccurs="0"/> <xs:element ref="SanctionsReferences" minOccurs="0"/> <xs:element ref="Address" minOccurs="0" maxOccurs="unbounded"/>
45 © Copyright 2016 Dow Jones & Company
<xs:element ref="CountryDetails" minOccurs="0"/> <xs:element ref="IDNumberTypes" minOccurs="0"/> <xs:element ref="ProfileNotes" minOccurs="0"/> <xs:element ref="SourceDescription" minOccurs="0"/> <xs:element ref="Images" minOccurs="0"/> </xs:sequence> <xs:attribute name="id" type="xs:string" use="required"/> <xs:attribute name="action" use="required"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="del"/> <xs:enumeration value="chg"/> <xs:enumeration value="add"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name="date" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <Person id="14245" action="chg" date="24-Jun-2015"> <Gender>Male</Gender> <ActiveStatus>Inactive</ActiveStatus> <Deceased>Yes</Deceased> + <NameDetails> + <Descriptions> + <DateDetails> +<BirthPlace> +<Address> + <CountryDetails> + <IDNumberTypes> +<ProfileNotes> +<SourceDescription> +<Images> </Person>
<Entity>……… </Entity>
46 © Copyright 2016 Dow Jones & Company
Diagram
Description Contains a list of specific information pertaining to all Entity profiles.
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 unbounded
47 © Copyright 2016 Dow Jones & Company
Attributes Attribute Name
Attribute Description Type Use Max length
id Represents a unique identifier for a Dow Jones entity Profile
xs:string required 4 bytes (integer)
action Represents an action value. Possible values are:
Value Description
add Newly added Profile
del Deleted Profile
chg Modified Profile
For a Deleted entity record only the Descriptions Tag would be mandatory.
xs:NMTOKEN required 3 characters
date Represents the date value when the record was created/modified/deleted
*This is derived based on the rules below:
d) If the record is a WL+SOC record, the date will be the max value of WL and SOC LRD dates.
e) If the record is pure WL, the date will be WL LRD date.
xs:string required 12 characters
48 © Copyright 2016 Dow Jones & Company
f) If the record is pure SOC, the date will be SOC LRD date.
Format is dd-mmm-ccyy where,
Value Description
ccyy Represents the year
mmm Represents the name of the month
dd Represents a day
Children • ActiveStatus • NameDetails • Descriptions • DateDetails • SanctionsReferences • CompanyDetails
• VesselDetails • CountryDetails • IDNumberTypes • ProfileNotes • SourceDescription
Source Schema
<xs:element name="Entity"> <xs:complexType> <xs:sequence> <xs:element ref="ActiveStatus" minOccurs="0"/> <xs:element ref="NameDetails" minOccurs="0"/> <xs:element ref="Descriptions" minOccurs="0"/> <xs:element ref="DateDetails" minOccurs="0"/> <xs:element ref="SanctionsReferences" minOccurs="0"/> <xs:element ref="CompanyDetails" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="VesselDetails" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="CountryDetails" minOccurs="0"/> <xs:element ref="IDNumberTypes" minOccurs="0"/> <xs:element ref="ProfileNotes" minOccurs="0"/> <xs:element ref="SourceDescription" minOccurs="0"/> </xs:sequence> <xs:attribute name="id" type="xs:string" use="required"/>
49 © Copyright 2016 Dow Jones & Company
<xs:attribute name="action" use="required"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="del"/> <xs:enumeration value="chg"/> <xs:enumeration value="add"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name="date" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <Entity id="853976" action="chg" date="24-Jun-2015"> <ActiveStatus>Inactive</ActiveStatus> <Deceased>Yes</Deceased> + <NameDetails> + <Descriptions> + <DateDetails> +<SanctionsReferences> + <CompanyDetails> +<VesselDetails> + <CountryDetails> + <IDNumberTypes> +<ProfileNotes> +<SourceDescription> </Entity>
<Gender>……… </ Gender>
Diagram
Description Represents the Person's Gender.
Use Optional
Type string
Max Length 6 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema
<xs:element name="Gender" type="xs:string"/>
50 © Copyright 2016 Dow Jones & Company
Sample Code <Gender>Male</Gender>
<ActiveStatus>……… </ActiveStatus>
Diagram
Description Represents the Active Status of the Dow Jones Profile.
An Active tag is applied to the following WL Records records:
• Politically Exposed Persons (PEP’s) with a current Primary Occupation • All Special Interest Persons (SIP’s) with the following criteria:
o SIP’s with at least one current valid Sanctions or Other Official list reference (for example, a list reference that does not have a To date)
o SIP’s who are deceased but still have at least one current valid list reference (for example, a list reference that does not have a To date)
o All SIP’s classified to the Corruption, Financial Crime, Organised Crime, Terror or Trafficking categories, whether dead or alive
• Special Interest Entities (SIE’s) with at least one current valid list reference (i.e. a list reference that does not have a To date)
• All Relatives & Close Associates (RCA’s), unless deceased.
Use Required
Type String
Max Length 8 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema
<xs:element name="ActiveStatus" type="xs:string"/>
Sample Code <ActiveStatus>Active</ActiveStatus>
<Deceased>……… </Deceased>
Diagram
51 © Copyright 2016 Dow Jones & Company
Description Represents if a person is deceased.
Use Required
Type String
Max Length 3 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema
<xs:element name="Deceased" type="xs:string"/>
Sample Code <Deceased>No</Deceased>
<NameDetails>……… </ NameDetails>
Diagram
Description The outer container for all elements pertaining to the name details of the record.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children • Name
Source Schema
<xs:element name="NameDetails"> <xs:complexType> <xs:sequence> <xs:element ref="Name" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
52 © Copyright 2016 Dow Jones & Company
Sample Code <NameDetails> + <Name NameType="Primary Name"> + <Name NameType="Also Known As"> + <Name NameType="Spelling Variation"> </NameDetails>
<Name>……… </Name>
Diagram
Description Contains the name type and name details
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes Attribute Name
Attribute Description Type Use Max length
NameType Represents the type of Name i.e. whether the name is Primary, Also Known As, Spelling Variation etc.
xs:string required 255 characters
Children • NameValue
Source Schema
<xs:element name="Name"> <xs:complexType> <xs:sequence> <xs:element ref="NameValue" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="NameType" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <Name NameType="Primary Name"> +<NameValue> </Name>
53 © Copyright 2016 Dow Jones & Company
<NameValue>……… </ NameValue>
Diagram
Description Contains the names that identify a person or an entity.
A Person record can include any of the following names:
NameValue Description
TitleHonorific Formal or honorific title, e.g. "Lord", "Samdech", "Doctor"
FirstName First given name of person MiddleName Second given name of a person Surname Surname of a person
Suffix Suffixes such as ", Jr.", "Junior", that are associated with a person's name
Maiden Name Surname of a woman before marriage OriginalScriptName Full name in a local non-Latin script SingleStringName A name formatted as a single text string
An Entity record can include any of the following names:
54 © Copyright 2016 Dow Jones & Company
NameValue Description
EntityName An entity’s name – Concatenation of prefix (if available) and firstname
Suffix Suffix of an Entity OriginalScriptName Full name in a local non-Latin script SingleStringName A name formatted as a single text string
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children • TitleHonorific • FirstName • MiddleName • Surname • EntityName • Suffix • OriginalScriptName • SingleStringName
Source Schema
<xs:element name="NameValue"> <xs:complexType> <xs:sequence> <xs:element ref="TitleHonorific" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="FirstName" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="MiddleName" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="Surname" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="MaidenName" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="Suffix" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="EntityName" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="SingleStringName" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="OriginalScriptName" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence>
55 © Copyright 2016 Dow Jones & Company
</xs:complexType> </xs:element>
Sample Code <NameValue> <FirstName>Mohammad</FirstName> <MiddleName>Jamal</MiddleName> <Surname>Khalifa</Surname> <OriginalScriptName>خخللييففةة ججمماالل ممححممدد</OriginalScriptName> </NameValue>
<TitleHonorific>……… </TitleHonorific>
Diagram
Description Represents the Person's Title or Honorific name.
Use Required
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children None
Source Schema
<xs:element name="TitleHonorific" type="xs:string"/>
Sample Code <TitleHonorific>Lieutenant General</TitleHonorific>
<FirstName>……… </FirstName>
Diagram
Description Represents the Person’s First Name.
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
56 © Copyright 2016 Dow Jones & Company
0 unbounded
Attributes None
Children None
Source Schema
<xs:element name="FirstName" type="xs:string"/>
Sample Code <FirstName>Win</FirstName>
<MiddleName>……… </MiddleName>
Diagram
Description Represents the Person’s Middle Name.
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children None
Source Schema
<xs:element name="MiddleName" type="xs:string"/>
Sample Code <MiddleName>Thambi</MiddleName>
<Surname>……… </Surname>
Diagram
Description Represents the Person’s Surname.
Use Optional
Type xs:string
Max Length 255 characters
57 © Copyright 2016 Dow Jones & Company
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children None
Source Schema
<xs:element name="Surname" type="xs:string"/>
Sample Code <Surname>Myint</Surname>
<MaidenName>……… </MaidenName>
Diagram
Description Represents the Person’s Maiden Name.
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children None
Source Schema
<xs:element name="MaidenName" type="xs:string"/>
Sample Code <MaidenName>Madikizela</MaidenName>
<EntityName>……… </EntityName>
Diagram
Description Represents the Entity Name. (Concatenation of prefix (if available) and firstname.)
Use Optional
Type xs:string
58 © Copyright 2016 Dow Jones & Company
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children None
Source Schema
<xs:element name="EntityName" type="xs:string"/>
Sample Code <EntityName>Morgan Stanley & Co</EntityName>
<Suffix>……… </Suffix>
Diagram
Description Represents the Person’s / Entity’s Suffix.
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children None
Source Schema
<xs:element name="Suffix" type="xs:string"/>
Sample Code <Suffix>Jr</Suffix>
<OriginalScriptName>……… </OriginalScriptName>
Diagram
Description Represents the Original Script Name of a Person or an Entity.
Use Optional
59 © Copyright 2016 Dow Jones & Company
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children None
Source Schema
<xs:element name="OriginalScriptName" type="xs:string"/>
Sample Code <OriginalScriptName>ككننععــاانن غغااززيي</OriginalScriptName>
<SingleStringName>……… </SingleStringName>
Diagram
Description Represents the Single String Name of a Person or an Entity
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children None
Source Schema
<xs:element name="SingleStringName" type="xs:string"/>
Sample Code <SingleStringName>Fathur Rohman Al-Ghozi</SingleStringName>
<Descriptions>……… </Descriptions>
60 © Copyright 2016 Dow Jones & Company
Diagram
Description Contains Description categories of profiles that are falling under Dow Jones WL-SOC feed criteria.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • Description
Source Schema
<xs:element name="Descriptions"> <xs:complexType> <xs:sequence> <xs:element ref="Description" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <Descriptions> <Description Description1="4" Description2="4"/> </Descriptions>
<Description>……… </Description>
Diagram
Description Contains Description1, Description2 and Description3 details of a content type.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
61 © Copyright 2016 Dow Jones & Company
0 Unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
Description1 Represents the person's or an entity’s Description 1 classification value.
xs:string required 4 characters
Description2 Represents the person's or an entity’s Description 2classification value.
xs:string optional 4 characters
Description3 Represents the person's or an entity’s Description 3 classification value.
xs:string optional 4 characters
Children None
Source Schema
<xs:element name="Description"> <xs:complexType> <xs:attribute name="Description1" type="xs:string" use="required"/> <xs:attribute name="Description2" type="xs:string"/> <xs:attribute name="Description3" type="xs:string"/> </xs:complexType> </xs:element>
Sample Code < <Descriptions> <Description Description1="3" Description2="1" /> <Description Description1="3" Description2="2" /> <Description Description1="3" Description2="6" /> </Descriptions>
<RoleDetail>……… </RoleDetail>
Diagram
Description The outer element for role details for the person profiles falling under WL-SOC content
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
62 © Copyright 2016 Dow Jones & Company
0 1
Attributes None
Children • Roles
Source Schema
<xs:element name="RoleDetail"> <xs:complexType> <xs:sequence> <xs:element ref="Roles" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <RoleDetail> <Roles RoleType="Primary Occupation"> <OccTitle OccCat="16">Deceased</OccTitle> </Roles> </RoleDetail>
<Roles>……… </Roles>
Diagram
Description Contains role details for person profiles grouped as per role type that are falling under Dow Jones WL-SOC feed.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
RoleType Represents whether the Role is Primary, Other Role or a Previous Role.
xs:string required 255 characters
Children • OccTitle
63 © Copyright 2016 Dow Jones & Company
Source Schema
<xs:element name="Roles"> <xs:complexType> <xs:sequence> <xs:element ref="OccTitle" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="RoleType" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <Roles RoleType="Primary Occupation"> <OccTitle OccCat="16">Deceased</OccTitle> </Roles>
<OccTitle>……… </OccTitle>
Diagram
Description Contains Occupation details per role type for person profiles that are falling under Dow Jones WL-SOC feed.
Use Required
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
SinceDay Represents day part of the Since Date in ‘dd’ format
xs:string optional 2 characters
SinceMonth Represents month part of the Since Date in ‘Mmm’
xs:string optional 3 characters
64 © Copyright 2016 Dow Jones & Company
format SinceYear Represents the
year part of the Since Date in ‘CCYY’ format
xs:string optional 4 characters
ToDay Represents day part of the To Date in ‘dd’ format
xs:string optional 2 characters
ToMonth Represents month part of the To Date in ‘Mmm’ format
xs:string optional 3 characters
ToYear REPRESENTS THE YEAR PART OF THE TO DATE IN ‘CCYY’ FORMAT
xs:string optional 4 characters
OccCat CONTAINS A CODE VALUE THAT CORRESPONDS TO AN OCCUPATION/PROFESSION.
xs:string optional 2 characters
Children None
Source Schema
<xs:element name="OccTitle"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> <xs:attribute name="SinceDay" type="xs:string"/> <xs:attribute name="SinceMonth" type="xs:string"/> <xs:attribute name="SinceYear" type="xs:string"/> <xs:attribute name="ToDay" type="xs:string"/> <xs:attribute name="ToMonth" type="xs:string"/> <xs:attribute name="ToYear" type="xs:string"/> <xs:attribute name="OccCat" type="xs:string"/> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element>
Sample Code <OccTitle SinceDay="08" SinceMonth="Dec" SinceYear="1976" ToDay="14" ToMonth="Jul" ToYear="1978" OccCat="1">Prime Minister of Central African Republic</OccTitle>
<DateDetails>……… </DateDetails>
65 © Copyright 2016 Dow Jones & Company
Diagram
Description The outer container for all elements pertaining to the date details of all the profiles that falls into the Dow Jones WL-SOC feed.
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children • Date
Source Schema
<xs:element name="DateDetails"> <xs:complexType> <xs:sequence> <xs:element ref="Date" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <DateDetails> + <Date DateType="Date of Birth"> + <Date DateType="Deceased Date"> </DateDetails>
<Date>……… </Date>
Diagram
Description Contains the date type and value details
Use Required
66 © Copyright 2016 Dow Jones & Company
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
DateType Represents whether the Date is Date Of Birth, Deceased Date for person records and date of registration for entities.
xs:string required 255 characters
Children • DateValue
Source Schema
<xs:element name="Date"> <xs:complexType> <xs:sequence> <xs:element ref="DateValue" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="DateType" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <Date DateType="Deceased Date"> <DateValue Day="23" Month="Jun" Year="2009"/> </Date>
<DateValue>……… </DateValue>
Diagram
Description Contains the date value details
Use Required
67 © Copyright 2016 Dow Jones & Company
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 Unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
Day Represents day part of the Date in ‘dd’ format
xs:string optional 2 characters
Month Represents month part of the Date in ‘Mmm’ format
xs:string optional 3 characters
Year Represents the year part of the Date in ‘CCYY’ format
xs:string optional 4 characters
Dnotes Contains notes associated with the date value.
xs:string optional 255 characters
Children None
Source Schema
<xs:element name="DateValue"> <xs:complexType> <xs:attribute name="Day" type="xs:string"/> <xs:attribute name="Month" type="xs:string"/> <xs:attribute name="Year" type="xs:string"/> <xs:attribute name="Dnotes" type="xs:string"/> </xs:complexType> </xs:element>
Sample Code <DateValue Day="04" Month="Apr" Year="1951" Dnotes="official date of birth"/> <DateValue Day="05" Month="Aug" Year="1952"/>
<BirthPlace>……… </BirthPlace>
Diagram
Description The outer container for a person’s place of birth value(s)
Use Optional
Type None
68 © Copyright 2016 Dow Jones & Company
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children • Place
Source Schema
<xs:element name="BirthPlace"> <xs:complexType> <xs:sequence> <xs:element ref="Place" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <BirthPlace> <Place name="Peam Koh Sna Commune, Stoeung Trang District of Kampong Cham Province, Cambodia"/> </BirthPlace>
<Place>……… </Place>
Diagram
Description Place Contains the concatenation of City of Birth and Country value of Birth with comma separated. If City of Birth is not available only Country of Birth will be written and vice versa.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 Unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
Name Contains value of the place of birth
xs:string required 100 characters
69 © Copyright 2016 Dow Jones & Company
name.
Children None
Source Schema
<xs:element name="Place"> <xs:complexType> <xs:attribute name="name" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <Place name="Tel Mond, Israel"/> <Place name="Phnom Penh, Cambodia"/>
<SanctionsReferences>……… </SanctionsReferences>
Diagram
Description The outer container for a person’s or an entity’s Sanction Reference(s).
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children • Reference
Source Schema
<xs:element name="SanctionsReferences"> <xs:complexType> <xs:sequence> <xs:element ref="Reference" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <SanctionsReferences> <Reference>1</Reference> <Reference>263</Reference> <Reference SinceDay="10" SinceMonth="Jun" SinceYear="2009">285</Reference> </SanctionsReferences>
70 © Copyright 2016 Dow Jones & Company
<Reference>……… </Reference>
Diagram
Description Contains the details of the Sanction/Other Official reference for a person or an entity.
Use Required
Type xs:string
Max Length 4 characters
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
SinceDay Represents day part of the Date in ‘dd’ format Since the person or entity has reference to the Sanctions list
xs:string optional 2 characters
SinceMonth Represents month part of the Date in ‘Mmm’ format Since the person or entity has reference to the Sanctions list
xs:string optional 3 characters
SinceYear Represents the year part of the Date in ‘CCYY’ format Since the person or entity has reference to the Sanctions list
xs:string optional 4 characters
71 © Copyright 2016 Dow Jones & Company
ToDay Represents day part of the Date in ‘dd’ format up to which the person or entity has reference to the Sanctions list
xs:string optional 2 characters
ToMonth Represents month part of the Date in ‘Mmm’ format up to which the person or entity has reference to the Sanctions list
xs:string optional 3 characters
ToYear REPRESENTS THE YEAR PART OF THE DATE IN ‘CCYY’ FORMAT UP TO WHICH THE PERSON OR ENTITY HAS REFERENCE TO THE SANCTIONS LIST
xs:string optional 4 characters
Children None
Source Schema
<xs:element name="Reference"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> <xs:attribute name="SinceDay" type="xs:string"/> <xs:attribute name="SinceMonth" type="xs:string"/> <xs:attribute name="SinceYear" type="xs:string"/> <xs:attribute name="ToDay" type="xs:string"/> <xs:attribute name="ToMonth" type="xs:string"/> <xs:attribute name="ToYear" type="xs:string"/> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element>
Sample Code <SanctionsReferences> <Reference>1</Reference> <Reference>263</Reference> <Reference SinceDay="10" SinceMonth="Jun" SinceYear="2009">285</Reference> </SanctionsReferences>
<VesselDetails>……… </VesselDetails>
72 © Copyright 2016 Dow Jones & Company
Diagram
Description Contains the elements that have values of Details of a Vessel Entity
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children • VesselCallSign • VesselType • VesselTonnage • VesselGRT • VesselOwner • VesselFlag
Source Schema
<xs:element name="VesselDetails"> <xs:complexType> <xs:sequence> <xs:element ref="VesselCallSign" minOccurs="0"/> <xs:element ref="VesselType" minOccurs="0"/> <xs:element ref="VesselTonnage" minOccurs="0"/> <xs:element ref="VesselGRT" minOccurs="0"/> <xs:element ref="VesselOwner" minOccurs="0"/> <xs:element ref="VesselFlag" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <VesselDetails> <VesselCallSign>P32C3</VesselCallSign> <VesselType>General Cargo</VesselType> <VesselTonnage>15088</VesselTonnage>
73 © Copyright 2016 Dow Jones & Company
<VesselGRT>8909</VesselGRT> <VesselOwner>Alaminos Shipping Co. Ltd.</VesselOwner> <VesselFlag>CYPR</VesselFlag> </VesselDetails>
<VesselCallSign>……… </VesselCallSign>
Diagram
Description Contains the Vessel Call sign value.
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema
<xs:element name="VesselCallSign" type="xs:string"/>
Sample Code <VesselCallSign>P32C3</VesselCallSign>
<VesselType>……… </VesselType>
Diagram
Description Contains the Vessel Type value.
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 1
74 © Copyright 2016 Dow Jones & Company
Attributes None
Children None
Source Schema
<xs:element name="VesselType" type="xs:string"/>
Sample Code <VesselType>General Cargo</VesselType>
<VesselTonnage>……… </VesselTonnage>
Diagram
Description Contains the Vessel Tonnage value.
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema
<xs:element name="VesselTonnage" type="xs:string"/>
Sample Code <VesselTonnage>15088</VesselTonnage>
<VesselGRT>……… </VesselGRT>
Diagram
Description Contains the GRT value for a Vessel Entity
Use Optional
Type xs:string
Max Length 255 characters
75 © Copyright 2016 Dow Jones & Company
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema
<xs:element name="VesselGRT" type="xs:string"/>
Sample Code <VesselGRT>8909</VesselGRT>
<VesselOwner>……… </VesselOwner>
Diagram
Description Contains the Owner Name for a Vessel Entity
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema
<xs:element name="VesselOwner" type="xs:string"/>
Sample Code <VesselOwner>Alaminos Shipping Co. Ltd.</VesselOwner>
<VesselFlag>……… </VesselFlag>
Diagram
Description Contains the Flag (DJII Region Code) value for a Vessel Entity
76 © Copyright 2016 Dow Jones & Company
Use Optional
Type xs:string
Max Length 13 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema
<xs:element name="VesselFlag" type="xs:string"/>
Sample Code <VesselFlag>CYPR</VesselFlag>
<Address>……… </Address>
Diagram
Description Contains the elements that have values of Address details of Person profile.
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children • AddressLine • AddressCity
77 © Copyright 2016 Dow Jones & Company
• AddressCountry • URL
Source Schema
<xs:element name="Address"> <xs:complexType> <xs:sequence> <xs:element ref="AddressLine" minOccurs="0"/> <xs:element ref="AddressCity" minOccurs="0"/> <xs:element ref="AddressCountry" minOccurs="0"/> <xs:element ref="URL" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <Address> <AddressLine>Karkh District</AddressLine> <AddressCity>Baghdad</AddressCity> <AddressCountry>IRAQ</AddressCountry> </Address>
<CompanyDetails>……… </CompanyDetails> Diagram
Description Contains the elements that have values of Company details of entity profile.
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes None
Children • AddressLine • AddressCity • AddressCountry • URL
Source <xs:element name="CompanyDetails">
78 © Copyright 2016 Dow Jones & Company
Schema <xs:complexType> <xs:sequence> <xs:element ref="AddressLine" minOccurs="0" maxOccurs="1"/> <xs:element ref="AddressCity" minOccurs="0" maxOccurs="1"/> <xs:element ref="AddressCountry" minOccurs="0" maxOccurs="1"/> <xs:element ref="URL" minOccurs="0" maxOccurs="1"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <CompanyDetails> <AddressLine>3 Mandeville Place</AddressLine> <AddressCity>London</AddressCity> <AddressCountry>UK</AddressCountry> </CompanyDetails>
<AddressLine>……… </AddressLine>
Diagram
Description Contains the Address Line of an entity or a person.
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 1
Children None
Source Schema <xs:element name="AddressLine" type="xs:string"/>
Sample Code <AddressLine>1585 Broadway</AddressLine>
<AddressCity>……… </AddressCity>
Diagram
Description Address City will be concatenation of City, State/Province and zip code with symbol semicolon “;" and is less than 255 else concatenation of city and State/Province with symbol semicolon “;” and is less than 255 else only city will
79 © Copyright 2016 Dow Jones & Company
be included in the feed. If City value is not available and concatenation of State/Province and zip code information is available then semicolon will still be available prefixing State/Province.
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema
<xs:element name="AddressCity" type="xs:string"/>
Sample Code <AddressCity>Norcross;Georgia;30092</AddressCity>
<AddressCountry>……… </AddressCountry>
Diagram
Description Contains the code (DJII Region Code) of the country as a part of the non ship Entity or a person address
Use Optional
Type xs:string
Max Length 13 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema <xs:element name="AddressCountry" type="xs:string"/>
Sample Code <AddressCountry>USA</AddressCountry>
80 © Copyright 2016 Dow Jones & Company
<URL>……… </URL>
Diagram
Description Contains the URL address as a part of the non-ship Entity or a person address. This field may contain non-Latin characters.
Use Optional
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema <xs:element name="URL" type="xs:string"/>
Sample Code <URL>http://www.morganstanley.com/</URL>
<CountryDetails>……… </CountryDetails>
Diagram
Description The outer container for a person’s or an Entity’s Country details.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children • Country
Source <xs:element name="CountryDetails"> <xs:complexType>
81 © Copyright 2016 Dow Jones & Company
Schema <xs:sequence> <xs:element ref="Country" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <CountryDetails> +<Country CountryType="Citizenship"> +<Country CountryType="Resident of"> </CountryDetails>
<Country>……… </Country>
Diagram
Description Contains the Country type and Country Value.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
CountryType
Represents whether the country information is for person’s Residence country or for which he is a Citizen of. For an entity it represents the country of affiliation
xs:string required 255 characters
Children • CountryValue
Source Schema
<xs:element name="Country"> <xs:complexType> <xs:sequence> <xs:element ref="CountryValue"
82 © Copyright 2016 Dow Jones & Company
maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="CountryType" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <Country CountryType="Citizenship"> <CountryValue Code="IRAQ"/> </Country>
<CountryValue>……… </CountryValue>
Diagram
Description Contains a country Code.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
Code Represents the code value associated with a country.
xs:string required 13 characters
Children None
Source Schema
<xs:element name="CountryValue"> <xs:complexType> <xs:attribute name="Code" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <CountryValue Code="IRAQ"/>
<IDNumberTypes>……… </IDNumberTypes>
83 © Copyright 2016 Dow Jones & Company
Diagram
Description The outer container for all elements pertaining to the Identification details of a Person or Entity.
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children • ID
Source Schema
<xs:element name="IDNumberTypes"> <xs:complexType> <xs:sequence> <xs:element ref="ID" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <IDNumberTypes> +<ID IDType="OFAC Program ID"> +<ID IDType="OFAC Unique ID"> </IDNumberTypes>
<ID>……… </ID>
Diagram
Description Contains the Identification Type and ID Details
Use Optional
Type None
Max Length NA
84 © Copyright 2016 Dow Jones & Company
Occurrences Min Occurrence Max Occurrence
1 Unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
IDType Represents whether the ID type is Passport Number, NationalID, drivers licence number, etc. For an entity the type could be Company ID.
xs:string required 255 characters
Children • IDValue
Source Schema
<xs:element name="ID"> <xs:complexType> <xs:sequence> <xs:element ref="IDValue" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="IDType" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <ID IDType="OFAC Program ID"> <IDValue>BALKANS</IDValue> </ID> <ID IDType="OFAC Unique ID"> <IDValue>7817</IDValue> </ID>
<IDValue>……… </IDValue>
Diagram
Description Contains the ID values for a person or an entity that is part of WL-SOC feed.
Use Required
Type xs:string
Max Length 255 characters
Occurrences Min Occurrence Max Occurrence
85 © Copyright 2016 Dow Jones & Company
0 Unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
IDnotes Contains notes associated with the Identity value.
xs:string required Up to 2,147,483,647 characters
Children None
Source Schema
<xs:element name="IDValue"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> <xs:attribute name="IDnotes" type="xs:string"/> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element>
Sample Code <IDValue IDnotes="German passport issued in Ulm, Germany, valid until 3 Dec. 2011">7020142921</IDValue>
<ProfileNotes>……… </ProfileNotes>
Diagram
Description Profile notes details mapped to WL/SOC or both will be written to the feed.
The order in the profile notes is given below:
Last Review Date Details: Watchlist Last Reviewed Date: Watchlist LRD value State Owned Companies Last Reviewed Date: State Owned Companies LRD value
Record Status:
Watchlist Acitve Status: Watchlist Active status value State Owned Companies Active Status: State Owned Companies Active status value
Watchlist Reported Allegation Details:
Watchlist Crime Details in a strcutured manner
State Owned Companies Stake Level Details: Stake level Details in a structured manner
Subisidary: Subisidary Value
86 © Copyright 2016 Dow Jones & Company
FDS Code: FDS Code value DJII Industry Details: DJII Index value in a structure manner Associated Entity Details: Associated Entity values in a structured manner Watchlist Comments: Watchlist External Comments value
State Owned Companies Comments: State Owned Companies External Comments value
Use Optional
Type xs:string
Max Length Up to 2,147,483,647 characters
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children None
Source Schema
<xs:element name="ProfileNotes" type="xs:string"/>
Sample Code <ProfileNotes> Last Review Date Details: Watchlist Last Reviewed Date: 14-Dec-2015 State Owned Companies Last Reviewed Date: 04-Dec-2015 Record Status: Watchlist Status: Active State Owned Companies Status: Active [Stake Level Details]: Voting Control: Yes Board Appointing Control: Yes Ownership Percentage: Majority-Known Ownership Percentage Status: Current Ownership Percentage Value: 100.000 Subsidiary: No FDS Code: AERCBN DJII Industry Details: itsp(Transportation/Logistics)-i7501(Scheduled Passenger
87 © Copyright 2016 Dow Jones & Company
Airlines) Watchlist Comments: SS&#x0D; SOR TESTING </ProfileNotes>
<SourceDescription>……… </SourceDescription>
Diagram
Description The outer container for the Source elements pertaining to the Sources from where the information for a Person, Entity or an associate was referenced.
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 1
Attributes None
Children • Source
Source Schema
<xs:element name="SourceDescription"> <xs:complexType> <xs:sequence> <xs:element ref="Source" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <SourceDescription> <Source name="http://www.treas.gov/offices/enforcement/ofac/sdn/t11sdn.pdf"/> <Source name="http://www.ustreas.gov/press/releases/hp721.htm"/> </SourceDescription>
<Source>……… </Source>
Diagram
88 © Copyright 2016 Dow Jones & Company
Description The outer container for the Source elements pertaining to the Sources from where the information for a Person, Entity or an associate was referenced.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 1
Attributes Attribute Name
Attribute Description
Type Use Max length
name Contains name of the source.
The Source field may contain non-Latin characters
xs:string required 255 characters
Children None
Source Schema
<xs:element name="Source"> <xs:complexType> <xs:attribute name="name" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <Source name="http://www.treas.gov/offices/enforcement/ofac/sdn/t11sdn.pdf"/> <Source name="http://www.ustreas.gov/press/releases/hp721.htm"/>
<Images>……… </Images>
Diagram
Description Contains the Images URL information for a person.
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 1
89 © Copyright 2016 Dow Jones & Company
Attributes None
Children • Image
Source Schema
<xs:element name="Images"> <xs:complexType> <xs:sequence> <xs:element ref="Image" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <Images> <Image URL="http://www.crimestoppers- uk.org/wanted/images/suspects/BARR_ALAN_1982-07- 18_10000111000000032756322.jpg"/> <Image URL="http://www.crimestoppers- uk.org/wanted/images/suspects/Alan%20BARR.jpg"/> </Images>
<Image>……… </Image>
Diagram
Description Represents source URL of the Person’s image.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
URL Contains Source URL of the Image. The URL values may contain Non-Latin Characters.
xs:string required 255 characters
Children None
Source Schema
<xs:element name="Images"> <xs:complexType> <xs:sequence> <xs:element ref="Image" maxOccurs="unbounded"/>
90 © Copyright 2016 Dow Jones & Company
</xs:sequence> </xs:complexType> </xs:element>
Sample Code <Image URL="http://164.100.24.208/ls/lsmember/13biodata/4249.jpg"/>
<Associations>……… </Associations>
Diagram
Description Represents the associations of a profile with other person or entity.
Use Required
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 1
Attributes None
Children • PublicFigure • SpecialEntity
Source Schema
<<xs:element name="Associations"> <xs:complexType> <xs:sequence> <xs:sequence> <xs:element ref="PublicFigure" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="SpecialEntity" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:sequence> </xs:complexType> </xs:element>
Sample Code <Associations> + <PublicFigure id="14245"> + <PublicFigure id="110846"> </Associations>
91 © Copyright 2016 Dow Jones & Company
<PublicFigure>……… </PublicFigure>
Diagram
Description Represent a person’s and association’s details of these profiles with its associates.
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
id Represents a unique identifier for a public figure. Value: n.
xs:string required 4 bytes (integer)
Children • Associate
Source Schema
<xs:element name="PublicFigure"> <xs:complexType> <xs:sequence> <xs:element ref="Associate" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="id" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code <PublicFigure id="1134216"> <Associate id="1134846" code="1" ex="No"/> <Associate id="1134847" code="17" ex="No"/> <Associate id="1134849" code="16" ex="No"/> </PublicFigure>
<SpecialEntity>……… </SpecialEntity>
92 © Copyright 2016 Dow Jones & Company
Diagram
Description Represent an Entity profiles with its associates
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
0 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
Id Represents a unique identifier for a public figure. Value: n.
xs:string required 4 bytes (integer)
Children • Associate
Source Schema
<xs:element name="SpecialEntity"> <xs:complexType> <xs:sequence> <xs:element ref="Associate" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="id" type="xs:string" use="required"/> </xs:complexType> </xs:element>
Sample Code
93 © Copyright 2016 Dow Jones & Company
<Associate>……… </Associate>
Diagram
Description Contains information about who the public figure or popular entity is associated with and its relationship details
Use Optional
Type None
Max Length NA
Occurrences Min Occurrence Max Occurrence
1 unbounded
Attributes Attribute Name
Attribute Description
Type Use Max length
code Represents a classified code value for Relationship between the public figure and the Associate record.
xs:string required 255 characters
ex Represents a prior or current relationship/association. Possible values are
Value
Description
Yes Represents former relationship/association
No Represents current relationship/asso
xs:NMTOKEN required 3 characters
94 © Copyright 2016 Dow Jones & Company
ciation
id Represents a unique identifier for an associate.
xs:string required 4 bytes (integer)
Children None
Source Schema
<xs:attribute name="ex" use="required"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="Yes"/> <xs:enumeration value="No"/> </xs:restriction> </xs:simpleType> </xs:attribute>
Sample Code <Associate id="1121152" code="2" ex="No"/> <Associate id="1121163" code="8" ex="No"/> <Associate id="1121167" code="3" ex="Yes"/> <Associate id="1121172" code="4" ex="No"/> <Associate id="1121174" code="7" ex="Yes"/>
95 © Copyright 2016 Dow Jones & Company
A P P E N D I X A : A C R O N Y M S
This section lists the most common Acronyms used across this Document.
Acronym Expansion WL Watchlist
SOC State Owned Companies PFA Public Figure & Associates GMT Greenwich Mean Time XML Extensible Mark-up Language XSD XML Schema Definition DTD Document Type Definition DB Database Id Identity
FAQ Frequently Asked Question API Application Programming Interface SAX Simple API for XML DOM Document Object Model HTTP Hypertext Transfer Protocol HTML Hyper Text Mark-up Language
A P P E N D I X B : F R E Q U E N T L Y A S K E D Q U E S T I O N S
The Customer Support Site contains all the latest FAQ’s consolidated in one place and renders all additional information about the Dow Jones WL-SOC Content.
To view all the latest FAQ’s visit Dow Jones Customer Support:
For Any Queries regarding the Dow Jones WL-SOC XML Feeds please contact: Dow Jones Customer Support
Top Related