639.4 Forbedret synkronitet til eksterne bookingsystemer

639.4 639.4 Forbedret synkronitet til eksterne bookingsystemer
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
(Skabelon af dato 14/02-2017)

STAR Projektleder (PL)Forretningsanalytiker (FA)STAR ReleaseEpic statusEksterne snitflader
Niels Freiberg (STAR)Jesper Brunholm2017-21.0Andre, Eksterne bookingsystemer


Indholdsfortegnelse
1 Ændringslog
2 Afgrænsning af epic
3 Oversigt over berørte web services
4 Beskrivelse af epic
4.1 639.4.1 ExternalBookingService v3 understøtter id for en reserveret tid
4.1.1 GetBookingDetails
4.1.2 CreateBooking
4.1.3 RescheduleBooking
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories


Ændringslog

Dato

Version

Forfatter

Berørte afsnit

17.02.2017

0.1

Jesper Brunholm

Epic oprettet med snitflader. Klar til PO- og teknisk review

17.02.2017

0.1

Jesper Brunholm

Mindre rettelser ifm. teknisk review.

20.02.2017

0.3

Jesper Brunholm

BookingIdentifier medsendes som optionelt felt i GetBookingDetails request i forbindelse med ombookninger. Løftet til version 0.3, klar til tilsagn

20.02.2017

0.3

Jesper Brunholm

Ingen forretningsmæssige ændringer.

07.03.2017

0.5

Jesper Brunholm

GetBookingDetailsRequest: InterviewOptionID er gjort optionelt
Løftes til 0.5 og blanket for ændringsmarkeringer.

09.03.2017

0.5

Jesper Brunholm

Fejlkoder afklarede i afsnit 4.1. Overskrifter omdøbte for bedre overblik

28.04.2017

1.0

Jesper Brunholm

Løftet til 1.0. Udvikling og dokumentation er gennemført.

Afgrænsning af epic

Afgrænsning



Som udstiller af et eksternt bookingsystem vil jeg have mulighed for at bruge id til at genkende en reserveret tid i brug af GetBookingDetails og efterfølgende endelig oprettelse eller ændring af booking



Acceptkriterier



Nr.

Beskrivelse

Relevant for Beskriver hvilke af STARs leverandører som skal løse dette acceptkriterie


639.4.1

Metoderne GetBookingDetails, CreateBooking og RescheduleBooking understøtter samlet id for en reserveret tid

DFDG, Eksterne Bookingsystemer



Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader

Berørte acceptkriterier







Bemærkninger



639.4.1

Acceptkriterie <nr.>

Acceptkriterie <nr.>

Acceptkriterie <nr.>

Acceptkriterie <nr.>

Acceptkriterie <nr.>

Acceptkriterie <nr.>




Eksterne Bookingsystemer skal give tilsagn til at bruge denne version 3 af servicen i 2017-2

X





















Oversigt over berørte web services

Snitflade

Serviceaftager der er berørt








Bemærkninger



DFDG

Jobnet

Plannersystemer

KSS

A-kasse

Ydelsessystem

JobKon

Andet




ExternalBookingService (Version 3)

X


X









Beskrivelse af epic

Denne epic til denne ISB: <Navn> <link>
Der etableres et Id som indgår i hele servicedialogen imellem DFDG og ExternalBookingService for at opnå en stærkere integration til brugen af GetBookingDetails.
Id'et BookingIdentifier findes allerede i GetBookingDetails, men medsendes pt. Ikke i CreateBooking og RescheduleBooking. Det er denne medsending som er ændringen.
De principielt set overflødige felter, vil først blive udfaset i en kommende release da det er for sent i 2017-2 at tage denne del af opgaven ind.

639.4.1 Metoderne GetBookingDetails, CreateBooking og RescheduleBookingExternalBookingService v3 understøtter id for en reserveret tid

Metoderne GetBookingDetails, CreateBooking og RescheduleBooking.

ExternalBookingService Version 3. GetBookingDetails

BookingIdentifier medsendes i GetBookingDetails response som hidtil, men nu også som optionelt felt i request i forbindelse med ombookninger. Fuld snitflade vist herunder for fuldt overblik.
Der bygges videre på ExternalBookingService v2 med en ny version.
Signaturforklaring: felter med grøn baggrund er nye eller ændrede. Felter med grå baggrund vil udgå ved næste version. Felter med rød (forekommer ikke her) udgår.

GetBookingDetailsRequest

Element

Type

Detaljer

Forekomst

Beskrivelse

GetBookingDetailsRequest

GetBookingDetailsRequestType


1


-    PersonCivilRegistrationIdentifier

PersonCivilRegistrationIdentifierType Base: string

