Enterprise Objects > Enterprise Operations > CygNet Native Operations > Facility

Facility Operations

Read Operations Description

GetFacilityAttrList

Returns the values of specified facility attributes for the facility IDs that meet filter requirements.

GetFacilityAttrMetadata

Returns the facility attribute metadata information for the active attributes for the Facility Service to which the request resolves.

Write Operations Description

AddFacilities

Adds multiple new facilities and facility attribute values, as described above.

AddFacility

Adds a new facility and facility attribute values.

UpdateFacilities

Updates the attribute values of multiple existing Facility IDs, as described above.

UpdateFacility

Updates the attribute values of an existing Facility ID.

DeleteFacilities

Deletes multiple facilities, as described above.

DeleteFacility

Deletes a facility.

GetFacilityAttrList

Given a service name (FAC, UIS, CVS), a facility attribute search filter and a list of facility attributes to return, this operation will return an XML response containing the list of facilities matched by the filter string, each including the facility attributes requested.  The return XML will also indicate success or failure.

Usage

The following table lists and describes all of the child elements of the request node (<GetFacilityAttrListReq>).

Element Name Required Description

SvcName

Yes

The Site.Service to which to connect.  This parameter must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

FacilityFilter

No

A set of rules to filter the returned facilities by facility attributes.

FacilityAttributes

No

The set of facility attributes to return.

Filter

The facility filter node (<FacilityFilter>) must contain a set of rules (based on facility attributes) used to filter the facilities which will be returned by this operation.  The filter may consist of a hierarchy of expressions using the <MultiExpr> and <SingleExpr> tags.  The following example will filter all facilities for which FacilityAttr0 contains the string “Test” AND FacilityCategory equals “GENFAC”.

<FacilityFilter>

<MultiExpr operator="AND" inverse="false">

<SingleExpr compare="EQ">

<FacilityAttr0>*Test*</FacilityAttr0>

</SingleExpr>

<SingleExpr compare="EQ">

<FacilityCategory>GENFAC</FacilityCategory>

</SingleExpr>

</MultiExpr>

</FacilityFilter>

Target Services

The service name node (<SvcName>) must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

Examples

Request

<?xml version="1.0"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721" >

<GetFacilityAttrListReq>

<SvcName>CYGDEMO.FAC</SvcName>

<FacilityFilter>

<MultiExpr operator="AND" inverse="false">

<SingleExpr compare="EQ">

<FacilityAttr0>*Test*</FacilityAttr0>

</SingleExpr>

<SingleExpr compare="EQ">    

<FacilityCategory>GENFAC</FacilityCategory>

</SingleExpr>

</MultiExpr>

</FacilityFilter>

 

<FacilityAttributes>

<FacilitySite/>

<FacilityService/>

<FacilityCategory/>

<FacilityAttr0/>

</FacilityAttributes>

</GetFacilityAttrListReq>

</CygNetEnterpriseOperations>

Response

The following example represents a successful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721">

<GetFacilityAttrListResp>

<FacilityList>

<Facility facilitytag="CYGDEMO.UIS::TEST1">

<FacilitySite>CYGDEMO</FacilitySite>

<FacilityService>UIS</FacilityService>

<FacilityCategory>GENFAC</FacilityCategory>

<FacilityAttr0>Test 1</FacilityAttr0>

</Facility>

<Facility facilitytag="CYGDEMO.UIS::TEST2">

<FacilitySite>CYGDEMO</FacilitySite>

<FacilityService>UIS</FacilityService>

<FacilityCategory>GENFAC</FacilityCategory>

<FacilityAttr0>Test 2</FacilityAttr0>

</Facility>

</FacilityList>

<OperationResults success="true" resp_timestamp="2011-11-25T21:01:15.118Z" exec_duration="PT0.270S" />

</GetFacilityAttrListResp>

</CygNetEnterpriseOperations>

The following example represents an unsuccessful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

<GetFacilityAttrListResp>

<FacilityList />

<OperationResults success="false" resp_timestamp="2011-07-30T22:12:22.983Z" exec_duration="PT0.002S">

<OperationResult type="ERROR" code="50003">Security check failed for ACS application ENTOPS and event ACCESS0</OperationResult>

<OperationResult type="ERROR" code="50208">You are not permitted to execute this operation</OperationResult>

</OperationResults>

</GetFacilityAttrListResp>

