[Section 10] Support Services [Draft]
1
2
3
4
5
Users of [OpenADR] found that they needed to be able to constrain the application of remote DR
services. For The DR Operator, advanced knowledge of these constraints improved the ability to predict
results. The services in this schedule are based on the services used to tailor expectations in
[OpenADR].
6
7
8
9
Availability and Opt are similar in that they communicate when a Party will receive an Event or participate
in a transactive market. Availability is a long-term schedule for when a Party will consider a response.
Availability could be set at registration or transaction negotiation. Opt (as in opt in or opt out)
encompasses short-term additions to or replacement of the schedule in Availability.
10
11
The combination of Availability and Opt states together define the times during which a committed
response from the VEN is possible or likely.
12
1.1 Relationship of Availability and Opt Information
13
14
Availability and Opt apply to interactions where an action is requested (e.g. curtailment and DER actions),
and only indirectly to (e.g.) price distribution interactions.
15
16
Availability is a long-term description and may be complex. Opt is a short-term description that replaces or
is combined into the long-term availability description.
17
18
19
Availability and Opt-In and Opt-Out, as well as Market Rules, use the VavailabilityType defined in [WSCalendar] which in turn is an XML serialization of [Vavailability]. The semantics are defined in
[Vavailability].
20
21
The behavior of the Availability schedule is defined as follows. We call the parameter passed for Opt-In
and Opt-Out the Opt Vavailability.

22
23
24
25
26
27
28
29
30
31
32
33






The EiAvailability class describes when the VEN expects/commits/plans to be available to
respond to a request for performance, generally an EiEvent.
Exactly one Vavailability is included in the EiAvailability and the EiOpt objects.
EiOpt MUST use exactly one Opt Availability defined with concrete fully specified intervals with no
recursion
An EiOpt that is used in a message MUST have a bounded interval (the Opt Interval) in the Opt
Vavailability1
An Opt-In while in effect adds the available times of the Opt Vavailability to the available times in
the bounded interval for the VEN with respect to a MarketContext, effectively performing a logical
OR operation on the available times but only within the opt Interval
An Opt-Out while in affect replaces the entire portion of the EiAvailability within the opt interval
Exactly zero or one Opt functions MAY be in effect at any time
34
35
In short, Opt-In adds the Opt Vavailability available times to the overall VEN vavailability; Opt-Out
replaces the entirety of its opt Intervals with the contents of the Opt-Out Vavailability.
36
1.1 EiAvail Service
37
38
39
The Availability2 is set by the VEN and indicates when an event may or may not be accepted and
executed by the VEN with respect to a Market Context. Knowing the Availability and Opt information for
its VENs improves the ability of the VTN to estimate response to an event or request.
1
By defining an end time for the Vavailability
2
Called Constraints in [OpenADR1]
energyinterop-v1-0-wd29-SECTION 10 ONLY
Working Draft
Copyright © OASIS® 2011. All Rights Reserved. Standards Track Work Product
October 11, 2011
Page 1 of 9
40
41
42
When Availability is set, opt-in or opt-out does not affect the Availability except for the specific interval(s)
described by the Opt—opting out is temporary unavailability, which may have transaction and business
consequences if an event is created during the opt-out period.
43
44
The modeling for Availability includes behavior indications for the situation where an EiEvent overlaps a
constrained time interval.
45
46
EiAvailability describes only the available times, using the patterns defined in [WS-Calendar] and
[Vavailability].
47
48
49
Table 0-1: Avail Service
Service
Operation
Response
Service
Consumer
Service
Provider
Notes
EiAvail
EiCreateAvail
EiCreatedAvail
VEN
VTN
EiAvail
EiChangeAvail
EiChangedAvail
VEN
VTN
EiAvail
EiDeleteAvail
EiDeletedAvail
VEN
VTN
No return object e.g.
DeletedAvail is required as
the EResponse will indicate
whether the request was
successful
EiAvail
EiRequestAvail
EiReplyAvail
VEN
VTN
To ensure that the VTN
Availability recorded matches
the VEN description or for
recovery
The class EiAvailBehavior defines how an issued EiEvent that conflicts with the current EiAvail is
performed:
50

ACCEPT – accept the issued EiEvent regardless of conflicts with the EiAvail
51

REJECT – reject any EiEvent whose schedule conflicts with the EiAvail
52
53

FORCE – regardless of what the issued DR events parameters are (even if there is no conflict)
force them to be the parameters that were configured as part of the program.3
54

RESTRICT – modify the EiEvent parameters so that they fall within the bounds of the EiAvail
55
1.1.1
56
57






