Versioner sammenlignet

Nøgle

  • Linjen blev tilføjet.
  • Denne linje blev fjernet.
  • Formatering blev ændret.
Info

Metoder til flytning af dagtilbud inden for kommunen er nu på preproduktionsmiljøet og kan testes.

Metoder

MetodenavnReturnererBeskrivelseEksempel på kald af metode med XML data
HelloWorld()Hello <datostempel>Returnerer ”Hello <datostempel>” hvilket indikerer at services og database er oppe og at der er hul igennem IP/Grund/Ung.
GetXMLSchema(XmlschemaName)XML-SchemaDenne metode returnerer det navngivne skema, som xml-data forventes at overholde, når der overføres data fra de administrative systemer til servicen.Det anbefales, at leverandøren altid sikrer sig, at xml-data overholder det skema, der udstilles via GetXmlSchema, og validerer xml-data mod skemaet før overførelse til webservicen.
ValidateXmlAgainstSchema(XmlschemaName, XmlElement)ImportSvarXML

Denne metode validerer overførte XML data mod de nævnte schema. Der returneres enten et OK-svar, hvis schemaet validerer/parses korrekt, eller en liste med fejlmeddelelser. ValidateXmlAgainstSchema har alene til formål at teste XML data og opdaterer ikke data i registeret.


InsertDaginstitution(InsertDaginstitutionXML)ImportSvarXMLOpretter daginstitution i registeretinsertDaginstitution.xml
UpdateDaginstitution(UpdateDaginstitutionXML)ImportSvarXMLOpdaterer oplysninger på daginstitution i registeretupdateDaginstitution.xml
DeleteDaginstitution(DeleteDaginstitutionXML)ImportSvarXML

Sletter daginstitution i registeret

deleteDaginstitution.xml

InsertAnvisningsEnhed(InsertAnvisningsEnhedXML)

ImportSvarXMLOpretter anvisningsenhed i registeretinsertAnvisningsEnhed.xml
UpdateAnvisningsEnhed(UpdateAnvisningsEnhedXML)ImportSvarXMLOpdaterer oplysninger på anvisningsenhed i registeretupdateAnvisningsEnhed.xml
DeleteAnvisningsEnhed(DeleteAnvisningsEnhedXML)ImportSvarXML

Sletter anvisningsenhed i registeret

deleteAnvisningsEnhed.xml
InsertAlternativAdresse(InsertAlternativAdresseXML)ImportSvarXMLOpretter alternativadresse i registeretinsertAlternativAdresse.xml
UpdateAlternativAdresse(UpdateAlternativAdresseXML)ImportSvarXMLOpdaterer oplysninger på alternativadresse i registeretupdateAlternativAdresse.xml
DeleteAlternativAdresse(DeleteAlternativAdresseXML)ImportSvarXML

Sletter alternativadresse i registeret

deleteAlternativAdresse.xml
MoveAnvisningsEnhed(AnvisningsEnhedMoveXML)ImportSvarXMLFlytter en anvisningsenhed, med evt tilhørende alternativeadresser fra et daginstitution til et anden daginstition. Flytning er kun muligt indenfor samme (kommunale) administrative enhed.moveAnvisningsEnhed.xml
MoveAlternativAdresse(AlternativAdresseMoveXML)ImportSvarXMLFlytter en alternativadresse fra en anvisningsenhed til en anden anvisningsenhed . Flytning er kun muligt indenfor samme (kommunale) administrative enhed.moveAlternativAdresse.xml


XML-Schemaer

 Requesttype

XML-Schemanavn

BeskrivelseBeskrivelse