</CygNetEnterpriseOperations>

Back to top

GetFacilityAttrMetadata

Given a service name (FAC, UIS, CVS), this operation will return an XML response containing the active facility attribute metadata information for the specified facility service.  This will be useful for exposing any “nice names” that have been assigned to specific facility attributes.  The return XML will also indicate success or failure.

Usage

The following table lists and describes all of the child elements of the request node (<GetFacilityAttrMetadataReq>).

Element Name Required Description

SvcName

Yes

The Site.Service to which to connect.  This parameter must specify the name of a FAC, UIS, or CVS Site.Service.  If a UIS or CVS is specified, the service will resolve to its associated FAC

Target Services

The service name node (<SvcName>) must specify the name of a FAC, UIS, or CVS Site.Service.  If a UIS or CVS is specified, the service will resolve to its associated FAC.

Examples

Request

<?xml version="1.0"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721" >

<GetFacilityAttrMetadataReq>

<SvcName>CYGDEMO.SVCMON</SvcName>

</GetFacilityAttrMetadataReq>

</CygNetEnterpriseOperations>

Response

The following example represents a successful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721">

<GetFacilityAttrMetadataResp>

<FacAttrMetadata>

<FacilityAttr0>Attribute 0</FacilityAttr0>

<FacilityAttr1>Attribute 1</FacilityAttr1>

<FacilityAttr2>Attribute 2</FacilityAttr2>

<FacilityAttr3>Attribute 3</FacilityAttr3>

<FacilityAttr4>Attribute 4</FacilityAttr4>

<FacilityAttr5>Attribute 5</FacilityAttr5>

<FacilityInfo0>Facility Location</FacilityInfo0>

<FacilityInfo1>Facility Contact</FacilityInfo1>

</FacAttrMetadata>

<OperationResults success="true" resp_timestamp="2011-10-05T21:47:09.457Z" exec_duration="PT17.483S"></OperationResults>

</GetFacilityAttrMetadataResp>

</CygNetEnterpriseOperations>

The following example represents an unsuccessful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

<GetFacilityAttrMetadataResp>

<FacAttrMetadata />

<OperationResults success="false" resp_timestamp="2011-07-30T22:12:57.675Z" exec_duration="PT0.002S">

<OperationResult type="ERROR" code="50003">Security check failed for ACS application ENTOPS and event ACCESS0</OperationResult>

<OperationResult type="ERROR" code="50208">You are not permitted to execute this operation</OperationResult>

</OperationResults>

</GetFacilityAttrMetadataResp>

</CygNetEnterpriseOperations>

Back to top

AddFacilities

Given a service name (FAC, UIS, CVS) and a list of facility attributes/value pairs, this operation will add new facility records.  The return XML will indicate success or failure.

Usage

The following table lists and describes all of the child elements of the request node (<AddFacilitiesReq>).

Element Name Required Description

AllowPartialFailure

No

If this element is set to true, the operation will log an error and continue to run if it fails to add a facility.  Otherwise, the operation will terminate immediately upon failing to add a facility.

SvcName

Yes

The Site.Service to which to connect.  This parameter must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

Facilities

No

A list of facility tags and facility attributes/value pairs representing the facilities to be added.  A Facility ID is specified by the facility tag node (<FacilityTag>).  Attribute values are nested in the <Parameters> node.

The list of facility attributes provided must include the minimum set, as specified in the XML schema, to establish a valid facility record.

Target Services

The service name node (<SvcName>) must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

Examples

Request

The following example utilizes AllowPartialFailure by attempting to add a facility with a tag that already exists in the FAC service.

<?xml version="1.0"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730" >

<AddFacilitiesReq>

<AllowPartialFailure>true</AllowPartialFailure>

<SvcName>CYGDEMO.FAC</SvcName>

<Facilities>

<Facility>

<FacilityTag>CYGDEMO.SVCMON::ADDTEST</FacilityTag>

<Parameters>

<FacilityAttr0>Test</FacilityAttr0>

</Parameters>

</Facility>

<Facility>

<FacilityTag>CYGDEMO.SVCMON::ADDTEST1</FacilityTag>

<Parameters>

<FacilityAttr0>Test1</FacilityAttr0>

</Parameters>

</Facility>

<Facility>

<FacilityTag>CYGDEMO.SVCMON::ADDTEST2</FacilityTag>

