2014 CPR Integration

(1)

(2)

1. Configuration Guide for WorkZone Content

Server CPR Integration 2014

This guide describes how you configure WorkZone Content Server and integrate with a service delivering CPR on-line information.

The purpose of this guide is to ensure correct configuration of the CPR integration with WorkZone Content Server.

The target audience is technicians responsible for the configuration of CPR integration with WorkZone Content Server.

RELATED PRODUCT DOCUMENTATION

WorkZone Content Server Database Installation Guide WorkZone Content Server CPR Batch Configuration Guide

SCANJOUR LINKS

View PDF version ScanJour website ScanJour support ScanJour on

(4)

2. What's new

2014

l This guide is now online and available from theScanJour Documentation site. To view or print a PDF version, clickView PDF versionin the table of contents.

l OFF1 is not supported in WorkZone Content Server 2014. 2013

l Updated for ScanJour WorkZone Content Server 2013

l ScanJour Captia has been replaced with WorkZone Content Server throughout the document.

2013 SP1

(5)

3. About CPR Integration

The Danish Ministry of Interior Affairs and Health's Central Office of Civil Registration (the CPR-kontoret/CPR-Office), located under the Ministry of Interior Affairs and Health's Department, is in charge of the Danish Civil Registration System and functions as the main supplier of basic personal information to public authorities and the private sector.

The CPR-Office has the responsibility for the content, maintenance and development of the Danish Civil Registration System, whileCRS1facilitates the operation of the system.

THE DANISH CIVIL REGISTRATION SYSTEM

The centralized civil register (CRS) is a nationwide civil register in Denmark whose purpose is to administrate the personal identification number system, to administrate general personal data reported from the national registration offices to the CRS, and to forward personal data in a technically/economically suitable manner in accordance with the Registers Act and the legislation governing civil registration.

CPR DIREKTE

For use in peer-to-peer communication from a customer’s administrative system to the CRS, the CPR-Office has developed an application calledCPR Direkte(CPR Direct). When you send a transaction from your administrative system with identification information to the CRS, you get relevant data in response from the CRS.

SUBSCRIPTION

WithCPR Direktethe user can make a “subscription” to a person. This means that the user is informed, when the data of a person changes. For example, when the person’s name is changed, the person is changing residence or dies.

CPR KLIENT

CPR Klient(CPR Client) integrates WorkZone Content Server withCPR Direkteand is implemented in WorkZone Content Server using the standard module Import Manager. This module is configured to import data into WorkZone Content Server.

CPR BATCH

CPR Batch is an application module that handles CRS subscriptions in batch mode, see CPR Batch Configuration Guide.

1_{The Danish Civil Registration System (CRS), in Danish called CPR, is a nationwide civil register whose purpose is}

to administrate the personal identification number system and to administrate general personal data reported from the national registration offices to the CRS.

(6)

4. Prerequisites

To use the CPR Integration, the customer must have a contract with the hosting service provider (CSC) to be able to extract data from the CRS system. CSC is the hosting service provider for theCPR-Office1and delivers an application (CprDirekte_V180.exe) used in connection with the installation of the application CPR Klient. The application CPR Klient is configured with the required parameters (user name, and so on) according to the signed contract.

It is required that WorkZone Content Server is prepared for using the CRS integration including custom label and so on. Furthermore, you need access to the WorkZone Content Server

installation and the contract with CSC. In this contract you will find the required configuration information concerning CPR port, CPR IP, CPR transaction code (CPR Trans. kode), custom number, user id, and password.

SERVICE OPERATION

You can launch the CPR Klient application in two ways:

l As an ordinary application with a visible user interface. l As a NT service.

When the application is running as a service, it is only visible in the Services window. It will be automatically started or stopped along with the PC.

Important:You must choose whether to run the application as an ordinary application or as a NT-service. They cannot run simultaneously.

1_{The Danish Ministry of Interior Affairs and Health's Central Office of Civil Registration (the}

CPR-kontoret/CPR-Office) is in charge of the Danish Civil Registration System (CRS) and functions as the main supplier of basic personal information to public authorities and the private sector.

(7)

5. Configure CRS Connection

This procedure describes how you configure the connection between WorkZone Content Server and the CRS using WorkZone Configuration Management.

You must apply the parametersIP andDefFiles. Regarding the compatibility with earlier versions of WorkZone Content Server, the parameterSubscription is introduced in connection with subscription.

HOW TO CONFIGURE THE CRS CONNECTION

