DSP Workflow - Using

PetroDesk to Import Well

Data from an External Data
Source into the Decline
Database
December, 2007
COPYRIGHT
Copyright © 2007 Schlumberger. All rights reserved.

The information in this document is subject to change without notice. The software described in this document is furnished under a
license agreement. This software may be used or copied only in accordance with the terms of such agreement. It is against the law to
copy the software on any medium except as specifically allowed in the license agreement. No part of this document may be
reproduced or transmitted in any form, or by any means, electronic or mechanical, including photocopying and recording, for any
purpose without the express written permission of Schlumberger.
Merak™ is a trademark of Schlumberger.
Merak Peep® is a registered trademark of Schlumberger.
Merak PetroDesk™, Merak Portfolio™, Merak Decision Tool Kit™, Merak VOLTS™, Merak Budget™, Merak Capital Planning™,
and FieldView™ are trademarks of Schlumberger.
Microsoft® is a registered trademark of Microsoft Corporation.
BackOffice®, Internet Explorer®, Windows®, Windows 98®, Windows NT®, Windows 2000®, MS-DOS®, Word®, Excel®,
ActiveX®, ODBC®, OLE®, COM®, Terminal Server®, Microsoft Access®, Visual C++®, and Microsoft SQL Server® are
registered trademarks of Microsoft Corporation.
Oracle ® is a registered trademark of Oracle Corporation.
All other names and trademarks are the property of their respective owners.
Released December, 2007.
 Contents

About the Data Service Provider (DSP) .........................................................................1

Data Service Provider (DSP) workflows ........................................................................1

DSP Licensing .................................................................................................................1

Selecting PetroDesk wells ..............................................................................................2

Downloading wells to Peep using PetroDesk Exporter ................................................3

Defining Peep well Import Option Settings ...................................................................6

How to reach us ..............................................................................................................7

 DSP Workflow – Using PDExporter to Import Data into Decline from an External Data Source

About the Data Service Provider (DSP)

The Data Service Provider provides seamless and live access to multiple public and private data sources,
enabling you to view data from different databases for a given well within Decline. For example, you could
use a smart data-source connection to obtain well header information for a well from a public data vendor,
production data from a Finder database, and additional private production data from a corporate database.
Instead of using the PDExporter tool* to import data into Decline, you can now use the DSP to view the
information without having to repeatedly import monthly data into the Decline database.
Note: the DSP functionality requires a Data Service Provider license, which is available with the purchase
of Merak PetroDesk. If you want to enquire about purchasing a PetroDesk license, contact the SIS Global
Help Desk.
*PDExporter is still an alternate method for exporting historical production from PetroDesk to Decline.

Data Service Provider (DSP) workflows

This workflow and other accompanying workflows illustrate different ways in which you can use the DSP:
• retrieving data for a Decline well from an external data source;
• retrieving data for a well from multiple data sources and editing that data;
• 2electing wells from a PetroDesk list and adding them to a Decline work group, then retrieving data for
those wells from one or more external data sources;
• posting a well from a PetroDesk list or map layer as the Current Entity, then saving that well to the
Decline database, and then retrieving data for that well from one or more external data sources;
• using PetroDesk Exporter to import well data from an external data source to the Decline database;
and,
• updating wells existing in the Decline database with data from an external data source (via PetroDesk
Exporter).

DSP Licensing
If you have a valid Data Service Provider (DSP) license and want to use the DSP with Decline, you must
configure Peep/Decline to request a DSP license when launching the application. See “Setting the Startup
Preferences” in Peep Help for more information.
If you choose not to request a DSP license, or if you request a license and none is available:
• the PetroDesk Work Group window will be unavailable. See “Copying a PetroDesk work group to the
Decline database” in Peep Help for information about PetroDesk work groups;
• the Data Service Provider (DSP) dialog box will be unavailable. See “Changing the DSP preferences”
later in this document for information about changing DSP preferences;
• only non-DSP wells will be displayed in the Peep select window;
• only non-DSP wells will be displayed in the Search window when you perform a search;
• only non-DSP wells will be displayed in the Select Wells dialog box when selecting wells for batch
well forecasts, plots, summary reports, or reports; and,
• only non-DSP wells will be summarized when performing batch recalculations of summary wells.

