Skip to Content

Wiki source code of 2 Actors and Use Cases

Version 18.1 by Helena on 2025/05/15 09:59
Show last authors
1 = 2 Actors and Use Cases =
2
3 == 2.1 Introduction ==
4
5 In order to develop the data models it is necessary to understand the functions to be supported resulting from the requirements definition. These are defined in a use case model. The use case model comprises actors and use cases and these are defined below.
6
7 ==== Actor ====
8
9 “//An actor defines a coherent set of roles that users of the system can play when interacting with it. An actor instance can be played by either an individual or an external system//”
10
11 ==== Use case ====
12
13 “//A use case defines a set of use-case instances, where each instance is a sequence of actions a system performs that yields an observable result of value to a particular actor”//
14
15 The overall intent of the model is to support data and metadata reporting, dissemination, and exchange in the field of aggregated statistical data and related metadata. In order to achieve this, the model needs to support three fundamental aspects of this process:
16
17 * Maintenance of structural and provisioning definitions
18 * Data and reference metadata publishing (reporting), and consuming (using)
19 * Access to data, reference metadata, and structural and provisioning definitions. This document covers the first two aspects, whilst the document on the Registry logical model covers the last aspect.
20
21 == 2.2 Use Case Diagrams ==
22
23 === 2.2.1 Maintenance of Structural and Provisioning Definitions ===
24
25 ==== 2.2.1.1 Use cases ====
26
27 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_eeba1ab9.png||height="418" width="718"]]
28
29 **Figure 7 Use cases for maintaining data and metadata structural and provisioning definitions**
30
31 ==== 2.2.1.2 Explanation of the Diagram ====
32
33 In order for applications to publish and consume data and reference metadata it is necessary for the structure and permitted content of the data and reference metadata to be defined and made available to the applications, as well as definitions that support the actual process of publishing and consuming. This is the responsibility of a Maintenance Agency.
34
35 All maintained artefacts are maintained by a Maintenance Agency. For convenience the Maintenance Agency actor is sub divided into two actor roles:
36
37 * maintaining structural definitions
38 * maintaining provisioning definitions
39
40 Whilst both these functions may be carried out by the same person, or at least by the same maintaining organization, the purpose of the definitions is different and so the roles have been differentiated: structural definitions define the format and permitted content of data and reference metadata when reported or disseminated, whilst provisioning definitions support the process of reporting and dissemination (who reports what to whom, and when).
41
42 In a community-based scenario where at least the structural definitions may be shared, it is important that the scheme of maintenance agencies is maintained by a responsible organization (called here the Community Administrator), as it is important that the Id of the Maintenance Agency is unique.
43
44 ==== 2.2.1.3 Definitions ====
45
46 |**Actor**|**Use Case**|**Description**
47 |(((
48 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_cc2b667.gif||alt="Shape2" height="41" width="30"]]
49
50 Community Administrator
51 )))||Responsible organisation that administers structural definitions common to the community as a whole.
52 ||(((
53 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_2e1da8dc.gif||alt="Shape3" height="31" width="60"]]
54
55 Maintain Maintenance Agency Scheme
56 )))|Creation and maintenance of the top-level scheme of maintenance agencies for the Community.
57 |(((
58 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_c8c072cf.gif||alt="Shape4" height="39" width="29"]]
59
60 Maintenance Agency
61 )))||(((
62 Responsible agency for maintaining structural artefacts such as code lists, concept schemes, Data
63
64 Structure Definition structural definitions, metadata structure definitions, data and metadata provisioning
65
66 artefacts such as provision agreement, and submaintenance agencies.
67
68 sub roles are:
69
70 Structural Definitions
71
72 Maintenance Agency
73
74 Provisioning Definitions
75
76 Maintenance Agency
77 )))
78 |(((
79 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_931fef33.gif||alt="Shape5" height="39" width="29"]]
80
81 Structural Definitions Maintenance Agency
82 )))||Responsible for maintaining structural definitions.
83 ||(((
84 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_5f0bb133.gif||alt="Shape6" height="31" width="60"]]
85
86 Maintain Structure Definitions
87 )))|The maintenance of structural definitions. This use case has sub class use cases for each of the structural artefacts that are maintained.
88
89 :
90
91 (((
92 ||(((
93 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_2e1da8dc.gif||alt="Shape7" height="31" width="60"]]
94
95 Maintain Code
96
97 List
98
99 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_523419aa.gif||alt="Shape8" height="31" width="60"]]
100
101 MaintainConcepts
102
103 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_ab241ca2.gif||alt="Shape9" height="33" width="69"]]
104
105 Maintain Category
106
107 Scheme
108
109 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_d1ac9b1f.gif||alt="Shape10" height="31" width="60"]]
110
111 Maintain Data Structure Definition
112
113 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_7af4600b.gif||alt="Shape11" height="31" width="67"]]
114
115 Maintain Metadata Structure Definition
116
117 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_2e1da8dc.gif||alt="Shape12" height="31" width="60"]]
118
119 Maintain Hierarchical Code Scheme
120 )))|(((
121 Creation and maintenance of the Data Structure Definition,
122
123 Metadata Structure
124
125 Definition, and the supporting artefacts that they use, such
126
127 as code list and concepts
128 )))
129 ||(((
130 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_2e1da8dc.gif||alt="Shape13" height="31" width="60"]]
131
132 Maintain Reporting
133
134 Taxonomy
135
136 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_c0d502a2.gif||alt="Shape14" height="31" width="60"]]
137
138 Maintain Organisation Scheme
139
140 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_523419aa.gif||alt="Shape15" height="31" width="60"]]
141
142 MaintainProcess
143
144 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_2e1da8dc.gif||alt="Shape16" height="31" width="60"]]
145
146 Maintain Dataflow Definition
147
148 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_2e1da8dc.gif||alt="Shape17" height="31" width="60"]]
149
150 Maintain Metadataflow Definition
151 )))|This includes Agency, Data Provider, Data Consumer, and Organisation Unit Scheme
152 |(((
153 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_2aa3fa9f.gif||alt="Shape18" height="33" width="25"]]
154
155 Provisioning Definitions
156
157 Maintenance Agency
158 )))||Responsible for maintaining data and metadata provisioning definitions.
159 ||(((
160 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_523419aa.gif||alt="Shape19" height="31" width="60"]]
161
162 Maintain Provision Agreement
163 )))|The maintenance of provisioning definitions.
164 )))
165
166 **Figure 8: Table of Actors and Use Cases for Maintenance of Structural and Provisioning Definitions**
167
168 === 2.2.2 Publishing and Using Data and Reference Metadata ===
169
170 ==== 2.2.2.1 Use Cases ====
171
172 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_ba4e50bb.png||height="492" width="633"]]
173
174 **Figure 9: Actors and use cases for data and metadata publishing and consuming**
175
176 ==== 2.2.2.2 Explanation of the Diagram ====
177
178 Note that in this diagram “publishing” data and reference metadata is deemed to be the same as “reporting” data and reference metadata. In some cases the act of making the data available fulfils both functions. Aggregated data is published and in order for the Data Publisher to do this and in order for consuming applications to process the data and reference metadata its structure must be known. Furthermore, consuming applications may also require access to reference metadata in order to present this to the Data Consumer so that the data is better understood.
179
180 As with the data, the reference metadata also needs to be formatted in accordance with a maintained structure. The Data Consumer and Metadata Consumer cannot use the data or reference metadata unless it is “published” and so there is a “data source” or “metadata source” dependency between the “uses” and “publish” use cases.
181
182 In any data and reference metadata publishing and consuming scenario both the publishing and the consuming applications will need access to maintained Provisioning Definitions. These definitions may be as simple as who provides what data and reference metadata to whom, and when, or it can be more complex with constraints on the data and metadata that can be provided by a particular publisher, and, in a data sharing scenario where data and metadata are “pulled” from data sources, details of the source.
183
184 ==== 2.2.2.3 Definitions ====
185
186 :
187
188 (((
189 |**Actor**|**Use Case**|**Description**
190 |(((
191 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_e17a3829.gif||alt="Shape20" height="50" width="37"]]
192
193 Data Publisher
194 )))||(((
195 Responsible for publishing data according to a specified Data Structure Definition
196
197 (data structure) definition, and relevant provisioning definitions.
198 )))
199 ||(((
200 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_b944d3ab.gif||alt="Shape21" height="33" width="57"]]
201
202 Publish Data
203 )))|Publish a data set. This could mean a physical data set or it could mean to make the data available for access at a data source such as a database that can process a query.
204 |(((
205 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_4dbf8772.gif||alt="Shape22" height="50" width="37"]]
206
207 Data Consumer
208 )))||The user of the data. It may be a human consumer accessing via a user interface, or it could be an application such as a statistical production system.
209 ||(((
210 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_ce3dcaa8.gif||alt="Shape23" height="29" width="56"]]
211
212 Uses Data
213 )))|Use data that is formatted according to the structural definitions and made available according to the provisioning definitions. Data are often linked to metadata that may reside in a different location and be published and maintained independently.
214 |(((
215 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_1e646dff.gif||alt="Shape24" height="50" width="37"]]
216
217 Metadata Publisher
218 )))||Responsible for publishing reference metadata according to a specified metadata structure definition, and relevant provisioning definitions.
219 ||(((
220 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_b024fd22.gif||alt="Shape25" height="31" width="60"]]
221
222 Publish Reference
223
224 Metadata
225 )))|Publish a reference metadata set. This could mean a physical metadata set or it could mean to make the reference metadata available for access at a metadata source such as a metadata repository that can process a query.
226 |[[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_52ea6abf.gif||alt="Shape26" height="49" width="37"]]||The user of the reference metadata. It may be a human consumer accessing via a user interface, or it could be
227 |Metadata Consumer||an application such as a statistical production or dissemination system.
228 ||(((
229 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_7ea5b8a3.gif||alt="Shape27" height="31" width="59"]]
230
231 Uses Reference Metadata
232 )))|Use reference metadata that is formatted according to the structural definitions and made available according to the provisioning definitions.
233 )))