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)
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 |
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 | 1 | Angiver hvilken samtaletype der skal afholdes | ||||||||||||||||||||||
InterviewFormTypeIdentifier | 1 | Angiver om det er et fælles eller individuelt møde. | ||||||||||||||||||||||
InterviewContactTypeIdentifier | 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 | 1 | Angiver hvilken samtaletype der skal afholdes | ||||||||||||||||||||||
InterviewFormTypeIdentifier | 1 | Angiver om det er et fælles eller individuelt møde. | ||||||||||||||||||||||
InterviewContactTypeIdentifier | 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 | 1 | Angiver hvilken samtaletype der skal afholdes | ||||||||||||||||||||||
InterviewFormTypeIdentifier | 1 | Angiver om det er et fælles eller individuelt møde. | ||||||||||||||||||||||
InterviewContactTypeIdentifier | 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.