+ All Categories
Home > Documents > Rewrite of National Database System United Nations International … · Requirement Analysis &...

Rewrite of National Database System United Nations International … · Requirement Analysis &...

Date post: 15-Aug-2020
Category:
Upload: others
View: 0 times
Download: 0 times
Share this document with a friend
97
Datamatics Ltd. Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 1/97 Rewrite of National Database System United Nations International Drug Control Programme REQUIREMENT ANALYSIS DOCUMENT PRELIMINARY DESIGN DOCUMENT [RNRP1 version 1.0.1] Prepared by: DATAMATICS LTD. Bespoke Solutions Division Unit No 29, SDF-I, SEEPZ, Andheri(E), Mumbai 400096 Tel No : 91 (22) 8291253 91 (22) 8291495 Fax No: 91 (22) 8290120
Transcript
Page 1: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

Rewrite of National Database System

United Nations International Drug Control Programme

REQUIREMENT ANALYSIS DOCUMENTPRELIMINARY DESIGN DOCUMENT

[RNRP1 version 1.0.1]

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 1/97

Prepared by:DATAMATICS LTD.

Bespoke Solutions DivisionUnit No 29, SDF-I, SEEPZ,

Andheri(E), Mumbai 400096Tel No : 91 (22) 8291253

91 (22) 8291495Fax No: 91 (22) 8290120

Page 2: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 2/97

BackgroundOver the last 80 years, a worldwide system for control of drugs of abuse has

developed gradually through the adoption of a series of international treaties. Theimportant multilateral conventions currently in force are the Single Convention onNarcotic Drugs of 1961 (1961 Convention), as amended by the 1972 Protocol; theConvention on Psychotropic Substances of 1971 (1971 Convention) and, adopted in1988, the United Nations Convention against Illicit Traffic in Narcotic Drugs andPsychotropic Substances (1988 Convention). Each successive treaty broughtcomplementary regulations and advances in international law. From the beginning, thebasic aim of the international drug control treaties has been to limit the use of drugs tomedical and scientific purposes only.

UNDCP has been given a mandate to develop a global drug Information strategywithin the United Nations structure, integrating input from national, and regional andinternational sources in a computerized database. The purpose is to facilitate thelinkages, retrieval and dissemination of information on all aspects of narcotic drugs,psychotropic substances and the chemicals used in their illicit processing andmanufacturing. This has been reemphasized by Resolution of the General Assembly,Economic and Social Council, the commission on Narcotic Drugs, InternationalNarcotics Control Board.

One Objective in the development strategy of the existing National DatabaseSystem is to establish electronic information sharing mechanisms for drug relatedinformation between organizations and governments. This is increasing the quantity ofinformation, improve its quality, minimize errors, enable better analysis and policydecisions and reduce redundancy. This mechanism is also used for electronic meetingsand discussions. The aim was to improve the coordination and dialogue betweenInternational Organizations and Governments as more Organizations andGovernments could afford to participate in such low cost “meetings” and rapiddiscussions. This required two components to be developed:

1: UNDCP Internal Information System accessible to Governments (maintainedcentrally at UNDCP Headquarters, Vienna, Austria).

2: National Database System (NDS system) (to be installed locally at nationaladministrations)

The need for a “National Database System” has emerged from the above,requesting UNDCP to facilitate reporting and exchange of statistical information asrequired by the 1961, 1971 and 1988 Conventions between UNDCP and the nationaladministrations.

UNDCP implemented this request by developing a PC-based database andcommunication software package, which provides national administrations with a toolfor data entry and storage, reporting and electronic transmission of statisticalinformation. The package is able to communicate with UNDCP internal informationsystem via EDI files. The National Database System (NDS) currently has the ability toact on data in multi-level and multi-dimensional manners. It could act as a

Page 3: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 3/97

“sophisticated typewriter” for filling in the forms that should be reported to INCBaccording to the conventions, up to acting as a complex international distributed drugtrafficking information control system monitoring individual trade transactions. Thesystem is able to fulfill such requirements of diverse scopes. The system provides ofaggregation of data that doesn’t involve just summarizing it, but summarizing itaccording to the context it is desired to be dealt with whether on the level of anestablishment, national authority, transaction type (import/export), and internationallevel. Such multi-level and multi-dimensional viewing of the data is currentlyavailable in the system.

Datamatics developed the existing system (NDS) under a contract provided byUNDCP in the year 1995 Ref No. 95/124/VK for the development on the NationalDatabase System. The National Database System (NDS) was developed using OraclePower Objects (OPO) and Oracle 7.1 as it s database. NDS was developed for 16-bitoperating systems mainly Windows 3.1 and Windows for Workgroup. With the rapidchange in technology for operating systems, UNDCP intends to re-write NDS, whichwill support 32-bit operating systems like Windows 95, Windows 98 and WindowsNT. With respect to this, UNDCP has awarded a contract to Datamatics Ltd. for therewrite of the National Database System ref no. 99/015. It should be understood thatunder the current contract NDS rewrite is only an upgrade for enabling front-endapplication to run on MS-Windows NT4.0 and later in 32-bit mode, enable use ofMS-Word in combination with Corel WordPerfect for automatic report generation.The main areas for new developments are: a significant extension of a new module(s)covering the UN Annual Reports Questionnaire and a small new module for managinglicenses required in combination with the existing system.

Page 4: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 4/97

Acknowledgments

We would like to thank Mr. NORSKER for his contributions to the process of requirementsgathering for the National Database System. We would also like to thank his team members Mr.ABU GHALI and Mr. EIDHERR for their contributions for the entire process.

National Database System version 4.0.0 will cover the domestic distribution process for stocksmovements. The inputs provided by Ms. SELVA-BARTOLOME provided us with some in depthknowledge as to how stock movements are managed currently within the national administration. Weappreciate the inputs and would like to thank her for the same.

An additional module would be provided in the new release of the National Database Systemfor gathering inputs on the Annual Report Questionnaire. With the changes that are being consideredfor Part II of the Annual Reports Questionnaire, it would have been difficult for the team to completethe exercise of requirements gathering without the help of Mr. GRIFFITHS and Ms. GYNNA OGUZ.We would like to thank them for their inputs on the Annual Reports Questionnaire.

National Database System in its release 4.0.0 needs to provide in interface to the format ofdata understood by Interpol. This feature would help the national administrations to accept data fromother organizations, which capture or provide data in the Interpol format. The inputs provided by Mr.SERAMY and Ms. BAYER has helped the requirements gathering team to finalize on the way nationaldatabase system would provide its interface to the Interpol format. We would like to thank them for thesame.

The multilingual dictionary is partly being captured in the national database system version3.3e. This needs to be extended to capture entire data with respect to the dictionary to be provided withthe national database system. The information gathering team was benefited in this area by the inputsprovided by Mr. STEAD and Ms. NAIDIS. The inputs provided were of great help and have enabledthe team to understand as to how the dictionary would be provided in the national database systemversion 4.0.0. We appreciate the inputs provided by them and would like to thank them for the same.

Individual Seizures module within the National Database System captures information onseizures data. The InterForm EDI file would be produced using the National Database System version4.0.0. The information provided by Ms. BAYER and Mr. SERAMY was very helpful in deciding theformat and contents of the InterForm EDI File. We would like to thank them for their inputs.

Various inputs were provided by Mr. MEDIONI from Switzerland national administrationduring the third user group meeting held at UNDCP Vienna on February 11 2000. Mr. MEDIONI alsoprovided the team with inputs during the NDS team visit to the Swiss Office of Public Health onFebruary 21 2000. These inputs have played a major role in finalizing the functionality required to bebuilt-in to the new version of the National Database System. We would like to thank the Swiss nationaladministration for their extended cooperation for this phase of the project.

In the third user group meeting various inputs were also provided by Dr. BALLA, Ms.LUXENE, Ms. PETERFY and Mr. LASZLO from Ministry of Health of Hungary. These inputs havehelped the team in understanding the various stock movements within the countries and provided greatinputs on the establishment management module. We would like to thank them for their inputs.

Page 5: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 5/97

PrefaceThe document contains the result of the Requirement Study conducted for additionalmodules at UNDCP, Vienna. The assignment was to collect information on theworking of the new modules as proposed by various National Administrations andINCB. The first step was to document the existing procedures of the new modules, theway they are used or they need to be used by the various National Administrations.This was based on the rationale that no solution can be proposed until a basicunderstanding of the existing functionality is understood.

The understanding of the new modules is briefly described in this document. Thisdocument also explains various inputs, outputs and interfaces to and from thesemodules. An attempt has been made to put forward the proposed model for the newmodules as well.

This document assumes certain documents received as input until the 10th of February1, 2000. Any changes to the documents related to the new modules will not bereflected in this document.

Organization of contents

• Existing Environment : Describes existing methods, procedure practices,business rules, problems and requirements.

• Proposed System : Describes the proposed system• Database Design : Describes the database model to be used for

Establishment Management Module and Annual Reports Questionnaire• User Procedures : Describes the user procedures that need to be followed

for day to day operations of the above-mentioned module.• Assumptions, Constraints and Risks: Describes the assumptions,

constraints and risks for the proposed system.• Acceptance Criteria : Describe the system acceptance criteria in terms of

Requirements, Features, Performance & Usability.

AudienceThis document addresses the functionality of the new modules that needs to be addedto the existing National Database System. This document hence is addressed to allpersonnel who are familiar with the functioning of these modules and also isaddressed for personnel who have an idea as to how the functionality should beimplemented in the new version of the National Database System. This document isprimarily addressed to the UNDCP staff members, however, any personnel who canadd value to this document and in turn to the National Database System are kindlyrequested to provide their feedback on the same.

Page 6: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 6/97

Guidelines for readingIn order to understand this document in its total context, we request you to read/referthe following documents in the order specified prior to reading this document;

1. Requirements Analysis Document prepared for the National DatabaseSystem version FINAL.

2. Request for Proposal (Ref No : 99/015)3. Annual Reports Questionnaire (Old and the new templates)4. Commentary on the United Nations Convention Against Illicit Traffic in

Narcotics Drug and Psychotropic Substances 1988.

Pre-Requisite ReadingRefer to Guidelines for Reading.

Definitions and AbbreviationsSince the document prepared for the National Database System version 4.0.0 is

an extension to the existing document prepared for the first version of NDS. Thedefinitions and abbreviations of the existing documents would apply.

Page 7: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 7/97

Table of Contents1. INTRODUCTION............................................................................................................................10

ORGANIZATION PARTICULARS .............................................................................................................10OBJECTIVES .........................................................................................................................................12SCOPE..................................................................................................................................................13

2. EXISTING ENVIRONMENT ........................................................................................................15

OVERVIEW OF PROCEDURES AND PRACTICES.......................................................................................15Establishment Management Module...............................................................................................15

Substances and various Groups...................................................................................................................15Licenses.......................................................................................................................................................15Stocks Movement........................................................................................................................................16

Multilingual Dictionary (MLD) ......................................................................................................19Annual Reports Questionnaire........................................................................................................20Interface to INTERPOL ..................................................................................................................21Preferences .....................................................................................................................................22Business Processes and Rules.........................................................................................................23

Function: Maintain a Group....................................................................................................................23Function: Request a License ...................................................................................................................24Function: Authorize a License ................................................................................................................25Function: Revoke a License....................................................................................................................26Function: Stock Movements ...................................................................................................................27Function: Multilingual Dictionary..........................................................................................................35Function: Annual Reports Questionnaire................................................................................................36Function: Interface to Interpol ................................................................................................................37Function: Preferences .............................................................................................................................37

Functions and Processes.................................................................................................................38Diagram 1:...................................................................................................................................................38

Process: Record Opening Stocks for a Substance and for an Establishment ..........................................39Process: Record Import Transactions from establishment in another country. .......................................39Process: Record Export Transactions from establishment in another country. .......................................39

Diagram 2:...................................................................................................................................................40Process: Records Domestic Distribution (Purchases) from another establishment. ................................41Process: Records transaction for losses in process of manufacture.........................................................41Process: Records transaction for stocks destroyed..................................................................................41Process: Records transaction for stocks consumed. ................................................................................42Process: Records Domestic Distribution (Sales) to another establishment. ............................................42

Diagram 3:...................................................................................................................................................43Process: Records transaction for Stocks Procured/ Withdrawn for special purposes. ............................44Process: Records transaction for stocks used in schedule III Preparations. ............................................44Process: Records transaction for stocks used for manufacture................................................................44

Diagram 4:...................................................................................................................................................45Process: Records transaction for stocks used in manufacture of non-psychotropic substances ..............46Process: Records transaction for Stocks used in manufacture of exempted preparations .......................46Process: Records transaction for Inventory adjustments for an establishment........................................46Process: Records Inspection results for an establishment .......................................................................46

Diagram 5:...................................................................................................................................................47Process: Generate Stock Ledger .............................................................................................................48

Diagram 6:...................................................................................................................................................49Process: Request a License .....................................................................................................................50Process: Approve a License ....................................................................................................................50Process: Revoke a License......................................................................................................................50

Diagram 7:...................................................................................................................................................51Process: Maintain ARQ Questions .........................................................................................................52Process: Generate EDI for ARQ Questions ............................................................................................52Process: Upload EDI for ARQ Questions...............................................................................................52Process: Capture Answers for ARQ........................................................................................................52Process: Authorize ARQ Answers ..........................................................................................................53Process: Generate EDI for ARQ Answers ..............................................................................................53Process: Print ARQ.................................................................................................................................53

Page 8: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 8/97

Inputs, Outputs and Interfaces........................................................................................................54Inputs ..........................................................................................................................................................54Outputs........................................................................................................................................................55Interfaces.....................................................................................................................................................56

Problems .........................................................................................................................................57Additional Requirements.................................................................................................................57

3. PROPOSED SYSTEM ....................................................................................................................58

OVERVIEW...........................................................................................................................................58FUNCTIONALITY...................................................................................................................................58DATA REQUIREMENTS .........................................................................................................................58GENERAL REQUIREMENTS ...................................................................................................................58

Performance requirements...........................................................................................................................58User interface requirements.........................................................................................................................58Other interface requirements .......................................................................................................................58Data Migration ............................................................................................................................................59Security .......................................................................................................................................................59Target environment .....................................................................................................................................59

For Single User Environment (Software) ...............................................................................................59For Single User Environment (Hardware) ..............................................................................................59For Multi User Environment (Software).................................................................................................59For Multi User Environment (Hardware) ...............................................................................................60

Development Environment .........................................................................................................................60For Single User Environment (Software) ...............................................................................................60For Single User Environment (Hardware) ..............................................................................................60For Multi User Environment (Software).................................................................................................61For Multi User Environment (Hardware) ...............................................................................................61

Documentation ............................................................................................................................................61Training.......................................................................................................................................................62Parallel run..................................................................................................................................................62Localization (Local language support)........................................................................................................62Compatibility ..............................................................................................................................................62Audit trails ..................................................................................................................................................62Error log......................................................................................................................................................62Archiving & restoring .................................................................................................................................63Versioning...................................................................................................................................................63History and retention control ......................................................................................................................63Administration and Customization..............................................................................................................63

ERROR HANDLING ...............................................................................................................................64STANDARDS.........................................................................................................................................64

4. DATABASE DESIGN......................................................................................................................65

5. USER PROCEDURES .....................................................................................................................66

ROUTINE..............................................................................................................................................66EXCEPTION ..........................................................................................................................................66NAVIGATION ........................................................................................................................................66SCREENS..............................................................................................................................................66

Logon screen...................................................................................................................................66Group Master Maintenance Screen (EMM)....................................................................................67License Type Maintenance Screen (EMM) .....................................................................................67License Request Screen (EMM) ......................................................................................................67License Authorization Screen (EMM).............................................................................................68License Revoking Screen (EMM)....................................................................................................70Establishment Management Screen ................................................................................................70

Screen Header .............................................................................................................................................70Opening Stocks TAB Folder .......................................................................................................................70Stock View TAB Folder..............................................................................................................................71Stock Adjustment TAB Folder....................................................................................................................71Inspection Results TAB Folder ...................................................................................................................72Import Details TAB Folder .........................................................................................................................73Export Details TAB Folder .........................................................................................................................73Domestic Purchase Details TAB Folder......................................................................................................74

Page 9: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 9/97

Domestic Sales Details TAB Folder............................................................................................................74Consumed TAB Folder ...............................................................................................................................75Manufactured (Psychotropic) TAB Folder.................................................................................................76Manufactured (Narcotics) TAB Folder ......................................................................................................76Manufactured (Precursors) TAB Folder.....................................................................................................77Manufacture of Non-Psychotropic TAB Folder (Psychotropics) ................................................................78Manufacture of Exempted Preparations TAB Folder (Psychotropic)..........................................................78Used for Scheduled III TAB Folder (Narcotics) .........................................................................................79Procured/Withdrawn TAB Folder (Narcotics) ............................................................................................79Destroyed TAB Folder ................................................................................................................................80Destroyed Type ...........................................................................................................................................80Losses TAB Folder (Loss in Process) .........................................................................................................80

Establishment Details Screen - Import/Export, Domestic Purchase & Sales ................................81Establishment Details Screen - Manufactured (Used/Obtained) ...................................................82Establishment Details Screen - Other Types..................................................................................83Recording of Questions (ARQ) .......................................................................................................84Recording Answers – (ARQ - Main Page Entry) ............................................................................86

Recording Answers .....................................................................................................................................86Header Portion ............................................................................................................................................86Answer Entry Portion..................................................................................................................................87

Approving ARQ Answers ................................................................................................................87Print ARQ Questions.......................................................................................................................88Print ARQ Answers .........................................................................................................................88Recording of MLD Details (MLD)..................................................................................................88

Description..................................................................................................................................................88Description..................................................................................................................................................88

Recording of Preference Window (Parameters) .............................................................................89REPORTS..............................................................................................................................................90

Print Group Master.........................................................................................................................90Print License Type Master ..............................................................................................................90Print a License Request ..................................................................................................................91Print a License Authorization .........................................................................................................91Print Stock Ledger ..........................................................................................................................93Print Inspection Details ..................................................................................................................94

6. ASSUMPTIONS, CONSTRAINTS AND RISKS..........................................................................95

ASSUMPTIONS......................................................................................................................................95CONSTRAINTS ......................................................................................................................................95RISKS...................................................................................................................................................95

7. ACCEPTANCE CRITERIA ...........................................................................................................96

ANNEXES .............................................................................................................................................97

Page 10: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 10/97

1. IntroductionOrganization Particulars

The International Narcotics Control Board (INCB or Board) is the independentand quasi-judicial control organ for the implementation of the United Nations drugconventions, established in 1968 by the Single Convention on Narcotic Drugs of1961. It had predecessors under the former drug conventions since the time of theLeague of Nations.

The Board is independent of Governments as well as of the United Nations; its13 members serve in their personal capacity. They are elected by the United NationsEconomic and Social Council (ECOSOC) and their work is financed by the UnitedNations. Three members are elected from a list of candidates nominated by WHO and10 from a list nominated by Governments. It is the Board's responsibility to promotegovernment compliance with the provisions of the drug control treaties and to assistthem in this effort. The Board's tasks are laid down in the treaties. Broadly speaking,the Board deals with two aspects of drug control:

With regard to licit manufacture, commerce and sale of drugs, the Boardendeavors to ensure that adequate supplies are available for medical and scientificuses, and that leakage’s from licit sources to illicit traffic do not occur. To this end, itadministers an estimates system for narcotic drugs and a voluntary assessment systemfor psychotropic substances, and monitors international trade in drugs through thestatistical returns system. The Board also monitors government control over chemicalsused in the illicit manufacture of drugs, and assists them in preventing diversion ofthese chemicals into illicit traffic. With respect to illicit manufacture and trafficking ofdrugs, the Board identifies where weaknesses in the national and international controlsystems exist and contributes to correcting the situation. Further, the Board isresponsible for assessing chemicals used to illicitly manufacture drugs, for possibleinternational control.

The United Nations Office for Drug Control and Crime Prevention, which consists ofthe United Nations International Drug Control Programme and the United NationsCentre for International Crime Prevention, is established to enable the Organization tofocus and enhance its capacity to address the interrelated issues of drug control, crimeprevention and international terrorism in all its forms. The United NationsInternational Drug Control Programme was established pursuant to General Assemblyresolution 45/179 of 21 December 1990 as a single body responsible for coordinatedinternational action in the field of drug abuse control.

The United Nations International Drug Control Programme (UNDCP);(a) Serves as the central drug control entity with exclusive responsibility for

coordinating and providing effective leadership for all United Nations drug controlactivities and serves as the repository of technical expertise in international drugcontrol for the Secretariat of the United Nations, including the regionalcommissions, and other United Nations organs, as well as Member States, and inthis capacity advises them on questions of international and national drug control;

Page 11: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 11/97

(b) Acts, on behalf of the Secretary-General, in fulfilling responsibilities under theterms of international treaties and resolutions of United Nations organs relating tointernational drug control;

(c) Provides advice to Member States on the implementation of international drugcontrol treaties and promotes effective implementation and adherence to theconventions by States;

(d) Provides secretariat and substantive services to the Commission on NarcoticDrugs and its subsidiary bodies and, with due consideration for treatyarrangements, to the International Narcotics Control Board;

(e) Provides substantive services to the General Assembly, the Economic and SocialCouncil and committees and conferences dealing with drug control matters;

(f) Develops and carries out drug control operational activities at the national,regional and global levels, through a network of field offices; assists Governmentsin the development and implementation of national, subregional and regionalprogrammes aimed at reducing illicit cultivation, production, manufacture, trafficand abuse of narcotic drugs and psychotropic substances and in improving theeffectiveness of measures for controlling the licit supply of drugs and precursorchemicals;

(g) Cooperates closely with outside research institutions, associations and universitiesto secure and share information on the latest research findings related to drugcontrol; initiates and participates in joint projects; and promotes coordination andcooperation on drug control activities with regional and internationalorganizations.

United Nations system and drug control organs and their secretariat

Direct connection (Administrative or constitutional)Reporting, cooperating and advising relationship

* In accordance with general Assembly resolution 45/179 of 21December 1990, the secretariat of INCB has been fully integrated intoUNDCP.

General

ECOSOC

INCB CND

UNDCP* / INCB

Page 12: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 12/97

ObjectivesProduction, manufacture of and trade in psychoactive drugs and the chemicals

needed for their illicit manufacture are controlled nationally and internationally. Thepurpose of control is twofold: to prevent diversion of substances into illicit channelsand to ensure that countries obtain the quantities they need for medical, scientific andother licit purposes. Monitoring and managing movements of controlled substances isa complex process as it involves numerous partners. Typically, information needs tobe exchanged between commercial companies, national drug control administrations,customs officials and the Secretariat of the International Narcotics Control Board(INCB). All information provided to INCB is kept confidential under the provision ofthe international drug control treaties.

A computer-based system has been designed and is available to facilitatemanagement and control over licit movements of psychoactive drugs and precursorschemicals and to enhance timeliness of information exchange at the national andinternational levels. It offers a means for electronic communication and data exchangebetween national drug control authorities, companies and customs officials. It enablesauthorization, certificates and data to be transmitted electronically between importingand exporting countries and all relevant statistics to be reported electronically toINCB.

The system primarily enables national administrations to keep track of allindividual transactions in a computerized database. It handles issuance of import-export authorizations, certificates and pre-notifications with respect to internationallicit trade. It facilitates national monitoring and management of production,manufacture, consumption, stocks, confiscation of seizures etc. in relation tosubstances and preparations containing narcotic drugs, psychotropic substances andprecursor chemicals.

In addition to electronic reporting of statistics to INCB, and electronictransmission of documents related to trade, hard copies of INCB forms can be printedout in multiple languages. The system is currently available in English, French andSpanish; however, it has been designed to allow individual countries to adapt it toother languages.

It should be understood that the requested software is an upgrade of thecurrently existing National Database System. The main areas of upgrade are: enablingthe front-end application to run on MS-Windows NT 4.0 and later in 32 bit mode,enable use of MS-word in combination with Corel WordPerfect for automatic reportgenerations. The main areas for new developments are: a significant small newmodule(s) covering the UN Annual Reports Questionnaire a small new module formanaging licenses required in combination with the existing system. The purpose ofthis document is to conceptualize the business functionality of the new modules andhighlight all other aspects related to the upgrade of the National Database System interms of environment, security features, navigation etc.

Page 13: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 13/97

Scope

National Database System (NDS) is currently made available to nationaladministrations in English, French and Spanish. NDS is currently designed usingOracle Power Objects (OPO) as its front-end tool and Oracle 7.1 as its database.Reporting is currently provided for using Corel WordPerfect 6.1 as its reporting tool.The National Database System was originally designed to run on MS-Windows 3.1 inthe standalone mode and MS-Windows 3.11 for Workgroup in a Workgroupenvironment using Oracle Workgroup Server as its database.

Considering the rapid change in technology and the heterogeneousenvironments of various users in terms of operating systems, Word-Processors anddatabase environments, a need for re-write has evolved. The objective of this exercisehas been explained in the “Objectives” section earlier. The scope for the same is;

(a) To enable the front-end applications to run on MS-windows NT 4.0and later in 32 bit mode. The exact software environment to be used forthe same is mentioned further in the section “DevelopmentEnvironment”.

(b) To enable the use of MS-word 8.0 along with Corel WordPerfect 8.0for generation of reports prescribed by INCB.

(c) To develop an extension of a new module(s) covering UN AnnualReports Questionnaire (ARQ).1

(d) To develop a small new module for managing licenses required incombination with the existing system.

It should be understood that a re-write is an upgrade of the existing NationalDatabase System. Apart from Form C, Form P, Individual Seizures, thefunctionality of the existing modules will remain as it is and will not undergo anychange. As changes to Form C, P and Individual Seizures following are theenhancements done;

a) In case of Form C an additional column of losses has been added to thestatistics. The report layout also in case of Form C has changed.

b) In case of Form P an additional Page for information for manufacturing hasbeen added. In case of Form P due to additional of the new page, the reporttemplate has changed.

c) In case of Individual Seizures, an additional EDI message is being added tomatch the file format of InterForm. In case of Individual Seizures, therewill be no change in the existing Significant Drug Seizures (SDS) formoutput.

d) In case of Form D, the report template has been changed.

In addition to the above-mentioned changes, there will be improvements provided forthe user interface as follows;

a) Context Sensitive Help.b) Record-Set Bar for every object within a window.

1 The ARQ component to be developed under client-server environment using PowerBuilder is a part ofthe contract. However an additional component for data capture over the Internet is being discussed andwill become a part of the scope, if mutually agreed between UNDCP and Datamatics Ltd.

Page 14: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 14/97

c) Vertical Scroll Bars for every possible object within a window.d) Drop-downs in query mode.e) Search facility within drop-downs in query mode.f) Single Login window for multiple modules of NDS running

simultaneously.g) Printing of Import Export documents through the application over and

above disintegration of report generation code from the application.h) Query facility for all visible objects on any given window.i) Color change for aggregated quantity, in case of discrepancies.j) Date control for data entry of date fields.k) Auto Save for navigation between TAB folders.l) Provision of record selectors to highlight multiple records so as to enable

users to delete more than one record at any given point in time. Thisfeature will be applicable only to screen objects with multiple lines.

m) Cascaded Deletions. This feature would mean that if the user deletes FormA Header, all the related records to Form A header should be deleted. Thisfeature is currently available in version 3.3e and needs to be carriedforward to version 4.0.0

n) Short Cut keys for menu items. This would mean any menu item from thesystem menu could be accessed using a function key or a combination ofkeys.

o) Context sensitive pop-up menu for all forms. This means that the user canright click on any editable field and would have a pop-up menu that canlaunch the context-sensitive help.

p) Sorting for any field within the form. This feature would be available onthe right click menu and would apply to the current object. Sorting will nottake place across objects.

q) Field Selection. Whenever the user places the cursor in a field, the fieldwould be selected enabling faster data entry changes for the user.

The improvements will be incorporated into the system discussed between UNDCPand Datamatics and only on mutual agreement between the two parties, the same willbe incorporated in the new build of the system.

Page 15: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 15/97

2. Existing EnvironmentOverview of Procedures and practices

This section will explain the procedures and practices in general with respectto the two new modules being added to the National Database System.

Establishment Management ModuleThe National Database System version 3.3e is directed towards capturing data

in order to enable National Administrations to report to INCB in various formsprescribed by the commission. The current version of NDS provides a facility tocapture data for various establishments and aggregates the same for INCB reportingpurposes. One of the objectives of upgrading NDS with additional modules is toenable the National Administrations to capture the data for its various establishmentsto manage the stock movements of substance and preparations within itsestablishments. Following are the features that need to be added to the newEstablishment Management Module;

a) A facility to define substances within various groups∗ .b) A facility to request for Licenses and approval of the same.c) A facility to manage stocks and its various movements within various

establishments of the respective country.

Substances and various GroupsNational Database System needs to provide a facility to add substances andpreparations to groups. Substances and preparations can be added to one ormany groups. These groups will be used for requesting and issuance oflicenses to various establishments requiring the same. A “group” concept willbe used for licenses only and will not be used anywhere else within thenational database system version 4.0.0

LicensesLicenses are required for more efficient inventory control of the varioussubstances and preparations that needs to be monitored by Nationaladministrations for Sales, Purchase, Imports, Exports, Manufacture, Transport,Wholesale, Scientific and Research activities, Special License for Brokers andStocks. As stated in the commentary of the 1988 convention, the NationalAdministration, to achieve better control against illicit traffic may;A) Control all persons and enterprise engaged in the manufacture and

distribution of such substances;B) Control under license the establishment and premises in which such

manufacture or distribution may take place;C) Require that licensees obtain a permit for conducting the aforesaid

operations; ∗ A group can contain the following;

a) A substance or a set of substancesb) A preparation of a set of preparationsc) A group or a set of groups

A group can contain any or all or even a combination of the items mentioned above.

Page 16: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 16/97

D) Prevent the accumulation of such substances in the possession ofmanufacturers and distributors, in excess of the quantities required for thenormal conduct of business and the prevailing market conditions.

The National Database System under version 4.0.0 needs to provide a facilityto allow various establishments to request for a license and allow the nationaladministrations to authorize the same. Licenses would be requested for variouspurposes. For e.g. for Sales, Purchase, Imports, Exports, Manufacture,Transport, Wholesale, Scientific and Research activities, Special License forBrokers and Stocks. Licenses may be requested and approved for a time periodand may be for a specified quantity/ volume. There are scenarios where alicense is requested and approved for substance without any limit on quantity/volume. When an establishment requests for import or export authorizations,the national database system on performing all the checks as it does in version3.3e would perform additional checks with respect to the license. First of all itwill check, if a license exists. If a license exist, it will check if the authorizedquantity is within the limits of the license. If any of these conditions are notmet, the import export module in case of import authorization and exportauthorization would provide the user with appropriate warnings. The nationaldatabase system version 4.0.0 needs to also maintain the quantity authorizedand needs to ensure that the quantity authorized across authorizations does notexceed the total permitted quantity under all licenses for the specifiedsubstance.

In case of issuance of an authorization (either imports or exports), each recordfor a substance must contain an information icon that provides a pop-upwindow with the licensed quantity for a country indicating as to what has beenissued and what is left. This information would be very useful in making adecision regarding the quantity that has been requested.

Stocks MovementThe national administrations under version 4.0.0 of the national databasesystem will have to be provided a facility to manage the stock movementswithin the various establishments. For every establishment, the nationaladministration would record the opening stocks of each of the substances andpreparations. During the year, every transaction that is performed by anestablishment would be informed to the national administrations. The nationaladministrations would in turn record these transactions within theEstablishment Management module.

Establishments in any country are categorized into three types, a manufacturer,a wholesaler and a retailer.

A manufacturer can import substances or preparations, use them tomanufacture other substances or preparations and can distribute themanufactured substances or preparations to wholesalers, retailers or othermanufacturers. A manufacturer in certain cases can export these substances orpreparations to establishments in other countries. The manufacturer ifpermitted can stock these substances or preparations until they have been

Page 17: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 17/97

processed or distributed. When a manufacturer imports or exports substancesor preparations to and from other establishments in other countries, thetransaction is recorded as import or export transaction respectively. The importand export transactions are recorded at the establishment and nationaladministration level. When a manufacturer manufactures substances orpreparations using substances under international control, two transactions arerecorded, one for used and the other for manufactured. Both these transactionsare recorded at the establishment level and also at the national administrationlevel. When the manufacturer does a domestic distribution to a wholesaler oranother manufacturer, two transactions are recorded, one as domestic sales andthe other as domestic purchases. These transactions are recorded only at theestablishment level. There is no transaction recorded in such a scenario at thenational administration level. When a manufacturer distributes substances toretailers, three transactions are recorded, one as domestic sales, the other asdomestic purchases and the third as consumed by the retailer. Thesetransactions are record at the establishment level. The only transactionrecorded at the national administration level is the one for consumed. When amanufacturer loses substances or preparations in the process of manufacturer,a transaction for loses is recorded at the establishment and the nationaladministration level. When the manufacturer destroys substances for variousreasons like contamination or hazardous reasons for other stocks or stockedbeyond the permitted period, one transaction for stocks destroyed is recordedat the establishment level. In such a scenario the national administration wouldrecord this transaction as inventory adjustments.

A wholesaler receives the substances or preparations from a manufacturer,repackages them into various preparations and distributes them to otherwholesaler or retailers. A wholesaler can also import or export substances, ifpermitted from establishments in other countries. When a wholesaler importsor exports substances or preparations containing substances under internationalcontrol, these are recorded as imports and exports respectively. Thesetransactions are recorded at the establishment level and also at the nationaladministration level. When a wholesaler receives substances or preparationsfrom a manufacturer or from another wholesaler, there are two transactionsrecorded. One transaction for domestic exports and the other transaction fordomestic imports. Both these transactions are recorded at the establishmentlevel and no transaction in such a scenario is record at the nationaladministration level. When a wholesaler distributes these substances orpreparations to retailers like hospitals, medical institutions or pharmacies,three transactions are recorded. One for domestic sales, the other for domesticpurchases and the third transaction for consumed by retailer. Thesetransactions are recorded only at the establishment level. At the nationaladministration only the third transaction of consumed is recorded. If awholesaler uses these substances to repackage them in preparations, then onetransaction for consumed by the wholesaler is recorded at the establishmentand the national administration level.

A retailer is an establishment other than a manufacturer. A retailer can be adoctor, a pharmacy, a hospital or any other establishment that can use these

Page 18: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 18/97

substances under international control. In certain cases, a retailer can importsubstances or preparations, if permitted from establishment in other countries.For monitoring stocks by a national administration, if a stock reaches aretailer, it is considered as consumed. The transaction for consumed by retaileris recorded at the establishment level and also at the national administrationlevel.

A new type of transaction type is being introduced as part of the stockmanagement module. This is the domestic distribution type. In case ofdomestic distribution, one transaction would be recorded against eachestablishment. Against the provider a domestic sales type of transaction wouldbe recorded and against the receiver, a domestic purchases type of transactionwould be recorded. Please note that there will be no aggregation of thesetransactions within the INCB prescribed forms. An example covering thevarious cases mentioned above is presented in a tabular form in Annex 9.

If the national administration in conjunction with various establishmentswithin the country involved in stock movements of controlled substancesrecord information on stock movements, then the national administration cangenerate a report called as the stock ledger. The stock ledger will indicate theopening balance of a substance and the transactions performed by the specifiedestablishment over a period of time. The stock ledger will indicate the closingbalance. The national administration on performing inspection acrossestablishments can record information on inspection performed within thenational database system. The stocks recorded during the inspection wouldenable the national administrations to highlight any discrepancies that exists inthe stocks reported by establishment and the one derived by nationaladministrations. The system would provide a facility to enter an inventoryadjustment entry. This entry would be required for balancing the stocks in caseof the inspection results resulting in discrepancy between derived and actualstocks.

For domestic distribution (stock movement), there are other types oftransactions that would also need to be tracked. In case of Narcotic Drugs,Psychotropic Substances and Precursors the transactions related to Losses,Destroyed, and Consumed and manufactured would have to be captured. Thesetransactions would have an impact on the stocks of an establishment and alsofor a national administration.

In case of narcotic drugs substances Procured or Withdrawn for specialpurposes and substances used for Schedule III preparations would affect thestocks of an establishment and the national administration. These would becaptured under the establishment management module for narcotic drugs. Incase of narcotic drugs transaction types for Substances used for manufacturefor non-psychotropic substances and used manufacture of exemptedpreparations under article 2 para 2 and 3c would not be applicable.

In case of Psychotropic substances additional to the transactions mentionedabove Substances used for manufacture for non-psychotropic substances and

Page 19: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 19/97

substances used for manufacture of exempted preparations under article 2 para2 and 3c would also affect the stocks of an establishment and the nationaladministration. These would also be captured under the establishmentmanagement module. In case of psychotropic substances transaction types forsubstances Procured or Withdrawn for special purposes and substances usedfor Schedule III preparations would not be applicable.

In case of precursors the transaction types for Substances used for manufacturefor non-psychotropic substances, substances used for manufacture of exemptedpreparations under article 2 para 2 and 3c, substances Procured or Withdrawnfor special purposes and substances used for Schedule III preparations wouldnot be applicable.

InspectionsOne of the objectives of the establishment management module is to be able tomanage the stock status of the various establishments within the country forbetter control. In such a scenario, one of the most important events that need tobe addressed is of Inspections. The new version of the national databasesystem version 4.0.0 would address the information recording process ofinspections. Inspections in the national database system would only be used torecord information on such events. The information recording process wouldnot be integrated with the stocks movement options provided in theestablishment management module. In case the national administration findsany discrepancies in the stocks of an establishment and wants the same to bereflected in actual stocks, then the national administration would have to usethe inventory adjustment option in the establishment management module todo so. There will be no automatic update facility for the same.

Multilingual Dictionary (MLD)The Multilingual Dictionary of Narcotic Drugs and Psychotropic substances

under International Control is prepared as a reference manual consisting ofmonographs on substances included in schedules of Single Convention on NarcoticDrugs, 1961, and the Convention on Psychotropic Substances, 1971, and an alphabeticcross-index of all names included in the monographs.