www.sis.slb.com 1
 DSP Workflow – Using PDExporter to Import Data into Decline from an External Data Source

Selecting PetroDesk wells

To select a single record from a list:
• To select a single record from any point on a list, place the pointer on that record and click the mouse.
• Press the <Home> key to go to the first record from any point on the list and make that record your
current selection.
• Press the <End> key to go to the last record from any point on the list and make that record your
current selection.
To select an object from a map layer:
When you select objects from a list layer on a PetroDesk map, if the list upon which the layer is based is
also open in your project, the corresponding records are also selected on the list.
You can select objects from a map layer only when it is selectable, and the active layer (click on a map
layer in the Layer Management pane on the left-hand side of the PetroDesk window to make it active).
Three tools are used to select objects:

• The Select tool is used to select one or more objects (or groups of objects), and to open the
Selection Information dialog box.

• The Select to List tool is used to post objects selected from map layers onto the Working List.

• The Flyover Select tool is used to pan over objects such as wells or pipelines, displaying
information about the currently selected object in the Selection Information dialog box and on the
map’s Status Bar.

www.sis.slb.com 2
 DSP Workflow – Using PDExporter to Import Data into Decline from an External Data Source

Downloading wells to Peep using PetroDesk

Exporter
If the desired PetroDesk Exporter Option file is already loaded, you can use the Peep Decline Export option
to export selected wells to Peep Decline without having to open the PetroDesk Exporter dialog box (see
“Downloading wells to Peep Decline using Peep Decline Export” in PetroDesk Help for more information).
If no option file is loaded, or if you want to load a saved option file or change the current export settings to
export wells to a Merak Peep Decline database, follow the steps below.
When downloading wells to Peep Decline, you can choose Peep Decline or Peep Decline (DSP) as your
export type (you can only choose Peep Decline (DSP) as your export type if the Data Service Provider has
been installed and correctly configured). Regardless of the export type you choose, PetroDesk Exporter
creates a Merak Export file and downloads the well data to a Peep Decline database.
If Peep Decline is properly configured to use the Data Service Provider (DSP), then Peep Decline can
retrieve data directly from an external database rather than from its own database (i.e. a "live" link).
To download wells to Peep Decline:
1. Select the wells from a PetroDesk list or map layer that you want to download, and then click the
PDExporter toolbar button to launch PetroDesk Exporter.
2. If working with a data source that does not identify each producing zone within a well by a unique well
identifier (UWI), define how you want to retrieve data for export. Choose Options menu > Retrieve
by, then one of the following options:
• Well: choose this to retrieve all the data for each selected well, regardless of producing zone;
• Producing zone: choose this to retrieve and sort data for each selected well by producing zone.

This step is not required for Canadian data sources.

3. If a PetroDesk Exporter Option file was already loaded when launching PetroDesk Exporter, the
PetroDesk Exporter dialog box shows that template’s settings and the dialog box title bar is called
PetroDesk Exporter - [PD Exporter Option filename.ddo].

If the last-used PetroDesk Exporter Option file was moved from its current location or deleted since
your last PetroDesk Exporter session, PetroDesk Exporter will open with its default settings.
4. You can also load a saved PetroDesk Exporter Option File (see “Creating and using PetroDesk
Exporter Option files” in PetroDesk Help), or follow the steps below to change the existing settings
and export wells in the desired format.
5. The Export Type drop-down list provides export type options. Choose Peep Decline or Peep Decline
(DSP) as your export type.
6. Assign a path and name for a new Merak Export file in the Output file field. Type the path and name
of the destination folder, then the file name (e.g. C:\Merak\Petrodesk\[ExportFilename.mer]). Or,
select an existing output file (next step).
• If no valid path name is assigned, PetroDesk Exporter will search for the system’s Temp folder
and store the information there; if no Temp folder exists, PetroDesk Exporter will create a
C:/Temp folder;
• If no extension is specified in the Output file field and Peep Decline is selected as the export type,
the file is automatically assigned a ".mer" extension;
• To assign an extension other than ".mer," add the desired extension to the string in the Output file
field, and the file will be saved using that extension.

www.sis.slb.com 3
 DSP Workflow – Using PDExporter to Import Data into Decline from an External Data Source

