complexType HiddenPeriod
diagram wp_diagrams/wp_p2674.png
namespace http://api.brm.n2.tibco.com
children hiddenDuration visibleDate
annotation
documentation
Information about how long the specified work item should remain hidden.

If a hiddenPeriod is specified the work item will transition to the PendHidden state, rather than Pended. Operations that work on the Pended state (e.g. reallocateWorkItem) cannot then access the work item until either of the following occurs.

- the hiddenPeriod expires.

- a further pendWorkItem operation is specified with a hiddenPeriod of 0. This cancels the current hiddenPeriod. (A negative duration or date that is in the past will have the same effect.)

The work item then transitions back to the state that was in before it was hidden.

NOTE: The duration of a hiddenPeriod can also be extended or reduced by issuing a further pendWorkItem operation with a new hiddenPeriod. The new hiddenPeriod overrides the existing hiddenPeriod and is calculated from the current date/time.

For example, suppose that a work item was pended at 2.30 with a hiddenPeriod of 30 minutes. If a further pendWorkItem is issued at 2.45 with:

- a hiddenPeriod of 2 hours, the work item will remain hidden until 4.45.

- a hiddenPeriod of 5 minutes, the work item will remain hidden until 2.50.

- a hiddenPeriod of 0, the work item will immediately transition to the Allocated state.

- a hiddenPeriod of -5 minutes, the work item will immediately transition to the Allocated state.
source <xsd:complexType name="HiddenPeriod">
 
<xsd:annotation>
   
<xsd:documentation>Information about how long the specified work item should remain hidden.

If a hiddenPeriod is specified the work item will transition to the PendHidden state, rather than Pended. Operations that work on the Pended state (e.g. reallocateWorkItem) cannot then access the work item until either of the following occurs.

- the hiddenPeriod expires.

- a further pendWorkItem operation is specified with a hiddenPeriod of 0. This cancels the current hiddenPeriod. (A negative duration or date that is in the past will have the same effect.)

The work item then transitions back to the state that was in before it was hidden.

NOTE: The duration of a hiddenPeriod can also be extended or reduced by issuing a further pendWorkItem operation with a new hiddenPeriod. The new hiddenPeriod overrides the existing hiddenPeriod and is calculated from the current date/time.

For example, suppose that a work item was pended at 2.30 with a hiddenPeriod of 30 minutes. If a further pendWorkItem is issued at 2.45 with:

- a hiddenPeriod of 2 hours, the work item will remain hidden until 4.45.

- a hiddenPeriod of 5 minutes, the work item will remain hidden until 2.50.

- a hiddenPeriod of 0, the work item will immediately transition to the Allocated state.

- a hiddenPeriod of -5 minutes, the work item will immediately transition to the Allocated state.
</xsd:documentation>
 
</xsd:annotation>
 
<xsd:choice minOccurs="0">
   
<xsd:element name="hiddenDuration" type="ItemDuration">
     
<xsd:annotation>
       
<xsd:documentation>Duration that the work item is hidden.</xsd:documentation>
     
</xsd:annotation>
   
</xsd:element>
   
<xsd:element name="visibleDate" type="xs:dateTime">
     
<xsd:annotation>
       
<xsd:documentation>Fixed date/time when the work item becomes visible.</xsd:documentation>
     
</xsd:annotation>
   
</xsd:element>
 
</xsd:choice>
</xsd:complexType>

element HiddenPeriod/hiddenDuration
diagram wp_diagrams/wp_p2675.png
type ItemDuration
properties
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
years  xs:int  optional  0    
documentation
Number of years in this duration period.
months  xs:int  optional  0    
documentation
Number of months in this duration period.
weeks  xs:int  optional  0    
documentation
Number of weeks in this duration period.
days  xs:int  optional  0    
documentation
Number of days in this duration period.
hours  xs:int  optional  0    
documentation
Number of hours in this duration period.
minutes  xs:int  optional  0    
documentation
Number of minutes in this duration period.
annotation
documentation
Duration that the work item is hidden.
source <xsd:element name="hiddenDuration" type="ItemDuration">
 
<xsd:annotation>
   
<xsd:documentation>Duration that the work item is hidden.</xsd:documentation>
 
</xsd:annotation>
</xsd:element>

element HiddenPeriod/visibleDate
diagram wp_diagrams/wp_p2676.png
type xs:dateTime
properties
content simple
annotation
documentation
Fixed date/time when the work item becomes visible.
source <xsd:element name="visibleDate" type="xs:dateTime">
 
<xsd:annotation>
   
<xsd:documentation>Fixed date/time when the work item becomes visible.</xsd:documentation>
 
</xsd:annotation>
</xsd:element>

WSDL documentation generated by XMLSpy WSDL Editor http://www.altova.com/xmlspy