Pattern: ((((0[1-9]

1[0-9]

2[0-9]

3[0-1])(01

03

05

07

08

10

12))

((0[1-9]

1[0-9]

2[0-9]

30)(04

06

09

11))

((0[1-9]

1[0-9]

2[0-9])(02)))[0-9]{6})

0000000000

1

PersonnummerForkortet beskrivelse i epic af praktiske årsager, skal ikke ændres i WSDL

-    BookingIdentifier

GUID


0-1

Unikt id (GUID) for bookingen som medsendes når der er tale om en ombookning

-    BookingStartTime

dateTime


1

Starttidspunkt for bookingen

-    InterviewOptionID

guid Base: string

Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12}

0-1

Identifikation af et online tilbud med GUID. ID skal anvendes ved efterfølgende forespørgsler i selvbook flowet.

-    CaseWorkerIdentifier

CaseWorkerIdentifierType Base: string

Length: 1-255

0 - 1

Sagsbehandler-id

-    IsImmediateBooking

boolean


1

Indikerer om der er tale om en straksbookingDenne feltbeskrivelse tilføjes til alle forekomster af IsImmediateBooking i ExternalBookingService.

InterviewOptionID er optionelt for at understøtte ombookningssituationen (her har DFDG ikke et InterviewOptionID til rådighed). Hvis DFDG ikke sender korrekt ID til situationen forventes EksterntBookingSystem at returner fejl 7044 - Id is empty.

GetBookingDetailsResponse

Element

Type

Detaljer

Forekomst

Beskrivelse

GetBookingDetailsResponse

GetBookingDetailsResponseType


1


-    ExternalBookingDetails

ExternalBookingDetailsType


1

Typen indeholder information tilknyttet en booking, det værende nyoprettet eller ombooket. Informationer anvendes af DFDG til dels at persistere informationen i DFDG og dels til at generere WSRM beskederne

        BookingIdentifier

guid Base: string

Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12}

1

Unikt id for bookingen (guid)

        GroupBookingIdentifier

guid Base: string

Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12}

0 - 1

Skal angives for fællesmøder

        PersonCivilRegistrationIdentifier

PersonCivilRegistrationIdentifierType Base: string

Pattern: ((((0[1-9]

1[0-9]

2[0-9]

3[0-1])(01

03

05

07

08

10

12))

((0[1-9]

1[0-9]

2[0-9]

30)(04

06

09

11))

((0[1-9]

1[0-9]

2[0-9])(02)))[0-9]{6})

0000000000

1

PersonnummerForkortet beskrivelse i epic af praktiske årsager, skal ikke ændres i WSDL

        RebookingPossible

boolean


1

Kan der ombookes for dette mødetilbud

        RebookingDeadline

dateTime


0 - 1

Obligatorisk hvis RebookingPossible er sat til true

        CancellationPossible

boolean


1

Kan der aflyses på dette mødetilbud

        CancellationDeadline

dateTime


0 - 1

Sluttidsdpunkt for borgers aflysningsmulighed

        BookingStartTime

dateTime


1

Starttidspunkt for bookingen

        BookingEndTime

dateTime


1

Sluttidspunktet for bookingen

        InterviewTypeIdentifier

InterviewTypeIdentifierType


1

Angiver hvilken samtaletype der skal afholdes

        InterviewFormTypeIdentifier

InterviewFormTypeIdentifierType


1

Angiver om det er et fælles eller individuelt møde.

        InterviewContactTypeIdentifier

InterviewContactTypeIdentifierType


1

Angiver afholdelsesformen, dvs. om mødet skal være personligt fremmøde, telefonisk osv.

        MeetingTitle

MeetingTitleType Base: string

Length: 1-100

1

Mødetitel. Vises på Jobnet

        MeetingDescription

MeetingDescriptionType Base: string

Length: 0-500

0 - 1

Beskrivelse til møde med dagsorden og uddybende information. Vises på Jobnet

        InterviewSupervisor

CaseWorkerStructureType


1

Ansvarlig sagsbehandler som står for mødet

        -    CaseWorkerGivenName

PersonGivenNameType Base: string

Length: 1-50

1

Sagsbehandlerens fornavn.

        -    CaseWorkerMiddleName

PersonMiddleNameType Base: string

Length: 1-40

0 - 1

Sagsbehandlerens mellemnavn.

        -    CaseWorkerSurname

PersonSurnameNameType Base: string

Length: 1-40

1

Sagsbehandlerens efternavn.

        -    CaseWorkerIdentifier

CaseWorkerIdentifierType Base: string

Length: 1-255

1

Sagsbehandler-id

        InterviewLocationDetail