Since its publication in the original form, the Commission of Narcotic Drugs(CND) has regularly requested further development and extension of the MultilingualDictionary until its edition in the current form. The CND has stressed the importanceof the Multilingual Dictionary on several occasions, and, at the same time, hashighlighted the need to keep the information up to date by regular revision of thepublication. This will ensure that it remains an effective tool for national andinternational control purposes and provides valuable information to nationalinstitutions involved in drug related issues, including law enforcement authorities,justice, regulatory agencies, health institutions and drug testing laboratories.

The National Database system version 3.3e currently provides for some of theinformation needed to produce a Multilingual Dictionary. Additional information thatis not currently covered under the national database system would encompass of themolecular weight, chemical formulae, CND approved names, trade names and

Page 20: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 20/97

chemical composition diagram. This information needs to be provided with version4.0.0 of the national database system in order for the users to lookup the requiredinformation. The national database system needs to provide a facility to view thisinformation and also to make the necessary changes to the information from time totime. The system as in version 3.3e prints details of a substance that is currently beingviewed. In version 4.0.0 the system needs to print the information as it would beprinted out in the MLD for that respective substance.

Annual Reports QuestionnaireThe traditional way for compiling data, as foreseen by the International Drug

Conventions, is to request the information from governments through officialchannels. Theoretically, the administration of data collection is simplified if a singlefocal point in each country is identified (“competent authority”, as foreseen in theConventions) through which data collection can be channeled. Consolidation andanalysis of such material is facilitated if the data are reported in a standardized format.

UNDCP and INCB have been applying this approach to solicit data for years.UNDCP (CND) sends “Annual Reports Questionnaire” (ARQs) to Member States onan annual basis.

The “information mandates”, as laid down in the conventions and in ECOSOCand General Assembly Resolutions, are largely complementary. They pertain toinformation on the whole spectrum of the “illicit’ aspects of the drug phenomenon,including illicit cultivation, clandestine manufacture, trafficking, drug abuse and itsconsequences, as well as preventive measures, and, more generally, drug policies andprogrammes. One of the key functions for collecting, analyzing and synthesizinginformation obtained through the ARQ is to report back to the commission and makerecommendations. In addition, ARQ data – in combination with information fromother sources – also serve as input for other UNDCP functions.

The current ARQ covers three domains:

Part I pertains to legal aspects referring to information clearly spelled out inthe Conventions;

Part II pertains to drug demand issues, reports information on the spread ofabuse (prevalence); the patterns of abuse and trends of abuse. Specialmention is also made of substance abuse related mortality cases. Inaddition, ‘programmatic’ information is to be collected to monitor theimplementation of the CMS;

Part III pertains to issues of the supply of controlled drugs; it is designed tocollect data on illicit trafficking – i.e. data on seizures, arrests, transitroutes, diversions from licit channels as well as other traffickingrelated data (prices, purities, etc); moreover information is to becollected on illicit cultivation and clandestine manufacture.

The national database system version 4.0.0 will provide a new module containing theannual reports questionnaire covering Part I, Part II and Part III. These questionnaireswould be made available for data capture and printing. The annual reportquestionnaire, Part II is currently under revision. The new format of Part II as

Page 21: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 21/97

provided by UNDCP would be provided along with the national database systemversion 4.0.0. This version of Part II is planned to be submitted to the nationaladministrations as a pilot exercise to receive more inputs on the questionnaire prior toit being finalized by the Commission of Narcotic Drugs. Considering the fact thatquestions are being continuously revised for improving the content and quality ofinformation being requested from national administrations and respective authorities,the system will provide for a facility to modify the existing questions within aquestionnaire. The system will also provide a facility to customize the way answersneeds to be provided by national administration and the respective authorities. Theprinting facility for the annual report questionnaire would be provided usingPowerBuilder as the format could be changed. Changes to questions performed atUNDCP headquarters Vienna would have to be transmitted to NDS installations viaEDI for these to be updated at every installations. The answers that are captured canalso be electronically transmitted to UNDCP headquarters in Vienna using the EDImechanism. Questions once changes and transmitted electronically via EDI wouldalso change the way answers needs to be printed for ARQ outputs.

Many a times there are multiple authorities within a country that provide for theinformation requested in the annual reports questionnaire. In such a scenario, thenational database system version 4.0.0 would provide for a facility to capture multipleanswers for the same question from various authorities. The competent authoritywould also be provided with a facility to authorize the answer that is felt to be morecorrect and close to the questions asked under the annual report questionnaire. Theanswers authorized will be the only answers that would get printed in the output of theannual report questionnaire. In case the competent authority has not authorized anyanswers for a specified question, no answer would be printed in the ARQ output.

Interface to INTERPOLThe national database system version 3.3e has a facility to capture seizures as

and when they take place. The system also supports for EDI exchange between twosystems of the national database system version 3.3e. The EDI message format is aninternal format to the system. One of the requirements for national database systemversion 4.0.0 is to be able to produce data in InterForm, format understood by theICPO System. Data today is received at the national administrations from varioussources. Some of the information is also provided by WCO and ICPO. Theinformation provided by ICPO and WCO to the competent authorities is provided inthe InterForm format. Hence it becomes very important for the national databasesystem to understand this format and to be able to translate the information providedappropriately so as to aggregate the same for reporting to INCB.

ICPO and WCO captures information that may not contain substances in theform of controlled substances. This is due to the circumstances under which thisinformation is captured. However it is very important for the national database systemto provide the facility for this kind of data be uploaded. It is therefore advisable for theIndividual Seizures data capture facility to capture the information on substances as itis provided by the various law enforcement organizations and subsequently providefor a facility to modify the captured information.

Page 22: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 22/97

As a part of national database system version 4.0.0 an EDI In and EDI Outfacility would be provided to create messages in the InterForm format and tounderstand the InterForm format so as to be able to upload the same.

PreferencesThe national database system is installed at a national administration and in

most of the cases the competent authority would be capturing information for therespective country. Under such circumstances, it has been reported as a tedious task toenter this information again and again when it would probably never change for agiven installation site. As a part of upgrade the national database system wouldprovide for a preference option. Using the preference option during installation oreven after an installation, the user could set default values, which the system woulduse when it operates in its various modules. Some of the examples are the countrycode, competent authority code, duration between validity dates etc. The option forsetting preferences would be available for system administrators and would cater to allthe forms, import export module and the license module.

Page 23: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 23/97

Business Processes and Rules

Function: Maintain a Group

Event RulesMaintain aGroup

• A group needs to be identified by a unique identifier. The groupshould also have a name and a description.

• A group can contain the following;a) A substance or a set of substancesb) A preparation of a set of preparationsc) A group or a set of groups

• A group can contain any or all or even a combination of the itemsmentioned above.

• A group master will have all the functionality as available today inversion 3.3e of the national database system for any master. Thisfunctionality will include the following;a) Excelb) Printc) EDI

• A group will be used only for license request and license approval.• In case of updates, there will be no impact on the licenses

produced using this group.• A group once defined can be deleted only when not used in any of

the licenses. If a license exists for the specified group, then therespective license needs to be deleted before deleting the group.

Page 24: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 24/97

Function: Request a License

Event RulesCreate aLicense Request

• A license can be requested by establishments for the following*;a) Importsb) Exportsc) Manufactured) Stockse) Salesf) Purchaseg) Transporth) Wholesalei) Scientific and Research activitiesj) Special License for brokers

• A license can also be created for groups other than the onesmentioned above.

• The information that needs to be provided under a license requestwould be as follows;a) License Request Numberb) License Request Datec) License Valid From Dated) License Valid To Datee) Requesting Establishmentsf) Remarks/ Notes (Optional)g) License Typeh) Substance/Preparation/Group for which a license is requestedi) Requested Quantity (Optional)j) Contact Person, Telephone, Fax and e-mail address

• A license can be requested for on or more types.• A License can be requested for unlimited quantity• A License can be requested for a group, a substance or a

preparation or a combination of many or all of these.Print a LicenseRequest

• A license once requested can be printed by the requestor or thenational administration.

• A license requested when printed needs to have the followinginformation;a) License Request Numberb) License Request Datec) License Valid From Dated) License Valid To Datee) Requesting Establishment name and EAN Code (if available)f) Requesting Establishment addressg) License Typeh) Substance / Preparation / Group for the requested license and

the EAN code (if available).i) Requested Quantityj) Contact Person, Telephone, Fax and e-mail address

* License types like Imports, Exports, Manufacture, Stocks, Sales & Purchase will be predefined and cannot be deleted.

Page 25: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 25/97

Function: Authorize a License

Event RulesAuthorize aLicense

• A license can be authorized by national administrations. A Licensecan be authorized for the following;a) Importsb) Exportsc) Manufactured) Stockse) Salesf) Purchaseg) Transporth) Wholesalei) Scientific and Research activitiesj) Special License for brokers

• The information that needs to be provided under a licenseauthorization would be as follows;a) License Authorization Numberb) License Authorization Datec) License Valid From Dated) License Valid To Datee) Remarks/ Notes (Optional)f) License Typeg) Substance / Preparation / Group for which the license is

authorizedh) Authorized Quantity (Optional)i) Contact Person, Telephone, Fax and e-mail address

• A license can be authorized only for one request.• A License can be authorized for unlimited quantity• A License can be authorized for a group, a substance or a

preparation or a combination of many or all of these.Print a LicenseAuthorization

• A license once authorized can be printed.• The license can be printed by the national administration.• A license authorization when printed needs to have the following

information;a) License Request Numberb) License Authorization Numberc) License Request Dated) License Authorization Datee) License Valid From Datef) License Valid To Dateg) Establishment name and EAN Code (if available)h) Establishment addressi) License Typej) Substance / Preparation / Group for which the license is

authorizedk) Authorized Quantity

• Contact Person, Telephone, Fax and e-mail address

Page 26: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 26/97

Function: Revoke a License

Event RulesRevoke aLicense

• A license can be revoked by national administrations. A Licensecan be revoked for the following;a) Importsb) Exportsc) Manufactured) Stockse) Salesf) Purchaseg) Transporth) Wholesalei) Scientific and Research activitiesj) Special License for brokers

• The information that needs to be provided for revoking a licenseauthorization would be as follows;a) License Authorization Number

• A license can be revoked only for authorization at a time.Print a LicenseAuthorization(Revoked)

• A license once revoked can be printed.• The revoked license can be printed by the national administration.• A revoked license when printed needs to have the following

information;a) License Request Numberb) License Authorization Numberc) License Request Dated) License Authorization Datee) License Valid From Datef) License Valid To Dateg) Establishment nameh) Establishment addressi) License Typej) Substance / Preparation / Group for which the license is

authorizedk) Authorized Quantityl) Date when it was revokedm) Reason for Revoking the license

• Bar Code for Establishment EAN Code (if available)

Page 27: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 27/97

Function: Stock Movements

Event RulesRecord OpeningStocks

• The opening stocks for a substance needs to be recorded for anestablishment.

• The user needs to define these stocks once every year. If thesestocks have been defined for the previous year, then the user cancarry forward the same.

• Once these stocks are defined, the user can change these only untilany transaction for the respective substance is defined. Once atransaction for the same has been defined, the modification optionfor the same should be disabled.

• Opening stocks can be defined for substance.• Stocks for preparations need to be converted to the respective

substance quantity before being recorded in the system.Record ImportDetails

• An entry in this TAB folder will be made when substances /preparations are imported from another establishment in anothercountry. The entry would be made from the import / export screen.

• In case of the establishment management module data forsubstance imported and preparations imported will have to bestored separately.

• The data populated in the establishment management module willhave to be aggregated to the following forms (within theestablishment wise entities);a) Form A (for narcotics)b) Form A/P and Form P (for Psychotropics)c) Form D (for Precursors)

• When data is aggregated into forms (establishment wise entities) ifpreparations are imported they needs to be split into substances,prior to they being populated in the establishment wise entities.

• The user should be provided a facility to drill-down from theestablishment wise TAB folders within forms to view the databeing captured under this option.

• In case the user captures data directly into this TAB folder, thesystem will have to perform the same aggregation into forms(establishment wise) as mentioned earlier.

• In addition to this aggregation the system should make a positive(+) entry into the stocks for the respective importing establishmentfor the substance or preparation.

• The stocks in this case will go up for the respective establishmentand will also have to be reflected in the closing stocks of forms(applicable for Form C and Form P only).

Record ExportDetails

• An entry in this TAB folder will be made when substances /preparations are exported from another establishment in anothercountry. The entry would be made from the import / export screen.

• In case of the establishment management module, data forsubstance exported and preparations exported will have to bestored separately.

Page 28: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 28/97

Event Rules• The data populated in the establishment management module will

have to be aggregated to the following forms (within theestablishment wise entities);d) Form A (for narcotics)e) Form A/P and Form P (for Psychotropics)f) Form D (for Precursors)

• When data is aggregated into forms (establishment wise entities) ifpreparations are exported they needs to be split into substances,prior to they being populated in the establishment wise entities.

• The user should be provided a facility to drill-down from theestablishment wise TAB folders within forms to view the databeing captured under this option.

• In case the user captures data directly into this TAB folder, thesystem will have to perform the same aggregation into forms(establishment wise) as mentioned earlier.

• In addition to this aggregation the system should make a negative(-) entry into the stocks for the respective exporting establishmentfor the substance or preparation.

• The stocks in this case will reduce for the respective establishmentand will also have to be reflected in the closing stocks of forms(applicable for Form C and Form P only).

RecordDomestic Trade(Purchase)Details

• The domestic purchase TAB folder will be used to capture thedomestic distribution details. These details will be similar to theestablishment wise import details with one difference. i.e. Theimporting country and the exporting country would be same.

• This type of transaction can only be captured through theestablishment management module.

• The entries made into this TAB folder will affect the stocks of theestablishment involved in the domestic distribution process. Thestocks for the purchasing establishment will have to be increasedand the stocks of the selling establishment will have to bedecreased. If the establishment is a manufacturer or a wholesaler.

• If the establishment is of type retailer, then only the stocks of theselling establishment needs to be reduced. In such a scenario, anadditional entry will have to be passed to the establishment wiseconsumed TAB folder if the substance is of type narcotics. Thisentry will be made automatically by the system.

• The stocks at the country level should remain the same if theestablishments participating in domestic distribution process aremanufacturers and wholesalers.

RecordDomestic Trade(Sales) Details

• The domestic sales TAB folder will be used to capture the domesticdistribution details. These details will be similar to theestablishment wise export details with one difference. i.e. Theimporting country and the exporting country would be same.

• This type of transaction can only be captured through theestablishment management module.

• The entries made into this TAB folder will affect the stocks of the

Page 29: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 29/97

Event Rulesestablishment involved in the domestic distribution process. Thestocks for the purchasing establishment will have to be increasedand the stocks of the selling establishment will have to bedecreased. If the establishment is a manufacturer or a wholesaler.

• If the establishment is of type retailer, then only the stocks of theselling establishment needs to be reduced. In such a scenario, anadditional entry will have to be passed to the establishment wiseconsumed TAB folder if the substance is of type narcotics. Thisentry will be made automatically by the system.

• The stocks at the country level should remain the same if theestablishments participating in domestic distribution process aremanufacturers and wholesalers.

Record LossesDetails

• Losses are applicable for Narcotics, Psychotropics andPrecursors. As far as reporting to INCB is concerned, it is onlybeing reported in Form C (Narcotics).

• In cases of loses being captured in this TAB folder, it needs to beaggregated (for narcotics) into losses for establishment. If thelosses are in terms of preparations, they needs to be converted tosubstances and for each of the narcotic substance within thepreparation, it needs to be aggregated into the losses forestablishments.

• In case of Psychotropics and precursors losses will be capturedonly in the establishment management module and will have noaggregation into forms.

• In case of Narcotic, Psychotropic and Precursors, and transactioncapture for losses would also result in a negative (-) entry into thestocks.

• Establishments that can use this option need to be of typemanufacturers. Since the wholesalers and retailer cannotmanufacture, wholesalers and retailers cannot exercise thisoption.

RecordDestroyedDetails

• Data captured in this TAB folder can be for two reasons;a) Destroyed in case of substances seized.b) Destroyed due to other conditions like contamination,

hazardous reasons, expiry date etc.• If narcotic drugs are being destroyed against seizures, then they

should be aggregated to seizure details within Form C. Ifpreparations are destroyed against seizures containing narcoticdrugs, then for each of the narcotic drugs within the preparationaggregation needs to take place.

• If the substances destroyed are psychotropic substance orprecursors or preparations containing psychotropic substances orprecursors then these would remain at the establishmentmanagement module. These will not be aggregated into any forms.As for psychotropic and precursors, no destroyed informationagainst seizures is to be reported in forms prescribed by INCB.

• However irrespective of the type of substance, the stocks at the

Page 30: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 30/97

Event Rulescountry level will have to be reduced by the quantity destroyed.There will have to be a negative (-) entry made in this case forcountry stocks.

• If stocks are destroyed as part of conditions other than seizuresthen there needs to be a negative (-) entry made in stocks for eachof the establishment reporting the destroyed quantity for therespective substance.

• These entries will be aggregated to the closing stocks, in case ofnarcotic drugs and psychotropic substances. In case of precursorsthese would not be aggregated to the form level.

• In case of preparation containing narcotic drugs and psychotropicsubstances separate entries needs to be made for each of thecontained substances in the stocks of the establishment whichwould then be aggregated to the forms as mentioned above.

• Establishments that can use this option need to be of typemanufacturers and wholesalers. Since the retailer cannot havestocks, substances or preparations destroyed by retailers will notbe captured using this option.

RecordConsumedDetails

• Consumed details when recorded in this TAB folder will have to beaggregated to forms in case of narcotic drugs. If a narcotic drugor a preparation containing narcotic drug is reported asconsumed then it is aggregated to consumed in Form C,establishment wise consumed details entity.

• In case of Psychotropic substance or precursors consumed wouldbe captured only into the establishment management module andwill not be aggregated to any of the forms.

• If any of the substance or preparation containing either narcoticdrug, psychotropic substance or precursors is reported asconsumed then for each of the consumption entries, one negative (-) entry will have to be made into stocks of that establishment forthe respective substance.

RecordProcured /WithdrawnDetails

• Procured or Withdrawn details when recorded in this TAB folderwill have to be aggregated to forms in case of narcotic drugs. If anarcotic drug or a preparation containing narcotic drug isreported as procured for or withdrawn from stocks for specialpurposes, then it is aggregated to procured/ withdrawn in Form C,establishment wise procured/ withdrawn details entity.

• In case of Psychotropic substance or precursors procured/withdrawn would be captured only into the establishmentmanagement module and will not be aggregated to any of theforms.

• If any of the substance or preparation containing either narcoticdrug, psychotropic substance or precursors is reported asprocured/ withdrawn then for each of the procured/ withdrawnentries, one negative (-) entry will have to be made into stocks ofthat establishment for the respective substance in case ofwithdrawn. In case of procured a positive (+) needs to be made for

Page 31: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 31/97

Event Rulesthat establishment for the respective substance.

• Establishments that can use this option need to be of typemanufacturers and wholesalers. Since the retailer cannot havestocks, retailers cannot exercise this option.

Record Used forSchedule IIIpreparationdetails

• Details of narcotic drugs used for manufacture of schedule IIIpreparation will be captured using this option for establishments.This option will not be available for psychotropic substances andprecursors.

• When data is recorded in this TAB folder, the same needs to beaggregated in Form C (establishment Wise) details.

• Since only a manufacturer can carry out manufacturing process,establishments of type manufacture can exercise this option. Thisoption will not be available for establishments of type wholesalersand retailers.

