Energy Upstream

Kingdom® 2017
Direct Connect User Guide
July 2017
 Trademarks and Copyright

Trademarks and Copyright

This manual was produced by IHS Markit.
July 2017
.

1401 Enclave Pkwy Ste 500

Houston, Texas 77077
U.S.A.
Tel: (281) 531-4660
Fax: (832) 531-9966
Website: www.ihs.com/kingdom
Sales: [email protected]
Support: [email protected]
The following trademarks appear in this manual.

IHS Markit Kingdom® software and all of its components, AVOPAK, CGMPAK, GeoSyn®,
LoadPAK, PAKnotes®, Petra®, SynPAK®, Tunnel O, VelPAK®, VuPAK®, Kingdom 1D
Forward Modeling, Kingdom Colored Inversion, The Kingdom Company, Kingdom
Data Management, Kingdom DM Catalog Builder Kingdom Illuminator Kingdom
Seeker, and Kingdom I3D Scan are trademarks of IHS Markit.
Portions of data loading are copyrighted by Blue Marble Geographics.
Mapping API for the Spatial Explorer map provided by Esri ArcGIS Runtime SDK for .NET.
Kingdom Geophysics contains components under U.S. Patent Numbers 6,675,102,
8,265,876, and 9,105,075.

VuPAK® includes OpenInventor® and VolumeViz from FEI Visualization Sciences Group,
Inc. Some components or processes may be licensed under U.S. Patent Number 6,765,570.
Tunnel L+ includes OpenWorks® and SeisWorks® Development Kit from the Halliburton
Corporation.
Kingdom Connect and Tunnel O include OpenSpirit® FrameWork from OpenSpirit, a
TIBCO Software Group Company. Kingdom Data Management includes components from
OpenSpirit and are copyrighted by OpenSpirit, a TIBCO Software Group Company.
Kingdom Gateway plug-in for Petrel* E&P software platform uses the Ocean* software
development framework and * is a mark of Schlumberger.
Kingdom®1D Forward Modeling® includes software developed as part of the NPlot library
project available from: http://www.nplot.com/.
Portions of Kingdom® bitmap graphics are based on GD library by Boutell.Com, Inc. Further
information about the company can be found at www.boutell.com.
PAKnotes TIFF support is based in part on libtiff.

Rock Solid Attributes® is a registered trademark of Rock Solid Images Inc. and contains
confidential, proprietary, and trade secret information of Rock Solid Images Inc. Copyright©
Rock Solid Images Inc. All Rights reserved.

2017 Confidential iii

Trademarks and Copyright

HDF5 (Hierarchical Data Format 5) Software Library and Utilities Copyright 2006-2015 by
The HDF Group. NCSA HDF5 (Hierarchical Data Format 5) Software Library and Utilities
Copyright 1998-2006 by the Board of Trustees of the University of Illinois.
VelPAK and Seismic Inversion are developed by Equipoise Software Ltd on behalf of IHS
Markit.
Microsoft is a registered trademark of Microsoft Corporation. Windows 7, Windows 8
operating systems, MS-DOS and SQL Server are trademarks of Microsoft Corporation.
Oracle® Databases are registered trademarks of Oracle Corporation.
OpenWorks, SeisWorks, Interpret 2000 and Interpret 2003 are registered trademarks of
Halliburton Corporation.
IHS Markit incorporates BMC® AppSight™ Black Box Technology in its software. BMC
Software, BMC Software logos and all other BMC Software product and service names are
registered trademarks or trademarks of BMC Software Inc. © 2009 BMC Software, Inc. All
rights reserved.
All other trademarks are the property of their respective owners.

Copyright Notice
© 2011 - 2017 IHS Markit. For Internal use only. All rights reserved.
This manual contains confidential information and trade secrets proprietary to IHS Markit LTd.
and its affiliated companies (“IHS Markit”). No portion of this manual may be reproduced,
reused, distributed, transmitted, transcribed or stored on any information retrieval system, or
translated into any foreign language or any computer language in any form or by any means
whatsoever without the express written permission of IHS Markit. For more information,
please contact Customer Care at [email protected].

Misuse Disclaimer
IHS Markit makes no representation or warranties of any kind (whether express or implied)
with respect to this manual or the Kingdom® software and to the extent permitted by law, IHS
Markit shall not be liable for any errors or omissions or any loss or damage or expense
incurred by an user. IHS Markit reserves the right to modify the Kingdom® software and any
of the associated user documentation at any time.

Acknowledgments
IHS Markit wishes to gratefully acknowledge the contributions of the many client software
testers in preparing the Kingdom® software. The enthusiastic Beta testers, smoke testers,
and staff greatly appreciate their invaluable feedback and contributions.

2017 Confidential
 Table of Contents

Direct Connect
Direct Connect Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Logging On. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
Understanding Datum Transformation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
Understanding How Direct Connect Processes Well and Production Data . . . .3
Understanding IHS Data Maintenance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Creating Jobs for the US . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Formation top source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Creating Queries for US Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Creating Jobs for International Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
Creating Queries for International Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Scheduling Jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Previewing Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Managing Jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Using the Scheduled Jobs List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Using the All Jobs List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Using the Failed Jobs List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Using the Completed Jobs List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Understanding Job Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Viewing Job Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
Summary Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
Reject Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
UWI Change Control Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Refreshing the Kingdom Project View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

© 2017 IHS Markit. All Rights Reserved. v

vi © 2017 IHS Markit. All Rights Reserved.
 Kingdom® 2017

Direct Connect
Direct Connect enables you to import well and production data from the Enerdeq Browser
directly into Kingdom. You can import any combination of well, allocated production, and
unallocated production data into existing projects or into new projects. The data available for
you to import depends on your IHS Markit subscription. Note that international subscribers
can only import well data. Direct Connect only imports production data for wells that are part
of your Kingdom project.

Tip: View Direct Connect videos posted on the IHS Kingdom website. 

