EcoStruxure™ Power Advisor

Manual Data Extraction Guide

7EN42-0207-01
06/2020
Legal Information
The Schneider Electric brand and any registered trademarks of Schneider Electric Industries SAS
referred to in this guide are the sole property of Schneider Electric SA and its subsidiaries. They
may not be used for any purpose without the owner's permission, given in writing. This guide and its
content are protected, within the meaning of the French intellectual property code (Code de la
propriété intellectuelle français, referred to hereafter as "the Code"), under the laws of copyright
covering texts, drawings and models, as well as by trademark law. You agree not to reproduce,
other than for your own personal, noncommercial use as defined in the Code, all or part of this guide
on any medium whatsoever without Schneider Electric's permission, given in writing. You also
agree not to establish any hypertext links to this guide or its content. Schneider Electric does not
grant any right or license for the personal and noncommercial use of the guide or its content, except
for a non-exclusive license to consult it on an "as is" basis, at your own risk. All other rights are
reserved.

Electrical equipment should be installed, operated, serviced and maintained only by qualified
personnel. No responsibility is assumed by Schneider Electric for any consequences arising out of
the use of this material.

As standards, specifications and designs change from time to time, please ask for confirmation of
the information given in this publication.
Safety Information
Important Information
Read these instructions carefully and look at the equipment to become familiar with the
device before trying to install, operate, service or maintain it. The following special
messages may appear throughout this bulletin or on the equipment to warn of potential
hazards or to call attention to information that clarifies or simplifies a procedure.

The addition of either symbol to a "Danger" or "Warning" safety label

indicates that an electrical hazard exists which will result in personal injury if
the instructions are not followed.
This is the safety alert symbol. It is used to alert you to potential personal
injury hazards. Obey all safety messages that follow this symbol to avoid
possible injury or death.

DANGER
DANGER indicates a hazardous situation which, if not avoided, will result in death or serious
injury.

WARNING
WARNING indicates a hazardous situation which, if not avoided, could result in death or
serious injury.

CAUTION
CAUTION indicates a hazardous situation which, if not avoided, could result in minor or
moderate injury.

NOTICE
NOTICE is used to address practices not related to physical injury.

Please Note
Electrical equipment should be installed, operated, serviced and maintained only by qualified
personnel. No responsibility is assumed by Schneider Electric for any consequences arising out of
the use of this material.

A qualified person is one who has skills and knowledge related to the construction, installation, and
operation of electrical equipment and has received safety training to recognize and avoid the
hazards involved.
 Manual Data Extraction Guide

Contents
Safety Precautions 5
Extract data 6
Downloading and unblocking the Data Extractor 6
Running the Data Extractor 6
Configuring the Data Extractor 7
Files produced by the Data Extractor 10
History files 10
Log files 10

Page 4 7EN42-0207-01
Manual Data Extraction Guide Safety Precautions

Safety Precautions
During installation or use of this software, pay attention to all safety messages that occur in the
software and that are included in the documentation. The following safety messages apply to this
software in its entirety.

WARNING
UNINTENDED EQUIPMENT OPERATION
• Do not use the software or devices for critical control or protection applications where human
or equipment safety relies on the operation of the control action.
• Do not use the software to control time-critical functions.
• Do not use the software to control remote equipment without proper access control and status
feedback.
Failure to follow these instructions can result in death, serious injury, or equipment
damage.

WARNING
INACCURATE DATA RESULTS
• Do not incorrectly configure the software or the devices.
• Do not base your maintenance or service actions solely on messages and information
displayed by the software.
• Do not rely solely on software messages and reports to determine if the system is functioning
correctly or meeting all applicable standards and requirements.
• Consider the implications of unanticipated transmission delays or failures of communications
links.
Failure to follow these instructions can result in death, serious injury, equipment
damage, or permanent loss of data.

WARNING
POTENTIAL COMPROMISE OF SYSTEM AVAILABILITY, INTEGRITY, AND
CONFIDENTIALITY
Use cybersecurity best practices to help prevent unauthorized access to the software.

Failure to follow these instructions can result in death, serious injury, equipment
damage, or permanent loss of data.

Work with facility IT System Administrators to ensure that the system adheres to the site-specific
cybersecurity policies.

7EN42-0207-01 Page 5
Extract data Manual Data Extraction Guide

Extract data
The Power Advisor Data Extractor lets you extract power data from your power monitoring system.

The power data files that you extract from your power monitoring system can subsequently be
uploaded by your Service Engineer into Power Advisor for analysis.

This guide describes how to obtain and run the Data Extractor, and how to configure the Data
Extractor to extract data from your power monitoring system.

Downloading and unblocking the Data Extractor

To download and unblock the Data Extractor:

1. Download the latest version of the Power Advisor Data Extractor package from the Exchange
Community. (Requires log in.)
2. Extract the contents of the ZIP file to a folder where you have read and write access.

NOTE: The computer does not need to be the PME server, but it must have network access
to the database server.

3. Unblock the executable file:

a. Right-click the executable and then click Properties.
b. Click Unblock.
c. Click OK.

Running the Data Extractor

Run the Power Advisor Data Extractor on the same computer that has the Power Monitoring Expert
SQL Server , or a computer where there is network access to the SQL instance.

NOTE: Running the Data Extractor on the same computer as PME allows it to get the credentials
to the PME databases automatically. This is the only option that allows the Data Extractor to sync
with the PME Cloud Agent.

Prerequisites
To run the Power Advisor Data Extractor, you need:

• Microsoft .NET Framework 4.5

