Zaak- en Documentservices

Michiel,

Ik heb alle wsdl's nagekeken en ik heb daarin (op basis van de best practices) het volgende waargenomen:

• In de naam van alle bestanden komt nog de term 'zs-dms' voor. Dit is nog een overerving van toen deze bestanden in de berichtcatalogus 'zs-dms' van zkn0310 stonden. Dit is dus niet correct. Hier zou eigenlijk de naam van de folder 'berichten' moeten komen te staan maar lees eerst maar de volgende opmerkingen;
• Wat mij opvalt is dat je alle type messages in 1 schema hebt staan en dus niet onderverdeeld over meerdere schema's welke weer in diverse berichtcatalogi staan. Dit is wel de bedoeling;
• Datzelfde geldt eigenlijk ook voor de complexTypes en simpleTypes in het schema 'zds0120_msg_stuf_zs-dms.xsd'. Verdeel deze over de te creëren berichtencatalogi;
• De bestanden 'zds0120_ent_zs-dms.xsd' en 'zds0120_simpletypes_zs-dms.xsd' staan ook op de verkeerde plaats. De complexTypes en simpleTypes in deze bestanden zijn geen basis complexTypes en simpleTypes en horen dus ook niet in de folder 'entiteiten' thuis. Deze moeten over de diverse berichtencatalogi verspreid worden;
• In de wsdl's onderken je een verschil in 'zds0120_ontvangAsynchroon_mutatie_zs-dms.wsdl' en 'zds0120_ontvangAsynchroon_overdragen_zs-dms.wsdl'. Even 'zs-dms' negerend zou dat moeten betekenen dat je ook beschikt over de berichtcatalogi 'mutatie' en 'overdragen' waarover de beide wsdl's verdeeld worden;
• De best practices schrijven voor dat een wsdl met 'beantwoordVraag' in de naam in de berichtcatalogus 'vraagAntwoord' komen te staan. In de naam van dit bestand komt de naam van de berichtcatalogus NIET terug.
• De wsdl 'zds0120_vrijeBerichten_zs-dms.wsdl' moet ook in een aparte berichtcatalogus komen te staan en 'zs-dms' moet dus vervangen worden door de naam van die catalogus.
• Er dienen dus enkele berichtcatalogi aangemaakt te worden. Te weten 'vraagAntwoord', 'mutatie', 'overdragen' en een voor de vrijeberichten en de bestanden dienen daarover verspreid te worden. Ik heb dit even uitgewerkt in het bijgevoegde zip bestand. Het is echter alleen om je een beeld te geven van de folder structuur en welke bestanden je daarin aan zou kunnen treffen. Kijk dus niet naar de inhoud van die bestanden. Het verdelen van de verschillende complexTypes en simpleTypes over de verschillende bestanden laat ik aan jou over. Ook kan het zijn dat niet alle bestanden die ik nu heb aangemaakt ook daadwerkelijk moeten worden aangemaakt. Dat is natuurlijk afhankelijk van het feit of er complexTypes en/of simpleTypes voor de betreffende berichtcatalogus bestaan. Lees evt. ook even paragraaf 3.4 van de Best Practices over Services. Lees ook even paragraaf 5.3. Daarin staat dat de foldernaam 'zds0120' eigenlijk vervangen zou moeten worden door 'zkn0310_zds0120'. Het is echter een best practice dus je mag er van afwijken en persoonlijk zou ik dit op dit punt doen.

Inhoudelijk heb ik ook even naar de WSDL's gekeken en het volgende waargenomen. Sommige opmerkingen hebben mogelijk ook nog gevolgen voor de folderstructuur welk ik hierboven al heb doorlopen:

• In allemaal is de appinfo incorrect. Deze geeft nl. aan dat deze onderdeel uitmaakt van de zkn0310 namespace terwijl ze juist onderdeel zijn van de zds0120 namespace. Ook de andere gegevens in de appinfo kloppen volgens mij niet. De patchversie is immers niet 25, de patchdatum moet aangepast worden aan de datum waarop je deze patch gaat publiceren en ik aangezien ik vermoed dat in sommige bestanden ook de xs:documentation zal worden aangepast moet ook de schemaversie worden aangepast.

Vanwege andere activiteiten heb ik de inhoudelijke check even stopgezet, deze wordt later vervolgd.

Michiel kan er idd mee aan de slag maar ik ben nog niet helemaal klaar met mijn review.

Overigens goed om te weten dat een aantal van de huidige best practice straks, als we de schema's gaan genereren, niet meer van toepassing zijn. Er wordt immers per koppelvlak maar 1 schema gegenereerd en ik neem aan dat we de inhoud van dat schema niet handmatig gaan spreiden over meerdere schema's.