To successfully connect to the Video Library, make sure you have selected to Use
online help in the Help Center. You can also access the full Video Library by clicking
the Knowledge Base and Videos link on the Help Center.

Creating Jobs Create and run jobs based on Enerdeq queries that you have already
created, or queries that you create using Direct Connect.
Creating Jobs for the US
Creating Jobs for International Data

Managing Jobs Once you create jobs, you can manage job schedules and view job
statuses. For completed jobs, you can also view reports that provide
detailed information about the results of each job.

Datum IHS Markit data uses the NAD27 datum or the WGS84 datum, depending
Transformations on whether you are importing US well and production data or international
well data. If the project into which you are importing data uses a different
datum, Direct Connect prompts you to transform the imported data into the
project’s datum. This may be a single- or two-step process, depending on
the project’s datum.

Processing Data Direct Connect processes the data before importing it into Kingdom to
ensure Kingdom can utilize the data.

Related topics
Logging On
Understanding IHS Data Maintenance
Logging On
Wells > Import > Direct Connect
The first time you log on to Direct Connect to create a job or query, you need to select a data
source and provide a user name and password. These are the same credentials you use to
connect to Enerdeq Browser directly. You can connect to either the U.S. or International IHS
web site. You select the web site to connect to and provide the appropriate credentials.
Once you are logged on to Direct Connect, the Create Job window indicates what data
source you are connected to in the upper right corner by displaying either “US” or
“International.” To switch to a different data source, click the name of the current data source.
If you have previously logged on to the new data source, Direct Connect automatically
reconnects using the previously provided credentials. Otherwise, Direct Connect prompts you
for your user name and password.
If you can’t log on, contact Customer Care.

Understanding Datum Transformation

All well and production data that you import into Kingdom with Direct Connect uses either the
NAD27 datum or WGS84 datum. US well and production data uses the NAD27 datum and
international well data uses the WGS84 datum. If the Kingdom project into which you are
importing data uses a different datum, Direct Connect prompts you to transform the data into
the project’s datum. Depending on the datum the project uses, you may need to transform
the datum twice: once into an intermediate datum and a second time into the project’s datum.
If the project already uses a coordinate reference system with the NAD27 or WGS84 datum,
there is no need to perform a datum transformation.
If your project requires a datum transformation, you only need to define the transformation
once. Direct Connect continues to use the same transformation for the project.
In most cases, it is possible to convert from NAD27 or WGS84 to whatever datum the project
uses. There are some instances, especially for non-US coordinate reference systems, where
this may not be possible even with a two-stage datum transformation. Direct Connect
indicates whether or not a datum transformation is possible.
To transform imported data to the project’s datum:
1. If you need to perform a single datum transformation, in the Datum Transformation
window, select the datum transformation that most closely matches the datum of your
Kingdom project from the list of available transformations. The list of datum
transformations available will vary depending on the datum your project uses.
2. If you need to perform two datum transformations, perform the following steps:
a. In the Datum Transformation window select the datum transformation in the
Transformation 1 list that is the most appropriate intermediate transformation.
b. In the Transformation 2 list, select the datum transformation that most closely
matches the datum of your Kingdom project.
3. Click OK.

2 © 2017 IHS Markit. All Rights Reserved.

 Note: The Name field in the list of available datum transformations may indicate a
transformation from NAD27 or WGS84 to another datum. Please disregard this
name. It is a default based on the fact that the datum transformations work in both
directions. Direct Connect always transforms from NAD27 or WGS84 to the
Kingdom project’s coordinate reference system, not the other way around.

State Plane 1927 Exact Coordinate Reference System

All well and production data for the US that you import into Kingdom with Direct Connect uses
the State Plane 1927 Exact coordinate reference system. If you are updating existing wells in
a project that uses the State Plane 1927 coordinate reference system, you may see slight
differences in XY coordinates for any updated wells due to differences between the State
Plane 1927 Exact and State Plane 1927 coordinate reference systems.

Related topics
Direct Connect Overview
Understanding How Direct Connect Processes Well and Production Data
Understanding IHS Data Maintenance

Understanding How Direct Connect Processes Well and

Production Data
Direct Connect does not import data directly into Kingdom. Instead it runs a variety of checks
and conversions to ensure the data imported is correct and matches the settings of the
current project:
• Any data that does not provide location information is excluded from Kingdom. Kingdom
requires location information to work correctly.
• If the data contains null values for data elements and Kingdom contains values for these
same elements, Direct Connect does not overwrite any existing values with null values.
Kingdom does this to preserve what may be more current and accurate data available in
your Kingdom project.
• Kingdom converts units of measure in the data to be imported to the units of measure
used by the current project. This ensures the consistency of the new data with any data
that is already part of the project.
• Kingdom converts final well status codes in the data to be imported to the appropriate well
status types in Kingdom.
Direct Connect gives you the option to import both allocated and unallocated production data
with the same query (this applies only to US well and production data). If you are importing
data from a region that has wells with both allocated and unallocated production data and you
choose to import both, this could result in reduced performance due to the amount of data
returned by the query. Importing allocated and unallocated production records for a well will
not result in duplicate production records for that well in Kingdom.
If you import production data into the Kingdom database Kingdom does not automatically
calculate cumulative totals for the imported data. To calculate cumulative totals, from the
Kingdom Wells menu, click Production Data > Calculate Cumulative.

© 2017 IHS Markit. All Rights Reserved. 3

When importing international well data, Kingdom always includes ground-level elevation in
the Surface Elevation field. If another elevation reference is also available, Kingdom includes
that as well. If the elevation reference for the additional elevation data is defined as Rotary
Top, Kingdom changes this to Derrick Floor.

Related topics
Direct Connect Overview
Understanding IHS Data Maintenance

Understanding IHS Data Maintenance