7. To select an existing file as the output file and overwrite it with the current information, click the
Browse button next to the Output file field to open the Output File Name dialog box. Select the
desired output file, then click the Open button to close the dialog box and add the selected path and
file name to the Output file field.
8. Use the Export log file field to assign a log file to record the exporting process. Export Log Files,
which are generated by PetroDesk when exporting well data, describe the export type, output file
name, data source, number of wells exported, start and finish times, as well as the export procedure:
• If no valid path name is assigned, the file is automatically saved in the C:\Temp folder;
• If no extension is specified in the Export log file field, the file is automatically assigned a ".txt"
extension;
• If the Export log file field is left blank, no log file is created;
• If you select an existing export log file after clicking the Browse button, it will be overwritten with
the new information.
9. Edit the Well List if necessary (see “Editing the PetroDesk Exporter well list” in PetroDesk Help for
more information).
10. Edit the data source options (see “Editing data source options” in PetroDesk Help for more
information). If Peep Decline (DSP) is your selected export type, you can select a smart data-source
connection if desired and use it to simultaneously export well data to Peep Decline from multiple data
sources (e.g. test results from one data source and production data from another data source).
11. Set the required launch options if you want to send data in Peep format to a third-party application and
launch that application, or to open a file or go to a Web address when exporting data. See “Setting
PetroDesk Exporter launch options” in PetroDesk Help for more information.
12. Use the Restrict Date Range option group to select a time span for the records you are exporting to
Peep (this is not available when Peep Decline (DSP) is the selected export type, since each well's entire
production history is downloaded when using this option):
• Clear the Restrict Date Range check box to download the full production data history for all
selected wells;
• Select the Restrict Date Range check box to limit the range of exported data to the dates
specified in the From and To fields:
• In the From Year and Month fields, type the first year and month of data you want to export
(e.g. 2000 and 01);
• In the To Year and Month fields, type the last year and month of data you want to export.

If you do not specify a month in the From or To Month fields, all the data for the selected year will be
included for export.
13. In the Send Data to Peep option group:
• Select the Send Data to Peep check box to launch Peep Decline and send data for the selected
wells. Clear this check box if you want to create a new Merak Export File, but do not want to send
data to Peep;
• Select the U.S., Canadian or World option buttons to open the desired version of Peep Decline
before exporting the data;
• Select the Use Peep Import Settings check box to import data into Peep Decline using the current
Peep settings, without having to open Peep to import the data. This feature works only if using
Merak Peep version 99.1 or later. For earlier versions of Peep, open the application, create the
desired settings, and then import the temporary Merak Export File that you created.

See Peep Help for information on automatically creating a Peep case for each well you import into
Peep with PetroDesk Exporter. Then ensure that the Use Peep Import Settings check box is
selected in the PetroDesk Exporter dialog box before exporting the well(s).

www.sis.slb.com 4
 DSP Workflow – Using PDExporter to Import Data into Decline from an External Data Source