InterviewLocationDetailType


0 - 1

Information om hvor mødet skal afholdes

        -    InterviewLocationDescription

InterviewLocationDescriptionType Base: string

Length: 1-200

0 - 1

Adresse for mødets afholdelse

        -    AddressPostal

AddressPostalType


0 - 1


                MailDeliverySublocationIdentifier

MailDeliverySublocationIdentifierType Base: string

Length: 1-34

0 - 1

The given name of a farm, estate, building or dwelling, which is used as a additional postal address identifier.

                StreetName

StreetNameType Base: string

Length: 1-40

1

The approved name of a road, a street, a square, a path and the like. Further more street names can be connected to other particularly limited areas like garden associations or summer residence areas without road network, large commercial or institutional areas with a large number of buildings, smaller islands without road network, larger sporting facilities and the like.

                StreetNameForAddressingName

StreetNameForAddressingNameType Base: string

Length: 1-20

0 - 1

An abbreviation of streetname. The street name for adressing is reported in case the street name is above 20 positions. For names up to 20 positions the street name for addressing is the same as the street name. The street name for adressing is among other things used on items of mail.

                StreetBuildingIdentifier

StreetBuildingIdentifierType Base: string

Pattern: ([1-9]

[1-9][0-9]

[1-9][0-9]{2})

([1-9][A-Z]

[1-9][0-9][A-Z]

[1-9][0-9]{2}[A-Z])

1

Numeric identification (da: house number ~ 'husnummer') including an optional letter, which identifies a certain access to a building, a plot/piece of land or a plant etc. based on the named road or street which gives access hereto. The identifier is determined in increasing numerical and letter order along the road, normally with even numbers on the right side and odd numbers on the left side of the road.

                FloorIdentifier

FloorIdentifierType Base: string

Pattern: [1-9]

[1-9][0-9]

KL

ST

kl

st

k[2-9]

K[2-9]

0 - 1

Identification which describes the floor or level on which a specific entrance door, appartment or suite is placed, in the staircase refered to.

                SuiteIdentifier

SuiteIdentifierType Base: string

Length: 1-4

0 - 1

Identification which describes the location of a specific entrance door on a floor or level (repos) in the staircase referred to.

                DistrictSubdivisionIdentifier

DistrictSubdivisionIdentifierType Base: string

Length: 1-34

0 - 1

Name of a village, city or subdivision of a city or district, which is determined as a part of the official address specification for a certain street or specific parts of a street, defined by intervals of street building identifiers (da: house numbers).

                PostOfficeBoxIdentifier

PostOfficeBoxIdentifierType Base: integer

MinInclusive: 1 MaxInclusive: 9999

0 - 1

Declaration of a Post Office Box.

                PostCodeIdentifier

PostCodeIdentifierType Base: string

Pattern: [0-9]{4}

1

The postal departments nationwide postal code.

                DistrictName

DistrictNameType Base: string

Length: 1-20

1

Declares the name of a postal district in plain text. The field contains 20 positions, which enables it to fit a window envelope together with the postal code and one free position in addition. The postal district is defined by municipalitycode, roadcode, postalcode, housenumber from/to together with a code, which declares whether the roadsection in question contains even or uneven housenumbers.

                CountryIdentificationCode

CountryIdentificationCodeType Base: _CountryIdentificationCodeType


0 - 1

Landeidentifikations kode baseret på de 4 forskellige formater.

                -    BaseType

CountryIdentificationCodeType _Base: string

Pattern: [a-z,A-Z]{2}

[a-z,A-Z]{3}

[0-9]{3}

[0-9]{4}

1

Dette er en støttetype til CountryIdentificationCodeType. Det regulære udtryk er et valg for de 4 forskellige regulære udtryk for de forskellige formater. ISO 3166 standard, alpha 2: [a-z,A-Z]{2}. Eksempel "DK" for Danmark. ISO 3166 standard, alpha 3: [a-z,A-Z]{3}. Eksempel "DKN" for Danmark. UN Statistics Divisions country codes: [0-9]{3}. Eksempel "208" for Danmark AuthorityCode from the Central Office of Civil Registration: [0-9]{4}. Eksempel "5100" for Danmark.

        InterviewContactDetail

InterviewContactDetailType


0 - 1

Angiver detaljer om mødet når det ikke er med personligt fremmøde

        -    DigitalContactIdentifier

DigitalContactIdentifierType Base: string

Length: 0-255

0 - 1

Kontaktinformation hvis mødet er digitalt

        -    PhoneNumber

TelephoneNumberIdentifierType Base: string

Pattern: (+)?[0-9]{3,20}

0 - 1

