Description
As a COMPAS service user, this US purpose is to create a new SSD file with its Header but also its Substation, VoltageLevel, Voltage and Bay sections.
As service user, I would like to create a new SSD file with its Header but also its Substation, VoltageLevel, Voltage and Bay sections.
The US has to fulfill the 61850-6 XSD schema. This US is contributing to the following functional services as described in the 61850-6:
- S45 Edit / create substation topology (connections between primary equipment (9.2.4)
To define context, COMPAS service checks:
- If the SSD file Header.id or header.version or header.revision is not provided as input, COMPAS service is in creation mode to create new SSD file.
- If the SSD file Header.id and header.revision and header.version are provided as input, COMPAS service is in update mode to edit an already existing SSD file and add new inputs objets.
SSD file creation UseCase:
The COMPAS service checks if the SSD file defined by the header.id, the header.version and header.revision are existing or not. If not, the COMPAS service create the new SSD file.
The Header.toolID is fixed string "COMPAS" and is not provided as input.
The Header.id is an automated generated GUID
The Header.revision is set to A
The Header.version is set to 1
The inputs of this service are:
- SSD filename (string) (required). It shall be unique within the database.
- Header.id, Header.version (string) and Header.revision (string) (required if header.id, header.revision and header.version is not referring to existing create the SSD file)
- Hitem.who, what, why attributes (optional) ; the Header/History/Hitem.when is automatically defined as current system date/time
- Substation.name (string) (required). It shall be unique within SSD file.
- VoltageLevel.nomFreq (string) (optional), VoltageLevel.numPhases (number) (optional) and VoltageLevel.name (string) (required). VoltageLevel.name shall be unique within a Substation section.
- Voltage section is optional :
- Case 1) All Voltage attributes are kept empty or omitted then Voltage section will not be created
- Case 2) If Voltage section exists, provide Voltage.unit (string) (required), Voltage.multiplier (string) (optional) and Voltage/Value (number) (required)
- Bay.name (string) (required). It shall be unique within a VoltageLevel section.
US process
SSD file creation UseCase:
The following steps have to be considered to create a new SSD file with its Header and its Substation, VoltageLevel and Bay section.:
If Header.id and Header.revision and Header.version is not referring to an existing SSD file the COMPAS service creates the new SSD file.
If a mandatory attribute is missing then an error message is returned and the processing is aborted
- Create the SSD file with its Name, Header and Hitem
- Insert into Substation.name, the VoltageLevel node with its attributes:
-- VoltageLevel.nomFreq (optional)
-- VoltageLevel.numPhases (optional)
-- VoltageLevel.name (required)
If at least Voltage value is specified as input, insert into VoltageLevel the Voltage:
- Voltage.unit (required if Voltage section exists)
- Voltage.multiplier (optional if Voltage section exists)
- Voltage/Value (required if Voltage section exists)
Insert into VoltageLevel, the Bay section with its name
For new SSD file creation, a new Hitem node is appended:
- Hitem.revision = current Header.revision and Hitem.version=current Header.version (required)
- Hitem.who, what, why attributes (optional).
Output
The header.id, header.revision and header.version are output in case of new SSD file creation
A Substation, VoltageLevel, Voltage (optional) and Bay sections are inserted into SSD file
The SSD file is stored in the database with the Header.id, Header.version and Header.revision as attributes
A message is returned to user in case of success or not of the processing
Error messages
If a mandatory attribute is missing then an error message is returned: "This attribut is mandatory attribut_name. End of processing."