RecordManufacturedDetails

• Details of the manufacturing process will be captured in case ofnarcotic drugs, psychotropic substances and precursors.

• In case of narcotic drug and psychotropic substances the samewould be aggregated into forms. In case of precursors the samewould not be aggregated into forms as form D does not reportprecursors used or obtained from the manufacturing process.

• In case of narcotic drugs used in manufacturing process orobtained as a result of the manufacturing process, the same wouldbe aggregated in the Form C (establishment wise manufacturingdetails). If a preparation is used or obtained as a result of themanufacturing process containing narcotic drugs, the same willhave be aggregated using the individual drugs within thepreparation.

• In case of precursor substances used in manufacturing process orobtained as a result of the manufacturing process, the same wouldbe aggregated in the Form P (establishment wise manufacturingdetails). If a preparation is used or obtained as a result of themanufacturing process containing psychotropic substances, thesame will have be aggregated using the individual drugs within thepreparation.

• If the manufacturing process uses a narcotic drug to obtain apsychotropic process or vice a versa, the system generatedsubstance will be used for counter entries. Tracing the substanceback to the originator will not be possible this case.For e.g. If a narcotic drug is used with a precursor to obtain apsychotropic substance, the following entries will be made;

In case of establishment wise manufactured details (Form C)of narcotic drugs, used substance will indicate the narcoticdrug used with its used quantity and the obtained substancewill indicate a system generated narcotic drug obtained withits quantity as 0.In case of establishment wise manufactured details (Form P) ofpsychotropic substances, used substance will indicate a system

Page 32: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 32/97

Event Rulesgenerated substance with quantity as 0 and the obtainedsubstance will be a psychotropic substance with its obtainedquantity.The precursor substance will not be shown in any of the formsas no forms for precursors have the manufacturing.

• In case of data being entered in this TAB folder, the usersubstances will have a negative (-) entry in the stocks and theobtained substances will have a positive (+) entry in the stocks.These entries will be applicable for narcotic drugs, psychotropicsubstances or precursors.

• Since only a manufacturer can carry out manufacturing process,establishments of type manufacture can exercise this option. Thisoption will not be available for establishments of type wholesalersand retailers.

Record Used forManufacture ofNonPsychotropicDetails

• Transaction captured, as a part of this TAB folder will beaggregated in Form P (establishment wise details) for substancesused in the manufacture of non-psychotropic details.

• Transactions to be captured for this TAB folder will be availableonly for psychotropic substances.

• If preparations are used in the manufacturing process, containingpsychotropic substances, then each of the psychotropic substancesavailable in these preparations will have to be aggregatedseparately in Form P, establishment wise details. In case thepreparation contains also a narcotic drug or a precursor,information regarding these substances will not be aggregated.

• Since only a manufacturer can carry out the process ofmanufacture, establishments of type manufacture can exercise thisoption. This option will not be available for establishments of typewholesalers and retailers.

• In case of data being entered in this TAB folder, there will be anegative (-) entry in the stocks These entries will be applicable forpsychotropic substances.

Record Used forManufacture ofExemptedPreparationsDetails

• Transaction captured as a part of this TAB folder will beaggregated in Form P (establishment wise details) for substancesused in manufacture of exempted preparations.

• Transactions to be captured for this TAB folder will be availableonly for psychotropic substances.

• If preparations are used in the manufacturing process, containingpsychotropic substances, then each of the psychotropic substancesavailable in these preparations will have to be aggregatedseparately in Form P, establishment wise details. In case thepreparation contains also a narcotic drug or a precursor,information regarding these substances will not be aggregated.

• Since only a manufacturer can carry out the process ofmanufacture, establishments of type manufacture can exercise thisoption. This option will not be available for establishments of typewholesalers and retailers.

Page 33: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 33/97

Event Rules• In case of data being entered in this TAB folder, there will be a

negative (-) entry in the stocks These entries will be applicable forpsychotropic substances.

RecordInventoryAdjustmentDetails

• In case of stock differences found due to certain reasons, thenational administration can record the differences in stocksdeclared and found as adjustment.

• Inventory adjustments can be performed for all types of substance.It can also be performed for preparations.

• Inventory adjustment would indicate the following;a) Establishment for which the stock is being adjustedb) Substance / preparation being adjustedc) Adjustment Dated) Difference quantity

• The difference quantity being entered would be used to adjust thestocks. There will be no aggregation of the same in case of FormD. In case of narcotic drugs and psychotropic substances, thesame would be aggregated in Form C and Form P respectively.

• When an Inventory adjustment is done, a corresponding entry willbe made into the establishment wise stocks entity.

RecordInspectionResults Details

• Inspection data can be recorded for any type of substance. Theinspection information would involve the following information;a) Inspection Dateb) Inspected Establishmentc) Inspection Authority Named) Inspecting Authority Addresse) Person Inspected.f) Inspected Substances / Preparationg) Declared Quantityh) Inspected Quantityi) Actual Quantityj) Notes/ Remarks

• Recording Inspection data will have no business validationsassociated to it. There will be no aggregation of data beingcaptured for inspections.

Print InspectionReports

• The inspection details captured can be printed for the currentrecord being viewed.

• Inspection print report should contain the following details;a) Inspection Dateb) Inspected Establishmentc) Inspection Authority Named) Inspecting Authority Addresse) Person Inspected.f) Inspected Substances / Preparationg) Declared Quantityh) Inspected Quantityi) Actual Quantityj) Notes/ Remarks

Page 34: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 34/97

Event RulesCreate StocksLedger

• A stock ledger can be generated at any point of time.• The stock ledger can be generated for a given establishment and a

given substance.• The stock ledger will use the opening stocks entered by the

national administration for the respective establishment forcalculations.

• If no stock has entered, then system will assume 0 as the openingstock for calculations.

• The stock ledger will take into consideration all the transactionsas stated in the establishment management module (“RecordTransactions by establishment / substance”)

• The stock ledger will display all transactions for the specifiedsubstance by the specified establishment. It will then calculate theclosing balance of a substance for an establishment, if theestablishment is of type Manufacturer or Wholesaler. If theestablishment is not of type manufacturer or a wholesaler then thesystem would indicate the closing balance as 0.

• The system will also using the transactions captured for all theestablishments calculate the closing balance of the specifiedsubstance at the domestic level.

Print StockLedger

• The stock ledger can be printed at any point in time.• The stock ledger will indicate the opening stock for a given

substance and a given establishment.• The stock ledger would contain all the headings for different types

of transactions that are provided as part of the establishmentmanagement module.

• The stock ledger at the end will also indicate the closing stocks fora given substance and a given establishment.

• To print stock ledger user will have to specify following criteria;a) Establishment Codeb) Substance/ Preparation Codec) Year (From - To)

• The stock ledger will be printed for the specified establishment andthe specified substance. If no establishment code or substance/preparation code is specified, the ledger should be generated forall establishments and substances/ preparations. If the year fieldis not specified the stock ledger would print the ledger for thecurrent year.

View ClosingStocks

• The closing stocks for a substance for an establishment can beviewed, if the establishment is of type manufacturer or wholesaler.

• If the establishment were of type other than manufacturer orwholesaler, the closing stocks for the same would indicate as 0.

• The closing stock option would show the closing stocks for thespecified substance at the domestic level.

• In case of import export authorizations issued, there will be nochange on the closing stocks. Only an endorsement would indicatea change in closing stocks for a specified substance.

Page 35: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 35/97

Function: Multilingual Dictionary

Event RulesMaintaininformation forthe MultilingualDictionary

• The maintenance of the additional information on the multilingualdictionary would be a part of the substance master within thesubstance module.

• The additional information that needs to be captured for themultilingual dictionary would encompass of the following;a) Molecular Weightb) Chemical Formulac) CND Approved Namesd) Trade Namese) Chemical Composition Diagram

• The data being captured needs to have the same features as anyother fields within the substance master, except for the chemicalcomposition diagram. This diagram will not be a part of the EDImessage. Similarly this will also not be a part of Excel outputproduced by the system.

WEB Query fora substancefrom theMultilingualDictionary

• This option needs to provide a facility to query information on asubstance within the multilingual dictionary on the internet.

• This option would comprise of two WEB pages. One to specify thecriteria and the second to display the substance information basedon the criteria.

• The first html page would provide for specifying the criteria. Thecriteria would consist of the following;a) Substance Nameb) CND approved Namec) Trade Name

• There needs to be a provision of specifying more than onecombinations of the above mentioned criteria

• On specifying the criteria, the system should display another htmlpage containing information for the substance based on thecriteria. The result html page should contain information that isavailable in the multilingual dictionary for the specified substance.

Printing of aSubstance fromthe MultilingualDictionary

• This option would print the current substance that is being queriedon the screen.

• This option would print MLD information that is available in themultilingual dictionary for the specified substance.

• This output will be produced using PowerBuilderPrinting theMultilingualDictionary

• The multilingual dictionary would be printed using A4 paperformat using PowerBuilder.

• The output of multilingual dictionary would be printed for allsubstances from the substance master for narcotic drugs andpsychotropic substances.

• Precursors will not be printed in the multilingual dictionary.• The multilingual dictionary would print all information as per the

format specified in the multilingual dictionary printed as onMarch 1993 using PowerBuilder.

Page 36: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 36/97

Function: Annual Reports Questionnaire

Event RulesMaintainquestion for theAnnual ReportsQuestionnaire

• Annual Reports Questionnaire as it is available in three parts,Part I, Part II and part III has questions of different nature thatchange from time to time. As a measure this option needs toprovide a facility to maintain the questions that are printed in thequestionnaire

• The questions for all three parts of the annual reportsquestionnaire would be maintained at a central location andprovided a facility to add, modify and delete as per the changes tothe ARQ.

• This option also needs to provide a facility to print a list of allquestions that are currently being stored in the database.

• This option also needs to provide a facility for exporting thequestions using an EDI option.

• Each question that is maintained needs to have a response type.• The response types will be pre-designed and provided with the

system. The user will have to select from the various responsetypes available in the system.

• The user can choose from the following response types;1. Date2. Text3. Numeric4. Boolean (Yes/ No)5. Tabular

• In case of a tabular response the user will have the facility todefine columns of the following type;1. Numeric2. Date3. Text4. Boolean (Yes/ No)

• Column Headers can also be defined as to how they will appear inthe output.

Data Capture ofAnswers for theAnnual ReportsQuestionnaire

• This option would provide a facility for the user to provideanswers for the questions in the annual report questionnaire.

• There can be multiple answers for a given question.• This option should allow the user to answer questions as and when

they want. No answer should be mandatory and the user should beable to move a specified question by specifying the questionnumber.

AuthorizeAnswers fromthe AnnualReportsQuestionnaire

• There can be multiple answers to a question coming from differentorganizations.

• These answers would be based upon the knowledge each of theorganization has on the questions.

• This process will allow the competent authority to decide thecorrect answer by allowing a facility to authorize the same.

• Once an answer has been authorized it will appear on the ARQ

Page 37: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 37/97

Event Rulesoutput.

• No answer unless and until authorized will appear in the ARQoutput or in the EDI file.

Printing theAnnual ReportsQuestionnaire

• The annual report questionnaire will be printed for the specifiedcountry and year.

• The print option should only print authorized answers for thequestionnaire.

Function: Interface to Interpol

Event RulesGenerate EDIMessage in theInter Formformat

• This process needs to generate an EDI message based upon theInter Form format.

• This process will use the available data within individual seizuredatabase and output the same in the Inter form Format.

• In case of data not available the EDI Out process does not outputthe respective line item. This would mean ignoring the entire tagfor that data element.

Read EDIMessage in theInter Formformat

• This process would read the Inter Form message that is beingprovided by ICPO and WCO.

• In case of data elements not belonging to NDS structure, the sameshould be ignored.

• In case of substance used in the Inter Form data file received arenot within the NDS database, this process will put the respectiveinformation in the comments filed and use a system generatedsubstance to capture the information.

• In such a scenario the user would have to change the requiredinformation on the same.

• This process when uploads the data received from Inter Formwould also flag the ICPO flag to “Yes” so as to enable users tolater on query only for ICPO data.

Function: Preferences

Event RulesData Capturefor PreferencesWindow

• This process will allow users to specify preferences to be used forevery form.

• Using this window the user can set preferences for Forms,Individual Seizures, Import / Export Documents.

• This process needs to be treated as any other master within thenational database system version 4.0.0 with facilities like EDI andPrint.

• The Excel facility will not be provided for this option.

Page 38: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 38/97

Functions and Processes

Diagram 1:

CompetentAuthority

2

1

Record OpeningStocks for a

Substance and foran Establishment

Opening Stocks1

Update Opening Stocks(Substance / Preparation)

2

Record Importtransaction fromanother companyin another country

Record Exporttransaction to

another companyin another country

3

Establishment

1

Establishment wise Transactions

Imports Exports

2 Establishment wiseSubstance wise Stocks

Update Stocks

Add To Stocks(substances / preparations)

Subtract from Stocks(substances / preparations)

Establishment ImportDetails (Narcotics)3

Establishment ImportDetails (Precursors)5

Establishment ImportDetails (Psychotropic)4

Establishment ExportDetails (Narcotics)6

Establishment ExportDetails (Precursors)8

Establishment ExportDetails (Psychotropic)7

substances only

substances only

substances only

substances only

substances only

substances only

Page 39: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 39/97

Process: Record Opening Stocks for a Substance and for an Establishment

Process Description:The opening stock process is applicable for every establishment and for everysubstance or preparations that is used by the respective establishment in some form orother. The opening stock process will allow the user to define the opening stock forevery substance and preparation within an establishment. This process also will allowthe user to carry forward the closing stocks of previous year (if available). The stocksdefined in this process are used for generating the stock ledger.

Process: Record Import Transactions from establishment in another country.

Process Description:The process of recording import transactions is available in version 3.3e throughvarious forms and the import export module. In case there is an import transaction tobe created one can create an Import Authorization Request. In case of multipleshipments within the same authorization, one can create import certificate request. Incase of shipment being received from across the border, the process of endorsementtakes place. In case of endorsement, the system generates entries for establishmentwise transactions for various forms. Entries for various forms are generated based onthe type of substance(s) being endorsed. If the Substance is a Narcotic Drug entries aremade for Import Details under Form A. If the Substance is a Psychotropic Substanceentries will be made for Import Details under Form A/P and Form P. If the Substanceis a Precursor entries will be made for Import Details under Form D. Entries can alsobe made directly in the establishment wise details of the respective forms dependingon the type of substance in use. Using the process mentioned above entries forestablishment wise import details could be made from a single screen without going toany of the forms. This process will allow user to capture import details forpreparations / substances and aggregate the same.

Process: Record Export Transactions from establishment in another country.

Process Description:The process of recording export transactions is available in version 3.3e throughvarious forms and the import export module. In case there is an export transaction tobe created one can create an Export Authorization Request. Only in case of theshipment being received from across the border, the process of endorsement takesplace. In case of endorsement, the system generates entries for establishment wisetransactions for various forms. The entries for various forms are generated based onthe type of substance(s) being endorsed. If the Substance is a Narcotic Drug entries aremade for Import Details under Form A. If the Substance is a Psychotropic Substanceentries will be made for Import Details under Form A/P and Form P. If the Substanceused is a Precursors entries will be made for Import Details under Form D. Entries canalso be made directly in the establishment wise details of the respective formsdepending on the type of substance exported. Using the above mentioned processentries for establishment wise import details could be made from a single screenwithout going to any of the forms. This process will allow user to capture exportdetails for preparations / substances and aggregate the same.

Page 40: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 40/97

Diagram 2:

4

Record domesticDistribution (Sales)

to anothercompany

5

Record domesticDistribution

(Purchase) fromanother company

Establishment

1

CompetentAuthority

2

Establishment wise Transactions

2 Establishment wiseSubstance wise Stocks

Domestic Purchases Domestic Sales

Add to Stocks for Manufacturer/ Wholesaler(Substance / Preparations)

Subtract from Stocks for Manufacturer/ Wholesaler(Substance / Preparations)

Add to Consumed in case of Retailer(Substance / Preparations)

Establishment wiseConsumed Details9

Add transaction in case of retailerand in case of Narcotic Drug

(Substance)

6

Record transactionfor Loses inprocess of

Manufacture

7

Record transactionfor Drugs/

SubstancesDestroyed

Losses

Destroyed

Subtract from Stocks

Subtract from Stocks

8

Record Transactionfor Drugs/SubstanceConsumed

Consumed

Subtract from Stocks

Add to Consumed in case of Narcotic Drug(Substance)

19 Establishment wiseDomestic Purchase Details 20 Establishment wise

Domestic Sales DetailsFor Domestic Purchases

(Substance / Preparations)For Domestic Sales

(Substance / Preparations)

Page 41: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 41/97

Process: Records Domestic Distribution (Purchases) from another establishment.

Process Description:This process is a new process being added to the national database system version4.0.0. Using this process the national administration can record information ondomestic purchases made by one establishment from another establishment. Thepurpose of this process is to allow tracking the stock movements within the country.In case of stocks being moved from one manufacturer to another, the establishmentwise stocks will deplete for the selling establishment and the stocks level will increasefor the purchasing establishment. The overall stock level for the country wouldhowever remain the same. The same would be applicable if the stocks are beingmoved from a manufacturer to a wholesaler, if the wholesaler is to keep the stocks. Incase of the wholesaler planning to use these stocks for use in schedule III preparationsthen the respective entries can also be made. In case of stocks moving from amanufacturer/wholesaler to a retailer the stocks for the manufacturer will deplete andrespectively for the retailer the stocks will be consumed. The process will allow thenational administrations to track these movements. The process is only meant tosupport the stock movements within a given country. These movements will not beaggregated to the any other level and will therefore not appear in any of the forms.The movements will however make the respective entries for consumes, used forschedule III and stocks in the respective areas so as to aggregate these into variousforms based on the substances used.

Process: Records transaction for losses in process of manufacture.

Process Description:The process of recording transactions for losses in process of manufacture is a newfeature of national database system version 4.0.0. This feature was not available incase of version 3.3e. Using this feature national administration can record transactionsfor losses in the process of manufacture. This transaction recording facility will onlybe available for narcotic drugs. The transactions recorded using this option will beaggregated in Form C as Form C has a new column for Losses being added from theSeventh Edition of the form printed in January 2000. This process is not linkeddirectly to the manufacture process as the manufacture and losses details are recordedseparately. One needs to maintain the two entries separately. In case of the nationaladministration wants to link these process then they needs to specify the same in thecomments while capturing losses as to which manufacturing process do these lossesbelong to.

Process: Records transaction for stocks destroyed.

Process Description:The process of recording transactions for substances destroyed is a new feature ofnational database system version 4.0.0. This feature was not available in case ofversion 3.3e. Using this feature national administration can record transactions forsubstances destroyed. Substances might be destroyed for various reasons like agingstocks, contamination, accidents etc. This process allows the national administrationto capture these details for domestic purposes only. The information captured underthis process is not aggregated under any form. This process however does deplete the

Page 42: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 42/97

stocks for an establishment and also the overall stocks of the respective substance forthe country respectively.

Process: Records transaction for stocks consumed.