The IHS server undergoes regular maintenance to update the database with new and
updated well and production records. While this update is taking place, the IHS server is
unavailable. If you have scheduled a job to run while the IHS server is undergoing
maintenance, Direct Connect will periodically attempt to resume the job until the IHS server
becomes available again and Direct Connect can run the job.
If you are using Direct Connect while the IHS server is undergoing maintenance, you will be
unable to perform any operations that require database access. This includes logging on to
the IHS server, creating queries, and running jobs. All other functionality remains available to
you.

Related topics
Direct Connect Overview
Understanding How Direct Connect Processes Well and Production Data

4 © 2017 IHS Markit. All Rights Reserved.

 Creating Jobs for the US

Creating Jobs for the US

Wells > Import > Direct Connect > Create
Use the Direct Connect - Create Jobs window to create jobs that import data into Kingdom.
When creating a job to import data into Kingdom, you can define several job options:
• The kind of data to import (well data, allocated production data, and/or unallocated
production data)
• Whether to truncate well API/UWI numbers to 12 or 14 characters
• Formation top source
• The import method to use (add, update, add/update)
• Whether to define any bounds for the data (project bounds, digitized area, or custom
bounds)
• What query to use (whether an existing or a new query)
• Whether to limit the import job to wells in one or more static subsets
At a minimum, you must define the kind of data to import and either the query to use, a
subset or subsets to use, or a set of bounds. If you do not specify any bounds or subsets, the
query you use can include data from anywhere in the world. If you do not specify a query or
subsets, Direct Connect imports data for all wells found within the defined bounds. Specifying
one or more subsets limits the imported data to wells in the selected subset(s). If you define
bounds as well as specify one or more subsets, the query will exclude any wells outside the
bounds even if they are included in the specified subset(s).
The queries that Direct Connect uses are queries created on the IHS web site, unless you
use Direct Connect to create a new well query. Well queries you create in Direct Connect are
saved on the IHS web site. For more information about creating well queries in Direct
Connect, see Creating Queries for US Jobs.
To create a new data import job:
1. From the Kingdom main menu, select Wells > Import > Direct Connect.
2. Click Create.
3. If you are connecting to the IHS database for the first time with Direct Connect, you must
select the US data source and provide your IHS username and password. You are only
prompted for these credentials once. Direct Connect continues to use these credentials
each time you connect.

Note: If your credentials change for any reason, Direct Connect will prompt you to enter
your new credentials.

4. Select the corresponding check boxes to define the type of data you want to import into
Kingdom. You can select any combination of well data, allocated production data, and
unallocated production data. For well data, you can also select the specific types of well
data you want to import. By default, all well data types are selected. For more information

© 2017 IHS Markit. All Rights Reserved. 5

Creating Jobs for the US

about how Direct Connect handles well and production data, see Understanding How
Direct Connect Processes Well and Production Data.
Direct Connect only imports production data for wells that are part of your Kingdom
project. You cannot import production data into a project that has no wells. If your query
includes well data, Direct Connect imports the well data before it imports any production
data. This ensures any production data for the wells in your query is also imported. If you
are importing production data into an empty project, Direct Connect only imports
production data related to any wells that are also part of the query.
5. Choose whether to truncate any well API/UWI numbers in the data to 12 characters (the
default is a14-digit well API/UWI number).
Truncating UWI numbers may result in duplicate UWI numbers in the project. Should this
occur, Kingdom retains the first well data imported into Kingdom from IHS. Since
Kingdom sorts well data by 14-digit UWI number in ascending order prior to importing and
truncating, data imported for any well with a duplicate 12-digit UWI number is always
based on the well with the lowest 14-digit UWI number prior to truncation to 12 digits. This
is always the 00 well (12-digit UWI + 00). If your project has well data for a subsequent
well number (12-digit duplicate UWI + 01 or greater), this data is ignored.
6. Select the method you want to use for importing the data. Your choices include the
following:
• Add and Update: Adds new wells in the query that are not in the project and updates
existing well data. This is the default.
• Add New: Adds new wells in the query that are not in the project. Existing well data is
not updated.
• Update existing: Updates well data for existing wells only. Ignores any new wells in
the query that are not in the project.

Note: If you are importing allocated or unallocated production data, any new or
updated production data is imported into your project regardless of the import
method you select. This includes production data for new wells added to your
project with the query or new production data for wells already in your project
that did not have any previous production data.

7. If you are importing formation tops, choose whether to limit the formation top data to
specific IHS sources. Select the check box next to each data source you want to include.
8. If you are importing formation tops, choose whether to update any formation tops already
in your project with the correct formation top name. This option replaces old IHS
formation top names, which were only abbreviations, with the correct formation top
names. If you do not select this option you could end up with duplicate formation tops.
9. If you are importing production data, you have the option to put all production data for
each borehole into the initial completion. To do this, select the Load production data
into initial completion option.
10. If you want to include the alternate UWI number for the boreholes you are importing,
select the Import Alternate UWI option.

6 © 2017 IHS Markit. All Rights Reserved.

 Creating Jobs for the US

11. Choose whether to limit the data you import to a specified set of bounds. You can limit
data according to the project bounds, an area you digitize on the base map, or by custom
bounds you enter using either X/Y or Lat/Long values. This option is turned off by default.
a. If you click Use Project Bounds, Direct Connect uses the bounds of the current
project to define the wells for which it will query data.
b. If you click Digitize on Base Map, then draw a rectangle on the base map
surrounding the wells you are interested in.
c. If you click Use Custom Bounds, then provide the X/Y or Lat/Long coordinates for
the area of interest. If you select Lat/Long, you must also specify whether these
coordinates are shown as DD or DMS.
12. If you want, select a query to use to locate data in the database. Select All existing to
pick a query you have already created on the IHS web site or select New well query to
create a new query. For more information about creating new queries, see Creating
Queries for US Jobs.

Note: If you want to filter the list of available queries to include only queries for a
particular type of data, select the corresponding button above the query list.