<Parameters>

<FacilityAttr0>Test2</FacilityAttr0>

</Parameters>

</Facility>

<Facility>

<FacilityTag>CYGDEMO.SVCMON::IEXIST</FacilityTag>

</Facility>

</Facilities>

</AddFacilitiesReq>

</CygNetEnterpriseOperations>

Response

The following example represents a successful response, with a warning to indicate that a facility with the tag “CYGDEMO.SVCMON::IEXIST” already exists in the FAC service.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

<AddFacilitiesResp>

<OperationResults success="true" resp_timestamp="2011-05-20T22:44:48.444Z" exec_duration="PT0.693S">

<OperationResult type="WARNING" code="50407">Facility with tag CYGDEMO.SVCMON::IEXIST already exists</OperationResult>

</OperationResults>

</AddFacilitiesResp>

</CygNetEnterpriseOperations>

The following example represents an unsuccessful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

<AddFacilitiesResp>

<OperationResults success="false" resp_timestamp="2011-07-30T22:12:15.723Z" exec_duration="PT0.002S">

<OperationResult type="ERROR" code="50003">Security check failed for ACS application ENTOPS and event ACCESS2</OperationResult>

<OperationResult type="ERROR" code="50208">You are not permitted to execute this operation</OperationResult>

</OperationResults>

</AddFacilitiesResp>

</CygNetEnterpriseOperations>

Back to top

AddFacility

Given a service name (FAC, UIS, CVS) and a list of facility attributes/value pairs, this operation will add a new facility record.  The return XML will indicate success or failure.

Usage

The following table lists and describes all of the child elements of the request node (<AddFacilityReq>).

Element Name Required Description

SvcName

Yes

The Site.Service to which to connect.  This parameter must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

FacilityTag

Yes

The tag of the new facility to be added.

Parameters

No

A list of facility attribute/value pairs for the added facility.

The list of facility attributes provided must include the minimum set, as specified in the XML schema, to establish a valid facility record.

Target Services

The service name node (<SvcName>) must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

Examples

Request

<?xml version="1.0"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721" >

  <AddFacilityReq>

    <SvcName>CYGDEMO.FAC</SvcName>

    <FacilityTag>CYGDEMO.SVCMON::ADDTEST</FacilityTag>

    <Parameters>

      <FacilityAttr0>Test</FacilityAttr0>

      <FacilityAttr1>Test</FacilityAttr1>

    </Parameters>

  </AddFacilityReq>

</CygNetEnterpriseOperations>

Response

The following example represents a successful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721">

  <AddFacilityResp>

    <OperationResults success="true" resp_timestamp="2011-09-11T20:44:07.724Z" exec_duration="PT54.956S"></OperationResults>

  </AddFacilityResp>

</CygNetEnterpriseOperations>

The following example represents an unsuccessful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

  <AddFacilityResp>

    <OperationResults success="false" resp_timestamp="2011-07-30T22:12:15.723Z" exec_duration="PT0.002S">

      <OperationResult type="ERROR" code="50003">Security check failed for ACS application ENTOPS and event ACCESS2</OperationResult>

      <OperationResult type="ERROR" code="50208">You are not permitted to execute this operation</OperationResult>

    </OperationResults>

  </AddFacilityResp>

</CygNetEnterpriseOperations>

Back to top

UpdateFacilities

Given a service name (FAC, UIS, CVS), a list of facility tags and a list of facility attributes/value pairs for each tag, this operation will update the attributes of existing facility records.  The return XML will indicate success or failure.

Usage

The following table lists and describes all of the child elements of the request node (<UpdateFacilitiesReq>).

Element Name Required Description

AllowPartialFailure

No

If this element is set to true, the operation will log an error and continue to run if it fails to update a facility.  Otherwise, the operation will terminate immediately upon failing to update a facility.

SvcName

Yes

The Site.Service to which to connect.  This parameter must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

Facilities

No

A list of facility tags and facility attributes/value pairs representing the facilities to update.  A Facility ID is specified by the facility tag node (<FacilityTag>).  Attribute values are nested in the <Parameters> node.

The list of facility attributes provided must not include any of the “key” attributes. 

Target Services

The service name node (<SvcName>) must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

Examples

Request

The following example utilizes AllowPartialFailure by attempting to update a facility with a tag that does not exist in the FAC service.

<?xml version="1.0"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730" >