DeleteDaginstitutionXMLDagInstitutionDelete.xsdSchema til brug ved sletning af daginstitution
InsertDaginstitutionXMLDagInstitutionInsert.xsdSchema til brug ved oprettelse af daginstitution
UpdateDaginstitutionXMLDagInstitutionUpdate.xsdSchema til brug ved opdatering af daginstitution
InsertAnvisningsEnhedXMLAnvisningsEnhedInsert.xsdSchema til brug ved sletning af anvisningsenhed
DeleteAnvisningsEnhedXMLAnvisningsEnhedDelete.xsdSchema til brug ved sletning af anvisningsenhed
UpdateAnvisningsEnhedXMLAnvisningsEnhedUpdate.xsdSchema til brug ved sletning af anvisningsenhed
MoveAnvisningsEnhedXMLAnvisningsEnhedMove.xsdSchema til brug ved flytning af anvisningsenhed
DeleteAlternativAdresseXMLAlternativAdresseDelete.xsdSchema til brug ved sletning af alternativadresse
InsertAlternativAdresseXMLAlternativAdresseInsert.xsdSchema til brug ved oprettelse af alternativadresse
UpdateAlternativAdresseXMLAlternativAdresseUpdate.xsdSchema til brug ved opdatering af alternativadresse
MoveAlternativAdresseXMLAlternativAdresseMove.xsdSchema til brug ved flytning af alternativadresse

Responsetyper

ImportSvarXML

Anker
importsvarxml
importsvarxml

Standaliseret svar ved update, insert og delete metodekald i ImportService.


NavnBeskrivelseFormat
errorCountAntal fundne fejlHeltal
messageStatus på kaldet: OK eller ErrorTekst (max 5 tegn)
number

Det nye institutionsnummer. Kun aktuelt ved kalde af insertmetoder, ellers nil

Tekst( 6 tegn)
validationsErrorsListe med valideringsfejl af typen ValidationsError
validationsErrorValideringsfejl 
 errorMessageFejlmeddelelse  Tekst (max 132 tegn)
 errorType

 Fejltype:

     XmlValidationError - fejl ift XML-schema

     ValidationError - øvrige fejl

 Tekst (max 50 tegn)


Status: OK

Eksempel på et kald hvor en ny daginstitution oprettes og får tildelt nummer G16412:

Request:


<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:dag="http://www.stil.dk/dagtilbudsregister" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays"><soap:Header/>    
<soap:Body>      
<dag:InsertDaginstitution>         
<dag:xml>            
<InsertDaginstitution>               
<Daginstitution>                  
<DaginstitutionNavn>Blommehavens børnehus</DaginstitutionNavn>
                  <EjerformKode>1</EjerformKode>
                 <LovgrundlagKode>5</LovgrundlagKode>                  
<KommuneKode>101</KommuneKode>
             </Daginstitution>
        </InsertDaginstitution>         
</dag:xml>      
</dag:InsertDaginstitution>   
</soap:Body>
</soap:Envelope>

Response:

 <InsertDaginstitutionResponse xmlns="http://www.stil.dk/dagtilbudsregister">
         <InsertDaginstitutionResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <ErrorCount>0</ErrorCount>
            <Message>OK</Message>
            <Nummer>G16412</Nummer>
            <Schema>DagInstitutionInsert</Schema>
            <ValidationErrors/>
         </InsertDaginstitutionResult>
  </InsertDaginstitutionResponse>

Status: Error/Fejl

Systemet validerer data i to faser. I første fase valideres data mod det tilhørende XML-schema. Hvis der er fejl svares der med en eller flere validationError elementer med errorTypen "XmlvalidationError".

Eksempel på ikke validt kald med to XmlValidationError:

Request:

<updateAnvisningsEnhed xsi:schemaLocation="http://data.stil.dk/dagtilbudsregister/ AnvisningsEnhedUpdate.xsd" xmlns="http://data.stil.dk/dagtilbudsregister/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<anvisningsenhedsNummer>D10085</anvisningsenhedsNummer>
        <anvisningsenhed>
                <anvisningsenhedsNavn>a</anvisningsenhedsNavn>
               <instType3>A010</instType3>
                <email>a</email>
               <telefonNummer>a</telefonNummer>
               <pNummer>1017716367</pNummer>
               <vejNavn>Strandholms Alle</vejNavn>
               <husNummer>1</husNummer>
               <supplerendeBynavn xsi:nil="true"/>
               <postNummer>1650</postNummer>
               <kommuneKode>A456</kommuneKode>
               <etage xsi:nil="true"/>
               <doer xsi:nil="true"/>
       </anvisningsenhed>