• Select the Prompt for Peep DB check box to select the desired Peep data source(s) for models,
cases, global parameters, prices, currency, reports or wells at the time of export. When you select
this option and click the Export button, after defining the Peep settings and retrieving well data,
the PEEP ODBC Data Sources dialog box appears (step 17).
• Select the Overwrite option button if you want to overwrite the contents of the Peep Decline
database with data for the selected wells. Select the Append option button to append the contents
of the Peep Decline database with data for the selected wells. This is useful if you want to export
data from two different data sources to the same database. For example, you could export gas
analysis data from Data Source A into a Peep Decline database (overwriting its contents), then
export production data from Data Source B into the same Peep Decline database, this time
appending the existing contents with the new information.
14. Create a Peep import log file (or click the Browse button and select an existing one) to record the
downloading process; these are used only when importing wells into Peep. They describe the export
type, Merak export file name, data source, number of wells exported, start and finish times, as well as
the selected time span and Peep type (Canadian, U.S. or World):
• If a file name but no valid path name is assigned in the Peep import log file field, the file is
automatically saved in the C:\Temp folder;
• If no extension is specified, the file is automatically assigned a ".txt" extension;
• If the Peep import log file field is left blank, no log file is created;
• If you select an existing Peep log file after clicking the Browse button, it will be overwritten with
the new information.
15. Click the Export button to begin the exporting process (if the Well List and/or the Output File field
are empty, the Export button is not available). The Export Status dialog box appears, followed by the
Peep Settings dialog box.
16. Select the desired settings for importing wells into Peep, then click OK to continue downloading the
wells (see “Defining Peep well import option settings” later in this document for more information):
• If all the settings are valid, the Export Status dialog box reappears, tracking the progress of the
data retrieval, processing, and importing sequence for all wells;
• If the Merak export file is not valid, a warning message appears;
• If the Well List contains an illegal well UWI, a warning message appears and the export process
terminates;
• Click the Cancel button to terminate the exporting process at any time. Once the process is
finished, the Cancel button is renamed to Close.
17. If you selected the Prompt for Peep DB check box, the PEEP ODBC Data Sources dialog box
appears:
• PetroDesk reads the last Peep data sources accessed by the current machine and uses this
information to populate the editing fields in the dialog box. If all Peep data is stored in a single
data source, the editing fields may list the same data source. Use these fields if necessary to select
new data sources for the various Peep database modules (Models, Cases, etc.);
• Click the Browse button next to a given field to open the Select Data Source dialog box and
select a data source for that database module. Click the Duplicate Down button beside a given
field to automatically populate all the fields below it with the same data source information.
18. The Export Complete message indicates that all data has been successfully retrieved from the data
source, while Import Complete indicates that the data has been successfully imported into Merak Peep.
Click the Close button to close the Export Status dialog box.
19. If desired, save the current settings as a new PetroDesk Exporter Option file (see “Creating and using
PetroDesk Exporter option files” in PetroDesk Help for more information).

www.sis.slb.com 5
 DSP Workflow – Using PDExporter to Import Data into Decline from an External Data Source

When errors occur while exporting wells to Peep Decline, an error message may appear but be
hidden behind the PetroDesk window. You can view (and close) this error message by clicking its icon on
the Windows taskbar at the bottom of the screen.

Defining Peep well Import Option Settings

When exporting wells to Merak Peep from the PetroDesk Exporter dialog box, the Peep Settings dialog
box appears during the export operation, offering two options for importing wells into Peep:
• Click the Create group of wells option button to create a well group, importing the actual data for the
selected well(s) into Peep. Type a name for the group in the Name field;
• Click the Display summary well in Peep option button to create a summary well whose values are
based on the combined values of all the selected wells. Type a name for the summary well in the Name
field.
Creating a well group saves the data to Peep, while using the Display summary well in Peep option
displays summary well data in Peep but does not save the data.

www.sis.slb.com 6
 DSP Workflow – Using PDExporter to Import Data into Decline from an External Data Source

How to reach us

United States
E-mail: merak-us-support@slb.com

Houston Tel.: +1 713-621-1165

Canada
E-mail: merakcscanada@slb.com

Calgary Tel.: +1-888-986-4357 (toll-free)

Europe and Africa
E-mail: merakcslondon@slb.com

London Tel.: +44 (0)207 517 2626

Russia and Caspian
E-mail: merakcsmoscow@slb.com

Moscow Tel.: 7 495 935 8200 Ext. 1218

South America
International E-mail: merakcsmexicocity@slb.com
Offices Mexico Tel.: 001 866 326 0174

Argentina Tel.: 0 800 444 0919

Brazil Tel.: 000811 005 9068

Colombia Tel.: 980912 3029

Venezuela Tel.: 0800 1 00 3588

Middle East
E-mail: merakcsMiddleEast@slb.com
Asia and Australia
E-mail: merakcsasia@slb.com

Malaysia Tel.: +60-3-21694266

Indonesia Tel.: +62-21-5229343

Australia Tel.: +61-1800001112

Thailand Tel.: +66-2-9371300

China Tel.: +86-10-64746699 Ext. 2816

Schlumberger supplements the standard maintenance agreement by offering extended on-site support
worldwide. This enhanced level of support includes on-site assistance, installation, troubleshooting, and
maintenance services of licensed Schlumberger software.Merak is a product line of Schlumberger
Information Solutions (SIS). For more information about SIS, please go to our Web site at
http://www.sis.slb.com.

www.sis.slb.com 7