• Microsoft SQL Server connection details to the Power Monitoring Expert databases.

NOTE: If PME is using SQL Server Express, you can only use the Data Extractor locally on the
PME Server.

Page 6 7EN42-0207-01
Manual Data Extraction Guide Extract data

To run the Data Extractor:

1. In Windows Explorer, navigate to the folder where you extracted the Data Extractor ZIP file,
and then run the Power Advisor Data Extractor.

For example:

The Data Extractor opens and displays the PME Databases and Customer Information
tab.

NOTE: Depending on site security, you might need to contact the IT team to run the
executable file.

Configuring the Data Extractor

Configure the Data Extractor by setting the database and your customer information, selecting
sources, and then verifying the measurement mapping file and setting extraction period.

After the extraction configuration settings are defined, you can extract data from the power
monitoring system.

NOTE: To run another data extraction using a different configuration, repeat ALL the following
steps. Skipping a step or providing wrong information can lead to wrong data extraction.

To configure and run the Data Extractor:

1. Click the PME Databases and Customer Information tab.

2. In the PME Databases section:
a. Verify the PME SQL Server address and instance name, and the ION Data, ION Network,
Application Modules, and ION SystemLog database names.
b. Select an Authentication Method for the connection to the SQL Server.

For example:

7EN42-0207-01 Page 7
Extract data Manual Data Extraction Guide

c. Click Test PME SQL Server Connection and Retrieve Sources to verify that the data
provided is correct.

A status message appears under the button. For example: 

d. (Optional) Resolve any connection issues before proceeding.

3. In the Customer Information section:

a. Enter your Customer Name and your Contract ID provided in the confirmation email for
provisioning Power Advisor diagnostics access.
b. Click Extract DataSource ID to retrieve the PME DataSource ID.

For example:

For detailed information on the PME Databases and Customer Information fields, see the
'PME Databases and Customer Information' section in the EcoStruxure Power Advisor User
Guide.
4. In the PME Sources Selection section:
a. Verify that the sources needed are selected for Import.

NOTE: If there are more than 1200 sources, see the 'Extracting large amounts of data'
section in the EcoStruxure Power Advisor User Guide.

b. Verify that LOGINSERTER, QUERYSERVER, and any VIP sources are not selected for
Import.

Any third-party devices or devices not recording energy data should be considered
separately. For more information, see the 'Including custom quantities' section in the
EcoStruxure Power Advisor User Guide.
c. Unless you are extracting data from a large system, do not click Save selection.

5. Go to the Data Extraction tab. In this tab:

a. Click Browse (the folder icon) and make sure MAP_PAL.xml is selected.
b. Verify that you are using the correct Measurement Map File; either the default or the cus-
tom one if there are custom quantities. For details, see the 'Including custom quantities'
section in the EcoStruxure Power Advisor User Guide.

Page 8 7EN42-0207-01
Manual Data Extraction Guide Extract data

c. Select From Date and To Date for data extraction. The default date range is one month.
Typically, you will not need to change this value.

NOTE: In most cases, one month of data is enough. The date range should not exceed
three months. If the date range is greater than three months, the connection could time
out (throw an exception) interrupting the extraction.

d. Click Cross Map File and Available Sources / Measurements. The list of meas-
urements appears to preview the sources and measurements that will be extracted. For
example:

e. Verify that the list includes the expected sources and measurements.

TIP: Use the Filter Icon (located next to each column name) to check specific devices.

To examine the source/measurement pairs that had data, but not for the date range you
selected, go to the Without Data tab.
f. In Destination Folder, select a target location on your machine for the extracted files.
g. Click History (Alarms and Waveforms are used internally only; they are not related to
the Power Advisor tests.)

7EN42-0207-01 Page 9
Extract data Manual Data Extraction Guide

h. Click Extract Data.

During extraction you can see the progress in the status bar at the bottom of the
application. The selected data appears in the indicated destination folder.

For detailed information on the Data Extraction fields, see the 'Data Extraction' section in the
EcoStruxure Power Advisor User Guide.

The Data Extractor creates several files you can upload to Power Advisor; it also creates log
files. For more information on these files, see "Files produced by the Data Extractor" on page
10.
6. Close the Data Extractor.

7. Send all the extracted files to your Service Engineer.

Files produced by the Data Extractor

History files
The Data Extractor saves the following history files to the destination folder:

File Description

Contains one or more .HIST files. When a .HIST file is

<customer_name> ! approximately 100MB in size, a new .HIST file is created.
<start_date> ! <end_date>
! History Files.zip The file names include file n of m, where n is the file number and
m is the total number of files.

<customer_name> !
<start_date> ! <end_date> Contains the selected alarm data (.CSV) and waveforms
! Additional Data for (COMTRADE).
Analytics.zip

<customer_name> ! Contains the device names and types with an empty column
Sources for Hierarchy labeled Parent. This is an optional file if the hierarchy will be
Building.xlsx defined in Microsoft Excel.

Log files
The Data Extractor saves the following log files to the same directory as the Power Advisor Data
Extractor executable:

File Description

Extractor.txt A log file of operations done.

Extractor_Error.txt A log file of errors encountered while performing operations.

Page 10 7EN42-0207-01
Schneider Electric
35 rue Joseph Monier
92500 Rueil Malmaison – France

Phone: +33 (0) 1 41 70 00

www.se.com

As standards, specifications, and designs change from time to time, please

ask for confirmation of the information given in this publication.

© 2020 Schneider Electric. All Rights Reserved.

7EN42-0207-01 06/2020