Vil være udfyldt med vejlederens telefonnummer, alternativt hovednummer til jobcenter. Skal angives, hvis det er borger, der skal ringe.

        -    ShouldCitizenCall

boolean


0 - 1

Angiver hvorvidt borgeren skal ringe i forbindelse med et telefonisk møde.

        ShowInterviewSupervisor

boolean


1

Afgør om InterviewSupervisor-Name skal vises på Jobnet


Fejlkoder på GetBookingDetails

Fejlkode

Fejltekst

Beskrivelse

1014

Failed to validate message

The submitted message could not be validated

4767

The booking has already been taken

The booking has already been taken

4768

The submitted BookingIdentifier is unknown to the system

The submitted BookingIdentifier is unknown to the system

4783

The BookingTime cannot be before todays date

The BookingTime cannot be before todays date

4812

The booking does not allow selfbooking

The booking does not allow selfbooking

4819

The BookingStartTime is no longer available

The BookingStartTime is no longer available

4822

Could not find the caseworker with the specified CVR-RID

Could not find the caseworker with the specified CVR-RID

7044

Id is empty

Id is empty

8107

The BookingIdentifier does not correspond to the person civil registration identifier

The BookingIdentifier does not correspond to the person civil registration identifier

8109

The booking time is NOT within the allowed range of dates for this interview option

The booking time is NOT within the allowed range of dates for this interview option

8111

An error occured when trying to look up the supplied PersonCivilRegistrationIdentifier

An error occured when trying to look up the supplied PersonCivilRegistrationIdentifier

9003

The interview supervisor specified is not allowed for this interview option

The interview supervisor specified is not allowed for this interview option

9130

The Booking can not be rescheduled or cancelled by the citizen because it is an immediate booking

The Booking can not be rescheduled or cancelled by the citizen because it is an immediate booking


ExternalBookingService version 3. CreateBooking

BookingIdentifier tilføjet til request. Response er uændret, men vil ved en kommende release blive ændret til blot at være en ServiceReceipt.

CreateBookingRequest

Element

Type

Detaljer

Forekomst

Beskrivelse

CreateBookingRequest

CreateBookingRequestType


1


-    PersonCivilRegistrationIdentifier

PersonCivilRegistrationIdentifierType Base: string

Pattern: ((((0[1-9]

1[0-9]

2[0-9]

3[0-1])(01

03

05

07

08

10

12))

((0[1-9]

1[0-9]

2[0-9]

30)(04

06

09

11))

((0[1-9]

1[0-9]

2[0-9])(02)))[0-9]{6})

0000000000

1

PersonnummerForkortet beskrivelse i epic af praktiske årsager, skal ikke ændres i WSDL

-    BookingIdentifier

guid Base: string

Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12}

1

Unikt id for bookingen (guid)

-    BookingStartTime

dateTime


1

Starttidspunkt for bookingen

-    InterviewOptionID

guid Base: string

Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12}

1

Identifikation af et online tilbud med GUID. ID skal anvendes ved efterfølgende forespørgsler i selvbook flowet.

-    CaseWorkerIdentifier

CaseWorkerIdentifierType Base: string

Length: 1-255

0 - 1

Sagsbehandler-id

-    IsImmediateBooking

boolean


1


Felterne med grå baggrund: BookingStartTime, InterviewOptionID, CaseWorkerIdentifier og IsImmediateBooking kan udgå, men vil først gøre det ved en senere release.

CreateBookingResponse

Uændret.

Element

Type

Detaljer

Forekomst

Beskrivelse

CreateBookingResponse

CreateBookingResponseType


1


-    ExternalBookingDetails

ExternalBookingDetailsType


1

Typen indeholder information tilknyttet en booking, det værende nyoprettet eller ombooket. Informationer anvendes af DFDG til dels at persistere informationen i DFDG og dels til at generere WSRM beskederne

        BookingIdentifier

guid Base: string

Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12}

1

Identifier for booking (guid)

        GroupBookingIdentifier

guid Base: string

Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12}

0 - 1

Skal angives for fællesmøder

        PersonCivilRegistrationIdentifier

PersonCivilRegistrationIdentifierType Base: string

Pattern: ((((0[1-9]

1[0-9]

2[0-9]

3[0-1])(01

03

05

07

08

10

12))

((0[1-9]

1[0-9]

2[0-9]

30)(04

06

09

11))

((0[1-9]

1[0-9]

2[0-9])(02)))[0-9]{6})

0000000000

1

PersonnummerForkortet beskrivelse i epic af praktiske årsager, skal ikke ændres i WSDL

        RebookingPossible

boolean


1

Kan der ombookes for dette mødetilbud

        RebookingDeadline

dateTime


0 - 1

