<Service Name> - <Authority> / <Contractor (<LOT No.>) Definition of an eService for Development in eGSS Date: DD/MM/YYYY Version: 1.0 <Company Name> <Company Logo> SDESC Section 1 E-Government Malta Information Technology Agency S-DESC for <Project Name> Table of Contents 1. SCOPING BRIEF ........................................................................................................................... 5 1.1 INTRODUCTION .......................................................................................................................... 5 1.2 CURRENT BUSINESS PROCESS ................................................................................................... 5 1.2.1 <Form Ref: Form Title> .................................................................................................. 5 1.2.2 Other Stakeholders ........................................................................................................... 5 1.3 OUT OF SCOPE ........................................................................................................................... 5 2. BUSINESS ANALYSIS .................................................................................................................. 6 2.1 INITIATING THE ESERVICES ....................................................................................................... 6 2.2 PROPOSED BUSINESS FLOW DIAGRAM ...................................................................................... 9 2.3 PROPOSED BUSINESS PROCESS DESCRIPTION .......................................................................... 10 2.3.1 Identification of any Routing based Relationships of the applicant................................ 10 2.4 WORKFLOW PATTERNS ........................................................................................................... 10 2.5 LIST OF ACTORS ...................................................................................................................... 11 2.6 ESERVICE INTERFACES ............................................................................................................ 15 2.7 INFORMATION WITHIN THE FORM (FORM SECTION TEMPLATES) ............................................. 11 2.7.1 List of key Information Records to be collected in order to carry out the service .......... 12 2.8 DOCUMENTS REQUIRED WITH THE FORM AND OTHER INFORMATION SOURCES WITHIN THE GOVERNMENT ..................................................................................................................................... 13 2.9 CONSENT TO ACCESS INFORMATION FROM THIRD PARTY......................................................... 15 2.10 PAYMENT RELATED PROCESSES .............................................................................................. 15 2.11 SIGNATURES AND OPTIONS FOR UNAUTHENTICATED FILING .................................................. 16 2.11.1 Access to the eService ..................................................................................................... 16 2.11.2 Options for Unauthenticated Filling ............................................................................... 17 2.12 ARCHIVING, DOCUMENT RETENTION ...................................................................................... 17 2.13 FORMS REQUIRED FOR THIS ESERVICE ..................................................................................... 18 2.14 SHARED SERVICES................................................................................................................... 19 APPENDIX 1 - EXAMPLE HIGH-LEVEL INTERACTIONS OF THE ESERVICE BEING PROPOSED WITH THE LINE OF BUSINESS APPLICATION................................................... 20 APPENDIX 2 – EXAMPLES OF BUSINESS FLOW DIAGRAMS................................................ 21 ESERVICE BUSINESS PROCESS FLOW FOR SELF-MANAGED ESERVICE .................................................. 21 ESERVICE BUSINESS PROCESS FLOW FOR AGENT-ENABLED ESERVICE ............................................... 22 THE APPLICATION STAGES ................................................................................................................... 23 SDESC Section 1 Page 2 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> Document Control Information 01. Document reference PE11009-TPL-SDESC_ScopingandAnalysis-v3.0 02. Document type Service Description Document 03. Security classification Unclassified 04. Synopsis This document includes the first 2 sections of the SDESC document and is used to scope and define electronic services based on the consumption of eGovernment shared services. Such shared services include the electronic forms and billing engine, which can be shared across electronic services. This section documents the analysis stage of the process. The document is completed gradually through the lifecycle of the development of the eServices, as more is known about the eService. This version of the S-DESC is intended for developers of eGovernment services on eForms where the eServices for a Government entity are analysed together. 05. SDESC Template Version Control Version Date Comments Draft 0.1 First Draft of document Version 1.0 Initial version for release Version 2.0 Updated release 06. Document Review History Reviewer 07. Position Department Terminology In this section define the technical and business terms used in the requirements document. Term Definition MITA Malta Information Technology Agency LOB Line of Business – System 08. Acknowledgements SDESC Section 1 Page 3 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 09. References 10. SDESC Sign off Supplier Entity Organistion Name Name & Surname Signature / Date SDESC Section 1 Page 4 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 1. Scoping Brief 1.1 Introduction Example: This licensing scheme covers activities that range from processing and manufacturing activities, wholesale and retail trade activities and various other professional and business services activities. The activities can also be on a ‘personal’ basis (as different from activity carried out from a premises) as is the case of hawkers and door-to-door sellers. The activities are listed in the First Schedule of Legal Notice 1 of 2006 1.2 1.2.1 Current Business Process <Form Ref: Form Title> <Include a step by step textual description of the current business process. The description should include all automated and manual processes and interfaces / dependencies with other systems. Include any previous attempts to provide this service including information regarding the aspects that met or failed expectations> 1.2.2 Other Stakeholders This section can be used to include other 3rd Parties that may contribute information or act as competent authorities in the eService process being described. If applicable fill the table below or enter NA. Authority Department Contact Person Dependency / Responsibility e.g. Health e.g. Food and Safety <Add contact name and surname> e.g. Site inspection to verify that establishment is suitable to handle perishables 1.3 Out of Scope <Describe aspects of the business process / underlying legislation that have been discussed and positively identified as out of the development scope for this service. Also include any information relating to options considered before being deemed out of scope for this phase of development. If not applicable enter NA.> SDESC Section 1 Page 5 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 2. Business Analysis 2.1 Initiating the eServices Choose one or more of the applicable contexts below, where the applicant or others on his/her behalf start the eService and different persons register their work on the form. If different contexts apply to the different eServices included in the SDESC, enter the unique form identifier. A. Scenarios for direct submission A1. The standard Flow; The form is exchanged between applicant and Competent Authority. The Authority maintains its information in a manual system. Applicant refers also to e-ID representatives of organizations. Form Reference:<Form Reference/s> A2. The Line of Business Interaction; The exchange of the form is similar to the standard flow between applicant and Competent Authority. However we must get information or place information in the Line of Business system Form Reference:<Form Reference/s> A3. Members of the public who need to exchange the form; The form process includes exchange of information with third party members of the public. Form Reference:<Form Reference/s> SDESC Section 1 Page 6 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> A4. A variant to the flow number 3 where the information needs to be updated in a Line of Business system Form Reference:<Form Reference/s> A5. When a form is submitted by a Public Officer over the counter at a Business/Citizen Care Unit Form Reference:<Form Reference/s> SDESC Section 1 Page 7 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> B. Scenarios for Agent-enabled eServices B1. When the eService is carried out through Partial Intermediation Form Reference:<Form Reference/s> B2. When the eService is carried out through Full Intermediation Form Reference:<Form Reference/s> B3. When the eService involves Organised, Authorised agents regulated by the Competent Authority Form Reference:<Form Reference/s> SDESC Section 1 Page 8 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 2.2 Proposed Business Flow Diagram (One per unique process) Specify service/s that it applies to. Please refer to appendix 2 for examples., SDESC Section 1 Page 9 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 2.3 Proposed Business Process Description Form Reference/s: Business Process Name: Proposed Business Process Description <Provide a step by step description of the proposed business process including all the subprocesses and description of the process actors and their actions within the process Each business process description should accompany a business process diagram as provided in the previous section. Do not replicate the diagram. Describe the process and the purpose of the steps.> Does the service/s require any specific accessibility features? Highlight such needs if any. If the form/s is/are triggered by the Authority, give the name/s of the group of individuals who can trigger the form/s 2.3.1 Form Reference:<Form Reference/s> Group of Individuals: <Group of Individuals> Identification of any Routing based Relationships of the applicant At times the business process of a service requires an action from someone related to the person who completed the step the previous step or who started off the eService. If applicable fill the table below or enter NA. Relationship Name Example: Approver’s Chief Information Officer Routing Purpose Example: Central information 2.4 Management of authorisation to access Workflow Patterns The example that is available from the MITA library uses a set of common patterns, such as the pattern for a simple submission, the pattern to escalate an eForm after a number of days in the workqueue and the payment subprocess . A register of workflow pattern examples is maintained and published on the EDEV Portal1. Identify and list the most relevant workflow patterns that may be used in this eService Workflow Block Existing Example Example: Submission form Standard Submission example Example: Parallel approval of the license by finance and technical 1 Example to be created Parallel approval process EDEV Portal: https://www.mita.gov.mt/page.aspx?pageid=259 SDESC Section 1 Page 10 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 2.5 List of Actors An electronic service is brought to the attention to the processing unit or the reviewing officer by posting work to the work queue that relates to the particular role or responsibility (sometimes termed Government function). Form Reference Group Main Contact Contact Details (Name and Surname) (Email Address) Example: Payment Verification 2.6 Information within the Form (Form Section Templates) At a high-level, what are the main items of information that are gathered while carrying out the eService? An Information Record is a collection of attributes (fields) that define an aspect of the service. Frequently the same Information Record is used in services across all Government. In eForms these common Information Records are converted into a Form Section Template and stored in a gallery on the MITA website. Please note that MITA has provided and maintains a gallery with form template/s which are to be used for all eform development to ensure a consistent look and feel. Any custom templates are to be based on said MITA templates. SDESC Section 1 Page 11 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 2.6.1 List of key Information Records to be collected in order to carry out the service For example to evaluate an application to operate a trade, the key information elements may be: Applicant Personal details, License Operator Details, Site Information and Business Case for the application. Please list all the information records in use and mark in which service/s said information record is used. The purpose of this exercise is to identify commonalities. Form Reference: 001 002 003 004 005 006 007 008 009 010 011 012 013 014 015 016 017 018 Information Records Information Records SDESC Section 1 Identified from Gallery To be Created Page 12 of 23 E-Government Malta Information Technology Agency No Template 019 020 S-DESC for <Project Name> 2.7 Documents required with the form and Other Information Sources within the Government It is required to determine all the links to other information sources. Refer to the manual form and the current process flow and list every attachment or piece of documentary evidence that is required for the service to be carried out, and for each one investigate and determine the following: 1. Does the documentary evidence (or the information that is required from it) already exist in Government? 2. Does it exist in electronic form? 3. How can this document or its contents be provided directly to this service? 4. What restrictions are there to the use of this information? If applicable fill the table below or enter NA. Form Reference(s) SDESC Section 1 Document name Information Source Is it in electronic form? Details on the item How will this document be provided directly to the service e.g. Trade License (a similar example is the copy of a driving license) e.g. Commerce Division License Management System e.g. MS SQL Database, managed by Commerce Division e.g. Data is stored electronically ,published on the Govt Gazette, but there are no web services There is no readily available mechanism. This shall be discussed with owner of the information source e.g. MEPA Full Development Permit e.g. MEPA eApps e.g. direct access to public information from MEPA site e.g. applicant must provide the correct PA number E,g, Read-only page within the electronic form e.g. Assessment of a National or International qualification from the Malta Qualifications Recognition Information Centre e.g. MQRIC e.g. Paper based forms e.g. The original statement is given to the applicant. MQRIC maintain an There is no readily available mechanism. To discuss with Page 13 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> e.g. Copy of the certificates demonstrating the applicants qualification(s) / course attendance as indicated in Applicants Experience page None Scanned copy will be uploaded by applicant internal register and a copy of the statement MQRIC referring to the “Statement reference number”. Not every statement contains the ID number. Digital image e.g. N/A IMPORTANT As per PPS Directives, a citizen or business requesting a service from Government shall not be required to furnish documents that are already available within Government. Therefore the eGovernment service will look at what options can be adopted to collaborate with other entities or other information repositories, rather than asking for these documents from the applicant. Eventually, an electronic representation of the remaining items will be provided by the applicant. This list of attachments is included in another specific document known as the Deployment Sheet. The Deployment Sheet is a document signed by the business owner with the configuration information about the service. It includes the name of the attachment, some instructions about it and whether the attachment is mandatory. SDESC Section 1 Page 14 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 2.8 eService Interfaces At this point all interfaces should be listed to define the scope completely and facilitate the business owner to apply for any accounts necessary for testing / implementation. Service Interface Requirement MyBills2 Example: On completion of the applications, process payment can be cleared through the MyBills Hosted Payment Page <OR> Journal entries will be posted to myBills for bill generation MyAlerts Example: Notify in bulk all authorised agents that a related licensing scheme has been issued CDR Required to populate the personal details section of the form. Line of Business (LOB) applications interface <Access the Government entity’s LOB system to retrieve account information> Other Service Interface/s 2.9 Payment Related Processes If applicable fill the table below or enter NA. Form Reference Uses preprinted receipt numbers 3 Requires a receipt reference to be returned from the Line-ofBusiness4 Description of the fees payable5 Specify Payment Options6 Calculation7 001 002 003 004 005 006 007 008 009 2 Test and Live MyBills account creation request form can be downloaded from https://www.mita.gov.mt/page.aspx?pageid=261 3 to record receipt number, including validation of last receipt for user 4 to print on receipt 5 Enter the value of the fixed service fee (in euro cents) or the method of calculation 6 Specify all that apply: M - MyBills; I – Internet Banking; C – Cheque; O – Other (please specify) 7 Example: The licence fee is equal to EUR 5 for every 100 m2 over the 80 m2 threshold. The area is found in field F9 SDESC Section 1 Page 15 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 010 011 012 013 014 015 016 017 018 019 020 Specify any changes to the Reconciliation Report. Payment reconciliation verifies the amounts on the merchant account bank statement with the transactions reported by the eService. Form Reference(s): 2.10 Signatures and Options for Unauthenticated Filing 2.10.1 Access to the eService Form Reference General Public 8 E-ID users Registered users 9 Public Officers10 Special Group11 Agents 001 002 003 004 005 006 007 008 009 010 011 012 013 014 8 Unauthenticated access (i.e. no login is required to access the eForm). The system will not know who submitted the form , the form cannot be placed into the applicant’s mailbox. There is no pre-filling and the customized attachment screen cannot be used. 9 Registration of “Alternative Login” accounts through the eForms Portal is only permissible to individuals who do not own an Maltese ID Card. 10 There are forms which are initiated by a public officer. 11 Use the Special Group tag to indicate that the form will not be publicly available to a defined set of authenticated and authorised accounts. A method must be defined to verify that the logged-in individual forms part of the group. SDESC Section 1 Page 16 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 015 016 017 018 019 020 2.10.2 Options for Unauthenticated Filling List work queues and functions that need public officer’s digital signature Form Reference/s: <Enter Reference/s> Clarify the need for wet ink12 Form Reference/s: <Enter Reference/s> 2.11 Archiving, Document Retention Indicate any special archiving needs in the table below. Form Reference(s) Document / Form Title Retention Period 13 User Access Name, Surname and Email Address 12 'Wet ink' refers to the physical original document bearing the hand-written signature of the signer, who could be the applicant , a referrer or a party involved in the process. eGovernment services request process owners to simplify procedures and to rely as much as possible on the virtual or electronic gesture of signing the form. If however there are registration or transfer processes that require original physical documents, then authorities must make undertakings only when they are actually holding the 'wet-ink' signed documents, not when they have merely seen electronic images of them. The process must allow for the document to be collected. Commonly this happens at an initial interview or at a final meeting between the parties to consolidate the process. 13 The maximum retention period for a document/form to be left on the system is 5 years. SDESC Section 1 Page 17 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 2.12 Forms required for this eService This section is repeated per form required for the business process. Form Ref. Form Versions to be put online14 Printable Versions of the form15 Integration16 Special Navigation and/or workflow variations Show / Hide17 Dynamic Rows18 Final Reply Template 001 002 003 004 005 006 007 008 009 010 011 012 013 014 015 016 14 Apart from the application and the approval forms, list any other different versions of the form that must be put online (Example: Completed Form) 15 Indicate what printable versions of the forms at different stages of the service are required. A printable version of the form summarises the sections of the form into a shorter PDF(Example: Completed Form, Final Reply, Other Printable Versions, Specify, No Printing Required) 16 State whether: Form is stand-alone or requires integration with other systems. If the latter please specify with what (Example: Document Management, Client Portal, etc) 17 State whether particular sections and/or fields will be hidden or shown based on the type of user and/or selected option (Example: If the user selects that he is filling a form on behalf of the organisation he represents, then show the organisation’s page and hide the Person Details page) 18 Dynamically adding rows to the form. The table must start with the mandatory or common number of rows and provide controls to add or remove rows. SDESC Section 1 Page 18 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> 017 018 019 020 2.13 Shared Services When information in another system is accessed by a shared service, the applicant (data subject) must be given the possibility to allow or deny this transfer of information. Specify the message for the consent by the applicant and define the conditions on the relying parties. If not applicable enter NA. Example: Do you consent that information about vehicles that you own, found in the systems of the Licensing directorate are passed to this eService? This information is necessary to complete the eService. Form Reference/s SDESC Section 1 Consent message in English Consent message in Maltese Page 19 of 23 E-Government Malta Information Technology Agency S-DESC for <Project Name> Appendix 1 - Example High-level Interactions of the eService being proposed with the Line of Business Application The interactions should be described as they happen in the flow. This sample is based on an assisted transfer of public registered asset Task Stage 1 Interactions with Line-ofBusiness Seller authenticates with e-ID – seller is known Seller chooses the asset Owner declares intention to transfer to another party Seller can see a)charges that are not yet settled, b)can see the asset restrictions and c)the barriers that stop this transfer .Get list of assets by Owner ID .Get charges by asset reference Seller is given link to optionally (good practice) settle the charges before the transfer; to note that payment does not happen real-time when systems need to synchronise .Get List of restrictions on the asset For c, seller is informed that transfer cannot proceed. Seller is offered contact details of the process to clear these restrictions(possibly manual) .Get list of transfer restrictions for asset ID .CDR Seller identifies the prospective buyer; seller is asked consent to provide all the above information to this person .Verify Buyer A timer of 10 days is started. If this expires without followup from the buyer, then the submission is set to expire. This is a final state. Stage 2 Buyer logs-in to confirm Save submission The form is routed to this person. The buyer logs-in and confirms the car reference Pay the transfer charge (handshake to print receipt) Verify business rules of the transfer Execute the LoB transfer process Save log of actions for this submission Transfer SDESC Section 1 Page 20 of 23 E-Government Malta Information Technology Agency Appendix 2 – Examples of Business Flow Diagrams eService Business Process Flow for self-managed eService eService Definition Document Template Version: 0.1 E-Government Malta Information Technology Agency Page 21 of 23 eService Business Process Flow for Agent-enabled eService SDESC Section 1 Page 22 of 23 E-Government Malta Information Technology Agency The application stages The diagram below is effective to describe the stages of the eService. The stages in the middle are used in the process timeline so that the citizen can follow-up the status of the application. The use cases at the borders indicate control buttons or submission options that will be used in the form: Those on the left are available for the applicant to act on his form. The use cases on the right are used by the Public Entity who is providing the service. SDESC Section 1 Page 23 of 23 E-Government Malta Information Technology Agency