13. If you want, select Subsets to display a list of available subsets, then select one or more
subsets to use for your query. Selecting subsets limits query results to wells contained in
the selected subsets.
14. Provide a name for the job you are creating in the Job Name field. Direct Connect
provides a default name that you can modify as needed.
15. If you want to preview the data that the query retrieves before saving and scheduling the
job, click Preview. This opens the Job Preview window. For more information about
previewing a job, see Previewing Jobs.
16. Click Create, and then choose whether to run your job now, schedule it for a later time, or
simply save the job. If you choose to save the job, you can always schedule it to run at
another time.

Note: You may have the option to connect directly to a database that is internal to your
company rather than accessing the Enerdeq database. If that is the case, you can
configure Direct Connect to use this internal database by clicking the Direct
Connect Settings button in the lower left corner and entering the URL to the
internal server.

To switch to a different window, click the Home button in the lower left corner to return to the
Home window or click the window selector to switch to the Manage or View window.

Related topics
Scheduling Jobs
Previewing Jobs
Refreshing the Kingdom Project View

© 2017 IHS Markit. All Rights Reserved. 7

Creating Jobs for the US

Formation top source

IHS offers Interpreted Formation Tops (GDS and GCS) and tops extracted from three other
sources, mud logs, driller’s logs, and rock samples. Access to GDS and GCS interpreted tops
is controlled through the IHS Enerdeq Browser. For subscription assistance, please contact
sales from the IHS Energy Products website.

IHS_GDS GDS tops are interpreted formation tops for the following US regions:
• From west Texas north through North Dakota in several basins
• Gulf coast formations from south Texas through western Florida
• Offshore Texas and Louisiana shelf formations
Formation tops are picked from logs using the same consistent
methodology by experienced geologists.

IHS_GCS GCS tops are interpreted formation tops for the following US regions:
• South and East Texas
• Northern Louisiana and southern Arkansas
• Southern and western Mississippi and southwestern Alabama
Formation tops are picked from logs using the same consistent
methodology by experience geologists.

IHS_LOG LOG tops come from mud logs.

IHS_DRLR DRLR tops are extracted from driller’s logs. Measurements are often
based on the observed changes in the speed of the drill bit, or
changes in the samples brought to the surface.

IHS_SPL SPL tops are taken from rock samples such as cores.

8 © 2017 IHS Markit. All Rights Reserved.

 Creating Queries for US Jobs

Creating Queries for US Jobs

Direct Connect allows you to create new well queries to select well and production data that
you want to import into Kingdom. You can create the same kinds of well queries using Direct
Connect that you can on the IHS web site. Direct Connect associates these queries with jobs
to import the data and saves the jobs so you can run the same queries again at a later time.
Any queries you create in Direct Connect are also available to you on the IHS web site.
You cannot create production queries and you cannot edit well queries using Direct Connect.
Once you create and save a new well query it becomes available in Direct Connect as an
existing query, and you cannot edit existing queries. To edit an existing query, you must do so
on the IHS web site.

Note: If you have a production-only subscription to IHS well data, any well queries you
attempt to run will not return any data. Be sure you are using a production query in
any query-based jobs you run with Direct Connect. (You must create production
queries on the IHS web site and any production queries you create there available in
Direct Connect.) Query types are indicated by an icon next to the query name in the
Create Job window. You can also filter the list of queries by query type by clicking the
corresponding Filter button.

Each query includes one or more query statements. Each query statement is comprised of a
property, an operator, and a value. The property corresponds to specific kind of information in
the IHS well and production database, the operator is the logical evaluation you want to
perform on the property, and the value is what you use to make the logical evaluation. For
example:

Property Operator Value

Lease name Contains Teapot

Last Activity Date Is less than or equal to 1/1/2011

Total Depth Is greater than 3,000

You can join multiple query statements together using both AND as well as OR. If you join two
query statements together using OR, Direct Connect pairs these statements together as a
single element in the overall query and joins it to any other query statements using AND. For
example:
Last Activity Date is greater than OR equal to 1/1/2011
AND
State is equal to Texas OR State is equal to Louisiana
AND
Operator is equal to ACME Petroleum

© 2017 IHS Markit. All Rights Reserved. 9

Creating Queries for US Jobs

Since Direct Connect treats statements joined by OR as a single paired element in the query,
they are always restricted to the same value for the property in both statements. For
example, Direct Connect permits you to create a query statement such as “State is equal to
Texas OR State is equal to Louisiana,” since the property is “State” in both statements. You
cannot use Direct Connect to create a query statement such as “State is equal to Texas OR
Operator is equal to ACME Petroleum” since the property is not the same in both statements.
When creating a query, certain operators make it possible to look up matching values in the
database as you create the query. These operators include:
• Starts with
• Does not start with
• Contains
• Does not contain
If you select one of these operators, type a partial value in the Value field, and then click the
down arrow at the end of the Value field, Kingdom displays a list of any entries in the
database that are a partial match to what you typed. For example, if you select Country as
the Property, Starts with as the Operator, and type “So” in the Value field, the list of possible
matches will contain country names in the database that start with “So,” such as the Solomon
Islands and South Sudan.
To create a query:
1. From the Direct Connect Home window, click Create.
2. If prompted, provide your US IHS credentials.
3. Click New well query.
4. Select the property you want and the operator you want in the Property and Operator
fields.
5. Enter the value you want in the Value field.
6. If you want to join this statement into a single paired element joined by OR, click OR and
then complete the Operator and Value fields for the new statement. The Property field
value is the same as in the paired statement and cannot be changed.
7. If you want to add another statement to the query, click AND, and then complete the
Property, Operator, and Value fields for the new statement.
8. Continue adding statements to the query and join them using AND and OR as needed.
9. To delete a statement from the query, click on the statement in the query window and then
click Delete.
10. If you want to validate the results of your query before saving it or running it, click
Preview. This opens the Job Preview window, where you can see the number of records
resulting from your query and some sample data from the query. You can also display a
preview of a map with the locations of the wells in the query results.
11. Once you have defined the query you want, enter a name for the query in the Query
Name field, and then click Save. If you exit the Create Job window before saving your
query, you will lose the query.