Process Description:The process for recording transactions for stocks consumed is available in nationaldatabase system version 3.3e. This process allows the national administration tocapture information for substance wise consumption details for narcotic drugs andPsychotropic substances. In case of national database system version 4.0.0 this processwill continue to capture information on narcotic drugs and psychotropic substancesconsumed. It will also allow for capture of information for Precursors consumed. Incase of narcotic drugs and psychotropic substances, this information will beaggregated in Form C and Form P respectively. However since Form D does not callfor this information on Precursors, the same will be maintained at the domestic level.The national administration using the establishment management module can captureinformation for stocks consumed to update the stocks of an establishment and in turnalso for the country.

Process: Records Domestic Distribution (Sales) to another establishment.

Process Description:This process is a new process being added to the national database system version4.0.0. Using this process the national administration can record information ondomestic sales made by one establishment to another establishment. The purpose ofthis process is to allow tracking the stock movements within the country. In case ofstocks being moved from one manufacturer to another, the establishment wise stockswill deplete for the selling establishment and the stocks level will increase for thepurchasing establishment. The overall stock level for the country would howeverremain the same. The same would be applicable if the stocks are being moved from amanufacturer to a wholesaler, if the wholesaler is to keep the stocks. In case of thewholesaler planning to use these stocks for use in schedule III preparations then therespective entries can also be made. In case of stocks moving from amanufacturer/wholesaler to a retailer the stocks for the manufacturer will deplete andrespectively for the retailer the stocks will be consumed. The process will allow thenational administrations to track these movements. The process is only meant tosupport the stock movements within a given country. These movements will not beaggregated to the any other level and will therefore not appear in any of the forms.The movements will however make the respective entries for consumes, used forschedule III and stocks in the respective areas so as to aggregate these into variousforms based on the substances used.

Page 43: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 43/97

Diagram 3:

Establishment

1

CompetentAuthority

2

Establishment wise Transactions

9

Record transactionfor Drugs Procured/

Withdrawn forspecial purposes

10

Record transactionfor Drugs Used for

Schedule IIIManufacture

Record transactionfor Drugs Used for

Manufacture

11

2 Establishment wiseSubstance wise Stocks

Establishment wiseProcured Details11

Establishment wiseUsed for Schedule III

Details12

Establishment wiseUsed Details13

Establishment wiseObtained Details14

Add to Stocks in case of ProcuredSubtract from Stocks in case of Withdrawn

(Substance / Preparations)

Subtract from Stocks(Substance / Preparations) Add to Stocks for Manufactured

Subtract from Stocks for Used(Substance / Preparations)

for Narcotic Drugs(Substances)for Narcotic Drugs

(Substances)

Used for Schedule III Preparations

Manufacture of Narcotic Drugs/Psychotropic SubstancesProcured / Withdrawn for Special Purposes

for Narcotic Drugs(Substances)

Establishment wiseManufactured Details10 for Psychotropic substances

(Substances)

for Narcotic Drugs(Substances)

Page 44: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 44/97

Process: Records transaction for Stocks Procured/ Withdrawn for special purposes.

Process Description:The process of capturing transactions in case of procured / withdrawn for specialstocks is available in national database system version 3.3e. The purpose of thisprocess is to allow the national administration to capture information when procuredfor medical and scientific purposes or are withdrawn for use by the government. Insuch a scenario the respective national administration would report the movement ofthese stocks to the national administration and the national administration wouldcapture the same to be aggregated with in the forms. Using this process in theestablishment management module, the national administration can capture the sameinformation at a central location to enable them to track the stock movement moreappropriately. The information capture in this process would get aggregated in formsand would also affect the stocks based on procured or withdrawn.

Process: Records transaction for stocks used in schedule III Preparations.

Process Description:The process of capturing transactions in case of stocks used in schedule III preparationis available in national database system version 3.3e. The purpose of this process is toallow the national administration to capture information when used for manufacture ofschedule III preparations. In such a scenario, the respective establishment wouldreport the used for schedule III preparation and in turn the national administrationwould capture the same for being aggregated in the respective forms. With respect tothe stock movements, if a drug is used for schedule III preparation then it isconsidered as consumed. No entry is made or reported under consumed as it isreported under used for schedule III preparations. However in such a case the stock ofthe respective establishment would deplete.

Process: Records transaction for stocks used for manufacture.

Process Description:The process of capturing transactions for substances used in manufacture is availablein national database system version 3.3e. The purpose of this process is to allow thenational administration to capture information on substances / preparations used formanufacture in case of Psychotropics. This information is aggregated in form P. Insuch a scenario, the respective establishment would report the use of drugs formanufacture and in turn the national administration would capture the same for beingaggregated in form P. With respect to the stock movements, if a drug is used formanufacture then it is considered as consumed. If the substance manufactured is anon-psychotropic substance or a preparation under article 3, paras. 2 and 3c then thereis a separate column to report the same. If the substance manufacture is anything otherthan the one mentioned the same is not reported. The use of substances wouldhowever deplete the stocks and the same would be captured under this process of theestablishment management module.

Page 45: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 45/97

Diagram 4:

Establishment

1

CompetentAuthority

2

Establishment wise Transactions

12

Record Transactionfor Substance usedin manufacture ofNON Psychotropic

Substances

Record Transactionfor Substance usedin manufacture of

ExemptedPreparations

13 14

Record Transactionfor Stock

Adjustments for anestablishment

15

Record InspectionResults for anEstablishment

Inspection ResultsManufacture of NON Psychotropic substances

Manufacture ofExempted Preparations Stocks Adjustment

2 Establishment wiseSubstance wise Stocks

Subtract from Stocks(Substances / Preparations)

Subtract from Stocks(Substances / Preparations)

Add to Stock if value is +veSubtract from Stocks if value is -ve

(Substances / Preparations)

Establishment wiseInspection Details19Establishment wise NON

Psychotropic MFG. details15 Establishment wiseExempted Prep. Details16 Establishment wise Stock

Adjustment Details18

for Psychotropic Substance(Substances)

Record Inspection Data(Substances / Preparations)

for Psychotropic Substance(Substances)

for All substances(Substances / Preparations)

Page 46: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 46/97

Process: Records transaction for stocks used in manufacture of non-psychotropicsubstances

Process Description:The process of capturing transactions for stocks used in manufacture of non-psychotropic substances is available in national database system version 3.3e. Usingthis process the national administration can record information on stocks used inmanufacture of non-psychotropic substances. The information recorded using thisprocess will be aggregated under form P. Using NDS version 4.0.0, the nationaladministration can record the same information that will get aggregated under form Pand also update the stocks for establishment wise, substance wise, used formanufacture. The stocks in this case will be depleted from the establishment level andthe country level.

Process: Records transaction for Stocks used in manufacture of exemptedpreparations

Process Description:The process of capturing transactions for substances used in manufacture of exemptedpreparations under article 3 para 2 and 3c is available in national database systemversion 3.3e. Using this process the national administration can record information onstocks used in manufacture of exempted preparations. The information recorded usingthis process will be aggregated under form P. The stocks in this case will be depletedfrom the establishment level and the country level.

Process: Records transaction for Inventory adjustments for an establishment.

Process Description:This is a new feature to be provided along with NDS version 4.0.0. The purpose ofthis process is to allow the national administration to adjust the inventory if there is adiscrepancy found during the year. Any entry made using this process will not beaggregated to the forms. Inventory adjustment if required will have to be performed bythe national administration for an establishment and for a substance or preparation.The inventory adjustments will affect the stocks for an establishment and for therespective substance and also the stocks for the country. Stock adjustments can beperformed any number of times within a given calendar year. Inventory adjustmentcan be done for add or subtracting the stocks from the declared stocks.

Process: Records Inspection results for an establishment

Process Description:Inspections data capture is the new functionality being added to establishmentmanagement module under national database system version 4.0.0. When officials at anational administrations performs an inspection, they can capture the informationgathered during their inspection using this process. The information captured usingthe inspection data capture process will not be aggregated in any of the forms and isonly for information of the national administration.

Page 47: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 47/97

Diagram 5:

16

GenerateStockLedger

Opening Stocks1

2 Establishment wiseSubstance wise Stocks

Establishment ImportDetails (Narcotics)3

Establishment ImportDetails (Precursors)5

Establishment ImportDetails (Psychotropic)4

Establishment ExportDetails (Narcotics)6

Establishment ExportDetails (Precursors)8

Establishment ExportDetails (Psychotropic)7

Establishment wiseConsumed Details9

Establishment wiseProcured Details11

Establishment wise Usedfor Schedule III Details12

Establishment wise UsedDetails13

Establishment wiseObtained Details14

Establishment wiseManufactured Details10

Establishment wise NONPsychotropic MFG. details15

Establishment wiseExempted Prep. Details16

Establishment wise StockAdjustment Details18

CompetentAuthority

2

Stocks(Substances / Preparations)

Stocks(Substances / Preparations)

Transactions(Substances / Preparations)

Transactions(Substances / Preparations)

Transactions

Transactions(Substances / Preparations)

Transactions(Substances / Preparations)

Transactions(Substances / Preparations)

Adjustment Details(Substances / Preparations)

Transactions(Substances)

Transactions(Substances)

Transactions(Substances)

Transactions(Substances)

Transactions(Substances)

Transactions(Substances)

Transactions(Substances / Preparations)

20 Establishment wiseDomestic Sales Details

Transactions(Substances)

Transactions(Substances)

Sales Details(Substances / Preparations)

Page 48: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 48/97

Process: Generate Stock Ledger

Process Description:The generate stock ledger process is provided in national database system version4.0.0. The generate stock ledger process is used to prepare a stock ledger for anestablishment for a substance / preparation. The stock ledger would print the openingstocks and all the transactions made by that establishment with respect to the stocks.At the end of the ledger the stock ledger would indicate the closing balance for thesubstance / preparation for the respective establishment and also for the country. Thisprocess can be used by the national administration at any point in time to find out thestocks for a substance or preparation at the domestic level or also for the stocks of asubstance at the country level. If the establishment happens to be a manufacturer or awholesaler, this option would apply. In case of a retailer, this option would not apply.

The following are the parameters for the stock ledger report;Start Date When left blank it will take the first Stock record as opening

stocks.End Date When left blank it will assume the system date.Substance /Preparation Code

When left blank will report for all substances/ preparations.

EstablishmentCode

When left blank will report for all establishments.

The grouping for the stock ledger is as follows;1. Establishment Wise2. Substance Wise

The Stock Ledger will be internally sorted by date.

Page 49: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 49/97

Diagram 6:

Request a License

17

18

Approve a License

19

Revoke a License

License Request24

License Approval25

Group Master21 Establishment Master22Competent Authority

Master23

CompetentAuthority

2

Establishment

1

Page 50: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 50/97

Process: Request a License

Process Description:An establishment can request for a license. A license can be for a group of substancesor preparations. The period of license needs to be specified by the establishment. Thelicense may be for a specified quantity or can be for unlimited quantity. The licenserequest can be electronically made using the WEB module for license request. Once alicense is requested, it for the competent authority to approve the same. A license canbe requested for multiple reasons like Imports, Exports, Manufacture, Stocks, Sales,Purchase, Transport, Wholesale, Scientific and Research activities and SpecialLicense for brokers. The system would validate against import and export licenseswhen authorizing the same in import export module. In cases of other licenses there isno cross validation performed.

Process: Approve a License

Process Description:The competent authority can approve a requested license. The authorization can beperformed only in the client server environment. In case of an authorization, thecompetent authority can decide to authorize the entire license quantity or a part of thelicense quantity. If a license for import / export has been authorization/ approved, thesame would take effect in validations for import / export authorizations.

Process: Revoke a License

Process Description:The competent authority for any reason, if decides to revoke a license can do so. Thislicense when revoked needs to have a reason. When a license is revoked for import /export licenses, the same would take effect in validations for import / exportauthorizations. When a license is revokes, a flag would be set in the licenseauthorization entities.

Page 51: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 51/97

Diagram 7:

Capture Answersfor ARQ

23

Authorize Answersfor ARQ

24

Print ARQ

26

20

Maintain questionsfor ARQ

UNDCP /INCB

3

21

Generate EDI forARQ Questions

CompetentAuthority

2

Generate EDI filein case of changes

in questionsMaintain Questions

ARQ Questions atUNDCP26 EDI File for ARQ

Questions27

ARQ Questions atNational Administration28

Update Questions

ARQ Questions

Upload ARQ EDIFiles

22

READ EDI File

Update NDS

ARQ Answers atNational Administration29

ARQ Questions

ARQ Answers

ARQ Answers ARQ Answers

Generate EDImessage for ARQ

Answers

25

ARQ Answers

30 EDI File for ARQAnswers

EDI File

Paper Output for ARQ31

ARQ Outputs

EDI Files

ARQ Answers

ARQ Printing

CompetentAuthority

2

ARQ Authorization

EDI MessageARQ Questions at

National Administration28

ARQ Questions

Page 52: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 52/97

Process: Maintain ARQ Questions

Process Description:The process to maintain ARQ questions is to be used by UNDCP to define whatquestions are to be provided in the ARQ. Using this process, users can define whatwill be the questions and what are the types of answers required. A question canbelong to a section and a section can belong to an ARQ. The user needs to beprovided the option to define a section, a question and a relation between thequestions and the sections. The user should also be allowed to move questionsbetween sections. These questions should be provided with standard facilities likeExcel, Print and EDI. It is preferred to provide an interface for maintaining questionsusing a tree view so as to enable the ease of adding sections and questions and movingquestions between sections. The ARQ definitions would take place in the followingorder;

ARQ Date-> Part -> Section -> Questions.

Process: Generate EDI for ARQ Questions

Process Description:The questions when changed needs to be provided to the national administrations whowould be using the ARQ module. To provide the updated set of questions, generateEDI for ARQ question’s process is being identified. UNDCP would update thesequestions as required and generate an EDI file for the same. The EDI file can betransmitted using any transmission medium.

Process: Upload EDI for ARQ Questions

Process Description:Questions when changed by UNDCP needs to be updated at installation sites using theARQ module. This would be done using the EDI facility. An EDI file generated fromthe installation at UNDCP would have to be uploaded into the NDS installationcontaining the ARQ module. This upload process will be like any other EDI uploadprocess and will update, add or delete questions from the annual report questionnaire.

Process: Capture Answers for ARQ

Process Description:ARQ will be answered by various agencies. These could be the nationaladministration or other agencies within the country. The system will provide for afacility to input multiple answers for every question within the ARQ. The system willalso allow for agencies to answer only the relevant questions. Each question can havemultiple answers. The limit for the number of answers would be 999 per questionwithin the ARQ. Sometimes the answers over the number of years do not change forcertain questions. In such a case, there will be a facility to carry forward the answersof the previous year. If the answers are carried forward for the previous year, theagency answering the questions will have to update the necessary answers and deletethe rest. When using the carry forward option the user will have to specify the yearfrom which the answers need to be carried forwarded. ARQ can also be answered onthe Internet using the WEB interface that will be provided for the same.

Page 53: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 53/97

Process: Authorize ARQ Answers

Process Description:When there are multiple answers for a question, the national administration will haveto decide on which answers need to be printed in the report. Answers can beauthorized only by the national administrations. For authorizing the answers the userwill be provided a list of answers that are available for a selected question. The usercan then select from an answer from the provided list that needs to be authorized.Answers once authorized will appear in the output that will be generated for ARQ.

Process: Generate EDI for ARQ Answers

Process Description:When answers are written for questions in the ARQ, one of the ways to provideUNDCP with the same would be to generate an EDI message for the same andtransmit it to UNDCP. The EDI generation process will only take authorized answersand write the EDI file. Unauthorized answers will not be written to the file. EDI fileformat will be similar to the one that exists for the internal modules of NDS. A newmessage ID will be assigned for the same. It will be the responsibility of UNDCP toprepare the interface for the UNIFACE component to read this format.

Process: Print ARQ

Process Description:The process of printing ARQ will print the Annual Reports Questionnaire usingPowerBuilder. The format for the same will be a free format. There will be no printingfor the same in Word and WordPerfect. The print process will print the annual reportquestionnaire in the hierarchy of a tree i.e. the annual report questionnaire number, thesection below it, the question below the section and the answer below the question. Asthe format of the annual report questionnaire is not important it would be a printed ina system-generated format.

Page 54: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 54/97

Inputs, Outputs and InterfacesFunctionality for National Database System (NDS) will remain as it is in version 3.3efor the existing modules. For the two new modules being added, NDS version 4.0.0will provide the following additional functionality;

Inputs# Inputs Type Of Input Interface Type1. Group Master Maintenance Screen PowerBuilder2. Create a License Request Screen PowerBuilder

OAS♦3. Authorize a License Request Screen PowerBuilder4. Recording of Opening Stocks Screen PowerBuilder5. Recording of Import Details Screen PowerBuilder6. Recording of Export Details Screen PowerBuilder7. Recording of Domestic Import Details Screen PowerBuilder8. Recording of Domestic Export Details Screen PowerBuilder9. Recording of Losses due to Process Screen PowerBuilder10. Recording of Destroyed Quantity Screen PowerBuilder11. Recording of Consumed Quantity Screen PowerBuilder12. Recording of Procured /Withdrawn Screen PowerBuilder13. Recording of Quantity used for Scheduled III Screen PowerBuilder14. Recording of Manufactured Quantity Screen PowerBuilder15. Recording of MFG-Non Psychotropic Screen PowerBuilder16. Recording of Exempted Preparation (MFG) Screen PowerBuilder17. Recording of Stock Adjustment Quantity Screen PowerBuilder18. Recording of Inspection Data Screen PowerBuilder19. Stock Ledger Screen PowerBuilder20. License Type Master Screen PowerBuilder21. ARQ Question Maintenance Screen PowerBuilder22. ARQ Answer Maintenance Screen PowerBuilder

OAS♦

23. Maintenance of MLD Details Screen PowerBuilder24. Opening Stock EDI File EDI File PowerBuilder25. Import Details EDI File EDI File PowerBuilder26. Export Details EDI File EDI File PowerBuilder27. Domestic Import Details EDI File EDI File PowerBuilder28. Domestic Export Details EDI File EDI File PowerBuilder29. Losses due to Process EDI File EDI File PowerBuilder30. Destroyed Quantity EDI File EDI File PowerBuilder31. Consumed Quantity EDI File EDI File PowerBuilder32. Procured /Withdrawn EDI File EDI File PowerBuilder33. Quantity used for Scheduled III EDI File EDI File PowerBuilder34. Manufactured Quantity EDI File EDI File PowerBuilder35. MFG-Non Psychotropic EDI File EDI File PowerBuilder36. Exempted Preparation (MFG) EDI File EDI File PowerBuilder

♦ Oracle Application Server

Page 55: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 55/97

# Inputs Type Of Input Interface Type37. Stock Adjustment Quantity EDI File EDI File PowerBuilder38. Inspection Data EDI File EDI File PowerBuilder39. License Type EDI File EDI File PowerBuilder40. ARQ Question Maintenance EDI File EDI File PowerBuilder41. ARQ Answer Maintenance EDI File EDI File PowerBuilder

OAS

Outputs# Outputs Type of Output Interface Type1. Group Master Report PowerBuilder2. License Request Report PowerBuilder

OAS3. License Authorization Report PowerBuilder4. License Type Master Report PowerBuilder5. MLD output Report PowerBuilder

OAS6. Print ARQ Questions Reports PowerBuilder7. Print ARQ Answers Reports PowerBuilder8. Group Master EDI File EDI File PowerBuilder9. License Request EDI File EDI File PowerBuilder