<UpdateFacilitiesReq>

<AllowPartialFailure>true</AllowPartialFailure>

<SvcName>CYGDEMO.SVCMON</SvcName>

<Facilities>

<Facility>

<FacilityTag>CYGDEMO.SVCMON::UPDATETEST</FacilityTag>

<Parameters>

<FacilityDesc>New description</FacilityDesc>

<FacilityAttr0>Test</FacilityAttr0>

</Parameters>

</Facility>

<Facility>

<FacilityTag>CYGDEMO.SVCMON::UPDATETEST1</FacilityTag>

<Parameters>

<FacilityDesc>New description</FacilityDesc>

<FacilityAttr0>Test</FacilityAttr0>

</Parameters>

</Facility>

<Facility>

<FacilityTag>CYGDEMO.SVCMON::NOTEXIST</FacilityTag>

<Parameters>

<FacilityDesc>I don't exist</FacilityDesc>

</Parameters>

</Facility>

</Facilities>

</UpdateFacilitiesReq>

</CygNetEnterpriseOperations>

Response

The following example represents a successful response, with a warning to indicate that a facility with the tag “CYGDEMO.SVCMON::NOTEXIST” already exists in the FAC service.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

<UpdateFacilitiesResp>

<OperationResults success="true" resp_timestamp="2011-05-20T22:46:35.417Z" exec_duration="PT0.590S">

<OperationResult type="WARNING" code="50407">Facility with tag CYGDEMO.SVCMON::NOTEXIST does not exist</OperationResult>

</OperationResults>

</UpdateFacilitiesResp>

</CygNetEnterpriseOperations>

The following example represents an unsuccessful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

<UpdateFacilitiesResp>

<OperationResults success="false" resp_timestamp="2011-07-30T22:12:28.107Z" exec_duration="PT0.002S">

<OperationResult type="ERROR" code="50003">Security check failed for ACS application ENTOPS and event ACCESS1</OperationResult>

<OperationResult type="ERROR" code="50208">You are not permitted to execute this operation</OperationResult>

</OperationResults>

</UpdateFacilitiesResp>

</CygNetEnterpriseOperations>

Back to top

UpdateFacility

Given a service name (FAC, UIS, CVS), a facility tag and a list of facility attributes/value pairs, this operation will update the attributes of an existing facility record.  The return XML will indicate success or failure.

Usage

The following table lists and describes all of the child elements of the request node (<UpdateFacilityReq>).

Element Name Required Description

SvcName

Yes

The Site.Service to which to connect.  This parameter must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

FacilityTag

Yes

The tag of the facility to update.

Parameters

No

A list of facility attribute/value pairs to update. 

The list of facility attributes provided must not include any of the “key” attributes.

Target Services

The service name node (<SvcName>) must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

Examples

Request

<?xml version="1.0"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721" >

<UpdateFacilityReq>

<SvcName>CYGDEMO.SVCMON</SvcName>

<FacilityTag>CYGDEMO.SVCMON::UPDATETEST</FacilityTag>

<Parameters>

<FacilityDesc>New description</FacilityDesc>

<FacilityAttr0>Test</FacilityAttr0>

</Parameters>

</UpdateFacilityReq>

</CygNetEnterpriseOperations>

Response

The following example represents a successful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721">

<UpdateFacilityResp>

<OperationResults success="true" resp_timestamp="2011-09-11T20:44:07.724Z" exec_duration="PT54.956S"></OperationResults>

</UpdateFacilityResp>

</CygNetEnterpriseOperations>

The following example represents an unsuccessful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

<UpdateFacilityResp>

<OperationResults success="false" resp_timestamp="2011-07-30T22:12:28.107Z" exec_duration="PT0.002S">

<OperationResult type="ERROR" code="50003">Security check failed for ACS application ENTOPS and event ACCESS1</OperationResult>

<OperationResult type="ERROR" code="50208">You are not permitted to execute this operation</OperationResult>

</OperationResults>

</UpdateFacilityResp>

</CygNetEnterpriseOperations>

The list of facility attributes provided must not include any of the “key” attributes. The attribute values are nested in the <Parameters> node.

The service name node (<SvcName>) must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

Back to top

DeleteFacilities

 Given a service name (FAC, UIS, CVS) and a list of facility tags, this operation will delete the specified facility records.  The return XML will indicate success or failure.

