1. CSPA Templates for sharing services
Mauro Bruno
THE CONTRACTOR IS ACTING UNDER A FRAMEWORK CONTRACT CONCLUDED WITH THE COMMISSION

2. Outline
Statistical Services
Templates
Example

3. CSPA Statistical Services

4. Statistical Services
The level of reusability promised by the adoption of a SOA is dependent on standard definitions of the services.
CSPA has three layers to the description of any service:
Service Definition
Service Specification
Service Implementation Description

5. Statistical Services

6. Statistical Services
The capabilities of a Statistical Service are described in terms of the GSBPM sub process that it relates to, the business function that it performs and GSIM information objects which are the inputs and outputs.

7. Statistical Services
The capabilities of a Statistical Service are fleshed out into business functions that have GSIM implementation level objects as inputs and outputs. This document also includes metrics and methodologies.

8. Statistical Services
The functions of the Statistical Service are refined into detailed operations whose inputs and outputs are GSIM implementation level objects.

9. Statistical Services
This layer fully defines the service contract, including communications protocols, by means of the Service Implementation Description. It includes a precise description of all dependencies to the underlying infrastructure, non-functional characteristics and any relevant information about the configuration of the application being wrapped, when applicable.

10. Statistical Services
In general, there will be one Service Specification corresponding to a Service Definition, to ensure that standard data exchange can occur.
At the implementation level, services may have different implementations reflecting the environment of the supplying organization.
Each implementation must rigidly adhere to the data format specified in the Service Specification.

11. CSPA Statistical Services: Templates

12. CSPA Service Definition
The CSPA Service Definition is at a conceptual level. In CSPA, the capabilities of a Statistical Service are described in terms of the GSBPM sub process that it relates to, the business function that it performs and GSIM information objects which are the inputs and outputs.

13. Service Definition Template
Name
GSBPM
Business Function
Outcomes
Restrictions
GSIM Inputs
GSIM Outputs
Service dependencies

14. CSPA Service Specification
The CSPA Service Specification is at a logical level. In this layer, the capabilities of a CSPA Service are fleshed out into business functions that have GSIM implementation level objects as inputs and outputs. This document also includes metrics and methodologies.

15. Service Specification Template

16. CSPA Service Implementation
The CSPA Service Implementation Description is at an implementation (or physical) level. In this layer, the functions of the CSPA Service are refined into detailed operations whose inputs and outputs are GSIM implementation level objects.
This layer fully defines the service contract, including communications protocols. It includes non-functional characteristics and any relevant information about the configuration of the application being wrapped.

17. Service Implementation Template 1/2

18. Service Implementation Template 2/2

19. CSPA Service Design & Implementation

20. CSPA Statistical Services: Example

21. Statistical Service Definition Example

22. Statistical Service Specification
Protocol for invoking the service
This service is invoked by calling a function called "CodeDataset" (all data is passed by reference):
1) Location of the codelist;
2) Location of the input dataset;
3) Location of the structure file describing the input dataset
4) Location of the mapping file describing which variables in the input dataset to be used
5) Location of the output dataset generated by the service
6) Location of the structure file describing the output dataset generated by the service
7) Location of the process metrics file generated by the service.
The protocol used to invoke this function is SOAP

23. Statistical Service Specification
Input messages
The first four parameters for the service refer to input files. In GSIM terms, the inputs to this service are:
1) NodeSet consisting of Nodes, which bring together CategoryItems, CodeItems, and other Designations (synonyms).
2) Unit data set – the texts to be coded for a particular variable
3) Data structure, describing the structure of the Unit data set
4) Set of Rules, describing which variables the service should use for which purpose.

24. Statistical Service Specification
Input messages
The codelist to be passed in must be expressed as a DDI 3.1 instance, using the following structure. The table shows the mapping of the conceptual GSIM objects to their encoding in DDI 3.1

25. Statistical Service Specification
Input messages
The unit data set is a fixed-width ASCII file containing at least a case ID (50 characters maximum) and a variable containing text strings to be coded. Each entry should be on a single line. The corresponding GSIM objects:

26. Statistical Service Specification
Input messages
The structure of the unit data set must be expressed as a DDI 3.1 instance, using the following structure. The table shows the mapping of the conceptual GSIM objects to their encoding in DDI 3.1

27. Statistical Service Specification
Output messages
The output of the service contains of three files. In GSIM terms, the outputs of this service are:
5) Unit data set containing the coded data for the variable concerned;
6) Data structure, describing the structure of this Unit data set
7) Process Metric, containing information about the execution of the service.
These generated files will be placed at the locations indicated by the 5th, 6th and 7th input parameters. No return parameter will be generated by the service.

28. Statistical Service Specification
Output messages
The unit data set will be a fixed-width ASCII file containing (for the successfully coded entries) the case ID (50 characters maximum) followed by the Code. Each entry should be on a single line.

29. Statistical Service Specification
Output messages

30. Statistical Service Specification
Output messages
The Process metrics will be expressed as an XML file structured in the following way:

31. Statistical Service Specification
Error messages
When the coding process cannot be executed or is aborted due to some error, the service will return an error message. The following error messages can be generated by the service.