OAS10. License Authorization EDI File EDI File PowerBuilder11. Group Master Excel File Excel PowerBuilder12. License Request Excel File Excel PowerBuilder

OAS13. License Authorization Excel File Excel PowerBuilder14. Print Stock Ledger Report PowerBuilder15. View Closing Stock Report PowerBuilder16. Stock Ledger EDI File EDI File PowerBuilder17. Closing Stock EDI File EDI File PowerBuilder18. Import Details EDI File EDI File PowerBuilder19. Export Details EDI File EDI File PowerBuilder20. Domestic Import Details EDI File EDI File PowerBuilder21. Domestic Export Details EDI File EDI File PowerBuilder22. Losses due to Process EDI File EDI File PowerBuilder23. Destroyed Quantity EDI File EDI File PowerBuilder24. Consumed Quantity EDI File EDI File PowerBuilder25. Procured /Withdrawn EDI File EDI File PowerBuilder26. Quantity used for Scheduled III EDI File EDI File PowerBuilder27. Manufactured Quantity EDI File EDI File PowerBuilder28. MFG-Non Psychotropic EDI File EDI File PowerBuilder29. Exempted Preparation (MFG) EDI File EDI File PowerBuilder30. Stock Adjustment Quantity EDI File EDI File PowerBuilder31. Inspection Data EDI File EDI File PowerBuilder32. ARQ Questions EDI File EDI File PowerBuilder33. ARQ Answers EDI File EDI File PowerBuilder

OAS34. Stock Ledger Excel File Excel PowerBuilder35. Closing Stock Excel File Excel PowerBuilder

Page 56: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 56/97

# Outputs Type of Output Interface Type36. Import Details Excel File Excel PowerBuilder37. Export Details Excel File Excel PowerBuilder38. Domestic Import Details Excel File Excel PowerBuilder39. Domestic Export Details Excel File Excel PowerBuilder40. Losses due to Process Excel File Excel PowerBuilder41. Destroyed Quantity Excel File Excel PowerBuilder42. Consumed Quantity Excel File Excel PowerBuilder43. Procured /Withdrawn Excel File Excel PowerBuilder44. Quantity used for Scheduled III Excel File Excel PowerBuilder45. Manufactured Quantity Excel File Excel PowerBuilder46. MFG-Non Psychotropic Excel File Excel PowerBuilder47. Exempted Preparation (MFG) Excel File Excel PowerBuilder48. Stock Adjustment Quantity Excel File Excel PowerBuilder49. Inspection Data Excel File Excel PowerBuilder

Interfaces# Description Existing Table(s) Name1. Establishment Export Details (Narcotics) NDS_TRN_ANARCOTICEXPDTLS

NDS_TRN_ANARCOTICEESTABDTLS2. Establishment Import Details (Narcotics) NDS_TRN_ANARCOTICIMPDTLS

NDS_TRN_ANARCOTICIESTABDTLS3. Establishment Export Details

(Psychotropic)NDS_TRN_APPSYCHOTROICEXPDTLSNDS_TRN_APPSYCHOTROICEESTDTLS

4. Establishment Import Details(Psychotropic)

NDS_TRN_APPSYCHOTROICIMPDTLSNDS_TRN_APPSYCHOTROICIESTDTLS

5. Establishment Export Details (Precursors) NDS_TRN_DLICITUSESEXPORTHDRNDS_TRN_DLICITUSESEXPORTDTLS

6. Establishment Import Details (Precursors) NDS_TRN_DLICITUSESIMPORTHDRNDS_TRN_DLICITUSESIMPORTDTLS

7. Establishment wise Consumed Details NDS_TRN_CCONUMEDSTATDLS8. Establishment wise Manufactured Details NDS_TRN_CMANUFACTUREDHDR

NDS_TRN_CMANUFACTUREDDTLSNDS_TRN_CESTABOBTAINEDDTLS

9. Establishment wise Procured Details NDS_TRN_CPROCUREDDTLS10. Establishment wise Schedule. III Details NDS_TRN_CSCHIIISTATSDTLS11. Establishment wise used Details NDS_TRN_CESTABUSEDDTLS12. Establishment wise Obtained Details NDS_TRN_CESTABOBTAINEDDTLS13. Establishment wise NON Psychotropic

MFG DetailsNDS_TRN_PNONPSYCHOSTATSDTLS

14. Establishment wise Exempted PreparationDetails

NDS_TRN_PPREPSTATSDTLS

Page 57: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 57/97

ProblemsFollowing are a list of problems as viewed in the existing version (version 3.3e) of thenational database system;a) The National Database System version 3.3e provides for a facility to capture

information for an establishment only with respect to aggregation into forms.b) The National Database system version 3.3e does not provide for a facility to

capture information on domestic distribution.c) The National Database System version 3.3e does not provide an interface to

Microsoft® Excel.d) The National Database System does not provide support for operations on

Microsoft® Windows® NT.e) The query facility that is provided in the National Database System version 3.3e is

very limited.f) The information / help provided for fields on the screen is very limited.

Additional Requirements

The following modules have been added to the system as additionalrequirements;

• Multilingual Dictionary• Annual Report questionnaire on Internet• Establishment Management Module with support for PreparationsThese requirements have been gathered during the Requirements Analysis

conducted by the professionals of Datamatics Ltd. at UNDCP, Vienna, Austriabetween 31st of January 2000 to 25th of February 2000. The same has beendocumented in various sections of requirement analysis and preliminary design withinthis document. However it should be noted that these requirements would be effectivefor being added to the National Database System version 4.0.0 on mutual acceptancebetween UNDCP and Datamatics Ltd.

Page 58: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 58/97

3. Proposed SystemOverviewThe proposed system for the existing modules will be as they are in the nationaldatabase system version 3.3e. The following are the new modules being added to thenational database system version 4.0.0;

a) Annual Reports Questionnaire;b) Multilingual Dictionaryc) Establishment Management Module with support for Preparations

FunctionalityRefer to the section Functions and processes for functionality of the proposed system.

Data RequirementsThe data requirements would be as per version 3.3e. Since this document is only anextension covering the modules being added additionally, the data requirements wouldremain the same.

General Requirements

Performance requirements

Maximum Response Time (in minutes)Reporting Data Capture Web Components

Server/Module

Drop-Down

GeneratePrintout

Query Drop-Down

Save Query Drop-Down

Save

NT 4 – Windows 2000 0.5 1 0.5 0.1 0.3 2 1 1NetWare 4,5 0.5 1 0.5 0.1 0.3 2 1 1Linux 0.5 1 0.5 0.1 0.3 2 1 1Stand-alone (95/98) 0.5 2 0.5 0.1 0.3 N.A N.A N.AStand-alone (NT) 0.5 1 0.5 0.1 0.3 N.A N.A N.A

The above performance criteria is applicable provided the following criteria is met.• Recommended hardware configuration is used for both servers and clients• In case of web components, the clients access the internet through a minimum 28.8 KBPS

line• Reporting is for generating the reports in Word and WordPerfect and does not apply to

printing the same on printers.

User interface requirementsThe user interface requirements would cover the features and functionality asaccepted in the prototype developed for PowerBuilder version 3.0.4, WEBcomponent 1.0.0 and Reports in Microsoft® Word 8.0 and Corel®WordPerfect 8.0 version 2.0.0.

Other interface requirementsThe system will provide interfaces to Microsoft® Word 8.0 and Corel®WordPerfect 8.0 for Reports. It will provide interface to Microsoft® Excel 8.0

Page 59: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 59/97

as an export feature from transaction and master data capture screens. Thesystem will use UPCHeightA Font for barcodes.

Data MigrationData migration is necessary for installations to move from versions 3.3e toversion 4.0 of the National Database System. The migration will only beneeded for transaction tables, as masters will be provided by UNDCP.Migration will have to be done using multiple schema objects and SQL scriptsthat will move data from NDS 3.3e to NDS 4.0. A procedure needs to bedocumented in the system manual that will provide guidance to the NationalAdministrations in migrating the database.

SecuritySecurity will be provided in NDS 4.0 as it exists today with NDS 3.3e. Therewill no additional security mechanism that will be added to NDS version 4.0.As far as national administrations are concerned they need to apply securitymechanisms base on the national legislation and procedures that apply to theirrespective national administrations.

Target environmentThe target environment comprises of various installations for the NationalDatabase System. These installations will need the following hardware andsoftware environment to operate successfully.

For Single User Environment (Software)# Category Environment1. Operating System Windows 95 / Windows 98 / Windows NT 4.02. Database Personal Oracle 8.0.53. WEB Server Not Applicable4. Word Processor Microsoft® Word 8.0 / Corel® WordPerfect 8.05. Spreadsheet Microsoft® Excel 8.06. Other Software UPCHeightA Barcode Font7. Browsers Not Applicable

For Single User Environment (Hardware)# Category Environment1. Processor Intel P-II 300 MHz, a P-III 500 MHz is preferred.2. Memory 128 MB RAM3. Hard Disk 1 GB4. Display Settings 1024x768 256 Colors, Small Fonts5. Other Devices Mouse and CD ROM Device6. Printer HP LaserJet

For Multi User Environment (Software)# Category Environment1. Operating System

(Server)Windows NT 4.0 Server / Novell NetWare 4.11 /Sun Solaris / Linux

Page 60: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 60/97

# Category Environment2. Operating System

(Client)Windows 95 / Windows 98 / Windows NT 4.0Workstation

3. Database Oracle Enterprise Server 8.1.54. WEB Server Oracle Application Server 4.0.85. Word Processor Microsoft® Word 8.0 / Corel® WordPerfect 8.06. Spreadsheet Microsoft® Excel 8.07. Other Software UPCHeightA Barcode Font8. Browsers Netscape Navigator 4.6 / Internet Explorer 5.0

For Multi User Environment (Hardware)# Category Environment1. Processor (Server) Intel P-II 450 MHz, a P-III 500 MHz is preferred2. Processor (Client) Intel P-5 166 MHz, a P-II 350 MHz is preferred3. Memory (Server) 256 MB RAM4. Memory (Client) 64 MB RAM5. Hard Disk (Server) 2 GB6. Hard Disk (Client) 1 GB7. Display Settings 1024x768 256 Colors, Small Fonts8. Other Devices Mouse and CD ROM Device9. Printer HP LaserJet

Development EnvironmentThe development will be carried out on a stand-alone and networkedenvironment. Following is the table indicating the environment that will beused for development;

For Single User Environment (Software)# Category Environment1. Operating System Windows 95 / Windows 98 / Windows NT 4.02. Database Personal Oracle 8.0.53. WEB Server Not Applicable4. Front-end Tool PowerBuilder 6.55. Word Processor Microsoft® Word 8.0 / Corel® WordPerfect 8.06. Spreadsheet Microsoft® Excel 8.07. Other Software UPCHeightA Barcode Font8. Browsers Netscape Navigator 4.6 / Internet Explorer 5.0

For Single User Environment (Hardware)# Category Environment1. Processor Intel P-II, 300 MHz, a P-III 500 MHz is preferred2. Memory 128 MB RAM3. Hard Disk 1 GB4. Display Settings 1024x768 256 Colors, Small Fonts5. Other Devices Mouse and CD ROM Device6. Printer HP LaserJet

Page 61: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 61/97

For Multi User Environment (Software)# Category Environment1. Operating System

(Server)Windows NT 4.0 Server / Novell NetWare 4.11 /Sun Solaris / Linux

2. Operating System(Client)

Windows 95 / Windows 98 / Windows NT 4.0Workstation

3. Database Oracle Enterprise Server 8.0.54. WEB Server Oracle Application Server 4.0.85. Front-end Tool PowerBuilder 6.56. Word Processor Microsoft® Word 8.0

Corel® WordPerfect 8.07. Spreadsheet Microsoft® Excel 8.08. Other Software UPCHeightA Barcode Font9. Browsers Netscape Navigator 4.6 / Internet Explorer 5.0

For Multi User Environment (Hardware)# Category Environment1. Processor (Server) Intel P II, 250 MHz2. Processor (Client) Intel P II, 250 MHz3. Memory (Server) 128 MB RAM4. Memory (Client) 64 MB RAM5. Hard Disk (Server) 2 GB6. Hard Disk (Client) 1 GB7. Display Settings 1024x768 256 Colors, Small Fonts8. Other Devices Mouse and CD ROM Device9. Printer HP LaserJet

DocumentationAs a part of the national database system version 4.0.0, one copy of thefollowing documentation will be provided;

a) Detailed Design Documentation for all the modules covered inNDS version 4.0.0. This documentation will be provided only inEnglish.

b) User Manual for all the modules covered in NDS version 4.0.0.This documentation will be provided only in English. UNDCPwould translate the same into French and Spanish and Datamaticswould prepare the on-line help in French and Spanish based on thetranslations provided by UNDCP.

c) Systems Administration Manual. This will not cover theinstallation procedures for the same. This documentation will beprovided only in English.

d) Installation Manual for installation of the Standalone andNetworked version of National Database System version 4.0.0. Theinstallation manual will not cover the installation of third partysoftware provided along with NDS for NDS to work. Thisdocumentation will be provided only in English.

Page 62: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 62/97

TrainingAs a part of user training there will be three training sessions conducted. Therewill be one session conducted covering system overview for a maximum oftwo (2) days for a maximum of five (5) users. There will be another trainingsession covering InfoMaker for a maximum of One (1) day for a maximum offive (5) users on InfoMaker. There will be another training session coveringthe design of the system for a maximum of two (2) days for a maximum of two(2) users. The above mentioned training will be conducted at UNDCP Site inVienna, Austria. For the second site identified for installation for useracceptance testing only two training’s covering System Overview andInfoMaker will be covered for the same period mentioned above.

Parallel runThere will be no Parallel Run for the National Database System 4.0.0

Localization (Local language support)The national database system will cover the functionality as covered underversion 3.3e for localization. There will be no additional localizationfunctionality covered under the national database system version 4.0.0

CompatibilityNational Database System version 4.0.0 has no compatibility issues to workwith any other software installed either on the server in case of the networkedenvironment or on the client in case of the standalone installation. However allcompatibility issues with respect to the third party software being used alongwith the national database system will have to be addressed prior to installingthe national database system version 4.0.0

Audit trailsThe national database system version 3.3e provides for a facility to have audittrail information for every component within the system. The national databasesystem version 4.0.0 will continue to provide the same facility as in version3.3e. There will be no additional audit control facility provided under NDSversion 4.0.0. Users however can use the audit trail facilities as provided bythe operating systems and the database software being used along with thenational database system

Error logEvery message of type “Error” that is being display in the national databasesystem version 4.0.0 will have to be logged to a separate error log file. Afacility needs to be provided for users to view all the errors that have beenlogged in the system. All the information that has been displayed in the errorsmessage window needs to be logged in the error log file. Along with theinformation that is being logged, in case of working with forms, the keycombination of the form header also needs to be logged. In case of masters noadditional information needs to be logged.

Page 63: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 63/97

Archiving & restoringThe national database system version 4.0.0 will not provide for any facility toarchive and restore data pertaining to the system. The users will have to usethe facility provided by the database vendor to carry out archiving andrestoring procedures.

VersioningEvery deliverable made during the period of the contract of Datamatics for thedevelopment of the national database system will be versioned. Once a versionis created, all subsequent changes will be tracked. Every deliverable will bebaselined and changes to deliverable will be maintained separately. During theperiod of warranty and support, it will be the responsibility of UNDPC tomaintain different versions of the national database software.

History and retention control

As per the policies of the national administration, the database administratorwould have to maintain the historical data on backup devices. The nationaldatabase system version 4.0.0 would not provide a facility to do so. Databaseadministrator can use existing software products from various vendors formaintaining historical data.

Administration and CustomizationThe system will provide for a user maintenance screen which will manageusers within the application. The users will be a part of NDS application andwill share a common Oracle user-id. The user maintenance screen will providefor setting preferences as mentioned in the preferences section for defaults forevery module/ form and access permission for modules. The parametersmodule will separate from the masters and will be provided only for DBAinstallations. There will also be a facility within the parameters screen toaccept parameters for creating database dumps and uploading the same. Theexecutable names for exporting the dump and uploading the same will beprovided through the initialization (“INI”) file for future customizations.

Page 64: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 64/97

Error Handling

The error handling procedures for national database system version 4.0.0 will be asprovided in version 3.3e. There will be no change in the error handling mechanism.However there will be an additional facility provided for logging the messages ontothe database. The user administration will also be provided with a screen to view thesemessages. In case of masters the messages will be logged as they appear on the screen.In case of forms, as it is important to track the record on which the message hasoccurred, the system will also log the key fields for the respective form headers intothe log table. This will enable the user administrator to view the error message and beable to identify the appropriate record.

Standards

• Refer to annex 4 for Standards of PowerBuilder to be used in the development ofNational Database System Version 4.0.0

• Refer to annex 5 for Standards of Oracle Application Server to be used in thedevelopment of National Database System Version 4.0.0

• Refer to annex 6 for Standards of Stored Procedures to be used in the developmentof National Database System Version 4.0.0

• Refer to annex 7 for Standards of Reports (WordPerfect) to be used in thedevelopment of National Database System Version 4.0.0

• Refer to annex 8 for Standards of Reports (Word) to be used in the developmentof National Database System Version 4.0.0

Page 65: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 65/97

4. Database Design

• Refer to Annex 1

Page 66: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 66/97

5. User Procedures

RoutineThe system will be installed only for users of the NDS Application.

The system will consist of various different executables with a feature that once theuser has logged, on selection of another executable, Login Id & Password screen willnot appear.

Access in the application will be controlled through Oracle User Id & Password.When the user wants to access the system, the user will have to provide theappropriate user-id and password. The database server will authenticate this.

In case of WEB Component, this document does not address the issues of firewall.The firewall issues (if any) would have to be addressed by the nationaladministrations.

ExceptionNone

NavigationPlease refer to Annex – 2.

ScreensThere will be different executables in NDS Ver. 4.0.0, as available in NDS Ver. 3.3.e.

In each of this executables the first window for the application is a Logon window,which is displayed with accept the user-id and password.

Logon screen

In the Logon screen the user-id and password will be entered. The Password willappear as asterisks (*). The Password will be validated and further access toapplication will be provided only to valid users.

If the user logs in incorrectly three times, he/she shall be denied access to theapplication in that session. The Logon window will close and the control will bepassed back to the Windows desktop.

Page 67: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 67/97

Group Master Maintenance Screen (EMM)

This screen will be used to define various Groups and also assigning varioussubstances or preparations to group.

The screen accepts and displays the following fields:Field Name DescriptionGroup Code Unique Group Code.Group Name Group Name.Sub Group Code Substance Code/Preparation Code/Group Code can be

assigned to Sub Group Code.

License Type Maintenance Screen (EMM)

This screen will be used to define various License Types. (Used for License Request& Approval)

The screen accepts and displays the following fields:Field Name DescriptionLicense Type Code Unique License Type to be entered.

Example of different License Types.• Sales• Purchase• Manufacture• Import• Export• Stocks• Transport• Wholesales• Scientific and Research activities• Special License for Brokers

Language Code User can choose from the available drop down list the desiredLanguage Code.

License Description Description for License Type.Comments User can enter Comments, if any.

License Request Screen (EMM)

This screen will be used for capturing License Request.

