...
- The operationId attribute contains the identifier value for the operation that is being referenced.
- The analysisId attribute may contain the identifier of an analysis that uses the method that contains the referenced operation. The analysisId attribute is only used if the results of the referenced operation are always generated by the same analysis. If the analysis that performs the referenced operation may differ depending on which analysis uses the method containing the dependent operation, then the analysis that generates the results of the referenced operation may be specified in the referencedAnalysisOperations attribute of the analysis that uses the dependent (as described below).
- The description attribute may be used to record a details of the relationship, which may include:
- In description of the referenced operation and how its results are used.
- In indication of which analyses are expected to produce the required result values, which may be helpful in situations when the analysisId is not provided in the referenced operation relationship.
| Example |
|---|
|
For example, in an operation that calculates a percentage, For the relationship where referencedOperationRole is - NUMERATOR: "The count operation whose result provides the numerator for calculation of the percentage. The referenced analysis should be the analysis that contains this percent operation."
- DENOMINATOR: "The count operation whose result provides the denominator for calculation of the percentage. The referenced analysis should have the same analysis set and subject grouping factor(s) as the analysis containing this percent operation."
|
If the identifier of the analysis that produces the results of the referenced operation The identifier of the analysis that produces the results of the referenced operation (the "referenced analysis identifier") must be specified. If it is not included in the definition of the referenced operation relationship (i.e., the the analysisId attribute of an instance of the ReferencedOperationRelationship class is not used), then the referenced analysis producing the referenced operation results identifier must be specified as part of the definition of any analysis that uses the method containing the dependent operation. The referenced analysis identifier should not be specified in both the definition of the dependent operation and the definition of an analysis that uses the dependent operation. When the referenced analysis identifier is specified as part of the definition of an analysis that uses the dependent operation, it is specified in the referencedAnalysisOperations attribute of the analysis in an instance of the ReferencedAnalysisOperation class, in which:
- The referencedOperationRelationshipId attribute contains the identifier value of the referenced operation relationship.
- The analysisId attribute contains the referenced analysis identifier.