Obligatorisk hvis RebookingPossible er sat til true

        CancellationPossible

boolean


1

Kan der aflyses på dette mødetilbud

        CancellationDeadline

dateTime


0 - 1

Sluttidsdpunkt for borgers aflysningsmulighed

        BookingStartTime

dateTime


1

Starttidspunkt for bookingen

        BookingEndTime

dateTime


1

Sluttidspunktet for bookingen

        InterviewTypeIdentifier

InterviewTypeIdentifierType


1

Angiver hvilken samtaletype der skal afholdes

        InterviewFormTypeIdentifier

InterviewFormTypeIdentifierType


1

Angiver om det er et fælles eller individuelt møde.

        InterviewContactTypeIdentifier

InterviewContactTypeIdentifierType


1

Angiver afholdelsesformen, dvs. om mødet skal være personligt fremmøde, telefonisk osv.

        MeetingTitle

MeetingTitleType Base: string

Length: 1-100

1

Mødetitel. Vises på Jobnet

        MeetingDescription

MeetingDescriptionType Base: string

Length: 0-500

0 - 1

Beskrivelse til møde med dagsorden og uddybende information. Vises på Jobnet

        InterviewSupervisor

CaseWorkerStructureType


1

Ansvarlig sagsbehandler som står for mødet

        -    CaseWorkerGivenName

PersonGivenNameType Base: string

Length: 1-50

1

Sagsbehandlerens fornavn.

        -    CaseWorkerMiddleName

PersonMiddleNameType Base: string

Length: 1-40

0 - 1

Sagsbehandlerens mellemnavn.

        -    CaseWorkerSurname

PersonSurnameNameType Base: string

Length: 1-40

1

Sagsbehandlerens efternavn.

        -    CaseWorkerIdentifier

CaseWorkerIdentifierType Base: string

Length: 1-255

1

Sagsbehandler-id

        InterviewLocationDetail

InterviewLocationDetailType


0 - 1

Information om hvor mødet skal afholdes

        -    InterviewLocationDescription

InterviewLocationDescriptionType Base: string

Length: 1-200

0 - 1

Adresse for mødets afholdelse

        -    AddressPostal

AddressPostalType


0 - 1


                MailDeliverySublocationIdentifier

MailDeliverySublocationIdentifierType Base: string

Length: 1-34

0 - 1

The given name of a farm, estate, building or dwelling, which is used as a additional postal address identifier.

                StreetName

StreetNameType Base: string

Length: 1-40

1

The approved name of a road, a street, a square, a path and the like. Further more street names can be connected to other particularly limited areas like garden associations or summer residence areas without road network, large commercial or institutional areas with a large number of buildings, smaller islands without road network, larger sporting facilities and the like.

                StreetNameForAddressingName

StreetNameForAddressingNameType Base: string

Length: 1-20

0 - 1

An abbreviation of streetname. The street name for adressing is reported in case the street name is above 20 positions. For names up to 20 positions the street name for addressing is the same as the street name. The street name for adressing is among other things used on items of mail.

                StreetBuildingIdentifier

StreetBuildingIdentifierType Base: string

Pattern: ([1-9]

[1-9][0-9]

[1-9][0-9]{2})

([1-9][A-Z]

[1-9][0-9][A-Z]

[1-9][0-9]{2}[A-Z])

1

Numeric identification (da: house number ~ 'husnummer') including an optional letter, which identifies a certain access to a building, a plot/piece of land or a plant etc. based on the named road or street which gives access hereto. The identifier is determined in increasing numerical and letter order along the road, normally with even numbers on the right side and odd numbers on the left side of the road.

                FloorIdentifier

FloorIdentifierType Base: string

Pattern: [1-9]

[1-9][0-9]

KL

ST

kl

st

k[2-9]

K[2-9]

0 - 1

Identification which describes the floor or level on which a specific entrance door, appartment or suite is placed, in the staircase refered to.

                SuiteIdentifier

SuiteIdentifierType Base: string

Length: 1-4

0 - 1

Identification which describes the location of a specific entrance door on a floor or level (repos) in the staircase referred to.

                DistrictSubdivisionIdentifier

DistrictSubdivisionIdentifierType Base: string

Length: 1-34

0 - 1

Name of a village, city or subdivision of a city or district, which is determined as a part of the official address specification for a certain street or specific parts of a street, defined by intervals of street building identifiers (da: house numbers).

                PostOfficeBoxIdentifier

PostOfficeBoxIdentifierType Base: integer

MinInclusive: 1 MaxInclusive: 9999

0 - 1

Declaration of a Post Office Box.

                PostCodeIdentifier

PostCodeIdentifierType Base: string