The screen accepts and displays the following fields:Field Name DescriptionLicense RequestNumber

User defined Unique License Request Number for the givenEstablishment.

License RequestDate

License Req. Date.

License Validity License Validity Period in terms of ‘From’ & ‘To’ Date.

Page 68: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 68/97

Field Name DescriptionDateCountry Code User can choose from the available drop down list the desired

Country Code.Country Name Based on the chosen Country Code, County Name will be

displayed. It is display-only field.Establishment Code User can choose from the available drop down list the desired

Establishment Code, for given Country.Establishment Name Based on the chosen Establishment Code, Establishment

Name will be displayed. It is display-only field.License Type User can choose for a given License Request, one or more

than one (many) license type.License Type are of following types:

• Sales• Purchase• Manufacture• Import• Export• Stocks• Transport• Wholesale• Scientific and Research activities• Special License for Brokers

Remarks Remarks, if any for a License can be entered.SubstanceCode/PreparationCode/Group Code

User will choose from the available drop down list the desiredcode.

SubstanceCode/PreparationCode/Group Name

Based on the chosen Substance Code/Preparation Code/GroupCode, Substance Code/Preparation Code/Group Name will bedisplayed. It is display-only field.

Requested LicenseQuantity

License Request Quantity for each of the SubstanceCode/Preparation Code/Group Code selected.

License Authorization Screen (EMM)

This screen will be used for Authorizing License, for which License Request has beenentered.

The screen accepts and displays the following fields:Field Name DescriptionLicense RequestNumber

User/Approving Authority will enter the License RequestNumber, which is to be authorized/approved.

License Number The concerned Authority authorizing will enter the UniqueLicense Number against the Request Number.

License ApproveDate

User/Approving Authority will enter the Date of approving theLicense Request.

License ValidityDate

Based on the entered License Request Number Screen willdisplay the License validity Dates. User/Approving Authority

Page 69: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 69/97

Field Name Descriptioncan change/modify Validity Period in terms of ‘From’ & ‘To’Date. ( ‘To’- Expiry Date)

Country Code For the given License Request Number, the correspondingCountry Code will be displayed. It is display-only field.

Country Name For the given License Request Number, the correspondingCountry Name will be displayed. It is display-only field.

Establishment Code For the given License Request Number, the correspondingEstablishment Code will be displayed. It is display-only field.

Establishment Name For the given License Request Number, the correspondingEstablishment Name will be displayed. It is display-only field.

Competent AuthorityCode

User/Approving Authority will choose from the available dropdown list the desired Competent Authority Code for givenCountry.

Competent AuthorityName

Based on the chosen Competent Authority Code, CompetentAuthority Name will be displayed. It is display-only field.

License Type User can approve one or more than one License Types, for thegiven License Request Number. License Type are of followingtypes:

• Sales• Purchase• Manufacture• Import• Export• Stocks• Transport• Wholesale• Scientific and Research activities

Note: user can not add any License Type at the time of approval ofrequest.

Remarks Remarks for a License can be entered.SubstanceCode/PreparationCode/Group Code

Requested Substance Code/Preparation Code/Group Code willbe displayed. It is display-only field.

SubstanceCode/PreparationCode/Group Name

Requested Substance Code/Preparation Code/Group Namewill be displayed. It is display-only field.

Requested LicenseQuantity

For the given License Request Number, requested quantitywill be displayed. It is display-only field.

Approved LicenseQuantity

For the given License Request Number, User/ApprovingAuthority will enter the approved quantity. The approvedquantity can be equal or lesser than requested quantity.

Page 70: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 70/97

License Revoking Screen (EMM)

This screen will be used for Revoking License, which has been authorized/approved.

The screen accepts and displays the following fields:Field Name DescriptionLicense Number Screen will display all the licenses, which are already

approved. It is display-only field.License ApproveDate

Corresponding to license number, license approve date will bedisplayed. It is display-only field.

Establishment Code For the given License Request Number, the correspondingEstablishment Code will be displayed. It is display-only field.

Establishment Name For the given License Request Number, the correspondingEstablishment Name will be displayed. It is display-only field.

License Type License Type will be displayed. It is display-only field.Date of Revocation Date of RevocationReason ofRevocation

Reason of Revocation, if any.

Establishment Management Screen

This screen facilitates in entering Opening Stock, Updating the stock & View thestock, for the given Establishment & for the given Substance.

The screen accepts and displays the following fields:

Screen Header

Field Name DescriptionCountry Code User will choose from the available drop down list, the desired

Country Code.Country Name Based on the chosen Country Code, County Name will be

displayed. It is display-only field.Competent AuthorityCode

Choose from the available drop down list, the desiredCompetent Authority Code for given Country.

Competent AuthorityName

Based on the chosen Competent Authority Code, CompetentAuthority Name will be displayed. It is display-only field.

Opening Stocks TAB Folder

Field Name DescriptionTransaction Date Date on which the opening Stock related to substance is

entered.Establishment Code User will choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for thechosen country.

Page 71: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 71/97

Field Name DescriptionEstablishmentName

Based on the chosen Establishment Code, Establishment Namewill be displayed. It is display-only field.

Substance/Preparation Code

User can choose from the available drop down list the desiredcode.Note: In case if Opening stocks entered in terms of preparation,it will not be converted into substances.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit ofMeasurement

Based on selection of the Substance/Preparation Code, the unitof measurement will be displayed. It is display-only field.

Opening StockQuantity

Opening Stock Quantity for the Substance/Preparation Code.

Comments Remarks, if any can be entered.

Stock View TAB Folder

As soon as user chooses ‘Stock View TAB Folder’, he/she will be able to see forvarious establishments and substance/preparations, closing stock.

Field Name DescriptionEstablishment Code It is display-only field.EstablishmentName

It is display-only field.

Substance/Preparation Code

It is display-only field.

Substance/Preparation Name

It is display-only field.

Unit ofMeasurement

Based on the Substance/Preparation Code, the unit ofmeasurement will be displayed. It is display-only field.

Stock Stock on hand for the given substance/preparation code.Comments Remarks entered if any will be displayed. It is display-only

field.

Stock Adjustment TAB Folder

Field Name DescriptionTransaction Date Date on which the Stock Adjustment entry is entered.Establishment Code User will choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for thechosen country.

EstablishmentName

Based on the chosen Establishment Code, Establishment Namewill be displayed. It is display-only field.

Substance/Preparation Code

User can choose from the available drop down list the desiredcode.

Page 72: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 72/97

Field Name DescriptionNote: In case if Stock Adjustment entered in terms ofpreparation, it will not be converted into substances.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit ofMeasurement

Based on selection of the Substance/Preparation Code, the unitof measurement will be displayed. It is display-only field.

Quantity to beAdjusted

Quantity to be Adjusted. If quantity entered is negative, stockswill be reduced (-) and in case of quantity entered is positive,stocks will be increased. (+)

Comments Remarks, if any can be entered. Comments can be related to thereason of adjusting stock.

Inspection Results TAB Folder

Field Name DescriptionInspection Number Unique Inspection Number for the given Establishment &

Country.Inspection Date Date on which Inspection was carried out by Competent

Authority.Establishment Code User will choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for thechosen country.

EstablishmentName

Based on the chosen Establishment Code, Establishment Namewill be displayed. It is display-only field.

InspectingAuthority Name

Name of the Person, who had carried out inspection.

Substance/Preparation Code

User can choose from the available drop down list the desiredcode.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit ofMeasurement

Based on selection of the Substance/Preparation Code, the unitof measurement will be displayed. It is display-only field.

Conversion Factor Based on selection of the Substance/Preparation Code, theconversion factor will be displayed. It is display-only field.

Declared Quantity Quantity declared for the given Substance/Preparation Code byEstablishment.

Inspection Quantity Quantity intended for inspection for the givenSubstance/Preparation Code by Inspecting Authority.

Actual Quantity Actual Quantity after inspection found.Comments Remarks, if any can be entered.

Page 73: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 73/97

Import Details TAB Folder

Field Name DescriptionCertificate Number User will enter certificate Number.Transaction Date Date of importing substance/preparationSubstance/Preparation Code

User can choose from the available drop down list the desiredcode.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit ofMeasurement

Based on selection of the Substance/Preparation Code, the unitof measurement will be displayed. It is display-only field.

Establishment Code User will choose from the available drop down list the desiredEstablishment Code.Drop down list will display only establishments(s) for thechosen country.

EstablishmentName

Based on the chosen Establishment Code, Establishment Namewill be displayed. It is display-only field.

Trading CountryCode

User will choose from the available drop down list the desiredCountry Code. Country from where the Importing Country isImporting.

Trading CountryName

Based on the chosen Country Code, County Name will bedisplayed. It is display-only field.

TradingEstablishment Code

User will choose from the available drop down list the desiredEstablishment Code. Establishment from where the ImportingEstablishment is Importing.

TradingEstablishmentName

Based on the chosen Establishment Code, Establishment Namewill be displayed. It is display-only field.

Import Quantity Quantity Imported.

Export Details TAB Folder

Field Name DescriptionCertificate Number User will enter certificate Number.Transaction Date Date of exporting substance/preparationSubstance/Preparation Code

User can choose from the available drop down list the desiredcode.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, the unitof measurement will be displayed. It is display-only field.

Establishment Code User will choose from the available drop down list the desiredEstablishment Code.Drop down list will display only establishments(s) for the

Page 74: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 74/97

Field Name Descriptionchosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Trading CountryCode

User will choose from the available drop down list the desiredCountry Code. Country to which the Exporting Country isExporting.

Trading CountryName

Based on the chosen Country Code, County Name will bedisplayed. It is display-only field.

TradingEstablishment Code

User will choose from the available drop down list the desiredEstablishment Code. Establishment to which the Exportingestablishment is Exporting.

TradingEstablishment Name

Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Export Quantity Exported Quantity

Domestic Purchase Details TAB Folder

Field Name DescriptionCertificate Number User will enter unique Certificate Number.Transaction Date Date of importing substance/preparationSubstance/Preparation Code

User can choose from the available drop down list the desiredcode.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, the unitof measurement will be displayed. It is display-only field.

Establishment Code User will choose from the available drop down list the desiredEstablishment Code.Drop down list will display only establishments(s) for thechosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

TradingEstablishment Code

User will choose from the available drop down list the desiredEstablishment Code.

TradingEstablishment Name

Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Purchased Quantity Purchased QuantityComments Remarks, if any can be entered.

Domestic Sales Details TAB Folder

Field Name DescriptionCertificate Number Unique Certificate NumberTransaction Date Date of exporting substance/preparationSubstance/Preparatio User can choose from the available drop down list the desired

Page 75: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 75/97

Field Name Descriptionn Code code.Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, the unitof measurement will be displayed. It is display-only field.

Establishment Code User will choose from the available drop down list the desiredEstablishment Code.Drop down list will display only establishments(s) for thechosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

TradingEstablishment Code

User will choose from the available drop down list the desiredEstablishment Code.

TradingEstablishment Name

Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Sale Quantity Sold QuantityComments Remarks, if any can be entered.

Consumed TAB Folder

Field Name DescriptionTransaction Date Date on which consumption has taken place.Establishment Code User will choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for thechosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Substance/Preparation Code

User can choose from the available drop down list the desiredcode.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, the unitof measurement will be displayed. It is display-only field.

Conversion Factor Based on selection of the substance code, the conversionfactor will be displayed. It is display-only field.

Quantity Consumed Quantity ConsumedComments Remarks, if any can be entered.

Page 76: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 76/97

Manufactured (Psychotropic) TAB Folder

Field Name DescriptionHeader Information:Establishment Code User will choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for the chosencountry.

Establishment Name Based on the chosen Establishment Code, Establishment Namewill be displayed. It is display-only field.

Transaction Date Date on which Psychotropic Substance/Preparation has beenmanufactured.

Comments Remarks, if any can be entered.Used:Substance/Preparation Code

User can choose from the available drop down list the desiredcode.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Conversion Factor If the selected code is substance code, Conversion Factor will bedisplayed. It is display-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, the unit ofmeasurement will be displayed. It is display-only field.

Quantity/value Used Quantity Used in Manufacturing.Obtained:Substance/Preparation Code

User can choose from the available drop down list the desiredcode.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, the unit ofmeasurement will be displayed. It is display-only field.

Conversion Factor If the selected code is substance code, Conversion Factor will bedisplayed. It is display-only field.

Quantity Obtained Quantity Obtained from Manufacturing Process

Manufactured (Narcotics) TAB Folder

Field Name DescriptionHeader Information:Establishment Code User will choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for the chosencountry.

Establishment Name Based on the chosen Establishment Code, Establishment Namewill be displayed. It is display-only field.

Transaction Date Date on which Narcotics substance/preparation has beenmanufactured.

Page 77: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 77/97

Field Name DescriptionComments Remarks, if any can be entered.Used:Substance/Preparation Code

User can choose from the available drop down list the desiredcode.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Conversion Factor If the selected code is substance code, Conversion Factor will bedisplayed. It is display-only field.

Quantity Used Quantity Used in Manufacturing.Obtained:Substance/Preparation Code

User can choose from the available drop down list the desiredcode.

Substance/Preparation Name

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, the unit ofmeasurement will be displayed. It is display-only field.

Conversion Factor If the selected code is substance code, Conversion Factor will bedisplayed. It is display-only field.

Quantity Obtained Quantity Obtained from Manufacturing Process

Manufactured (Precursors) TAB Folder

Field Name DescriptionTransaction Date Date on which Precursors substance/preparation has been

manufactured.Establishment Code User can choose from the available drop down list the

Establishment Code.Drop down list will display only establishments(s) for thechosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Substance/PreparationCode

User can choose from the available drop down list the desiredcode.

Substance/PreparationName

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, theunit of measurement will be displayed. It is display-only field.

Table Indicator If the selected code is substance code, the Table Indicator willbe displayed. It is display-only field.

QuantityManufactured

Quantity Manufactured

Comments Remarks, if any can be entered.

Page 78: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 78/97

Manufacture of Non-Psychotropic TAB Folder (Psychotropics)

Field Name DescriptionTransaction Date Date on which Psychotropic substance/preparation has been

manufactured.Establishment Code User can choose from the available drop down list the

Establishment Code.Drop down list will display only establishments(s) for thechosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Substance/PreparationCode

User can choose from the available drop down list the desiredcode.

Substance/PreparationName

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, theunit of measurement will be displayed. It is display-only field.

Schedule Indicator If the selected code is substance code, the Schedule Indicatorwill be displayed. It is display-only field.

Quantity Quantity used to Manufacture Non-Psychotropic SubstancesComments Remarks, if any can be entered.

Manufacture of Exempted Preparations TAB Folder (Psychotropic)

Field Name DescriptionTransaction Date Date on which Psychotropic preparation/substance had been

manufactured.Establishment Code User will choose from the available drop down list the

desired Establishment Code.Drop down list will display only establishments(s) for thechosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Substance/PreparationCode

User can choose from the available drop down list the desiredcode.

Substance/PreparationName

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Schedule Indicator If the selected code is substance code, the Schedule Indicatorwill be displayed. It is display-only field.

Quantity Quantity Used for exempted preparations.Comments Remarks, if any can be entered.

Page 79: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 79/97

Used for Scheduled III TAB Folder (Narcotics)

Field Name DescriptionTransaction Date Date on which Narcotics preparation/substance had been used

for Schedule III purpose.Establishment Code User can choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for thechosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Substance/PreparationCode

User can choose from the available drop down list the desiredcode.

Substance/PreparationName

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, theunit of measurement will be displayed. It is display-only field.

Conversion Factor If the selected code is substance code, Conversion Factor willbe displayed. It is display-only field.

Quantity Quantity used for Schedule III.Comments Remarks, if any can be entered.

Procured/Withdrawn TAB Folder (Narcotics)

Field Name DescriptionTransaction Date Date on which Narcotics preparation/substance had been

procured (+)/withdrawn (-) for special purpose.Establishment Code User can choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for thechosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Substance/PreparationCode

User can choose from the available drop down list the desiredcode.

Substance/PreparationName

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Unit of Measurement Based on selection of the Substance/Preparation Code, theunit of measurement will be displayed. It is display-only field.

Conversion Factor If the selected code is substance code, Conversion Factor willbe displayed. It is display-only field.

Quantity Positive (+) Quantity will indicate that Quantity has beenprocured for special purposes.Negative (-) Quantity will indicate that Quantity has beenwithdrawn for special purposes.

Page 80: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 80/97

Field Name DescriptionComments Remarks, if any can be entered.

Destroyed TAB Folder

Field Name DescriptionTransaction Date Date on which Substance has been destroyed.Establishment Code User can choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for thechosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Substance/PreparationCode

User can choose from the available drop down list the desiredcode.

Substance/PreparationName

Based on the chosen Substance Code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Destroyed Type User can choose from the available drop down list one offollowing destroyed types:

• Others• Seizures

Quantity Destroyed Quantity DestroyedComments Remarks, if any can be entered.

Losses TAB Folder (Loss in Process)

Field Name DescriptionTransaction Date Date on which Loss In Process has been reported.Establishment Code User can choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for thechosen country.

Establishment Name Based on the chosen Establishment Code, EstablishmentName will be displayed. It is display-only field.

Substance/PreparationCode

User can choose from the available drop down list the desiredcode.

Substance/PreparationName

Based on the chosen Substance code/Preparation Code,Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Conversion Factor If the selected code is substance code, Conversion Factor willbe displayed. It is display-only field.

Quantity Lost Quantity Lost in process.Comments Remarks, if any can be entered.

Page 81: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 81/97

Establishment Details Screen - Import/Export, Domestic Purchase &Sales

This screen facilitates in viewing Establishment details for the givenSubstance/Preparation Code. This screen will be displayed from applicable tab foldersof forms of National Database System.

The screen accepts and displays the following fields:

Field Name DescriptionSubstance/PreparationCode

Substance/Preparation Code will be displayed based on theconcerned form, from where this window/screen has beencalled. It is display-only field.

Substance/PreparationName

Corresponding to Substance/Preparation Code,Substance/Preparation Name will be displayed. It is display-only field.

Conversion Factor Corresponding to Substance/Preparation Code, ConversionFactor will be displayed. It is display-only field.

Unit of Measurement Corresponding to Substance/Preparation Code, Unit ofMeasurement will be displayed. It is display-only field.

Country Code Country Code will be displayed based on the concerned form,from where this window/screen has been called. It is display-only field.

Country Name Corresponding to Country Code, Country Name will bedisplayed. It is display-only field.

Total Quantity Sum of establishment wise quantity. It is display-only field.Certificate Number Certificate Number, for the trade will be displayed. It is

display-only field.Establishment Code Establishment Code will be displayed based on the concerned

form, from where this window/screen has been called. It isdisplay-only field.

Establishment Name Corresponding to Establishment Code, Establishment Namewill be displayed. It is display-only field.

Quantity Establishment wise quantity will be displayed. This field iseditable. Any changes to quantity field will be reflected inEstablishment Management Module, for the concernedcountry and establishment.

Transaction Date Date on which trade has taken place.TradingEstablishment Code

Trading Establishment Code, against which trade has takenplace.

TradingEstablishment Name

Name of the Trading Establishment against which trade hastaken place.

Page 82: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 82/97

Establishment Details Screen - Manufactured (Used/Obtained)

