Versions Compared

Old Version 6

changes.mady.by.user Richard Marshall

Saved on

compared with

New Version 7

changes.mady.by.user Richard Marshall

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • The id attribute contains the identifier value assigned for the operation.
  • The name attribute indicates the assigned name of the operation.
  • The label attribute contains a short label for the operation, such as might be shown in an output display (e.g., "n", "%", "Mean", "SD").
  • The description attribute may be used record a detailed description of the operation.
  • The referencedOperationRelationships attribute may be used to specify relationships to any other operations whose results are referenced in the calculation of the results for this operation, as described below.
  • The resultPattern attribute contains a textual representation for the default pattern or format used for the display of the results of this operation in output displays. The pattern should indicate the precision of the value to be displayed (e.g., "X.XXX") and may include parentheses or other additional characters (e.g., "(XXX.X)" or "±XX.XX"). In general, the pattern will usually be in the format that is displayed in output table shells, but sponsors may choose to use other pattern specifications.

Some "dependent" operations may be defined to reuse the results of other operations in the calculation of their result values. For example, an operation that calculates a percentage may reuse the results of other "count of subjects" operations to act as the numerator and denominator in the calculation of the percentage. In such operations, the the referencedOperationRelationships attribute of the dependent operation is used to specify 1 or more relationships to the other operation(s) whose results are used, or referenced, in this the dependent operation's calculation. Each relationship is defined as an instance of the ReferencedOperationRelationship class, in which:

  • The id attribute contains the identifier value assigned for the relationship.
  • The referencedOperationRole attribute contains attribute contains an indication of the role that the results of the referenced operation play in the calculation of the dependent operation. The role is represented as an instance of 1 of the two specializations of the ExtensibleTerminologyTerm class for the OperationRoleEnum enumeration:
    • OperationRole, in which the controlledTerm attribute contains a file type from the OperationRoleEnum enumeration
    • SponsorOperationRole, in which the sponsorTermId attribute contains the identifier of a sponsor term created in the terminology extension for the OperationRoleEnum enumeration. In this case, the submissionValue attribute of the referenced sponsor term contains the name of the role. 

...

  • 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 producing the required results that performs the referenced operation may differ depending on which analysis uses the method containing the dependent operation being defined, then the analysis that generates the results of the referenced operation may be specified in the the referencedAnalysisOperations attribute of the analysis that uses this operation 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

...

Example
inlinetrue

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 is not included in the definition of the referenced operation relationship (i.e., the analysisId attribute of an instance of the ReferencedOperationRelationship class is not used), then the analysis producing the referenced operation results must be specified as part of the definition of any analysis that uses the method containing the dependent operation.

Pagenav