Pattern: [0-9]{4}

1

The postal departments nationwide postal code.

                DistrictName

DistrictNameType Base: string

Length: 1-20

1

Declares the name of a postal district in plain text. The field contains 20 positions, which enables it to fit a window envelope together with the postal code and one free position in addition. The postal district is defined by municipalitycode, roadcode, postalcode, housenumber from/to together with a code, which declares whether the roadsection in question contains even or uneven housenumbers.

                CountryIdentificationCode

CountryIdentificationCodeType Base: _CountryIdentificationCodeType


0 - 1

Landeidentifikations kode baseret på de 4 forskellige formater.

                -    BaseType

CountryIdentificationCodeType _Base: string

Pattern: [a-z,A-Z]{2}

[a-z,A-Z]{3}

[0-9]{3}

[0-9]{4}

1

Dette er en støttetype til CountryIdentificationCodeType. Det regulære udtryk er et valg for de 4 forskellige regulære udtryk for de forskellige formater. ISO 3166 standard, alpha 2: [a-z,A-Z]{2}. Eksempel "DK" for Danmark. ISO 3166 standard, alpha 3: [a-z,A-Z]{3}. Eksempel "DKN" for Danmark. UN Statistics Divisions country codes: [0-9]{3}. Eksempel "208" for Danmark AuthorityCode from the Central Office of Civil Registration: [0-9]{4}. Eksempel "5100" for Danmark.

        InterviewContactDetail

InterviewContactDetailType


0 - 1

Angiver detaljer om mødet når det ikke er med personligt fremmøde

        -    DigitalContactIdentifier

DigitalContactIdentifierType Base: string

Length: 0-255

0 - 1

Kontaktinformation hvis mødet er digitalt

        -    PhoneNumber

TelephoneNumberIdentifierType Base: string

Pattern: (+)?[0-9]{3,20}

0 - 1

Vil være udfyldt med vejlederens telefonnummer, alternativt hovednummer til jobcenter. Skal angives, hvis det er borger, der skal ringe.

        -    ShouldCitizenCall

boolean


0 - 1

Angiver hvorvidt borgeren skal ringe i forbindelse med et telefonisk møde.

        ShowInterviewSupervisor

boolean


1

Afgør om InterviewSupervisor-Name skal vises på Jobnet

Fejlkoder ¤Under afklaring

Fejlkode

Fejltekst

Beskrivelse

1014

Failed to validate message

The submitted message could not be validated

4783

The BookingTime cannot be before todays date

The BookingTime cannot be before todays date

4819

The BookingStartTime is no longer available

The BookingStartTime is no longer available

8108

The specified InterviewOptionID is not active or is unknown to the system

The specified InterviewOptionID is not active or is unknown to the system

8109

The booking time is NOT within the allowed range of dates for this interview option

The booking time is NOT within the allowed range of dates for this interview option

8111

An error occured when trying to look up the supplied PersonCivilRegistrationIdentifier

An error occured when trying to look up the supplied PersonCivilRegistrationIdentifier

9003

The interview supervisor specified is not allowed for this interview option

The interview supervisor specified is not allowed for this interview option

ExternalBookingService version 3. RescheduleBooking

Request og response er uændret. Ved en kommende release vil response blive ændret til blot at være en ServiceReceipt.

RescheduleBookingRequest

Element

Type

Detaljer

Forekomst

Beskrivelse

RescheduleBookingRequest

RescheduleBookingRequestType


1


-    PersonCivilRegistrationIdentifier

PersonCivilRegistrationIdentifierType Base: string

Pattern: ((((0[1-9]

1[0-9]

2[0-9]

3[0-1])(01

03

05

07

08

10

12))

((0[1-9]

1[0-9]

2[0-9]

30)(04

06

09

11))

((0[1-9]

1[0-9]

2[0-9])(02)))[0-9]{6})

0000000000

1

PersonnummerForkortet beskrivelse i epic af praktiske årsager, skal ikke ændres i WSDL

-    BookingIdentifier

guid Base: string

Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12}

1

Identifier for booking (guid)

-    BookingStartTime

dateTime


1

Starttidspunkt for bookingen

-    CaseWorkerIdentifier

CaseWorkerIdentifierType Base: string

Length: 1-255

0 - 1

Sagsbehandler-id

RescheduleBookingResponse

Uændret.

Element

Type

Detaljer

Forekomst

Beskrivelse

RescheduleBookingResponse

RescheduleBookingResponseType


1


-    ExternalBookingDetails

ExternalBookingDetailsType


1

Typen indeholder information tilknyttet en booking, det værende nyoprettet eller ombooket. Informationer anvendes af DFDG til dels at persistere informationen i DFDG og dels til at generere WSRM beskederne

        BookingIdentifier