10 © 2017 IHS Markit. All Rights Reserved.

 Creating Queries for US Jobs

12. Confirm the name of the job in the Name field, and then click Create. You have the option
to run the job now, simply save the job, or schedule the job to run at a later time.

Related topics
Creating Jobs for the US
Scheduling Jobs
Refreshing the Kingdom Project View
Previewing Jobs

© 2017 IHS Markit. All Rights Reserved. 11

Creating Jobs for International Data

Creating Jobs for International Data

Wells > Import > Direct Connect > Create
Use the Direct Connect - Create Job window to create jobs that import data into Kingdom.
When creating a job to import data into Kingdom, you can define several job options:
• The kind of well data to import
• The import method to use (add, update, add/update)
• Whether to define any bounds for the data (project bounds, digitized area, or custom
bounds)
• What query to use (whether an existing or a new query)
At a minimum, you must define the kind of data to import and either the query to use or a set
of bounds. If you do not specify any bounds, the query you use can include data from
anywhere in the world. If you do not specify a query, Direct Connect imports data for all wells
found within the defined bounds.
To create a new data import job:
1. From the Kingdom main menu, select Wells > Import > Direct Connect.
2. Click Create.
3. If you are connecting to the IHS database for the first time with Direct Connect, you must
select the International data source and provide your IHS username and password. You
are only prompted for these credentials once. Direct Connect will continue to use these
credentials each time you connect.

Note: If your credentials change for any reason, Direct Connect will prompt you to enter
your new credentials.

4. Select the corresponding check boxes to define the type of well data you want to import
into Kingdom. By default, all well data types are selected. For more information about
how Direct Connect handles well data, see Understanding How Direct Connect
Processes Well and Production Data.
5. Select the method you want to use for importing the data. Your choices include:
• Add and Update: Adds new wells in the query that are not in the project and updates
existing well data. This is the default.
• Add New: Adds new wells in the query that are not in the project. Existing well data is
not updated.
• Update Existing: Updates well data for existing wells only. Ignores any new wells in
the query that are not in the project.
6. Choose whether to limit the data you import to a specified set of bounds. You can limit
data according to the project bounds, an area you digitize on the base map, or by custom
bounds you enter using either X/Y or Lat/Long values. This option is turned off by default.

12 © 2017 IHS Markit. All Rights Reserved.

 Creating Jobs for International Data

a. If you click Use Project Bounds, Direct Connect uses the bounds of the current
project to define the wells for which it will query data.
a. If you click Digitize on Base Map, then draw a rectangle on the base map defining
the area are interested in.
b. If you click Use Custom Bounds, then provide the X/Y or Lat/Long coordinates for
the area of interest. If you select Lat/Long, you must also specify whether these
coordinates are shown as DD or DMS.
7. If you want to use a query to locate data in the IHS database, select All existing to use
an existing query or select New well query to create a new query. For more information
about creating new queries, see Creating Queries for International Jobs.

Note: If you select an existing query, you can change the parameters of the query before
running or saving the job. These changes are saved with the job. The default
values of the existing query do not change.

8. If you want, select Subsets to display a list of available subsets, then select one or more
subsets to use for your query. Selecting subsets limits query results to wells contained in
the selected subsets.
9. If you created a new query, provide a name for the query in the Query name field and
click Save.
10. Provide a name for the job you are creating in the Job Name field. Direct Connect
provides a default name that you can modify as needed.
11. If you want to preview the data that the query retrieves before saving and scheduling the
job, click Preview. This opens the Job Preview window. For more information about
previewing a job, see Previewing Jobs.
12. Click Create, and then choose whether to run your job now, schedule it for a later time, or
simply save the job. If you choose to save the job, you can always schedule it to run at
another time.
To switch to a different window, click the Home button in the lower left corner to return to the
Home window or click the window selector to switch to the Manage or View window.

Related topics
Scheduling Jobs
Refreshing the Kingdom Project View
Creating Queries for International Jobs
Previewing Jobs

Creating Queries for International Jobs

Direct Connect allows you to create new well queries to select well data that you want to
import into Kingdom. Direct Connect associates these queries with jobs to import the data
and saves the jobs so you can run the same queries again at a later time. Any queries you
create in Direct Connect are only available to you in Direct Connect, and any queries you
create on the IHS web site (EDIN) are only available to you on the web site.

© 2017 IHS Markit. All Rights Reserved. 13

Creating Jobs for International Data

Each query includes one or more query statements. Each query statement is comprised of a
property, an operator, and a value. The property corresponds to specific kind of information in
the IHS well database, the operator is the logical evaluation you want to perform on the
property, and the value is what you use to make the logical evaluation. For example:

Property Operator Value

Field name Is equal to Jawalamukhi 1

Operator Is equal to Oil & Natural Gas

Commission

Total Depth Is greater than or equal to 3,000

You can join multiple query statements together using both AND as well as OR. If you join two
query statements together using OR, Direct Connect pairs these statements together as a
single element in the overall query and joins it to any other query statements using AND. For
example:
Last Activity Date is greater than OR equal to 1/1/2011
AND
State is equal to Texas OR State is equal to Louisiana
AND
Operator is equal to ACME Petroleum
Since Direct Connect treats statements joined by OR as a single paired element in the query,
they are always restricted to the same value for the property in both statements. For
example, Direct Connect permits you to create a query statement such as “State is equal to
Texas OR State is equal to Louisiana,” since the property is “State” in both statements. You
cannot use Direct Connect to create a query statement such as “State is equal to Texas OR
Operator is equal to ACME Petroleum” since the property is not the same in both statements.
When creating a query, certain operators make it possible to look up matching values in the
database as you create the query. These operators include:
• Starts with
• Does not start with
• Contains
• Does not contain
If you select one of these operators, type a partial value in the Value field, and then click the
down arrow at the end of the Value field, Kingdom displays a list of any entries in the
database that are a partial match to what you typed. For example, if you select Country as
the Property, Starts with as the Operator, and type “So” in the Value field, the list of possible
matches will contain country names in the database that start with “So,” such as the Solomon
Islands and South Sudan.
To create a query:
1. From the Direct Connect Home window, click Create.

