Document Management and Workflow System: Real Estate Administration Montenegro
Document Management and Workflow System: Real Estate Administration Montenegro
Document Management and Workflow System: Real Estate Administration Montenegro
Specification
Document Management
and Workflow System
Document History
Date Version Description By Approval
Content
1 Introduction................................................................................................5
1.1 Purpose of this Document...................................................................5
1.2 Scope of this Document......................................................................5
2 Background and Environment.....................................................................6
3 Terms and Definitions.................................................................................7
3.1 Definition of Terms.............................................................................7
3.1.1 Concept of Workflow Management Terms.................................9
3.2 Acronyms............................................................................................9
3.3 References........................................................................................10
4 Overall System Concept............................................................................11
4.1 The system Components...................................................................11
4.1.1 Workflow...................................................................................11
4.1.2 Document Management...........................................................12
5 Overall System Requirements...................................................................13
6 Document Management System...............................................................17
6.1 Overall Requirements.......................................................................17
6.2 Data Repository Requirements.........................................................17
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
1 Introduction
This document is related to a project where Statens kartverk (The Norwegian
Mapping Authority) is supporting the Real Estate Administration of
Montenegro (REA) to strengthen the national information infrastructure.
One procurement under this project shall include two sub-projects:
1. Document Management and
Workflow System
2. Pilot Document Data Conversion
This document contains the specifications for sub-project 1. Document
Management and Workflow System
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
Business Process
i.e. what is intended to happen
is defined in a Is managed by a
Process Instances
A representation of what is actually
Activity happening
which may be
include one or more
or
during
Manual Activities Automated Activities execution Activity Instances
Which is not managed as a part of represented by
the Workflow system which Include
and/or
Work Items Invoked Applications
Task allocated to a Computer tools/
workflow participant applications used to
support activity
3.2 Acronyms
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
Architecture
SOAP Simple Object Access Protocol
SQL Structured Query Language
UAT End-User Acceptance Test (synonymous with Site
Acceptance Test)
URL Uniform Resource Locator
WFMC Workflow Management Coalition WFMC
XML Extended Mark up Language
3.3 References
Some of the terms above are further explained in:
ISO International Standard - CEI/IEC 82045-1:2001
Workflow Management Coalition Glossary and Terminology, WFMC-
TC-1011
http://www.wfmc.org/standards/docs/TC-1011_term_glossary_v3.pdf
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
Note: The figure shows workflow control only of some components that are
those to be initially put under the workflow control. The workflow control shall,
however, be used for control of all modules of the document management
system, as well as other applications as expressed in the requirements to
Workflow Management System.
4.1.1 Workflow
The workflow system shall be offered as an optional part and is shown in red in
the figure above.
The workflow administration module shall define processes, activities and
roles. The module shall also monitor the process and activity instances and
generate status reports, as well as perform other relevant workflow
administration tasks. Both definition data and instance data shall be stored in
the workflow data repository.
The Workflow Control Module (or Workflow Engine) shall execute the actual
control of process and activity instances and their flow. It shall invoke and
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8.1.1 The Document Management and Workflow System l shall be available 24 Mandatory
hours a day, 7 days a week (24/7).
8.1.2 The Document Management and Workflow System shall be available at REA Mandatory
offices at the Local Offices via the Governmental network, and available for
public and private institutions, and citizens, via the Internet.
The system shall be able to manage more than 500 users connected at the
same time.
8.1.3 System response times for data entry will be 90% within 2 seconds
Mandatory
measured at REA as the delay between a key
100% within 3 seconds
stroke action by the user and the completion of
the system operation, on a client desktop
workstation similar to Intel Core Duo processor.
8.1.4 System response times for data search will be 90% within 2 seconds
Mandatory
measured at REA as the delay between a key
100% within 3 seconds
stroke action by the user and the time taken to
display the record required by the user, on a
client desktop workstation similar to Intel Core
Duo processor.
8.1.5 System response times for use of services provided by other systems shall Mandatory
not be included in the response time of the Document Management and
Workflow System, but the system shall provide a log for response times
when using services.
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8.1.6 The system shall be scalable to handle up to twice the currently planned Mandatory
amount of users of the Document Management and Workflow System.
8.2.1 The Document Management and Workflow System shall have an uptime of Mandatory
more than 99% of the announced 24/7 availability, measured over any 30
days period.
Note! Will be enforced in maintenance contract
8.3.1 The system shall provide the option on every page of the complete Mandatory
Document Management and Workflow System to view the headings, menus,
labels, tooltips, and any software control values in Montenegrin and English
language.
8.4.1 All written software shall be subject to a comprehensive error handling Mandatory
regime, which shall be described in the offer by the bidder.
8.4.2 Error and Warning messages shall be informative and identify the error as Mandatory
completely as possible (e.g. identifying the system, the procedure or
function, any variables passed to the procedure or function, the identifier of
the record being processed at the time of the error, the last SQL statement,
if relevant.)
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8.4.3 All error and warning messages shall be written to the server’s Windows Mandatory
Event Log for the Document Management and Workflow System
8.4.4 Critical errors shall be emailed automatically to all relevant software support Mandatory
personnel.
8.4.5 It shall be possible to configure the language (Montenegrin and English) for Mandatory
Error Messages.
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8,6,1 All modules of the Document Management and Workflow System shall be Mandatory
able to be scaled-up to the double the amount of users as currently
specified, without the need to pay for additional software license fees.
8,6,3 The supplier shall, at the stage of detailed system design, identify all Mandatory
software packages (whether Commercial or Open Source) that are required
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8.7.1 The system shall keep a log of all changes to the databases, including: Mandatory
Database transactions made by the Document Management and
Workflow System
Database changes made by Database Administrator
8.7.2 The system shall keep the log of changes for at least 6 months, and then Mandatory
archive it.
8.8.1 The system shall provide System Administration tools for the definition of Mandatory
user roles of
Read-only
Edit
and
Editor of the Document Management and Workflow System
Database Administrator
8.8.2 Changes to the databases shall only be made by use of the Document Mandatory
Management and Workflow System functionality, or by SQL-operations
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8.8.3 The Document Management and Workflow System shall be able to prevent Mandatory
the receipt of trivial messages from users as well as other kinds of spam
8.8.4 The Document Management and Workflow System shall take into account Mandatory
the existing comprehensive firewall protection for connections outside of
REA
8.9.1 The supplier shall deliver a plan for training of the staff at REA as part of the Mandatory
inception report.
8.9.2 It is required that the supplier works in partnership with the REA and other Mandatory
stakeholders identified by the REA to ensure knowledge transfer and further
build local capacity for maintenance of the system.
8.9.3 The supplier shall involve REA staff when developing administration and Mandatory
users manuals.
8.9.4 As part of the final handover the supplier shall provide the REA management Mandatory
with a written assessment confirming that the responsible REA staff is
competent to assume full responsibility for the system and make
appropriate recommendations about further training or support.
8.9.5 The supplier shall prepare and execute a formal training programme which Mandatory
shall identify timing, structure and content of the following training
programmes for the Document Management and Workflow System:
Training of Editor(s). The Editor(s) will be staff designated by the REA.
Training of Superuser
Training of REA web site programmer (if relevant)
Training of REA IT staff for system operation
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8.9.7 The number of participants of a training session shall be no more than 5 Mandatory
(five)
8.10.1 Installation The software shall be installed by the supplier at the Mandatory
premises of the REA under the supervision of the REA
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8.10.2 Testing There shall be three stages of the software testing Mandatory
and acceptance:
o Factory Acceptance Testing (FAT)
o User Test (UT)
o End User Acceptance Test (UAT)
8.10.3 Test plan The supplier shall deliver a test plan of all tests to be Mandatory
included in the FAT. This plan shall follow IEEE 829-
2008 guidelines. The test plan shall contain
A list of test scenarios (test cases)
Detail test cases associated to the scenarios
8.10.4 Test scenario The supplier shall prepare a list of test scenarios Mandatory
which shall contain a short description of real use
cases or workflows to be tested. The list of scenarios
shall be approved by REA
8.10.5 Test cases The supplier shall prepare test case specifications and Mandatory
provide them to the REA for approval. The REA shall
have the right to request modifications to the test
case documentation. The REA shall have the right to
use amended and expanded test cases for the User
Test and End User Acceptance Test (UAT).
8.10.6 Test cases The supplier shall prepare test case descriptions for Mandatory
Functional tests
Test of practical and actual workflows / use cases
8.10.7 Test case content The test cases shall cover all test scenarios. The Mandatory
description shall be formatted as a step-by-step
procedure (check-list), where each step is described
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8.10.8 Web Service Tests If relevant, the supplier shall use the following SOAP- Mandatory
UI software for the testing of web services:
http://www.soapui.org/
8.10.9 Test and training The supplier shall develop testing, training and Mandatory
environment development environments, separated from the
production system.
8.10.10 FAT The supplier shall perform FAT on all test cases. The Mandatory
FAT shall be documented and accepted by the REA
prior to the installation at REA.
8.10.11 External test During the development period, the supplier shall Mandatory
possibilities establish a test environment which is accessible from
REA and others as decided be REA
8.10.12 User Test After installation, a user test shall be performed at Mandatory
REA and at least one office or Internet user outside
REA. User test and acceptance shall be done after the
training is completed for the relevant REA staff.
8.10.13 Error corrections Based on the user testing the supplier shall correct Mandatory
the software and install a new version of the
software. The user tests shall continue until all errors
are removed.
8.10.14 UAT When all errors are removed, the supplier shall Mandatory
participate in the UAT. The UAT shall take place no
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8.10.16 Error handling During the installation, acceptance and warranty Mandatory
period the supplier shall provide corrective services.
The supplier shall in the offer present a proposal for
error reporting and corrective services, including
response times.
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8. System roll-out
8.11.2 Project schedule The project plan shall include the overall time Mandatory
schedule for the project with milestones. The project
plan shall be integrated with the Pilot Data Conversion
project into one common project plan.
8.11.3 Delivery plan The supplier shall provide a delivery plan that step-by- Mandatory
step specifies the deliveries which shall be approved
by REA after the Inception stage. This plan shall
include:
Detailed specification of the deliverables
Timetable of deliveries
8.11.4 Reporting For each of the initial stages: Inception, System Design Mandatory
and Pilot Project, the supplier shall provide a report
with the findings and recommendations for further
implementation. The REA shall accept the reports
individually before the project proceeds to the next
stage.
8.11.5 Project The supplier shall provide a description of the project Mandatory
organisation organisation with roles and required competences of
each position.
8.11.6 Personnel The supplier shall provide CVs for persons nominated Mandatory
for positions for project development and
implementation
8.11.7 Design stage The deliverables from the design stage of the project Mandatory
shall include documentation of
System architecture document with reference to
required principles
Data models
Service specifications
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
Task description
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
8.14.3 Price offer for support Yearly cost for support, software licences and Mandatory
and maintenance maintenance of IT Infrastructure shall be
specified by the supplier as a part of the B&Q
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
Appendix 1
Overview of relevant existing technical infrastructure
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
Appendix 2
List of relevant existing scanners
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
Appendix 3
SOA – Service Oriented Architecture
The Document Management system will be based on the principles of Service Oriented Architecture
(SOA), namely:
invocation services
web services
Web Services are services applied between two systems without user interaction. A request for
service is sent by one system as a message, and the response from the other system is a message.
SOAP Web Service, WMS and WFS are examples of Web Services.
Invocation services are used when the service involves user interaction directly to the system which
provides the service. The diagram below shows the principal functionality and data flow of an
invocation service:
An invocation service implies that a unique (session) key is defined by the Client. The key will be
associated with results which will be stored at the Service Provider. The Client will therefore be able
to request the stored data using the key via a final Web Service.
3
Real Estate Administration, Montenegro
Technical Requirement Specification, System, Version 1.2, Draft
3
Real Estate Administration, Montenegro