Note: Delete associated device and point records before deleting a facility.

Usage

The following table lists and describes all of the child elements of the request node (<DeleteFacilitiesReq>).

Element Name Required Description

AllowPartialFailure

No

If this element is set to true, the operation will log an error and continue to run if it fails to delete a facility.  Otherwise, the operation will terminate immediately upon failing to delete a facility.

SvcName

Yes

The Site.Service to which to connect.  This parameter must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

FacilityTags

Yes

A list of tags of facilities to delete. 

Target Services

The service name node (<SvcName>) must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

Examples

Request

The following example utilizes AllowPartialFailure by attempting to delete a facility with a tag that does not exist in the FAC service.

<?xml version="1.0"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730" >

<DeleteFacilitiesReq>

<AllowPartialFailure>true</AllowPartialFailure>

<SvcName>CYGDEMO.SVCMON</SvcName>

<FacilityTags>

<FacilityTag>CYGDEMO.SVCMON::DELETETEST</FacilityTag>

<FacilityTag>CYGDEMO.SVCMON::DELETETEST1</FacilityTag>

<FacilityTag>CYGDEMO.SVCMON::DELETETEST2</FacilityTag>

<FacilityTag>CYGDEMO.SVCMON::NOTEXIST</FacilityTag>

</FacilityTags>

</DeleteFacilitiesReq>

</CygNetEnterpriseOperations>

Response

The following example represents a successful response, with a warning to indicate that a facility with the tag “CYGDEMO.SVCMON::NOTEXIST” already exists in the FAC service.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

<DeleteFacilitiesResp>

<OperationResults success="true" resp_timestamp="2011-05-20T22:47:06.375Z" exec_duration="PT0.241S">

<OperationResult type="WARNING" code="50407">Facility with tag CYGDEMO.SVCMON::NOTEXIST does not exist</OperationResult>

</OperationResults>

</DeleteFacilitiesResp>

</CygNetEnterpriseOperations>

The following example represents an unsuccessful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

<DeleteFacilitiesResp>

<OperationResults success="false" resp_timestamp="2011-07-30T22:13:38.364Z" exec_duration="PT0.002S">

<OperationResult type="ERROR" code="50003">Security check failed for ACS application ENTOPS and event ACCESS3</OperationResult>

<OperationResult type="ERROR" code="50208">You are not permitted to execute this operation</OperationResult>

</OperationResults>

</DeleteFacilitiesResp>

</CygNetEnterpriseOperations>

Back to top

DeleteFacility

Given a service name (FAC, UIS, CVS) and a facility tag, this operation will delete the specified facility record.  The return XML will indicate success or failure.

Note: Delete associated device and point records before deleting the facility.

Usage

The following table lists and describes all of the child elements of the request node (<DeleteFacilityReq>).

Element Name Required Description

SvcName

Yes

The Site.Service to which to connect.  This parameter must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

FacilityTag

Yes

The tag of the facility to be deleted.

Target Services

The service name node (<SvcName>) must specify the name of a FAC, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated FAC.

Examples

Request

<?xml version="1.0"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721" >

<DeleteFacilityReq>

<SvcName>CYGDEMO.SVCMON</SvcName>

<FacilityTag>CYGDEMO.SVCMON::DELETETEST</FacilityTag>

</DeleteFacilityReq>

</CygNetEnterpriseOperations>

Response

The following example represents a successful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721">

<DeleteFacilityResp>

<OperationResults success="true" resp_timestamp="2011-09-11T20:44:07.724Z" exec_duration="PT54.956S"></OperationResults>

</DeleteFacilityResp>

</CygNetEnterpriseOperations>

The following example represents an unsuccessful response.

<?xml version="1.0" encoding="UTF-8"?>

<CygNetEnterpriseOperations

xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730">

<DeleteFacilityResp>

<OperationResults success="false" resp_timestamp="2011-07-30T22:13:38.364Z" exec_duration="PT0.002S">

<OperationResult type="ERROR" code="50003">Security check failed for ACS application ENTOPS and event ACCESS3</OperationResult>

<OperationResult type="ERROR" code="50208">You are not permitted to execute this operation</OperationResult>

</OperationResults>

</DeleteFacilityResp>

</CygNetEnterpriseOperations>

Back to top

Let us know how we can improve this topic.

CygNet at weatherford.com

© 2020 Weatherford. All rights reserved.