14 © 2017 IHS Markit. All Rights Reserved.

 Creating Jobs for International Data

2. Click New well query.

3. Select the property you want and the operator you want in the Property and Operator
fields.
4. Enter the value you want in the Value field.
5. If you want to join this statement into a single paired element joined by OR, click OR and
then complete the Operator and Value fields for the new statement. The Property field
value is the same as in the paired statement and cannot be changed.
6. If you want to add another statement to the query, click AND, and then complete the
Property, Operator, and Value fields for the new statement.
7. Continue adding statements to the query and join them using AND and OR as needed.
8. To delete a statement from the query, click on the statement in the query window and then
click Delete.
9. If you want to validate the results of your query before saving it or running it, click
Preview. This opens the Job Preview window, where you can see the number of records
resulting from your query and some sample data from the query. You can also display a
preview of a map with the locations of the wells in the query results.
10. Once you have defined the query you want, enter a name for the query in the Query
Name field, and then click Save. If you exit the Create Job window before saving your
query, you will lose the query.
11. Confirm the name of the job in the Name field, and then click Create. You have the option
to run the job now, simply save the job, or schedule the job to run at a later time.

Related topics
Creating Jobs for International Data
Scheduling Jobs
Refreshing the Kingdom Project View
Previewing Jobs

© 2017 IHS Markit. All Rights Reserved. 15

Scheduling Jobs

Scheduling Jobs
After you create a job, you have the option to run the job immediately, schedule the job to run
at a later time, or simply save the job. To schedule a newly created job, click Create in the
Create Job window and then enter a date you want the job to run. To schedule saved job or a
job that has run previously, in the Manage window click the Schedule Job column for the job
you want to schedule. The default time for all jobs is 12:00 am. To select a date and time from
a calendar, click the Calendar button next to the date field.
Kingdom does not need to be open to run scheduled jobs. However, you must be logged on
to your computer. If you scheduled a job to run and it did not run, it may be because you were
not logged on to your computer at the time the job was scheduled to run. The job may also
not have run if the Kingdom Scheduling Service (KingdomSchedulingService.exe) is
not running. Although this service runs by default, you may need to confirm that it is running
on your computer if scheduled jobs fail to run. To restart the Kingdom Scheduling Service,
restart Direct Connect.

Related topics
Creating Jobs for the US
Creating Jobs for International Data
Refreshing the Kingdom Project View
Previewing Jobs

16 © 2017 IHS Markit. All Rights Reserved.

 Previewing Jobs

Previewing Jobs
You can preview the results of a query before saving and scheduling the job that will run the
query. This enables you quickly evaluate the results of the query to be sure you are importing
the data you want.
To preview a job, click Preview on the Create Job window. This opens the Job Preview
window, which consists of a data preview and a map. The data preview indicates the number
of records in the query segmented by type. For example, if your query includes well data as
well as allocated and unallocated production data, the data preview displays an icon for each
type of data with a number next to the icon indicating the number of records for that type of
data. The data preview also includes a small sample of the data that your query returns.
Click Populate Map to display a map with the wells that are in your query. The preview map
also includes any existing wells within the project. Existing wells are indicated in black and
new wells from the query are indicated in red. You can pan, zoom in and out, and reset the
map. You can also turn on and off several layers within the map to customize what the map
displays:
• Preview Wells (any new wells in the query that are not yet imported into your project -
shown in red)
• Project Wells (wells that are already part of your project - shown in black)
• Bing Map WMS Layer
• XY
• Latitude/Longitude
The preview map always displays the data that your query returns from the IHS server. The
method you select for importing the data into your Kingdom project (Add and Update, Add
New, Update Only) does not affect what the preview map displays. For more information
about data importing methods, see Creating Jobs for the US.

Related topics
Creating Jobs for the US
Scheduling Jobs
Refreshing the Kingdom Project View

© 2017 IHS Markit. All Rights Reserved. 17

Managing Jobs

Managing Jobs
Wells > Import > Direct Connect > Manage
Use the Manage Jobs window to manage the jobs you create. This includes:
• Scheduling completed jobs to run again immediately or at another scheduled time
• Reviewing any failed jobs to see why they failed
• Deleting jobs that have already run
• Use an existing job as a template for a new job
• Cancelling scheduled jobs or jobs already in progress
• Updating the results of a job from the last time the job was run
The Manage Jobs window consists of two persistent lists, the Scheduled Jobs list and the All
Jobs list. The Manage Jobs window also shows a Failed Jobs list if any scheduled jobs fail as
well as a Completed Jobs list if any scheduled jobs have completed since being scheduled.

Related topics
Refreshing the Kingdom Project View
Using the Scheduled Jobs List
Using the All Jobs List
Using the Failed Jobs List
Using the Completed Jobs List
Understanding Job Status

Using the Scheduled Jobs List

The Scheduled Jobs list shows any jobs that are pending or currently in progress. You can
cancel any job in progress by selecting the job and then clicking Cancel. You can remove any
pending jobs from this list by clicking Remove. Cancelling or removing a job does not delete
the job, it simply clears it from the schedule so the job will not run. The job remains in the All
Jobs list.
To filter the list of scheduled jobs by name, click the filter icons available in the Name column
head. You can use this filter to help you locate a particular job.

Related topics
Using the All Jobs List
Using the Failed Jobs List
Using the Completed Jobs List
Understanding Job Status

Using the All Jobs List

The All Jobs list shows all the jobs you have created, including both jobs that have run
previously and those you have created but that have not yet run. It includes completed jobs,
partially successful jobs, and failed jobs. This list makes it easy to run a job again rather than
needing to create a new job with the same query. For more information about job status, see
Understanding Job Status.