1. SelectStart>Configuration Management. TheWorkZone Configuration Managementwindow displays.

2. SelectOperation>External Sources. TheScanJour Configuration

Management - Module: External Sourceswindow displays where you can see the configurations for the external data sources.

3. FindCPRin theNamecolumn.

4. In theParameterscolumn, enter the following: IP=<IP Address>:<Port no.>;

DefFiles=.\CPRkilde\P12170.*;Subscription=0; Assembly=Scanjour.CPRDriver;

Class=Scanjour.ImportManager.CPRDriver

IP indicates the IP address for the internal connection for the CPR integration. Subscription=0 indicates that there is no subscription added to the persons (default value). If the parameterSubscription is not included in the parameter string, then it corresponds toSubscription=0.

Subscription=1 indicates, that subscription is added to the persons.

4. Click the empty field to the left of theNamecolumn, and selectDatabase>Save. The information is stored, and the connection between WorkZone Content Server and CRS is defined.

(8)

6. Test of the CRS Integration

TEST FROM THE CPR KLIENT

1. SelectStart>All Programs>CPR Klient>CPR Klient. TheCPR Klient window displays.

2. ClickTest. TheCPR Klientwindow displays with a string containing codes and the textForbindelse og login er OK, if the configuration is correct.

The first four characters in the string indicate the CRS customer number (kunde nr.). In the example above, it is 0132.

Character position 15-22 indicates the user id (Bruger-ID). In the example above, it is WUADIR34.

The next 2 positions contain the error message from CPR Direkte. If two characters 00 are returned there, as in the example above, then the connection is established and the login is correct.

The last 4 characters indicate the length of string. In the example above, it is 0028. 3. ClickOK. The test is completed.

(9)

TEST FROM A BROWSER

1. Start a browser and use the following syntax for the address: http://<database>/workzone/app/captia/testkilder.htm

where<database>is the name of the WorkZone Content Server database. For example:http://db01/workzone/app/captia/testkilder.htm. TheTest af ImportManager-kilderwindow displays.

2. Enter a CPR number in the fieldSearch person using CPR no., and clickSearch. TheResultat af søgning i eksternt registerwindow displays.

The result of the search is that the name of the person is shown, which indicates that the connection to the CRS is available.

(10)

3. Return to the website Test af ImportManager-kilder with the address http://<database>/workzone/app/captia/testkilder.htm.

4. Enter a CPR number (without hyphen) in the fieldImporter CPRnr fra

skyggeregisteret[import CPR no. from shadow register] and clickImporter. The following website with a summary displays.

Note: The Shadow register is a temporary storage, where the incoming information is stored temporarily.

(11)

7. The CRS Integration in Captia Web Client

This procedure describes how the integration is made visible in the Captia Web Client. The CRS integration is seen as a menu item, for instance when adding parties to a case.

INTEGRATE CRS IN THE CAPTIA WEB CLIENT

1. Start Captia Web Client in a browser with address http://<server>/workzone/app/captia. 2. Select an appropriate case.

3. SelectMere... > Parter[More…> Parties], and thenTilføj til liste[Add to list]. The Tilknyt parter [Add parties] window displays with the menu item CPR. 4. Fill in theKode [Code]field with a CPR number (with a hyphen) and click onCPR. 5. TheScanJour Captia -- Web Page Dialogwindow displays.

(12)

8. OFF4 mapping information from CRS

The following table shows how the OFF4 record types from CRS are mapped into WorkZone Content Server.

The use of different styles and fonts in the table below: l Boldtypeface is used for field names.

l Monospacing font is used for words to be typed in exactly as they appear.

l <Italics in angle brackets>are used for words to be substituted. This means that name2 = <surname> is interpreted as the field name2 holds the surname of a person. For example, you type Jensen in the field name2, whereas text = <full name> means that you must enter the full name, for instance, Karl Bay Jensen.

CPR OFF4 document number

Field in WorkZone Content Server

001 Register = contact name_type= C

name_code=<CPR number> 008 name1=<first name, middle name> 008 name2=<surname>

001 Group name = contact_info custom_label = GældendePNR info=<CPR number>

001 Group name = contact_date custom_label = Fødselsdag date=<date of birth> 001 Group name = contact_info

custom_label = Køn info= M|K

001 Group name = contact_date custom_label = Statusfra date=<status date> 001 _{Group name = contact_info}

custom_label = Status info=<status code>

(13)

001 If statuskode = 90, then the person is dead, and end_date is filled in. end_date =<status date>