58
59
60
61
62
63
64
3
This requires further definition when Program metadata is defined.
energyinterop-v1-0-wd29-SECTION 10 ONLY
Working Draft
Copyright © OASIS® 2011. All Rights Reserved. Standards Track Work Product
October 11, 2011
Page 2 of 9
65
1.1.2 Interaction Patterns for the EiAvailability Service
66
This is the [UML] interaction diagram for the EiAvail Service.
sd EiAv ail
VEN
VTN
EiCreateAvail()
EiCreatedAvail()
EiChangeAvail()
EiChangedAvail()
EiDeleteAvail()
EiRequestAvail()
EiReplyAvail()
67
68
Figure 0-1: Interaction Pattern for the EiAvailability Service NEED DELETED AVAIL
69
energyinterop-v1-0-wd29-SECTION 10 ONLY
Working Draft
Copyright © OASIS® 2011. All Rights Reserved. Standards Track Work Product
October 11, 2011
Page 3 of 9
70
71
72
1.1.3 Information Model for the EiAvailability Service
Figure 0-2: UML Class Diagram for the EiAvailability and Associated Classes OUT OF DATE
73
energyinterop-v1-0-wd29-SECTION 10 ONLY
Working Draft
Copyright © OASIS® 2011. All Rights Reserved. Standards Track Work Product
October 11, 2011
Page 4 of 9
74
1.1.4 Operation Payloads for the EiAvail Service
75
The [UML] class diagram describes the payloads for the EiAvail service operations.
76
77
Figure 0-3: UML Class Diagram for EiAvailability Service Operation OUT OF DATE
78
energyinterop-v1-0-wd29-SECTION 10 ONLY
Working Draft
Copyright © OASIS® 2011. All Rights Reserved. Standards Track Work Product
October 11, 2011
Page 5 of 9
79
1.2 Opt Service
80
81
82
The Opt service creates and communicates Opt-In and Opt-Out schedules from the VEN to the VTN.
Schedules are combined with EiAvailability and the Market Context requirements to give a complete
picture of the willingness of the VEN to respond to EiEvents received by the VEN.
83
Exactly one Vavailability MUST be provided in EiCreateOptIn and EiCreateOptOut.
84
Opt schedules SHALL override any Availability in place while there is an Opt in effect. See Section 1.1
85
86
Applying EiCreateOptIn or EiCreateOptOut if an Opt is currently in effect replaces the current Opt in effect
with that in the Opt Vavailability, which effectively cancels the current Opt state and Creates a new one.
87
-Table 0-2: Opt-Out Service
Service
Operation
Response
Service
Consumer
Service
Provider
EiOpt
EiCreateOptIn
EiCreatedOptIn
VEN
VTN
EiOpt
EiCreateOptOut
EiCreatedOptOut
VEN
VTN
EiOpt
EiChangeOptState
EiChangedOptState
VEN
VTN
EiOpt
EiCancelOptState
EiCanceledOptState
VEN
VTN
EiOpt
EiRequestOptState
EiReplyOptState
VEN
VTN
88
1.2.1 Interaction Patterns for the EiOpt Service
89
This is the [UML] interaction diagram for the EiOpt Service.
energyinterop-v1-0-wd29-SECTION 10 ONLY
Working Draft
Copyright © OASIS® 2011. All Rights Reserved. Standards Track Work Product
Notes
October 11, 2011
Page 6 of 9
sd EiOpt
VEN
VTN
EiCreateOptState()
EiCreatedOptState()
EiChangeOptState()
EiChangedOptState()
EiDeleteOptState()
EiRequestOptState()
processing()
EiReplyOptState()
90
91
Figure 0-4: Interaction Diagram for the EiOpt Service NEEDS UPDATE
92
energyinterop-v1-0-wd29-SECTION 10 ONLY
Working Draft
Copyright © OASIS® 2011. All Rights Reserved. Standards Track Work Product
October 11, 2011
Page 7 of 9
93
1.2.2 Information Model for the EiOpt Service
94
95
96
Opting in or out is a temporary situation indicating that the VEN will or will not respond to a particular
event or in a specific time period, without changing the potentially complex Availability. The EiOpt
schedule is a [WS-Calendar] VavailabilityType.
97
98
Figure 0-5: UML Class Diagram for EiOpt Class NEEDS UPDATE
99
100
energyinterop-v1-0-wd29-SECTION 10 ONLY
Working Draft
Copyright © OASIS® 2011. All Rights Reserved. Standards Track Work Product
October 11, 2011
Page 8 of 9
101
1.2.3 Operation Payloads for the EiOpt Service
102
The [UML] class diagram describes the payloads for the EiOpt service operations.
103
104
Figure 0-6: UML Class Diagram for EiOpt Service Operation Payloads NEEDS UPDATE
energyinterop-v1-0-wd29-SECTION 10 ONLY
Working Draft
Copyright © OASIS® 2011. All Rights Reserved. Standards Track Work Product
October 11, 2011
Page 9 of 9