Document Escalation Operator ||

The document escalation || operator can be used to create escalation documents, day of week documents, time of day documents, or time of week documents. If at least one of the operands is a document or a java.io.InputStream or a java.io.Reader, the other is converted to a document. This conversion only supports the prompt conversion as seen in Prompt Conversions. The result of this operator will be a new document. It is syntactically left-associative (it groups left-to-right). It is fully associative with respect to both side effects and result value; that is, for any expressions a, b, and c, evaluation of the expression ((a)||(b))||(c) produces the same result, with the same side effects occurring in the same order, as evaluation of the expression (a)||((b)||(c)).

			DocumentEscalationExpression:
						DocumentExpression || DocumentEscalationExpression
						InputStreamExpression || DocumentEscalationExpression
						ReaderExpression || DocumentEscalationExpression

The determination of the type of document that will result from this operator depend on how the first two document operands (in a sequence of || operators) were qualified using the @ operator:

1. If both document operands are qualified with a time of day and a day of week then the resulting document will be a time of week document. All remaining operands of subsequent || operators are going to be added as documents for subsequent time of week and must then be qualified with at least both a time of day and a day of week or a parse-time error will occur. Other qualifiers if present will be ignored.

2. Otherwise, if both document operands are qualified with a day of week then the resulting document will be a day of week document. All remaining operands of subsequent || operators are going to be added as documents for subsequent day of week and must then be qualified with at least a day of week or a parse-time error will occur. Other qualifiers if present will be ignored.

3. Otherwise, if both document operands are qualified with a time of day then the resulting document will be a time of day document. All remaining operands of subsequent || operators are going to be added as documents for subsequent time of day and must then be qualified with at least a time of day or a parse-time error will occur. Other qualifiers if present will be ignored.

4. Otherwise, the resulting document will be an escalation document. All remaining operands of subsequent || operators are going to be added as subsequent escalation and their qualifications will be ignored.