guid Base: string

Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12}

1

Identifier for booking (guid)

        GroupBookingIdentifier

guid Base: string

Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12}

0 - 1

Skal angives for fællesmøder

        PersonCivilRegistrationIdentifier

PersonCivilRegistrationIdentifierType Base: string

Pattern: ((((0[1-9]

1[0-9]

2[0-9]

3[0-1])(01

03

05

07

08

10

12))

((0[1-9]

1[0-9]

2[0-9]

30)(04

06

09

11))

((0[1-9]

1[0-9]

2[0-9])(02)))[0-9]{6})

0000000000

1

PersonnummerForkortet beskrivelse i epic af praktiske årsager, skal ikke ændres i WSDL

        RebookingPossible

boolean


1

Kan der ombookes for dette mødetilbud

        RebookingDeadline

dateTime


0 - 1

Obligatorisk hvis RebookingPossible er sat til true

        CancellationPossible

boolean


1

Kan der aflyses på dette mødetilbud

        CancellationDeadline

dateTime


0 - 1

Sluttidsdpunkt for borgers aflysningsmulighed

        BookingStartTime

dateTime


1

Starttidspunkt for bookingen

        BookingEndTime

dateTime


1

Sluttidspunktet for bookingen

        InterviewTypeIdentifier

InterviewTypeIdentifierType


1

Angiver hvilken samtaletype der skal afholdes

        InterviewFormTypeIdentifier

InterviewFormTypeIdentifierType


1

Angiver om det er et fælles eller individuelt møde.

        InterviewContactTypeIdentifier

InterviewContactTypeIdentifierType


1

Angiver afholdelsesformen, dvs. om mødet skal være personligt fremmøde, telefonisk osv.

        MeetingTitle

MeetingTitleType Base: string

Length: 1-100

1

Mødetitel. Vises på Jobnet

        MeetingDescription

MeetingDescriptionType Base: string

Length: 0-500

0 - 1

Beskrivelse til møde med dagsorden og uddybende information. Vises på Jobnet

        InterviewSupervisor

CaseWorkerStructureType


1

Ansvarlig sagsbehandler som står for mødet

        -    CaseWorkerGivenName

PersonGivenNameType Base: string

Length: 1-50

1

Sagsbehandlerens fornavn.

        -    CaseWorkerMiddleName

PersonMiddleNameType Base: string

Length: 1-40

0 - 1

Sagsbehandlerens mellemnavn.

        -    CaseWorkerSurname

PersonSurnameNameType Base: string

Length: 1-40

1

Sagsbehandlerens efternavn.

        -    CaseWorkerIdentifier

CaseWorkerIdentifierType Base: string

Length: 1-255

1

Sagsbehandler-id

        InterviewLocationDetail

InterviewLocationDetailType


0 - 1

Information om hvor mødet skal afholdes

        -    InterviewLocationDescription

InterviewLocationDescriptionType Base: string

Length: 1-200

0 - 1

Adresse for mødets afholdelse

        -    AddressPostal

AddressPostalType


0 - 1


                MailDeliverySublocationIdentifier

MailDeliverySublocationIdentifierType Base: string

Length: 1-34

0 - 1

The given name of a farm, estate, building or dwelling, which is used as a additional postal address identifier.

                StreetName

StreetNameType Base: string

Length: 1-40

1

The approved name of a road, a street, a square, a path and the like. Further more street names can be connected to other particularly limited areas like garden associations or summer residence areas without road network, large commercial or institutional areas with a large number of buildings, smaller islands without road network, larger sporting facilities and the like.

                StreetNameForAddressingName

StreetNameForAddressingNameType Base: string

Length: 1-20

0 - 1

An abbreviation of streetname. The street name for adressing is reported in case the street name is above 20 positions. For names up to 20 positions the street name for addressing is the same as the street name. The street name for adressing is among other things used on items of mail.

                StreetBuildingIdentifier

StreetBuildingIdentifierType Base: string

Pattern: ([1-9]

[1-9][0-9]

[1-9][0-9]{2})

([1-9][A-Z]

[1-9][0-9][A-Z]

[1-9][0-9]{2}[A-Z])

1

Numeric identification (da: house number ~ 'husnummer') including an optional letter, which identifies a certain access to a building, a plot/piece of land or a plant etc. based on the named road or street which gives access hereto. The identifier is determined in increasing numerical and letter order along the road, normally with even numbers on the right side and odd numbers on the left side of the road.

                FloorIdentifier

FloorIdentifierType Base: string

Pattern: [1-9]

[1-9][0-9]

KL

