Skip to main content
Skip table of contents

Data Cube Associations

Tabulation results are stored in a data cube. The cross tabulation cube can be associated with other results, such as frequency of contributors and first N largest contributors.

The associations between the cross tabulation cube and others are determined by association names.

For example:

 

AddAssociationT()

Add multiple association cubes to a job.

Available To
PrepareJob
PerformJob
CleanUpJob
CPP
AddAssociationT(JobInfoT *JobInfo, const char* AssociationName, int Num)
Arguments
JobInfoInputInformation about the current job.

AssociationName

InputThe name of a result, such as FREQ, TOPN, CONCEALMENT, CELL_ERRORS.
NumInputThe number of the association.
Returns
1Success.
0Failed.

GetAssociationNamesT()

Retrieve the names of the associations that exist in a job.

Available To
PrepareJob
PerformJob
CleanUpJob
CPP
GetAssociationNamesT(JobInfoT* JobInfo,int* Len)
Arguments
JobInfoInputInformation about the current job.
LenOutputThe number of associations.
Returns An array containing the association names, or NULL if there are no associations.

GetNumOfAssociatedCubeT()

Retrieve the number of associated results for a tabulation result. Depending on the type of the association, there may be multiple values for the association name.

For example:

  • ASSOCATION_FREQ will have a single associated value for each cell in the cube.
  • ASSOCIATION_TOPN will have multiple associated values determined by the value of 'N' specified in the SuperADMIN properties when the requesting module was configured.
Available To
PrepareJob
PerformJob
CleanUpJob
CPP
GetNumOfAssociatedCubeT(JobInfoT *JobInfo, const char* AssociationName)
Arguments
JobInfoInputInformation about the current job.
AssociationNameInputThe name of an association.
Returns The number of associated cubes, or 0 if the requested association does not exist.

DoesAssociationExistT()

Query the existence of an association for a tabulation result.

Available To
PrepareJob
PerformJob
CleanUpJob
CPP
DoesAssociationExistT(JobInfoT* JobInfo, const char* AssociationName)
Arguments
JobInfoInputInformation about the current job.
AssociationNameInputThe name of an association.
Returns
1The association exists.
0The association does not exist.

DoesNthAssociationExistT()

Query the existence of an nth association result for a given association.

Associations such as TOPN can have multiple associated values for the same association name.

Available To
PrepareJob
PerformJob
CleanUpJob
CPP
DoesNthAssociationExistT(JobInfoT* JobInfo, const char* AssociationName,int Pos)
Arguments
JobInfoInputInformation about the current job.
ResultNameInputThe name of an association result.
PosInputThe result position to query.
Returns
1The association exists.
0The association does not exist.

DuplicateTabulationCubeT()

Duplicate the cross tabulation cube and give the duplicate a name. The name can be used to retrieve/access the duplicated cube.

Available To
PrepareJob
PerformJob
CleanUpJob
CPP
DuplicateTabulationCubeT(JobInfoT *JobInfo, const char* AssociationName)
Arguments
JobInfoInputInformation about the current job.
AssociationNameInputThe name of an association.
Returns
1Cells are available.
0No cells are available.
JavaScript errors detected

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

If this problem persists, please contact our support.