18 © 2017 IHS Markit. All Rights Reserved.

 Managing Jobs

To schedule a previously run job to run again, click in the Schedule Job column for the job
you want and select the date and time you want the job to run again. You can also click Run
to run the job immediately. If you choose to start a job immediately and another job is already
in progress, the job you are attempting to start remains in a pending status until the current
job completes.
To run the job again but only include any new or updated records in the query results since
the last time the job was run, click Update. This option can result in much faster job
processing depending on the amount of data that has changed since the last time the job was
run.
To use an existing job as a template for creating a new job, select the job you want to use as
a template in the list and then click Use as Template. This opens the Create Job from
Template window, where you can modify the previous job settings and then run the new job
or schedule the new job to run at a later time.

Note: You cannot save two jobs with the same name. A new job you create from a previous
job requires a new job name.

For US jobs, you can modify job settings but you cannot edit queries using Direct
Connect. To edit an existing query, you must do so on the US IHS web site.

You can also delete jobs from the list by selecting the job and then clicking Delete. This
deletes the job from Direct Connect. You cannot delete a job if it is currently running.
Deleting a job cannot be undone. Deleting a job removes any scheduled occurrences for the
job to run and also deletes the job history from the Reports window.
To filter the list of completed jobs by name or by the last successful run, click the filter icons
available in the Name and Last Successful Run column heads. You can use these filters to
help you locate a particular job.

Related topics
Using the Scheduled Jobs List
Using the Failed Jobs List
Using the Completed Jobs List
Understanding Job Status

Using the Failed Jobs List

The Failed Jobs list shows any jobs that failed to run. This list is not visible if there are no
failed jobs. The Failed Jobs list provides basic information about the failed job, such as the
job name, the time the job failed, and the type of data the query includes. The Show Reports
button links to the Reports window and displays the report for the selected job. To learn more
about failed jobs, see Reject Report.
If a job ran partially before failing, you can restart the job from the point where it failed by
clicking Resume. If the job failed completely, you can try to run the job again from the
beginning by clicking Restart.

© 2017 IHS Markit. All Rights Reserved. 19

Managing Jobs

Failed jobs remain in this list until you remove them. To remove a job from the list, select the
job and then click Remove. This does not delete the job from Direct Connect; it remains in
the All Jobs list. To remove all failed jobs from the list, click Remove All.
To filter the list of failed jobs by name or by status, click the filter icons available in the Name
and Status column heads. You can use these filters to help you locate a particular job.

Related topics
Using the Scheduled Jobs List
Using the All Jobs List
Using the Completed Jobs List
Understanding Job Status

Using the Completed Jobs List

The Completed Jobs list shows any jobs that have completed. This list is not visible if there
are no completed jobs or you have previously cleared all completed jobs from the list. The list
includes jobs that completed successfully or completed with errors. Completed jobs remain in
the list until you remove them. For more information about job status, see Understanding Job
Status.
To update your Kingdom project view with data imported by completed jobs, click Refresh
Project. This updates the current project view with any data imported by jobs since the last
time you clicked Refresh Project. This includes any completed jobs that you have removed
from the Completed Jobs list. Depending one the amount of data you imported since the last
refresh and other activities you may be performing with the project, updating the project may
take a significant amount of time and interfere with other project operations. Be aware of
these factors when deciding to update your project. For more information about refreshing
the project, see Refreshing the Kingdom Project View.
To remove a completed job from the list, select the job and then click Remove. This does not
delete the job from Direct Connect; it remains in the All Jobs list. To remove all completed
jobs from the list, click Remove All.
To filter the list of completed jobs by name or by completion time, click the filter icons
available in the Name and Completion Time column heads. You can use these filters to help
you locate a particular job.

Related topics
Refreshing the Kingdom Project View
Using the Scheduled Jobs List
Using the All Jobs List
Using the Failed Jobs List
Understanding Job Status

Understanding Job Status

Direct Connect jobs can have a number of different statuses, depending on whether a job has
run and if so, whether it ran successfully. Possible job statuses include:

In Progress Jobs that are currently running

20 © 2017 IHS Markit. All Rights Reserved.

 Managing Jobs

Pending Jobs that are scheduled to run but have not yet started.

Completed jobs that have completed successfully without any errors. The job
finished and all data was successfully imported into Kingdom.
Completed jobs are shown in the Completed Jobs list.

Completed with Jobs that have completed successfully but not all the data was
Errors successfully imported into Kingdom. This typically occurs when some
portion of the data you are attempting to import cannot be processed by
Kingdom. To find out more about why the data produced errors, click
Show Reports. To learn more about failed data in jobs, see Reject
Report. Jobs that have completed with errors are shown in the
Completed Jobs list.

Partially Completed Jobs that failed before they were able to complete. Possible causes for
partially completed jobs include a loss of connectivity or unexpected
interruptions in the software. In most cases, you can resume a partially
completed job from the point where it failed by clicking Resume. This
prevents you from having to run the entire job again. The reason for the
job failure is indicated below the job name when you select the job in the
Failed Jobs list. To find out more about what data was imported by the
job, click Show Reports. For more information about reports, see
Viewing Job Reports.

Failed Jobs that failed to run at all. The reason for the job failure is indicated
below the job name when you select the job in the Failed Jobs list.
Failed jobs display in the Failed Jobs list. Failed jobs do not have a
Reject report since no data was imported into Kingdom.

Related topics
Using the Scheduled Jobs List
Using the All Jobs List
Using the Failed Jobs List
Using the Completed Jobs List

© 2017 IHS Markit. All Rights Reserved. 21

Viewing Job Reports

Viewing Job Reports

