Skip to main content
Skip table of contents

Module Reference - Data Control

This section contains details of the data control modules that are supplied with SuperSERVER.

Module Requirements

Many of the data control modules are designed to work together. The following table lists the combinations of modules that are required for common scenarios:

 

Count Perturbation

Count and Continuous
Perturbation

Weighted Dataset with
Count Perturbation
Weighted Dataset with
Count and Continuous Perturbation

Weighted Dataset
(No Perturbation)

Average Cell Weight  RequiredRequired 
Continuous Perturbation Required Required 
Output ScalingOptionalOptionalOptionalOptionalOptional

Perturbation

RequiredRequiredRequiredRequired 
Perturbed Continuous RSE  Required if dataset has measuresRequired 
Perturbed Count RSE  RequiredRequired 
Perturbed EstimatesRequired if dataset has measuresRequiredRequired if dataset has measuresRequired 
Perturbed Mean Variance   Required 
Perturbed Population Estimate Variance  Required if dataset has measuresRequired 
RSE Annotation  OptionalOptionalOptional
RSE Calculation  Runs AutomaticallyRuns AutomaticallyRuns Automatically
RSE Poor Table Check  OptionalOptionalOptional
RSE Suppression  OptionalOptionalOptional
Sparsity CheckOptionalOptionalOptionalOptionalOptional

Refer to the Example Configuration section for some examples of these scenarios.

Using Multiple Data Control Modules

Where multiple data control modules are required, they generally need to be run in a specific sequence, so that the results from one module can be used by another. To manage this, the Data Control API uses a priority system, which allows you to configure the sequence in which the modules are executed. The priority is a numeric value; modules with a lower value will be executed first.

When you require multiple data control modules to work together, you can choose either to create just one method and add all the individual module plugins that you need to that method, or you can create multiple methods and apply them individually to the dataset.

  • If you are using one method, set the priority of each module when you add it to the method: method <method_id> adddcplugin <plugin_id> <plugin_filename> <priority>
  • If you are using multiple methods, set the priority of each method when you apply it to the dataset: cat <dataset_id> addmethod <method_id> <priority>
You can change the priority of a module or method if necessary, refer to the method comand and the cat command for more details.

Refer to the individual module reference pages for details on their specific priority requirements.

Logging

By default, the Data Control modules will log limited information about the affect of each module. To increase the amount of logging output for specific modules, do the following:

  1. Open the SuperSERVER logging properties file in a text editor. If you installed to the default location this file is C:\ProgramData\STR\SuperSERVER SA\log4j.scsa.xml.
  2. Add the following section before the closing </log4j:configuration> tag:

    XML
    <logger name="AUDIT_DataServer.Dcapi" additivity="false">
        <level value ="DEBUG" />
        <appender-ref ref="MainLog" />
        <appender-ref ref="CONSOLE"/>       
    </logger>
  3. For each specific module that you want to log additional information, add the following property to your method:

    CODE
    method <method_id> <plugin_id> addproperty EnableLogCube "true"

    By default the log output will be written to the SuperSERVER log directory. If you wish to change the location of the log file for an individual module, add the following property:

    CODE
    method <method_id> <plugin_id> addproperty LogCubePath <path>

    For example:

    CODE
    method MyPerturbationMethod PerturbedMeanVariance addproperty EnableLogCube "true"
    method MyPerturbationMethod PerturbedMeanVariance addproperty LogCubePath "C:\\dcapi\\logs"
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.