001 position=<occupation> 003 text=<full name>

003 _{Group name = address, restrictor = HA} address1=<street name house number> 003 Group name = address

address2=<locality> 003 Group name = address

address3=<care of name> 003 Group name = address

municipality=<municipality code> 003 Group name = address

If landekod = 5100 then country_code= DK 003 Group name = address

postcode=<postcode> 002 Group name = address

start_date=<date for moving in> 004 _{Group name = address}

protection=<date for start of protection of information>

003 _{If the address of the person already exists in WorkZone Content Server, and it} is different from the received address, then existing (that is, primary) address is considered to be invalid, and the following is inserted:

address_type= CPRADR

end_date=<date for moving in>

(that is, the end_date for the old address is equal to start_date for the new address)

003 Group name = contact_info custom_label = Bynavn

(14)

003 Group name = contact_info custom_label = Postdist info=<post district> 016 _{Group name = contact_date}

custom_label = Umyndig

date=<date where legal guardians has been appointed to the person> If the date for appointing legal guardians to the person is blank in the received record, then any former legal guardian attachment is removed.

009 Group name = contact_info custom_label = Fødregkode

info=<authority code for place of birth> 009 _{Group name = contact_info}

custom_label = Fødreg.myn. info=<place of birth> 012 _{Group name = contact_info}

custom_label = Civilstand

info=<marital status, civilstand i form af G> 012 Group name = contact_date

custom_label = Civst.fra date=<wedding date> 012 custom_label = Ægtefælle

A case relation is created for the spouse through name_ref_key Group name = part

name_type= C

name_code=<CPR number of spouse>

If the spouse is not registered in WorkZone Content Server, then the following is inserted:

name1= Person med cprnr<CPR number of spouse> name2= - ikke importeret

(15)

015 A case relation is created for the father through name_ref_key Group name = part, restrictor = Forældre

If the CPR number of the father is present in the received record: name_type= C

name_code=<CPR number of father>

If the CPR number of the father is not present in WorkZone Content Server, then the following information is added:

name1= Person med cprnr<CPR number of father> name2= - ikke importeret

If the name of the father is present in the received record: name_type= P

name1=<name of father>

If the name of the father is not present in WorkZone Content Server, then the following information is added:

name2= Far til<CPR number of person> text= Person fra CPR uden cprnr

015 A case relation is created for the mother throughname_ref_key Group name = part, restrictor = Forældre

If the CPR number of the mother is present in the received record: name_type= C

name_code=<CPR number of mother>

If the CPR number of the mother is not present in WorkZone Content Server, then the following information is added:

name1= Person med cprnr<CPR number of mother> name2= - ikke importeret

If the name of the mother is present in the received record: name_type= P

(16)

If the name of the mother is not present in WorkZone Content Server, then the following information is added:

name2= Mor til<CPR number of person> text= Person fra CPR uden cprnr

017 custom_label = Værge

A case relation is created for the guardian throughname_ref_key If reltyp = 1:

Group name = part name_type= C

name_code=<CPR number of guardian>

016 If the CPR number of the guardian is not present in WorkZone Content Server, then the following information is added:

name1= Person med cprnr<CPR number of guardian> name2= - ikke importeret

If reltyp = 2:

Group name = part, restrictor = Værge name_type= P

name1=<name of guardian>

If the name of the guardian is not present in WorkZone Content Server the following information is added:

name2= Værge til<CPR number of person> text= Person fra CPR uden cprnr

(17)

9. Troubleshooting

In case of errors, check the following prerequisites:

l Is CPR Direkte up and running with the correct password and other parameters? l Is the CPR client application installed and running?

l Is the WorkZone Content Server database configured to handle the CRS integration? l Are there problems with firewalls or other programs blocking the connections between the

(18)

10. Terms and conditions

INTELLECTUAL PROPERTY RIGHTS

This document is the property of ScanJour. The data contained herein, in whole or in part, may not be duplicated, used or disclosed outside the recipient for any purpose other than to conduct business and technical evaluation. This restriction does not limit the recipient’s right to use information contained in the data if it is obtained from another source without restriction. DISCLAIMER

This document is intended for informational purposes only. Any information herein is believed to be reliable. However, ScanJour assumes no responsibility for the accuracy of the

information. ScanJour reserves the right to change the document and the products described without notice. ScanJour and the authors disclaim any and all liabilities.

ScanJour is a trademark used under license by ScanJour A/S. All other logos, trademarks and service marks are the property of the respective third parties.