ST

kl

st

k[2-9]

K[2-9]

0 - 1

Identification which describes the floor or level on which a specific entrance door, appartment or suite is placed, in the staircase refered to.

                SuiteIdentifier

SuiteIdentifierType Base: string

Length: 1-4

0 - 1

Identification which describes the location of a specific entrance door on a floor or level (repos) in the staircase referred to.

                DistrictSubdivisionIdentifier

DistrictSubdivisionIdentifierType Base: string

Length: 1-34

0 - 1

Name of a village, city or subdivision of a city or district, which is determined as a part of the official address specification for a certain street or specific parts of a street, defined by intervals of street building identifiers (da: house numbers).

                PostOfficeBoxIdentifier

PostOfficeBoxIdentifierType Base: integer

MinInclusive: 1 MaxInclusive: 9999

0 - 1

Declaration of a Post Office Box.

                PostCodeIdentifier

PostCodeIdentifierType Base: string

Pattern: [0-9]{4}

1

The postal departments nationwide postal code.

                DistrictName

DistrictNameType Base: string

Length: 1-20

1

Declares the name of a postal district in plain text. The field contains 20 positions, which enables it to fit a window envelope together with the postal code and one free position in addition. The postal district is defined by municipalitycode, roadcode, postalcode, housenumber from/to together with a code, which declares whether the roadsection in question contains even or uneven housenumbers.

                CountryIdentificationCode

CountryIdentificationCodeType Base: _CountryIdentificationCodeType


0 - 1

Landeidentifikations kode baseret på de 4 forskellige formater.

                -    BaseType

CountryIdentificationCodeType _Base: string

Pattern: [a-z,A-Z]{2}

[a-z,A-Z]{3}

[0-9]{3}

[0-9]{4}

1

Dette er en støttetype til CountryIdentificationCodeType. Det regulære udtryk er et valg for de 4 forskellige regulære udtryk for de forskellige formater. ISO 3166 standard, alpha 2: [a-z,A-Z]{2}. Eksempel "DK" for Danmark. ISO 3166 standard, alpha 3: [a-z,A-Z]{3}. Eksempel "DKN" for Danmark. UN Statistics Divisions country codes: [0-9]{3}. Eksempel "208" for Danmark AuthorityCode from the Central Office of Civil Registration: [0-9]{4}. Eksempel "5100" for Danmark.

        InterviewContactDetail

InterviewContactDetailType


0 - 1

Angiver detaljer om mødet når det ikke er med personligt fremmøde

        -    DigitalContactIdentifier

DigitalContactIdentifierType Base: string

Length: 0-255

0 - 1

Kontaktinformation hvis mødet er digitalt

        -    PhoneNumber

TelephoneNumberIdentifierType Base: string

Pattern: (+)?[0-9]{3,20}

0 - 1

Vil være udfyldt med vejlederens telefonnummer, alternativt hovednummer til jobcenter. Skal angives, hvis det er borger, der skal ringe.

        -    ShouldCitizenCall

boolean


0 - 1

Angiver hvorvidt borgeren skal ringe i forbindelse med et telefonisk møde.

        ShowInterviewSupervisor

boolean


1

Afgør om InterviewSupervisor-Name skal vises på Jobnet


Fejlkoder ¤Under afklaring

Fejlkode

Fejltekst

Beskrivelse

1014

Failed to validate message

The submitted message could not be validated

4767

The booking has already been taken

The booking has already been taken

4768

The submitted BookingIdentifier is unknown to the system

The submitted BookingIdentifier is unknown to the system

4783

The BookingTime cannot be before todays date

The BookingTime cannot be before todays date

8107

The BookingIdentifier does not correspond to the person civil registration identifier

The BookingIdentifier does not correspond to the person civil registration identifier

9130

The Booking can not be rescheduled or cancelled by the citizen because it is an immediate booking

The Booking can not be rescheduled or cancelled by the citizen because it is an immediate booking




Overvej for hvert acceptkriterie hvilke systemer der berøres af ændringen:

  • DFDG
    • Services
    • WSRMer
    • Kodelister
  • Jobnet
  • VITAS
  • JobKon
  • JobAG
  • BI integrationsplatform
  • Kommunalt sagsbehandlingssystem
  • A-kasse sagsbehandlingssystem
  • Kommunalt bookingsystem
    • Planner
  • Kommunalt ydelsessystem
  • LSS (Landssupportsystem)


Særlige krav til test

Testscenarie

Berørte systemområder

Identificeret af







Kendte udeståender fra udviklingsfasen

Link til søgeresultat fra FogBugz på epic-nummer:

User stories

User stories er kun til interne brug for STAR's leverandører.