Skip to main content

Celonis Product Documentation

PU_COUNT
Description

Calculates the number of elements in the specified source column for each element in the given target table.

PU_COUNT can be applied on any data type. The data type of the result is always an INT.

Syntax
 PU_COUNT ( target_table, source_table.column [, filter_expression] )

  • target_table: The table to which the aggregation result should be pulled. This can be:

  • source_table.column: The column which should be aggregated for every row of the target_table.

  • filter_expression (optional): An optional filter expression to specify which values of the source_table.column should be taken into account for the aggregation.

Use Cases
NULL handling

If no value in the source table column exists for the element in the target table (either because all values of the source table are filtered out, or because no corresponding value exists in the first place), 0 will be returned. NULL values in the source table column are treated as if the row does not exist.

Examples

[1]

Count the number of cases for each company code:

Query

Column1 

         "companyDetail"."companyCode"

Column2 

         PU_COUNT ( "companyDetail" , "caseTable"."companyCode" )

Input

Output

caseTable

caseId : int

companyCode : string

value : int

1

'001'

600

2

'001'

400

3

'001'

200

4

'002'

300

5

'002'

300

6

'003'

200

companyDetail

companyCode : string

country : string

'001'

'DE'

'002'

'DE'

'003'

'US'

Foreign Keys

caseTable.companyCode

companyDetail.companyCode

Result

Column1 : string

Column2 : int

'001'

3

'002'

2

'003'

1

[2]

PU-functions can be used in a FILTER. In this example, the company codes are filtered such that the corresponding number of case table values is smaller than 2:

Query

Filter 

         FILTER PU_COUNT ( "companyDetail" , "caseTable"."value" ) < 2;

Column1 

         "companyDetail"."companyCode"

Input

Output

caseTable

caseId : int

companyCode : string

value : int

1

'001'

600

2

'001'

400

3

'001'

200

4

'002'

300

5

'002'

300

6

'003'

200

companyDetail

companyCode : string

country : string

'001'

'DE'

'002'

'DE'

'003'

'US'

Foreign Keys

caseTable.companyCode

companyDetail.companyCode

Result

Column1 : string

'003'

[3]

PU-functions can be used inside another aggregation function. In this example, the maximum value of all number of case table values for each company code is calculated:

Query

Column1 

         MAX ( PU_COUNT ( "companyDetail" , "caseTable"."value" ) )

Input

Output

caseTable

caseId : int

companyCode : string

value : int

1

'001'

600

2

'001'

400

3

'001'

200

4

'002'

300

5

'002'

300

6

'003'

200

companyDetail

companyCode : string

country : string

'001'

'DE'

'002'

'DE'

'003'

'US'

Foreign Keys

caseTable.companyCode

companyDetail.companyCode

Result

Column1 : int

3

[4]

Count the number of cases which have a value larger than 300 for each company code. All case table values for company codes '002' and '003' are filtered out, which means that in these cases, 0 is returned.

Query

Column1 

         "companyDetail"."companyCode"

Column2 

         PU_COUNT ( "companyDetail" , "caseTable"."companyCode" , "caseTable"."value" > 300 )

Input

Output

caseTable

caseId : int

companyCode : string

value : int

1

'001'

600

2

'001'

400

3

'001'

200

4

'002'

300

5

'002'

300

6

'003'

200

companyDetail

companyCode : string

country : string

'001'

'DE'

'002'

'DE'

'003'

'US'

Foreign Keys

caseTable.companyCode

companyDetail.companyCode

Result

Column1 : string

Column2 : int

'001'

2

'002'

0

'003'

0

[5]

Example over three tables: For each entry in table B, count the number of values that are less than 300 in table C. Tables B and C do not have a direct connection, but are connected via table A:

Query

Column1 

         "B"."B_KEY"

Column2 

         PU_COUNT ( "B" , "C"."VALUE" , "C"."VALUE" < 300 )

Input

Output

A

B_KEY : int

C_KEY : string

VALUE : int

1

'A'

100

1

'B'

200

2

'C'

300

2

'D'

400

3

'E'

500

3

'F'

600

B

B_KEY : int

1

2

C

C_KEY : string

VALUE : int

'A'

400

'A'

100

'A'

200

'B'

100

'C'

200

'D'

500

Foreign Keys

A.C_KEY

C.C_KEY

B.B_KEY

A.B_KEY

Result

Column1 : int

Column2 : int

1

3

2

1

See also: