C Proxy › Proxy Function Prototypes › API Variable Types › Repeating Group Views

Repeating Group Views

Repeating groups can be in import and export views. The repeating group view has two variables added to the view structure:

• cardinality-an integer value that contains either the maximum size of the repeating group or the number of elements that are populated (if less than the maximum). For an import view, your application needs to populate this field with the number of occurrences of actual data at runtime. If you have an array of five elements, but there are only three with data, the cardinality variable contains 3 as its value. If you do not set this value correctly on an import view, the server will not process the view.
• active_flag-a character array that indicates (with Y or N) which elements of the repeating group view are populated. For an import view, copy the corresponding number of Y characters into the active_flag array.

The following is an example of export repeating group view.

/* Repeating Group View: ALL_OUTPUT */
/* Repeats: 30 times */
struct {
    long cardinality;
    char active_flag[30];
    /* Entity View: EXPORT */
    /* Type: WI_SELECTION */

    struct {
        char    value[30][2];
    } export_wiSelection;

    /* Entity View: EXPORT */
    /*        Type: EMPLOYEE */
    struct {
        long    number[30];
        char    name[30][31];
    } export_employee;

    /* Entity View: EXPORT */
    /*        Type: DIVISION */
    struct {
        short   number[30];
        char    name[30][31];
    } export_division;
} allOutput;
/* End of Group View: ALL_OUTPUT */

The following is an example section of code to display the export repeating group values:

printf("List of Divisions\n");
if (server_maintain_division.allOutput.cardinality > 0)
{
   printf("\tNumber\tName\n");
   printf("  ------------------------------\n");
  for (loop = 0; loop < server_maintain_division.allOutput.cardinality; loop++)
  {
       printf("\t%d",
               server_maintain_division.allOutput.export_division.number[loop]);
       printf("\t%s\n",
               server_maintain_division.allOutput.export_division.name[loop]);
  }
}
else
   printf("\tNo Data Found\n");
}