</updateAnvisningsEnhed>


Response:

      <UpdateAnvisningsEnhedResponse xmlns="http://www.stil.dk/dagtilbudsregister">
         <UpdateAnvisningsEnhedResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <errorCount>2</errorCount>
            <message>schemaErrors</message>
            <number i:nil="true"/>
            <schema>AnvisningsEnhedUpdate</schema>
            <validationErrors>
               <validationError>
                  <errorMessage>Linje: 5 udløser fejlen: [The 'http://data.stil.dk/dagtilbudsregister/:instType3' element is invalid -
                                The value 'A010' is invalid according to its datatype 'Int' - The string 'A010' is not a valid Int32 value.]</errorMessage>
                  <errorType>XmlvalidationError</errorType>
               </validationError>
               <validationError>
                  <errorMessage>Linje: 13 udløser fejlen: [The 'http://data.stil.dk/dagtilbudsregister/:kommuneKode' element is invalid -
                                The value 'A456' is invalid according to its datatype 'Int' - The string 'A456' is not a valid Int32 value.]</errorMessage>
                  <errorType>XmlvalidationError</errorType>
               </validationError>
            </validationErrors>
         </UpdateAnvisningsEnhedResult>
      </UpdateAnvisningsEnhedResponse>

Hvor der er fundet datatypefejl på felterne kommuneKode og instType3.


I anden fase valideres for mere komplekse fejl, som validering mod det officielle adresseregister mm. Hvis der er fejl svares der med en eller flere validationError elementer med errorTypen "validationError".
Fase to gennemføres kun såfremt der ikke er fundet fejl under fase et. I nedenstående tabel vises en komplet liste over mulige fejl af typen "validationError.

Typer af ValidationError

errorMessageMetoderBeskrivelse

Unknown dagInstitutionsNummer (100)

UpdateDaginstitutionDet anførte daginsititutionsnummer findes ikke dagtilbudsregisteret

Unknown code in admKommunekode (101)

UpdateDaginstitution,
InsertDaginstitution
Ukendt kommunekoden, jævnfør den officielle kommunekodeliste  

Unable to delete record. Unknown dagInstitutionsNummer  (102)

DeleteDaginstitutionDet anførte daginsititutionsnummer findes ikke dagtilbudsregisteret

Unable to delete record. The dagInstitutionsNummer is
referenced by anvisningEnheder (103)

DeleteDaginstitutionDaginstitutionen kunne ikke slettes, idet den refereres til af underliggende anvisningsenheder. De underliggende anvisningsenheder skal slettes før daginstitutionen kan slettes.
Unable to delete record. Unknown anvisningsEnhedsNummer (104)DeleteAnvisningsEnhedDet anførte anvisningsenhedsNummer findes ikke dagtilbudsregisteret

Unable to delete record. The anvisningsEnhedsNummer is
referenced by alternativeAdresse (105)

DeleteAnvisningsEnhedAnvisningsenheden kunne ikke slettes, idet den refereres til af underliggende alternativeadresser. De underliggende alternativeadresser skal slettes før anvisningsenheden kan slettes.

Unable to delete record. Unknown alternativAdresseNummer (106)

DeleteAlternativAdresseDet anførte alternativAdresseNummer findes ikke dagtilbudsregisteret
Unknown code in kommunekode (107)

UpdateAnvisningsEnhed,
UpdateAlternativAdresse,
InsertAnvisningsEnhed,
InsertAlternativAdresse

Ukendt kommunekoden, jvænfør den officielle kommunekodeliste  

Unknown address (108)