This screen facilitates in viewing Establishment details for the given PreparationCode. This screen will be displayed from applicable tab folders of forms of NationalDatabase System.

The screen accepts and displays the following fields:

Field Name DescriptionHeader Information:Establishment Code User will choose from the available drop down list the desired

Establishment Code.Drop down list will display only establishments(s) for the chosencountry.

Establishment Name Based on the chosen Establishment Code, Establishment Namewill be displayed. It is display-only field.

Transaction Date Date on which Psychotropic Substance/Preparation has beenmanufactured.

Comments Remarks, if any can be entered.Used:Preparation Code User can choose from the available drop down list the desired

code.Preparation Name Based on the chosen Substance Code/Preparation Code,

Substance Name/Preparation Name will be displayed. It isdisplay-only field.

Conversion Factor If the selected code is substance code, Conversion Factor will bedisplayed. It is display-only field.

Quantity Used Quantity Used in Manufacturing.Establishment wise quantity will be displayed. This field iseditable. Any changes to quantity field will be reflected inEstablishment Management Module, for the concerned countryand establishment.

Obtained:Preparation Code User can choose from the available drop down list the desired

code.Preparation Name Based on the chosen Preparation Code, Preparation Name will

be displayed. It is display-only field.Unit of Measurement Based on selection of the Preparation Code, the unit of

measurement will be displayed. It is display-only field.Conversion Factor If the selected code is substance code, Conversion Factor will be

displayed. It is display-only field.Quantity Obtained Quantity Obtained from Manufacturing Process.

Establishment wise quantity will be displayed. This field iseditable. Any changes to quantity field will be reflected inEstablishment Management Module, for the concerned countryand establishment.

Page 83: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 83/97

Establishment Details Screen - Other Types

This screen facilitates in viewing Establishment details for the givenSubstance/Preparation Code. This screen will be displayed from applicable tab foldersof forms of National Database System.

This screen will be used to display establishment-wise details for following types:

• Consumed• Procured/Withdrawn• MFG – Non Psychotropic• Exempted Preparation (MFG)• Used For Preparation• Destroyed• Losses

The screen accepts and displays the following fields:

Field Name DescriptionSubstance/PreparationCode

Substance/Preparation Code will be displayed based on theconcerned form, from where this window/screen has beencalled. It is display-only field.

Substance/PreparationName

Corresponding to Substance/Preparation Code,Substance/Preparation Name will be displayed. It is display-only field.

Conversion Factor Corresponding to Substance/Preparation Code, ConversionFactor will be displayed. It is display-only field.

Unit of Measurement Corresponding to Substance/Preparation Code, Unit ofMeasurement will be displayed. It is display-only field.

Country Code Country Code will be displayed based on the concerned form,from where this window/screen has been called. It is display-only field.

Country Name Corresponding to Country Code, Country Name will bedisplayed. It is display-only field.

Total Quantity Sum of establishment-wise quantity. It is display-only field.Establishment Code Establishment Code will be displayed based on the concerned

form, from where this window/screen has been called. It isdisplay-only field.

Establishment Name Corresponding to Establishment Code, Establishment Namewill be displayed. It is display-only field.

Quantity Establishment-wise quantity will be displayed. This field iseditable. Any changes to quantity field will be reflected inEstablishment Management Module, for the concernedcountry and establishment.

Transaction Date Date on which transaction had taken place.

Page 84: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 84/97

Recording of Questions (ARQ)

This screen will facilitate in entering Annual Reports Questionnaire.

The screen accepts and displays the following fields:

Field Name DescriptionARQ Part User can choose from the available tree list the desired ARQ

part. Following values will be displayed.• Part I• Part II• Part III

Question Number User will enter Question Number in the form of number. Fore.g. 1,2,3

Sub QuestionNumber

User will enter Question Number in the form of number. Fore.g. 1,2,3For the main question, user needs to enter 0. For sub questionlike 1.1,2.1,4.1,5.1, user needs to enter 1,2,3,4

• For e.g. ARQ/Part – I (Page 4), User will enter forquestion no:1 following details for the fields QuestionNumber & Sub Question Number

• Question Number 1• Sub Question Number 0

• For e.g. ARQ/Part – I (Page 4), User will enter forquestion no:1.1 following details for the fields QuestionNumber & Sub Question Number

• Question Number 1• Sub Question Number 1

Response Type User can choose from the available drop down list the desiredResponse Type. For details please refer to Annex – 3.

Link to Details User can choose from the available drop down list the desiredchoice. Drop Down List will display following:

Yes ( Yes indicating Link to details)No ( No indicating No Link to details)

• For e.g. ARQ/Part – I (Page 4), User will enter forquestion no:1 following detail for the field Link to Details

• Yes• For e.g. ARQ/Part – I (Page 4), User will enter for

question no:1 following detail for the field Link toQuestion

• NoLink to Question User can choose from the available drop down list the desired

choice. Drop Down List will display following:

Page 85: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 85/97

Field Name Description

Yes ( Yes indicating Link to Question)No ( No indicating No Link to Question)• For e.g. ARQ/Part – I (Page 4), User will enter for

question no:1.1 following detail for the field Link toDetails

• No• For e.g. ARQ/Part – I (Page 4), User will enter for

question no:1.1 following detail for the field Link toQuestion

• YesQuestion Text 1 to 5 Explained with Following Example:

• For e.g. ARQ/Part – I (Page 4), User will enter forquestion no: 1, in the Question Text Area – 1 ‘Were anylaws or regulations relating to narcotic drugs or …’

• For e.g. ARQ/Part – I (Page 4), User will enter forquestion no: 1.1, in the Question Text Area – 1 ‘pleasefill out the following table listing the laws …’

• For e.g. ARQ/Part – I (Page 4), User will enter forquestion no: 1.1, in the Question Text Area – 2 ‘Date’

• For e.g. ARQ/Part – I (Page 4), User will enter forquestion no: 1.1, in the Question Text Area – 3 ‘Title andimportant features’

Comments Remarks, if any can be entered.

Note: It is desired by UNDCP that Tree-View / List-View controls are used for interface, for ease of use.

Page 86: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 86/97

Recording Answers – (ARQ - Main Page Entry)

This screen will facilitate for answering Annual Reports Questionnaire –Main page,where user needs to input Name of the Competent Authority, Full Postal Address etc.(For e.g. Please refer to page 3 of ARQ/Part – I)

The screen accepts and displays the following fields:

Field Name DescriptionCountry Code User will choose from the available drop down list the desired

Country Code.Country Name Based on the chosen Country Code, Country Name will be

displayed. It is display-only field.Year ARQ Year needs to be entered. For e.g. 1998,1999,2000CompetentAuthority

User will choose from the available drop down list the desiredCompetent Authority Code.Drop down list will display only competent authority(s) for thechosen country.

CompetentAuthority Name

Based on the chosen Competent Authority Code, CompetentAuthority Name will be displayed. It is display-only field.

CompetentAuthority Address

Based on the chosen Competent Authority Code, CompetentAuthority Address will be displayed. The field will be editable.

Person to becontacted

Person to be contacted, who will be contacted from CompetentAuthority.

Title Title of Person to be contacted.Telephone Telephone number of Competent AuthorityTelex Telex number of Competent AuthorityTelefax Telefax number of Competent Authority

Recording Answers

This screen will facilitate for answering Annual Reports Questionnaire – Details part.(For e.g. Please refer to page 4 of ARQ/Part – I)

The screen accepts and displays the following fields:

Header Portion

Field Name DescriptionCountry Code User will choose from the available drop down list the desired

Country Code.Country Name Based on the chosen Country Code, Country Name will be

displayed. It is display-only field.Year ARQ Year needs to be entered. For e.g. 1998,1999,2000CompetentAuthority

User will choose from the available drop down list the desiredCompetent Authority Code.Drop down list will display only competent authority(s) for the

Page 87: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 87/97

Field Name Descriptionchosen country.

CompetentAuthority Name

Based on the chosen Competent Authority Code, CompetentAuthority Name will be displayed. It is display-only field.

ARQ Number User can choose from the available drop down list the desiredARQ Number. Following values will be displayed.

• Part I• Part II• Part III

User Name Person who is answering the ARQ question.Date Date on which person answered the ARQ question.Title Title of person, who is answering the ARQ question.

Answer Entry Portion

Field Name DescriptionQuestion Based on the ARQ Number, Question will be displayed. It is

display-only field.Answer Depending upon the response type, the Answer text area layout

will change. Explained with Following Example:

• For e.g. ARQ/Part – I (Page 4), for question no: 1, radiobutton group will appear, indicating choice between ‘YES’or ‘NO’.

• For e.g. ARQ/Part – I (Page 4), for question no: 1.1, tabularwindow will appear with two columns.

• For e.g. ARQ/Part – I (Page 5), for question no: 5.1, tabularwindow will appear with five rows.

Approving ARQ Answers

On clicking of menu tool bar, Pop-Up Screen will appear.

The screen accepts and displays the following fields:Field Name DescriptionAnswer number Answer number. It is display-only field.Answer serialnumber

For the given question, there can be many answers by differentusers. Each answer will be identified by answer number &serial number. It is display-only field.

Author Name Person who had answered the question. It is display-only field.Authorizer choice Authorizing authority can authorize answer by choosing from

drop-down list his choice.Drop-down list will have following values:

• Yes• No

Note: Once the ARQ answer is approved, user cannot delete ARQ answer.

Page 88: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 88/97

Print ARQ Questions

• This report will be printed from Recording of Questions Screen.• Sort Order:

• Question Number• ARQ Part• ARQ Section

The report will print following fields:Field Name DescriptionARQ Number ARQ NumberSection Number Section NumberQuestion Number Question NumberSub Question Number Sub Question NumberQuestion Text 1 to 5 Questions Text will be printedResponse Type Applicable response type will be printed.Link to Details Link to DetailsLink to Question Link to QuestionComments Comments, if any, will be printed.

Print ARQ Answers

• Printing of ARQ Answers will be in the free format.

Recording of MLD Details (MLD)

The additional details, which needs to be captured, will be captured as an additionaltab folder to the substance master window. The present tab folders available in thesubstance master are:

• Language• General

The screen accepts and displays the following fields:

CND Names TAB Folder

Field Name DescriptionLanguage Code User can choose from the available drop down list the Language

Code.CND Names CND Name can be entered.Comments User can enter Comments, if any.

Chemical Diagram TAB Folder

Field Name DescriptionChemical Diagram For the UDF Code, Chemical Diagram will be displayed.

Page 89: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 89/97

Trade Names & Other Details TAB Folder

Field Name DescriptionTrade Names Different trade names can be entered for the substance code.

Same substance can have more than one trade name.Molecular Weight Molecular Weight for the given substance.Chemical Formula Applicable Chemical Formula for the given substance.

Screen / Query for MLD on NET/WEB

This screen will facilitate in querying information for the substance related to MLD.User needs to give any or all of the following criteria. Based on this criterion detailscreen will appear, displaying MLD details.

The screen accepts and displays the following fields:

Field Name DescriptionSubstance Name User can enter one or more of substance names.CND Names User can enter one or more of CND names.Trade Names User can enter one or more of Trade names.Based on the above criterion, following details will be displayed.Chemical Diagram For the given substance, Chemical Diagram (Picture/BLOB) will

be displayed.Trade Name(s) For the given substance, one or more than one Trade Names will

be displayed. It is display-only field.Molecular Weight Molecular Weight for the given substance will be displayed. It is

display-only field.Chemical Formula Chemical Formula for the given substance will be displayed. It is

display-only field.

Recording of Preference Window (Parameters)

Preference screen will be additional screen to Parameters Module.

This screen will facilitate in recording for each user of NDS his/her preference inrelation to Country Code, Competent Authority, Establishment etc. The informationcaptured will be used by setting preferences for Forms, Import/Export Documents &Individual Seizures.

The screen accepts and displays the following fields:

Field Name DescriptionUser id User defined Unique User Id for the NDS usage.Competent AuthorityCode

User can choose from the available drop down list CompetentAuthority Code.

Competent Authority Based on the chosen Competent Authority Code, Competent

Page 90: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 90/97

Field Name DescriptionName Authority Name will be displayed. It is display-only field.Country Code User can choose from the available drop down list the Country

Code.Country Name Based on the chosen Country Code, Country Name will be

displayed. It is display-only field.Establishment Code User can choose from the available drop down list the

Establishment Code.Establishment Name Based on the chosen Establishment Code, Establishment

Name will be displayed. It is display-only field.License Period General License validity period. This will be in terms of

months. User will enter for e.g. 3,6,9 etc.Note:Based on the entered license period, EMM module will calculateexpiry date (To-Date), by adding license period to system date.

Reports

Print Group Master

• This report will be printed from Group Master Maintenance Screen.• Report will be printed in order of Group Codes.

The report will print following fields:

Field Name DescriptionGroup Code Group CodeGroup Name Name of the GroupSub Group Code Sub Group Code

Print License Type Master

• This report will be printed from License Type Master Screen.• Report will be printed in order of License Type Code.• Sort order:

• License Type

The report will print following fields:Field Name DescriptionLicense Type Code License Type CodeLanguage Code Language CodeLicense Description Description for License Type.Comments Comments, if any will be printed.

Page 91: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 91/97

Print a License Request

• This report will be printed from using License Request Screen.• Sort order:

• Establishment Code• License Request Number

The report will print following fields:

Field Name DescriptionLicense RequestNumber

License Request Number

License RequestDate

License Request Date

License ValidityDate

License Validity Date – From Date & To Date

Country Name Corresponding to License Request Number, the Country Namewill be printed.

Establishment Name Corresponding to License Request Number, the EstablishmentName will be printed.

Competent AuthorityName

Corresponding to License Request Number, the CompetentAuthority Name will be printed.

License Type Corresponding to License Request Number, the License TypeName will be printed.

Remarks Corresponding to License Request Number, if Any will beprinted.

EAN Code EAN Code for the establishment.SubstanceCode/PreparationCode/Group Name

Corresponding to License Request Number, SubstanceCode/Preparation Code/Group Name will be printed.

Requested LicenseQuantity

Corresponding to License Request Number, Requested LicenseQuantity, for each substance or preparation or Group will beprinted.

Print a License Authorization

• This report will be printed using License Authorization Screen.• Sort order:

• Establishment Code• License Number

The report will print following fields:

Field Name DescriptionLicense RequestNumber

License Request Number

License Number License NumberLicense Approve License Approval Date

Page 92: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 92/97

Field Name DescriptionDateLicense ValidityDate

Approved License Validity Date – From Date & To Date

Country Name Corresponding to License Number, the Country Name will beprinted.

EstablishmentName

Corresponding to License Number, the Establishment Name willbe printed.

EstablishmentAddress

Corresponding to Establishment Name, the Establishment addresswill be printed.

CompetentAuthority Name

Corresponding to License Number, the Competent Authority Namewill be printed.

License Type Corresponding to License Number, the License Type Name will beprinted.

Remarks Corresponding to License Number, Remarks, if Any will beprinted will be printed.

SubstanceCode/PreparationCode/Group Name

Corresponding to License Number, Substance Code/PreparationCode/Group Name will be printed.

Approved LicenseQuantity

Corresponding to License Number approved License Quantity, foreach substance or preparation or Group will be printed.

Revocation Date Date on which license was revoked.Reason ofRevocation

Reason of Revocation will be printed.

Page 93: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 93/97

Print Stock Ledger

• This report will be printed from tab of Establishment Management Screen..• This screen will facilitate in printing stock ledger for given establishment,

substance/preparation code & year.• Sort Order:

• Preparation Code/Substance Code• Establishment Management stock ledger print flag• Transaction Date

The report will print following fields:Field Name DescriptionEstablishment Name Establishment Name, for which stock ledger will be printed.Substance/Preparation Name

Establishment Name, for which stock ledger will be printed.

Year Year, for which stock ledger will be printed. Default year will bedefault year.

Transaction Date Transaction DateSerial Number For a given date, there can be many transactions, for the same

type. Serial Number will indicate the transaction number for thedate.

EMM TransactionDescription

Description of various transactions. For e.g.• Consumed• Procured/Withdrawn• MFG – Non Psychotropic• Exempted Preparation (MFG)• Used For Preparation• Destroyed• Losses• Import/Export• Domestic Purchase• Domestic sale• Opening Stock• Closing Stock

Trading CountryName

Trading Country Name will be printed for Internationalimport/export type of transaction.

TradingEstablishment Name

Trading Establishment Name will be printed for Internationalimport/export type and Domestic Purchase/Sale type oftransaction.

Quantity Quantity for the transaction. Depending upon the transaction type,quantity can indicate +ve or –ve.

Remarks/Comments Remarks/Comments, if any will be printed.Document ReferenceNumber

Document Reference Number applicable to Internationalimport/export type and Domestic Purchase/Sale type oftransaction.

Page 94: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 94/97

Print Inspection Details

• This report will be printed from Establishment Management Screen.• Inspection details entered by users can be printed.• Report will be printed for an establishment for a given competent

authority.• Sort Order:

• Inspection Date• Preparation Code/Substance Code

The report will print following fields:

Field Name DescriptionInspection Number Inspection Number for the given Establishment & Country.Inspection Date Date on which Inspection was carried out by Competent

Authority.Inspecting AuthorityName

Name of the Person, who had carried out inspection.

Substance/Preparation Code

Substance/Preparation Code

Substance/Preparation Name

Name corresponding to Substance/Preparation Code

Unit of Measurement Unit of Measurement corresponding to Substance/PreparationCode

Declared Quantity Quantity declared for the given Substance/Preparation Code byEstablishment.

Inspection Quantity Quantity intended for inspection for the givenSubstance/Preparation Code by Inspecting Authority.

Actual Quantity Actual Quantity after inspection found.Comments Remarks, if any will be printed.

Page 95: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 95/97

6. Assumptions, Constraints and RisksAssumptions

• We assume that requirements which are stated or implied in this document whenincorporated into the proposed software / application / solution / service, is heldlegal and does not contradict with any and all regulatory requirements in thecountries of execution and /or implementation.

Constraints• None

Risks• None

Page 96: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD.DOC page : 96/97

7. Acceptance CriteriaRefer to Annex 11

Page 97: Rewrite of National Database System United Nations International … · Requirement Analysis & Preliminary Design Document UNDCP NDS-32 02/25/2000 /17:42 ver.1.0.1 Doc. Id: RNRP1

Datamatics Ltd.Requirement Analysis & Preliminary Design Document

UNDCPNDS-32

02/25/2000 /1

Annexesi. Data Model for new modules being added to the National Database System in

7:42 ver.1.0.1 Doc. Id: RNRP1 softcopy : RNRAPD

Version 4.0.0 (covers Multilingual Dictionaand Establishment Management Module)

ii. Navigational Guidelines to be used for Natiii. Annual Reports Questionnaire response typiv. PowerBuilder coding standardsv. Oracle® Application Server stored proceduvi. Oracle® stored procedure coding standardsvii. Corel® WordPerfect coding standardsviii. Microsoft® Word coding standardsix. Examples covering stock movements for esx. Minutes of Meetings conducted during info

development of National Database System xi. Acceptance Criteria

.DOC page : 97/97

ry, Annual Reports Questionnaire

ional Database System version 4.0.0e details.

re coding standards

tablishment management module.rmation gathering process for theversion 4.0.0

Maher A Abu Ghali
The below lines in blue are links to the prespective documents.

Recommended