DCE API

[TS1]

Hi, 

Exploring the option of using the SOAP Api calls associated with DCE to get the below details for the UPS or any power devices:

1. Input Voltage
2. UPS on Battery
3. Battery Faults

DCE Dashboard version: 7.5

Please let me know if there are any options to get the above details.

[Cory_McDonald]

Hello @TS1,

I would recommend doing any integrations with Rest API for DCE, which is available starting in DCE version 8.1.0: https://community.se.com/t5/DCE-FAQ/Data-Center-Expert-REST-API/ta-p/463059

To do the level of filtering that you are looking for you will have to parse data within your application or polling utility.

1. For input voltage, you will need to poll the /v1/sensors/type/{type} for type of NUMBER and then filter the data further within your tool to look for specific kind of "voltage" and label of "Input Voltage".  This will give you all input voltages for all devices in DCE. 

If you are only looking for a specific devices input voltage, you can instead use the /v1/devices/{guid}/sensors call and use the GUID of the device in question to poll all of its sensors and then do the filtering.

It is recommended that if you are building polls that will reoccur that you store the GUID's of the devices and sensors that you need and you can then do very specific calls for the data in question instead of polling all data each time, which may cause you to reach the rate limit of the API.

2. Similar to #1 you can instead use the /v1/alarms to poll all alarms and then parse for the specific text string you desire in the "description" field.

You can also poll alarms for specific devices using the /v1/devices/{guid}/alarms call.

3. Same process as #2.

Kind Regards,
Cory

[TS1]

Thanks Cory for the response. But currently DCE dashboard version is 7.5. Is it possible to get the details such as input voltage, battery faults , ups on battery  using the SOAP API calls. 

[Shaun]

Hi @TS1,

There's really no shortcut to this in the SOAP API.  You need to use getSensorsForDevice() from the SensorService endpoint to list out the sensors available, record the IDs for the ones you're interested in, and then getSensorData() (from the same endpoint) to retrieve the values.

It's difficult to provide shortcuts to get to specific data, because .. for example, batteries - does the device have a battery, two batteries, battery modules, battery strings, battery frames, a BMS, etc. The sensors available for a device will vary wildly depending on the device itself.

(Aside: For new integrations, I really would recommend upgrading to a current version to get access to the REST API.  I've been using the SOAP API for years and I will not miss it. A small time investment now will have ongoing payoff.)

[Cory_McDonald]

Hello @TS1,

I highly recommend upgrading DCE as you are currently on an unsupported version.  You can check out our End of Life policy here so you know which versions of DCE are currently supported: https://community.se.com/t5/EcoStruxure-IT-Policies/End-of-Life-Policy/ta-p/446509

As an FYI, DCE 7.5 has been end-of-life about 5 years ago in December 2019.

Kind Regards,

Cory