UpdateAnvisningsEnhed,
UpdateAlternativAdresse,
InsertAnvisningsEnhed, InsertAlternativAdresse
Adressen er ikke gyldigt jævnfør https://dawa.aws.dk/. Kombinationen af vejNavn, husNummer, postNummer og kommuneKode) er forsøgt opslået i DAWA, men den var ikke valid.  
Unknown pNummer (109)

UpdateAnvisningsEnhed,
UpdateAlternativAdresse,
InsertAnvisningsEnhed,
InsertAlternativAdresse

Pnummeret valideres mod cvr-registeret, og denne fejl betyder at den angivne pnummer er ukendt eller nedlagt.

Unknown code in instType3 (110)

UpdateAnvisningsEnhed,
InsertAnvisningsEnhed
Ukendt institutionstype, se her  (indsæt link til liste)

Unknown anvisningsEnhedsNummer (111)

UpdateAnvisningsEnhed,
InsertAlternativAdresse 
Det anførte anvisningsenhedsNummer findes ikke dagtilbudsregisteret
Unknown alternativAdresseNummer (112)UpdateAlternativAdresseDet anførte alternativAdresseNummer findes ikke dagtilbudsregisteret
Wrong kommunekode in address (113)

UpdateAnvisningsEnhed,
UpdateAlternativAdresse,
InsertAnvisningsEnhed,
InsertAlternativAdresse

Den anførte Kommundekode stemmer ikke med den kommunkode der er fundet ved opslag af adressen i https://dawa.aws.dk/
Unable to move record. Unknown anvisningsEnhedsNummer (114)

MoveAnvisningsEnhed
MoveAlternativAdresse

Det anførte anvisningsenhedsNummer findes ikke dagtilbudsregisteret
Unable to move record. Unknown dagInstitutionsNummer (115)MoveAnvisningsEnhedDet anførte daginsititutionsnummer findes ikke dagtilbudsregisteret
Unable to move record. Different AdmKommuneNummer (116)

MoveAnvisningsEnhed
MoveAlternativAdresse

AdmKommuneNummer skal være identisk på daginstitutionesniveau for den enhed der flyttes fra og den enhed der flyttes til.
Unable to move record. Unknown alternativAdresseNummer (117)MoveAlternativAdresseDet anførte alternativAdresseNummer findes ikke dagtilbudsregisteret
Insufficient privileges for InstitutionNummer (201)Alle metoderDet i IPUNG anførte institutionsnummer har ikke rettigheder til at arbejde på den pågældende  administrative enhed
Unknown InstitutionNummer (202)Alle metoderUkendt institutionsnummer anført i IPUNG
Missing InstitutionNummer (203)Alle metoderDer mangler et institutionsnummer i kaldet fra IPUNG


Eksempel på ikke validt kald med en validationError:

Request:

<updateAlternativadresse>
<alternativadresseNummer>E10328</alternativadresseNummer>
        <alternativadresse>
         <alternativadresseNavn>adagfg</alternativadresseNavn>
                <pNummer>1017716367</pNummer>
                <vejNavn>Strandholms Alle</vejNavn>
                <husNummer>22</husNummer>
                <supplerendeBynavn xsi:nil="true"/>
                <postNummer>2650</postNummer>
                <kommuneKode>167</kommuneKode>
                <etage>1</etage>
                <doer>34</doer>
        </alternativadresse>
</updateAlternativadresse>

Response:

     <UpdateAlternativAdresseResponse xmlns="http://www.stil.dk/dagtilbudsregister">
         <UpdateAlternativAdresseResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <errorCount>1</errorCount>
            <message>error</message>
            <number i:nil="true"/>
            <schema>AlternativAdresseUpdate</schema>
            <validationErrors>
               <validationError>
                  <errorMessage>Unknown alternativAdresseNummer (112)</errorMessage>
                  <errorType>validationError</errorType>
               </validationError>
            </validationErrors>
         </UpdateAlternativAdresseResult>
      </UpdateAlternativAdresseResponse>

Hvor requestet fejler, fordi der forsøges opdateres på et ukendt institutionsnummer  .