Wells > Import > Direct Connect > View
The Reports window provides information about any jobs you have run in Direct Connect.
This includes a Summary report and if a job has failed for any reason there is also a detailed
Reject report indicating what data was rejected and the reason for the rejection. The Reports
window shows a history of jobs at the top of the window. To see a Summary or Reject report
for a job, select a job in the Job History list. The corresponding Summary report displays in
the Summary section and if applicable the Reject report displays in the Reject Report section.
There are separate Reject reports for well data, allocated production data, and unallocated
production data.

Related topics
Summary Report
Reject Report
UWI Change Control Report

Summary Report
Every job in Direct Connect has a Summary report. The Summary report shows basic
information about each job, segmented by data type. The report includes the following
information:
• Added: The number of records added to the project.
• Updated: The number of records updated in the project.
• Data Errors: The number of records with errors, such as unprocessed data. Any valid
data for a given record with errors is still imported into Kingdom. Unprocessed data may
be valid data in the IHS database, but it is not data that can be used by the Kingdom
database.
• Locked: The number of records that were only partially updated in your project due to a
lock on one or more well properties in Kingdom.
• Skipped: The number of records skipped when adding or updating. Records are skipped
depending on the import method you selected. For example, if you chose the option to
only add new wells to the project, any wells in the query that are already in your project
are skipped. Records are also skipped if the query results include production data for
wells that are not part of the project. You cannot add well production data unless the well
is part of the project.

Related topics
Viewing Job Reports
Reject Report
UWI Change Control Report

Reject Report
If Direct Connect cannot import data in a job into your project, Direct Connect creates a
Reject report for the job. Note that data that cannot be imported into Kingdom may be valid

22 © 2017 IHS Markit. All Rights Reserved.

 Viewing Job Reports

data in the IHS database, but it is not data that can be used by the Kingdom database. For
example, Kingdom cannot import data about well linings or casings without a defined depth,
though this data is valid in the IHS database without a defined depth.
The Reject report consists of two parts: a tabbed display of errors grouped by well property
and a detailed report. The Well, Production Allocated, and Production Unallocated tabs
indicate both the number of data elements with errors, as well as the number of wells affected
by the rejected data for each well property (the two production-related tabs apply to US data
only). For example, you could have a job with 25 test perforation errors but only 18 wells
where those test perforation errors occur. The bar chart on each tab shows data that was not
imported with each bar representing the number of rejected data elements for a particular
well property. Each tab also displays the total number of failed wells in the imported data.
A detailed version of the Reject report indicating the reason each data element was not
imported is also available in HTML format. To see the detailed report, click Detailed Report.
This report groups information by borehole, which is uniquely identified by the UWI. The
detailed report indicates what kind of well property information could not be imported and a
reason for each failure.
Both the US and International IHS master data stores contain historical geologic data that is
valid data but that cannot be used for interpretation. For example, the International database
(EDIN) contains information about eroded out formation top picks on wells, but these picks
have no depth values and therefore will be rejected by Kingdom.

Related topics
Viewing Job Reports
Summary Report
UWI Change Control Report

UWI Change Control Report

The UWI Change Control report shows any well UWIs that have been changed or deleted in
the IHS database for any wells in the current project. This report is essentially a way to
access the API Change Control file available through the IHS Enerdeq Browser, with the
results of the report limited to the wells in the current project. The changes and deletions
listed in the report occur for a variety of reasons and can include the following:
• Incorrect UWI numbers
• Duplicate well data under different UWI numbers
• Regulatory agency changes to UWI numbers
You can use the information available in this report to ensure your Kingdom project is up to
date with the most accurate UWI information.
You have the option to specify a date range when running the report or you can run the report
with no date range. If you are running the report for the first time, you may want to run it
without a date range to ensure the report includes all available information about UWI
changes and deletions for the wells in your project.
You may choose to set up a regular schedule for running the report as a way to keep your
project up to date. If you do so, provide the date of the last time you ran the report to capture

© 2017 IHS Markit. All Rights Reserved. 23

Viewing Job Reports

only those changes that have occurred since the last report. This practice will reduce the size
of the report and make it easier to identify any changes to the wells in your project.
The UWI Change Control report provides information only. It is up to you to make any
changes to your Kingdom project based on the information in the report.

Note: The UWI Change Control Report is based on 14-digit UWI numbers. If your project
contains any wells with 12-digit UWI numbers, Kingdom appends 00 to the number to
make it a 14-digit UWI number and then queries for any changes or deletions based
on the new 14-digit number.

If you want to export the UWI Change Control report to a .csv file, click Export.

Related topics
Viewing Job Reports
Summary Report
Reject Report

24 © 2017 IHS Markit. All Rights Reserved.

 Refreshing the Kingdom Project View

Refreshing the Kingdom Project View

Direct Connect does not automatically update your Kingdom project view with the data it has
imported into the Kingdom database. Depending on the amount of data you imported and
other activities you may be performing with the project, updating the project view may take a
significant amount of time and interfere with other project operations.
To update the Kingdom project view after completing a job and importing data, you need to
click Refresh Project in the Manage Jobs window above the Completed Jobs list. This
refreshes the current project view with any data imported into Kingdom by Direct Connect
jobs since the last time you refreshed the project view. For more information about the
Completed Jobs list, see Using the Completed Jobs List.
If you import production data into the Kingdom database, Kingdom does not automatically
calculate cumulative totals for the imported data. To calculate cumulative totals, from the
Kingdom Wells menu, click Production Data > Calculate Cumulative.

Related topics
Creating Jobs for the US
Creating Jobs for International Data
Scheduling Jobs

© 2017 IHS Markit. All Rights Reserved. 25

Contacting Customer Care

Contacting Customer Care

If you have any questions or need to obtain your software on physical media, contact one of
our Customer Care Centers of Excellence at [email protected] or by phone.
Regional numbers are listed below.

Region Phone

Americas +1 800 IHS-CARE

+1 800 447-2273
+1 303 736-3001

Latin & South America +54 11 43438635

+55 21 2588-8145 (Brazil)

EMEA +44 (0)1344 328 220

APAC +604 291 3600

26 © 2017 IHS Markit. All Rights Reserved.