com.gmcb.plandk2.server

Class Pdk2Ws

java.lang.Object

com.gmcb.plandk2.server.Pdk2Ws

All Implemented Interfaces:

Pdk2WsInterface

public class Pdk2Ws
extends java.lang.Object
implements Pdk2WsInterface

Field Summary

Fields

Modifier and Type	Field and Description
Pdk3Ws	pdk3Ws

Constructor Summary

Constructors

Constructor and Description
Pdk2Ws()

Method Summary

Modifier and Type	Method and Description
java.lang.String	addSubscriber(java.lang.String user, java.lang.String pwd, int areaNodeId, int featureType, java.lang.String email, java.lang.String firstName, java.lang.String lastName, java.lang.String organization, boolean required) Tilføj email-abonnent til område-node for given feature-type.
java.lang.String	addUserPrivilege(java.lang.String user, java.lang.String pwd, java.lang.String targetUser, int featureType, int areaNodeId, int privilegeMask) Tilføj adgangsrettigheder for en bruger for given feature-type under given område-node.
java.lang.String	changeSubscriber(java.lang.String user, java.lang.String pwd, int areaNodeId, int featureType, java.lang.String targetEmail, java.lang.String email, java.lang.String firstName, java.lang.String lastName, java.lang.String organization, boolean required) Ændring af email-abonnent til område-node for given feature-type.
java.lang.String	changeUser(java.lang.String user, java.lang.String pwd, java.lang.String targetUser, java.lang.String newUserName, java.lang.String newPwd, java.lang.String firstName, java.lang.String lastName, java.lang.String email, java.lang.String organization) Ændring af en eksisterende bruger med tilhørende personoplysninger.
java.lang.String	createUser(java.lang.String user, java.lang.String pwd, java.lang.String targetUser, java.lang.String targetPwd, int areaNodeId, java.lang.String firstName, java.lang.String lastName, java.lang.String email, java.lang.String organization) Opret ny bruger under given område-node.
java.lang.String	deleteFeature(java.lang.String user, java.lang.String pwd, int featureType, java.lang.String featureId) Slet senest opdaterede version af Plan-feature af given type og ID.
java.lang.String	deleteUser(java.lang.String user, java.lang.String pwd, java.lang.String targetUser) Nedlæg bruger og alle vedkommendes adgangsrettigheder.
java.lang.String	deleteUserPrivilege(java.lang.String user, java.lang.String pwd, java.lang.String targetUser, int featureType, int areaNodeId, int privilegeMask) Fjern adgangsrettigheder for en bruger for given feature-type under given område node.
java.lang.String	getAccessKey(java.lang.String user, java.lang.String pwd, java.lang.String clientIP) Hent en accessKey til brug for en anden klient's kald til getCredentials.
java.lang.String	getAreaInfo(java.lang.String user, java.lang.String pwd, int areaNodeId, boolean includeChildren) Hent XML-streng med definition af node eller node-struktur for given område-node.
java.lang.String	getAreaInfoWithPrivileges(java.lang.String user, java.lang.String pwd, int areaNodeId, boolean includeChildren, java.lang.String targetUser, int featureType) Hent XML-streng med definition af hvilke adgangsrettigheder der findest til en given område-node eller given område-node-struktur for given bruger og feature-type.
java.lang.String	getAreaInfoWithSubscribers(java.lang.String user, java.lang.String pwd, int areaNodeId, boolean includeChildren, int featureType) Hent XML-streng med definition af hvilke email-abonnenter der findest til en given område-node eller given område-node-struktur for given feature-type.
java.lang.String	getAreaInfoWithUsers(java.lang.String user, java.lang.String pwd, int areaNodeId, boolean includeChildren) Hent XML-streng med definition af hvilke brugere der findes til en given område-node eller indenfor en given område-node-struktur.
java.lang.String	getAreaNodeTypes(java.lang.String user, java.lang.String pwd) Hent XML-streng med definitioner af hvilke område-node-typer systemet kender.
java.lang.String	getAreaTypes(java.lang.String user, java.lang.String pwd) Hent XML-streng med definitioner af hvilke område-typer systemet kender.
java.lang.String	getChildrenByParentId(java.lang.String user, java.lang.String pwd, int parentFeatureType, int childFeatureType, java.lang.String parentFeatureId, java.lang.String[] attributes) Hent GML-streng med senest opdaterede versioner af Plan-features af given type, som har en given moder-plan.
java.lang.String	getCredentials(java.lang.String accessKey) Hent brugernavn og password udfra en nøgle genereret af et forudgående kald til getAccessKey.
java.lang.String	getEmailInfo(java.lang.String user, java.lang.String pwd, int featureType, java.lang.String featureId) Hent XML dokument indeholdende info vedr.
java.lang.String	getFeatureAttributeInfo(java.lang.String user, java.lang.String pwd, int featureType, java.lang.String attributeName) Hent XML-streng med definition af en enkelt eller alle attributter for en feature.
java.lang.String	getFeatureAttributesByAdminCodes(java.lang.String user, java.lang.String pwd, int featureType, int[] adminCodes, java.lang.String[] attributes) Hent GML-streng med senest opdaterede versioner af Plan-features af given type, som tilhører et udvalg af administrative enheder (kommuner/områder).
java.lang.String	getFeatureByAdminCodes(java.lang.String user, java.lang.String pwd, int featureType, int[] adminCodes) Hent GML-streng med senest opdaterede versioner af Plan-features af given type, som tilhører et udvalg af administrative enheder (kommuner/områder).
java.lang.String	getFeatureById(java.lang.String user, java.lang.String pwd, int featureType, java.lang.String featureId) Hent GML-streng med senest opdaterede version af Plan-feature af given type og ID.
java.lang.String	getFeatureExtentById(java.lang.String user, java.lang.String pwd, int featureType, java.lang.String featureId) Hent geografisk ekstent for senest opdaterede version af Plan-feature af given type og ID.
java.lang.String	getFeatureWithinGeometry(java.lang.String user, java.lang.String pwd, int featureType, java.lang.String gml) Hent GML-streng med senest opdaterede versioner af Plan-features af given type, som er overlappet af geometri angivet i GML-streng.
java.lang.String	getNewFeatureId(java.lang.String user, java.lang.String pwd, int featureType) Hent et nyt ID til brug for oprettelse af ny Plan-feature af given type.
java.lang.String	getPlanTypes(java.lang.String user, java.lang.String pwd) Hent information over hvilke plan typer som SOAP snitfladen kan arbejde med.
java.lang.String	getProgramInfo(java.lang.String user, java.lang.String pwd) Returner XML-streng med information om indeværende version af kerne-system samt tilhørende database version.
javax.xml.ws.WebServiceContext	getServiceContext()
java.lang.String	getSubscribersByAdminCode(java.lang.String user, java.lang.String pwd, int featureType, int adminCode) Hent XML-streng med definition af hvilke email-abonnenter der findes til en given kommune for en given feature-type.
java.lang.String	removeSubscribers(java.lang.String user, java.lang.String pwd, int areaNodeId, int featureType, java.lang.String[] adresses) Fjern email-abonnenter fra given område-node for given feature-type.
java.lang.String	saveFeature(java.lang.String user, java.lang.String pwd, java.lang.String gml) Gem (opret/opdater) Plan-features i henhold til data indeholdt i GML-streng, og hvis moder-plan skifter status, så opdater evt.
java.lang.String	saveFeatureAndNotify(java.lang.String user, java.lang.String pwd, java.lang.String gml, java.lang.String[] adresses) Gem (opret/opdater) Plan-feature i henhold til data indeholdt i GML-streng, og hvis moder-plan skifter status, så opdater evt.
java.lang.String	saveFeatureValidate(java.lang.String user, java.lang.String pwd, boolean validateDraft, java.lang.String gml) Gem (opret/opdater) Plan-features i henhold til data indeholdt i GML-streng, og hvis moder-plan skifter status, så opdater evt.
java.lang.String	sendEmailByPlanId(java.lang.String user, java.lang.String pwd, int featureType, java.lang.String featureId, java.lang.String tilStatus, java.lang.String subject, java.lang.String body, java.lang.String[] includeAdresses, java.lang.String[] excludeAdresses) Send Email til abonnenter for en given plan.
java.lang.String	sendMail(java.lang.String to, java.lang.String bcc, java.lang.String subject, java.lang.String message) TODO: SKal flyttes/fjernes
java.lang.String	setPassword(java.lang.String user, java.lang.String pwd, java.lang.String newPwd)
java.lang.String	setUserPassword(java.lang.String user, java.lang.String pwd, java.lang.String targetUser, java.lang.String targetPwd) Ændrer password for en anden eksisterende bruger.
java.lang.String	testPlanStatusChange(java.lang.String user, java.lang.String pwd, int featureType, java.lang.String featureId, java.lang.String newState) Test om en given plan (og børneplaner) vil lade sig opdatere til den angivne status.
java.lang.String	validateGML(java.lang.String user, java.lang.String pwd, java.lang.String gml) Kontroller at GML-streng med Plan-features er valid i henhold til PlanDK2 XML-skemadefinitioner.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

pdk3Ws

public Pdk3Ws pdk3Ws

Constructor Detail

Pdk2Ws

public Pdk2Ws()

Method Detail

getServiceContext

public javax.xml.ws.WebServiceContext getServiceContext()

sendMail

public java.lang.String sendMail(java.lang.String to,
                                 java.lang.String bcc,
                                 java.lang.String subject,
                                 java.lang.String message)
                          throws java.lang.Exception

TODO: SKal flyttes/fjernes

Throws:

java.lang.Exception

getProgramInfo

public java.lang.String getProgramInfo(java.lang.String user,
                                       java.lang.String pwd)
                                throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Returner XML-streng med information om indeværende version af kerne-system samt tilhørende database version.

Forudsætninger: user,pwd kombination er valid.

Specified by:

getProgramInfo in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

Returns:

XML-streng med versions info.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getPlanTypes

public java.lang.String getPlanTypes(java.lang.String user,
                                     java.lang.String pwd)
                              throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent information over hvilke plan typer som SOAP snitfladen kan arbejde med.

Forudsætninger: user,pwd kombination er valid.

Der returneres XML med følgende struktur:

 
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <PlanSystemDK version="1.1.5" build="14" gistools_version="1.8 build 13" method="getPlanTypes(brugernavn,****)">
   <plantypes>
     <plantype name="KommunePlanRamme" featuretype="10"/>
     <plantype name="ZoneKort" featuretype="40"/>
     <plantype name="AndenKommunalPlan" featuretype="50"/>
     <plantype name="KommunePlanTillaeg" featuretype="12"/>
     <plantype name="KommunePlan" featuretype="11"/>
     <plantype name="LokalPlanDel" featuretype="30"/>
     <plantype name="LokalPlan" featuretype="20"/>
     <plantype name="KommunePlanStrategi" featuretype="70"/>
     <plantype name="AdmSkel" featuretype="60"/>
   </plantypes>
 </PlanSystemDK>
 
 

Specified by:

getPlanTypes in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

Returns:

XML-streng med plan typer.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getAreaTypes

public java.lang.String getAreaTypes(java.lang.String user,
                                     java.lang.String pwd)
                              throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent XML-streng med definitioner af hvilke område-typer systemet kender.

Forudsætninger: user,pwd kombination er valid.

Specified by:

getAreaTypes in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

Returns:

XML-streng med definition af områdetyper.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getAreaNodeTypes

public java.lang.String getAreaNodeTypes(java.lang.String user,
                                         java.lang.String pwd)
                                  throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent XML-streng med definitioner af hvilke område-node-typer systemet kender.

Forudsætninger: user,pwd kombination er valid.

Specified by:

getAreaNodeTypes in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

Returns:

XML-streng med definition af område-node-typer.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

createUser

public java.lang.String createUser(java.lang.String user,
                                   java.lang.String pwd,
                                   java.lang.String targetUser,
                                   java.lang.String targetPwd,
                                   int areaNodeId,
                                   java.lang.String firstName,
                                   java.lang.String lastName,
                                   java.lang.String email,
                                   java.lang.String organization)
                            throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Opret ny bruger under given område-node. Den oprettede bruger vil blive tilknyttet noden identificeret med areaNodeId i område-hierarkiet. Det er en forudsætning at aktuel bruger har admin-adgang til denne node. En brugers tilhørsforhold til en node i områdehierarkiet afspejler ikke nødvendigvis det område eller den organisation han er en del af. Tilhørsforholdet har først og fremmest betydning for, hvem der efterfølgende kan nedlægge eller ændre brugeren igen. Alle ny-oprettede brugere vil automatisk få tildelt læse-adgang til alle planer i hele landet.

Ved succes returneres XML á la følgende:

 
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <PlanSystemDK version="1.1.5" build="30" gistools_version="1.8 build 15" method="createUser(brugernavn,****,xxx,****,306,John,Doe,johndoe@sns.dk,SNS)">
   <adduserpersonresult>
     <user areaid="306" id="674" name="xxx">
       <person efternavn="Doe" email="johndoe@sns.dk" fornavn="John" id="5655" organisation="SNS"/>
     </user>
   </adduserpersonresult>
 </PlanSystemDK> 
 
 

Ved fejl returneres enten et Soap-fault eller XML-data á la:

 
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <PlanSystemDK version="1.0.2" build="13" method="addUser(brugernavn,****,xyz,****)">
   <pdkexception class="DataNotValidException" message="Bruger &amp;lt;xyz&amp;gt; eksisterer allerede."/>
 </PlanSystemDK>
 
 

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed til den givne område-node.

Specified by:

createUser in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

targetUser - Initialer for bruger som skal oprettes.

targetPwd - Password for bruger som skal oprettes.

areaNodeId - Identifikation af område-node.

firstName - Identifikation af person firstName.

lastName - Identifikation af person lastName.

email - Identifikation af person email.

organization - Identifikation af person organization.

Returns:

XML-streng med definition af område-node og hvilke brugere den herefter har tilknyttet.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

changeUser

public java.lang.String changeUser(java.lang.String user,
                                   java.lang.String pwd,
                                   java.lang.String targetUser,
                                   java.lang.String newUserName,
                                   java.lang.String newPwd,
                                   java.lang.String firstName,
                                   java.lang.String lastName,
                                   java.lang.String email,
                                   java.lang.String organization)
                            throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Ændring af en eksisterende bruger med tilhørende personoplysninger.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed til targetUser's område-node.

Specified by:

changeUser in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

targetUser - Initialer for bruger som skal ændres.

newUserName - Nyt initial for bruger.

newPwd - Nyt password for bruger.

firstName - Ny identifikation af person firstName.

lastName - Ny identifikation af person lastName.

email - Ny identifikation af person email.

organization - Ny identifikation af person organization.

Returns:

XML-streng med definition af område-node og hvilke brugere den herefter har tilknyttet.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

deleteUser

public java.lang.String deleteUser(java.lang.String user,
                                   java.lang.String pwd,
                                   java.lang.String targetUser)
                            throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Nedlæg bruger og alle vedkommendes adgangsrettigheder.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed til den givne område-node.

Specified by:

deleteUser in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

targetUser - Initialer for bruger som skal nedlægges.

Returns:

XML-streng med definition af område-node og hvilke brugere den herefter har tilknyttet.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

setPassword

public java.lang.String setPassword(java.lang.String user,
                                    java.lang.String pwd,
                                    java.lang.String newPwd)
                             throws java.lang.Exception

Throws:

java.lang.Exception

setUserPassword

public java.lang.String setUserPassword(java.lang.String user,
                                        java.lang.String pwd,
                                        java.lang.String targetUser,
                                        java.lang.String targetPwd)
                                 throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Ændrer password for en anden eksisterende bruger.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed til den givne område-node.

Specified by:

setUserPassword in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

targetUser - Initialer for bruger som skal have ændret password.

targetPwd - Password for bruger som skal have ændret password.

Returns:

XML-streng med brugerinfo.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

addUserPrivilege

public java.lang.String addUserPrivilege(java.lang.String user,
                                         java.lang.String pwd,
                                         java.lang.String targetUser,
                                         int featureType,
                                         int areaNodeId,
                                         int privilegeMask)
                                  throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Tilføj adgangsrettigheder for en bruger for given feature-type under given område-node.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed til den givne område-node, og at han iøvrigt selv besidder de rettigheder til område-noden som han ønsker at tilføje.

Bemærk at der enten må refereres til en specifik feature-type eller til alle feature- typer (vha. -1). Refereres der til alle feature-typer påvirkes evt. adgangsrettigheder til individuelle feature-typer ikke. Refereres der til specifik feature-type påvirkes evt. adgangsrettigheder til alle feature-typer ikke.

Specified by:

addUserPrivilege in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

targetUser - Initialer for bruger som skal have tildelt rettigheder.

featureType - Identifikation af feature-type.

areaNodeId - Identifikation af område-node.

privilegeMask - Bit-maske med rettigheder som skal tilføjes.

Returns:

XML-streng med definition af område-node og hvilke adgangsrettigheder den herefter har tilknyttet for given bruger og feature-type.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

deleteUserPrivilege

public java.lang.String deleteUserPrivilege(java.lang.String user,
                                            java.lang.String pwd,
                                            java.lang.String targetUser,
                                            int featureType,
                                            int areaNodeId,
                                            int privilegeMask)
                                     throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Fjern adgangsrettigheder for en bruger for given feature-type under given område node.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed til den givne område-node, og at han iøvrigt selv besidder de rettigheder til område-noden som han ønsker at fjerne.

Bemærk at der enten må refereres til en specifik feature-type eller til alle feature- typer (vha. -1). Refereres der til alle feature-typer påvirkes evt. adgangsrettigheder til individuelle feature-typer ikke. Refereres der til specifik feature-type påvirkes evt. adgangsrettigheder til alle feature-typer ikke.

Specified by:

deleteUserPrivilege in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

targetUser - Initialer for bruger som skal have fjernet rettigheder.

featureType - Identifikation af feature-type.

areaNodeId - Identifikation af område-node.

privilegeMask - Bit-maske med rettigheder som skal fjernes.

Returns:

XML-streng med definition af område-node og hvilke adgangsrettigheder den herefter har tilknyttet for given bruger og feature-type.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

addSubscriber

public java.lang.String addSubscriber(java.lang.String user,
                                      java.lang.String pwd,
                                      int areaNodeId,
                                      int featureType,
                                      java.lang.String email,
                                      java.lang.String firstName,
                                      java.lang.String lastName,
                                      java.lang.String organization,
                                      boolean required)
                               throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Tilføj email-abonnent til område-node for given feature-type.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed eller email-admin-rettighed til den givne område-node.

Bemærk at der enten må refereres til en specifik feature-type eller til alle feature- typer (vha. -1). Refereres der til alle feature-typer påvirkes email-abonnenter til individuelle feature-typer ikke. Refereres der til specifik feature-type påvirkes email-abonnenter til alle feature-typer ikke.

Specified by:

addSubscriber in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

areaNodeId - Identifikation af område-node.

featureType - Feature-type for hvilken abonnenter skal tilføjes.

email - Identifikation af person email.

firstName - Identifikation af person firstName.

lastName - Identifikation af person lastName.

organization - Identifikation af person organization.

required - Flag for hvorvidt e-mail udsendelse er påkrævet.

Returns:

XML-streng med definition af område-noden og hvilke email-abonnenter den herefter har tilknyttet.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

changeSubscriber

public java.lang.String changeSubscriber(java.lang.String user,
                                         java.lang.String pwd,
                                         int areaNodeId,
                                         int featureType,
                                         java.lang.String targetEmail,
                                         java.lang.String email,
                                         java.lang.String firstName,
                                         java.lang.String lastName,
                                         java.lang.String organization,
                                         boolean required)
                                  throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Ændring af email-abonnent til område-node for given feature-type.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed eller email-admin-rettighed til den givne område-node.

Bemærk at der enten må refereres til en specifik feature-type eller til alle feature- typer (vha. -1). Refereres der til alle feature-typer påvirkes email-abonnenter til individuelle feature-typer ikke. Refereres der til specifik feature-type påvirkes email-abonnenter til alle feature-typer ikke.

Bemærk at metoden IKKE kan benyttes hvis der er tilknyttet en bruger til email-abonnenten - hvis dette er tilfældet skal metoden changeUser i stedet anvendes.

Specified by:

changeSubscriber in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

areaNodeId - Identifikation af område-node.

featureType - Feature-type for hvilken abonnenter skal tilføjes.

targetEmail - Identifikation af person email.

email - Ny identifikation af person email.

firstName - Ny identifikation af person firstName.

lastName - Ny identifikation af person lastName.

organization - Ny identifikation af person organization.

required - Ny flag for hvorvidt e-mail udsendelse er påkrævet.

Returns:

XML-streng med definition af område-noden og hvilke email-abonnenter den herefter har tilknyttet.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

removeSubscribers

public java.lang.String removeSubscribers(java.lang.String user,
                                          java.lang.String pwd,
                                          int areaNodeId,
                                          int featureType,
                                          java.lang.String[] adresses)
                                   throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Fjern email-abonnenter fra given område-node for given feature-type.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed til den givne område-node, eller at han dels har email-admin-rettighed til noden, men også selv tidligere har tilføjet de pgld. abonnenter til noden.

Bemærk at der enten må refereres til en specifik feature-type eller til alle feature- typer (vha. -1). Refereres der til alle feature-typer påvirkes email-abonnenter til individuelle feature-typer ikke. Refereres der til specifik feature-type påvirkes email-abonnenter til alle feature-typer ikke.

Specified by:

removeSubscribers in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

areaNodeId - Identifikation af område-node.

featureType - Feature-type for hvilken abonnenter skal fjernes.

adresses - Array med email-adresser.

Returns:

XML-streng med definition af område-noden og hvilke email-abonnenter den herefter har tilknyttet.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getSubscribersByAdminCode

public java.lang.String getSubscribersByAdminCode(java.lang.String user,
                                                  java.lang.String pwd,
                                                  int featureType,
                                                  int adminCode)
                                           throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent XML-streng med definition af hvilke email-abonnenter der findes til en given kommune for en given feature-type.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed eller email-admin-rettighed til den pgld. kommune.

Specified by:

getSubscribersByAdminCode in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Feature-type for hvilken der findes abonnenter.

adminCode - Kommunenr. for hvilken der findes abonnenter.

Returns:

XML-streng med liste af email-abonnenter.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getAreaInfo

public java.lang.String getAreaInfo(java.lang.String user,
                                    java.lang.String pwd,
                                    int areaNodeId,
                                    boolean includeChildren)
                             throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent XML-streng med definition af node eller node-struktur for given område-node.

Forudsætninger: user,pwd kombination er valid.

Specified by:

getAreaInfo in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

areaNodeId - Identifikation af område-node.

includeChildren - Hvorvidt der skal returneres information om struktur.

Returns:

XML-streng med definition af område-noder.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getAreaInfoWithPrivileges

public java.lang.String getAreaInfoWithPrivileges(java.lang.String user,
                                                  java.lang.String pwd,
                                                  int areaNodeId,
                                                  boolean includeChildren,
                                                  java.lang.String targetUser,
                                                  int featureType)
                                           throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent XML-streng med definition af hvilke adgangsrettigheder der findest til en given område-node eller given område-node-struktur for given bruger og feature-type.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed til den givne område-node.

Bemærk at der kun returneres øvrig område-struktur for de dele af den komplette node-struktur som har tilknyttet adgangsrettigher af given beskaffenhed.

Specified by:

getAreaInfoWithPrivileges in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

areaNodeId - Identifikation af område-node.

includeChildren - Hvorvidt der skal returneres information om struktur.

targetUser - Bruger for hvilke rettigheder skal returneres.

featureType - Feature-type for hvilken rettigheder gælder.

Returns:

XML-streng med definition af område-noder og hvilke adgangsrettigheder de har tilknyttet.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getAreaInfoWithSubscribers

public java.lang.String getAreaInfoWithSubscribers(java.lang.String user,
                                                   java.lang.String pwd,
                                                   int areaNodeId,
                                                   boolean includeChildren,
                                                   int featureType)
                                            throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent XML-streng med definition af hvilke email-abonnenter der findest til en given område-node eller given område-node-struktur for given feature-type.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed eller email-admin-rettighed til den givne område-node.

Bemærk at der kun returneres øvrig område-struktur i for de dele af den komplette node-struktur som har tilknyttet abonnenter for pgld. feature-type.

Specified by:

getAreaInfoWithSubscribers in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

areaNodeId - Identifikation af område-node.

includeChildren - Hvorvidt der skal returneres information om struktur.

featureType - Feature-type for hvilken der findes abonnenter.

Returns:

XML-streng med definition af område-noder og hvilke email-abonnenter de har tilknyttet.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getAreaInfoWithUsers

public java.lang.String getAreaInfoWithUsers(java.lang.String user,
                                             java.lang.String pwd,
                                             int areaNodeId,
                                             boolean includeChildren)
                                      throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent XML-streng med definition af hvilke brugere der findes til en given område-node eller indenfor en given område-node-struktur. Hvis areaNodeId sættes til -1 benyttes aktuel brugers areaNodeId.

Forudsætninger: user,pwd kombination er valid. At aktuel bruger har admin-rettighed til den givne område-node.

Bemærk at der kun returneres øvrig område-struktur for de dele af den komplette node-struktur som har tilknyttet brugere.

Specified by:

getAreaInfoWithUsers in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

areaNodeId - Identifikation af område-node.

includeChildren - Hvorvidt der skal returneres information om struktur.

Returns:

XML-streng med definition af område-noder og hvilke brugere de måtte have tilknyttet.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getAccessKey

public java.lang.String getAccessKey(java.lang.String user,
                                     java.lang.String pwd,
                                     java.lang.String clientIP)
                              throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent en accessKey til brug for en anden klient's kald til getCredentials.

Forudsætninger: user,pwd kombination er valid.

Bemærk at den returnerede nøgle KUN kan anvendes af en klient som har den IP-adresse som specificeres i parametren clientIp. Den returnerede nøgle KUN kan anvendes i 120 sekunder.

Specified by:

getAccessKey in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

clientIP - IP-adresse på den klient som skal benytte den returnerede accessKey

Returns:

Accesskey

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getCredentials

public java.lang.String getCredentials(java.lang.String accessKey)
                                throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent brugernavn og password udfra en nøgle genereret af et forudgående kald til getAccessKey.

Specified by:

getCredentials in interface Pdk2WsInterface

Parameters:

accessKey - Den nøgle som blev afleveret fra getAccessKey.

Returns:

XML-streng med brugernavn og password.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getEmailInfo

public java.lang.String getEmailInfo(java.lang.String user,
                                     java.lang.String pwd,
                                     int featureType,
                                     java.lang.String featureId)
                              throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent XML dokument indeholdende info vedr. email-udsendelse for given plan.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har admin-adgang til den plan-feature som forsøges læst e-mail informationer om. At planen eksisterer.

Der returneres XML med følgende struktur:

 
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <PlanSystemDK version="1.1.1" build="1" gistools_version="1.8 build 6" method="getEmailInfo(brugernavn,****,20,1025657)">
   <emailinfo featuretype="20" planid="1025657">
     <sendinfo fromstatus="" tostatus="Forslag" time="2007-02-07 11:55:31.578">
       <errortext/>
       <adresses>llox@carlbor.dk,ormy@lifaf.dk</adresses>
     </sendinfo>
     <sendinfo fromstatus="Forslag" tostatus="Vedtaget" time="2007-02-07 12:55:31.578">
       <errortext>javax.mail.MessagingException: Exception reading response: nested exception is: java.net.SocketException: Connection reset</errortext>
       <adresses>llox@carlbor.dk,ormy@lifaf.dk</adresses>
     </sendinfo>
   </emailinfo>
 </PlanSystemDK>
 
 

Hvis der ikke har været nogen email-udsendelser vedr. planen returneres XML med følgende struktur:

 
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <PlanSystemDK version="1.1.1" build="1" gistools_version="1.8 build 6" method="getEmailInfo(brugernavn,****,20,1014001)">
   <emailinfo featuretype="20" planid="1014001"/>
 </PlanSystemDK>
 
 

Specified by:

getEmailInfo in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

featureId - Identifikation af plan.

Returns:

XML-streng med info vedr email-udsendelse(r).

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getFeatureAttributeInfo

public java.lang.String getFeatureAttributeInfo(java.lang.String user,
                                                java.lang.String pwd,
                                                int featureType,
                                                java.lang.String attributeName)
                                         throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent XML-streng med definition af en enkelt eller alle attributter for en feature.

Ved succes returneres XML følgende:

 
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <PlanSystemDK version="1.1.5" build="20" gistools_version="1.8 build 13" method="getFeatureAttributeInfo(brugernavn,****,40,)">
   <getfeatureattributeinforesult>
     <planattributes name="ZoneKort" type="40">
       <attribute name="PLANID" dbtype="Integer" schematype="pdk:PlanIdentifierType" required="true"/>
       <attribute name="KOMNR" dbtype="Integer" schematype="pdk:MunicipalityCodeType" required="true">
         <values>
           <value name="København">101</value>
           <value name="Frederiksberg">147</value>
             .
             .
           <value name="Aalborg">851</value>
           <value name="Hjørring">860</value>
         </values>
       </attribute>
       <attribute name="GLKOMNR" dbtype="Integer" schematype="pdk:OldMunicipalityCodeType" required="false">
         <values>
           <value name="København">101</value>
           <value name="Frederiksberg">147</value>
             .
             .
           <value name="Aalborg">851</value>
           <value name="Aars">861</value>
         </values>
       </attribute>
       <attribute name="OBJEKTKODE" dbtype="Integer" schematype="pdk:ZoneMapObjectcodeType" required="true">
         <values>
           <value name="Zonekort">40</value>
         </values>
       </attribute>
       <attribute name="ZONE" dbtype="Integer" schematype="pdk:ZoneType" required="true">
         <values>
           <value name="Byzone">1</value>
           <value name="Landzone">2</value>
           <value name="Sommerhusområde">3</value>
         </values>
       </attribute>
       <attribute name="DATAPROD" dbtype="String" schematype="pdk:DataProducerType" required="false"/>
       <attribute name="DATOGEOM" dbtype="Integer" schematype="pdk:DateType" required="false"/>
       <attribute name="DIGIGRUNDL" dbtype="String" schematype="pdk:DigitizationBasisType" required="false"/>
       <attribute name="DIGIGRUNDD" dbtype="Integer" schematype="pdk:DateType" required="false"/>
     </planattributes>
   </getfeatureattributeinforesult>
 </PlanSystemDK>
 
 

Forudsætninger: user,pwd kombination er valid.

Specified by:

getFeatureAttributeInfo in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

attributeName - Navn på attribut. Er navnet blankt returneres definition af alle attrbibutter.

Returns:

XML-streng med definition af attribut(ter)

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getFeatureByAdminCodes

public java.lang.String getFeatureByAdminCodes(java.lang.String user,
                                               java.lang.String pwd,
                                               int featureType,
                                               int[] adminCodes)
                                        throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent GML-streng med senest opdaterede versioner af Plan-features af given type, som tilhører et udvalg af administrative enheder (kommuner/områder).

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har læse-rettighed til hver eneste plan-feature som forsøges læst.

Specified by:

getFeatureByAdminCodes in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

adminCodes - Array med identifikationer af administrative enheder.

Returns:

GML-streng med Plan-features.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getFeatureAttributesByAdminCodes

public java.lang.String getFeatureAttributesByAdminCodes(java.lang.String user,
                                                         java.lang.String pwd,
                                                         int featureType,
                                                         int[] adminCodes,
                                                         java.lang.String[] attributes)
                                                  throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent GML-streng med senest opdaterede versioner af Plan-features af given type, som tilhører et udvalg af administrative enheder (kommuner/områder). Der afleveres kun attribut-data for specificerede kolonner aht. performance. Bemærk at der altid leveres "krævne" attributter, således at den afleverede GML er skema-valid.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har læse-rettighed til hver eneste plan-feature som forsøges læst.

Specified by:

getFeatureAttributesByAdminCodes in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

adminCodes - Array med identifikationer af administrative enheder.

attributes - Array med kolonner som skal afleveres. null - alle kolonner

Returns:

GML-streng med Plan-features.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getFeatureById

public java.lang.String getFeatureById(java.lang.String user,
                                       java.lang.String pwd,
                                       int featureType,
                                       java.lang.String featureId)
                                throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent GML-streng med senest opdaterede version af Plan-feature af given type og ID.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har læse-rettighed til den plan-feature som forsøges læst. At planen eksisterer.

Specified by:

getFeatureById in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

featureId - Identifikation af plan.

Returns:

GML-streng med Plan-features.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getFeatureExtentById

public java.lang.String getFeatureExtentById(java.lang.String user,
                                             java.lang.String pwd,
                                             int featureType,
                                             java.lang.String featureId)
                                      throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent geografisk ekstent for senest opdaterede version af Plan-feature af given type og ID. Hvis featuren ikke har geometri, returneres ekstent for kommune, eller ekstent for relevant "moder-plan" hvis en sådan findes. Alternativt returnerer ekstent for Danmark. Denne metode er lavet for at tilvejebringe et "default ekstent" for brug for SpatialEdit.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har læse-rettighed til den plan-feature som forsøges læst. At planen eksisterer.

Specified by:

getFeatureExtentById in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

featureId - Identifikation af plan.

Returns:

Relevant ekstent for Plan-featuren.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getFeatureWithinGeometry

public java.lang.String getFeatureWithinGeometry(java.lang.String user,
                                                 java.lang.String pwd,
                                                 int featureType,
                                                 java.lang.String gml)
                                          throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent GML-streng med senest opdaterede versioner af Plan-features af given type, som er overlappet af geometri angivet i GML-streng.

Eksempel på input GML-streng:

  
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <gml:polygonProperty xmlns:gml="http://www.opengis.net/gml">
    <gml:Polygon srsName='epsg:25832'>
      <gml:outerBoundaryIs>
        <gml:LinearRing>
          <gml:coordinates>545000,6150000 546000,6150000 546000,6151000 545000,6151000 545000,6150000</gml:coordinates>
        </gml:LinearRing>
      </gml:outerBoundaryIs>
    </gml:Polygon>
  </gml:polygonProperty>
  
  

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har læse-rettighed til hver eneste plan-feature som forsøges læst.

Specified by:

getFeatureWithinGeometry in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

gml - GML-streng med geometri.

Returns:

GML-streng med Plan-feature.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

getChildrenByParentId

public java.lang.String getChildrenByParentId(java.lang.String user,
                                              java.lang.String pwd,
                                              int parentFeatureType,
                                              int childFeatureType,
                                              java.lang.String parentFeatureId,
                                              java.lang.String[] attributes)
                                       throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent GML-streng med senest opdaterede versioner af Plan-features af given type, som har en given moder-plan.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har læse-rettighed til hver eneste plan-feature som forsøges læst. At parentFeatureType er valid, og at der findes børneplaner for denne plantype. At childFeatureType er valid, og at childFeatureType er barn af parentFeatureType.

Specified by:

getChildrenByParentId in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

parentFeatureType - Identifikation af parent feature-type.

childFeatureType - Identifikation af child feature-type.

parentFeatureId - Identifikation af plan, hvis børn ønskes fundet.

attributes - Optiionalt Array med kolonner som skal afleveres - Hvis null returneres alle kolonner.

Returns:

GML-streng med Plan-features.

Throws:

java.lang.Exception

getNewFeatureId

public java.lang.String getNewFeatureId(java.lang.String user,
                                        java.lang.String pwd,
                                        int featureType)
                                 throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Hent et nyt ID til brug for oprettelse af ny Plan-feature af given type.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har skrive-rettighed til pgld. Plan-feature.

Specified by:

getNewFeatureId in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

Returns:

XML-streng med et nyt genereret plan-ID.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

saveFeature

public java.lang.String saveFeature(java.lang.String user,
                                    java.lang.String pwd,
                                    java.lang.String gml)
                             throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Gem (opret/opdater) Plan-features i henhold til data indeholdt i GML-streng, og hvis moder-plan skifter status, så opdater evt. børne-planer.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har skrive-rettighed til hver eneste plan-feature som ønskes opdateret. At der er tale om valide opdateringer.

Der returneres XML med følgende struktur:

  
    <?xml version="1.0" encoding="ISO-8859-1"?>
    <PlanSystemDK version="1.1.4" build="5" gistools_version="1.8 build 11" method="saveFeature(brugernavn,****,gml)">
      <savefeatureresult status="ok" okCount="2" errorCount="0">
        <updatefeatureresult status="ok">
          <featureinfo>
            <type>LokalPlan</type>
            <id>1110916</id>
            <plannavn>Område til offentlige formål i Brenderup..</plannavn>
            <plannr>B103</plannr>
            <komnr>410</komnr>
            <frastatus>Vedtaget</frastatus>
            <tilstatus>Vedtaget</tilstatus>
          </featureinfo>
          <emaillist status="ok" adresses="" time="2009-08-04 16:08:45.143"/>
        </updatefeatureresult>
        <updatefeatureresult status="ok">
          <featureinfo>
            <type>LokalPlan</type>
            <id>1110918</id>
            <plannavn>Boligområde ved Kirkevej i Brenderup..</plannavn>
            <plannr>B113</plannr>
            <komnr>410</komnr>
            <frastatus>Vedtaget</frastatus>
            <tilstatus>Vedtaget</tilstatus>
          </featureinfo>
          <emaillist status="ok" adresses="" time="2009-08-04 16:08:45.143"/>
        </updatefeatureresult>
      </savefeatureresult>
    </PlanSystemDK>
  
  

Eksempel på svar med fejl, hvor der forsøges gemt en enkelt plan-feature.

  
    <?xml version="1.0" encoding="ISO-8859-1"?>
    <PlanSystemDK version="1.1.4" build="5" gistools_version="1.8 build 11" method="saveFeature(brugernavn,****,gml)">
      <savefeatureresult status="fejl" okCount="0" errorCount="1">
        <updatefeatureresult status="med fejl">
          <featureinfo>
            <type>LokalPlan</type>
            <id>1110916</id>
            <plannavn>Område til offentlige formål i Brenderup..</plannavn>
            <plannr>B103</plannr>
            <komnr>410</komnr>
            <frastatus>Vedtaget</frastatus>
            <tilstatus>Forslag</tilstatus>
          </featureinfo>
          <errors count="1">
            <message>Tilstandsskiftet [Vedtaget] til [Forslag] er ikke validt for feature-typen: LokalPlan</message>
          </errors>
        </updatefeatureresult>
      </savefeatureresult>
    </PlanSystemDK>
  
  

Hvis den eller de berørte planer skifter status, vil dette medføre at der automatisk udsendes email's til de tilknyttede abonnenter. Dette gælder dog kun for visse plantyper. Hvis der ikke ønskes udsendt email til alle abonnenter, så kan metoden saveFeatureAndNotify anvendes i stedet.

Bemærk at der kan gemmes flere plan-features i et enkelt kald til metoden. Hvis en eller flere plan-features ikke kan gemmes (savefeatureresult, hvor atributten status="fejl" og errorCount større end 0) vil INGEN af de plan-features som er indeholdt i GML'en blive gemt. Hvis den/de plan-features som gemmes er af typen kommuneplan, kommuneplantillæg eller lokalplan og status skiftes, vil dette automatisk medføre at underliggende planer med samme status som den eksisterende plan vil skifte status - dette afspejles i den XML, som metoden returnerer. Dette medfører ligeledes at status-skift på f.eks. en lokalplan ikke kan udføres hvis de tilhørende lokalplandelområder ikke kan skifte status til den ny status - den returnerede XML vil indeholde informationer om hvilke lokalplandelområder som ikke kan skifte status. Bemærk iøvrigt at ikke alle underliggende planer nødvendigvis vil blive opdateret, fx vil en underliggende plan ikke blive opdateret, hvis den er i status kladde og hovedplanen skifter status fra forslag til vedtaget (Se info om behandling af børne-planer herunder). For at teste om hvorvidt en plan kan skifte status, kan metoden testPlanStatusChange anvendes.

 Behandling af børne-planer er implementeres således:
   Hvis moder-plan skifter status
     For alle børne-planer (lokalplandelområder, kommuneplanrammer og kommuneplantillæg)
       (Hvis NY moder-plan er i status aflyst OG barne-plan ikke er i status kladde eller aflyst)
       ELLER (hvis barne-plan er i samme status som GAMMEL moder-plan 
              OG hvis der ikke er tale om at barne-planen er et kommuneplantillæg)  
         Sæt datoforsl, datovedt og datoaflyst fra moder-plan hvis ikke sat, og behandl barne-plan.
 

Specified by:

saveFeature in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

gml - GML-streng med Plan-features.

Returns:

XML-streng med kvitteringer for plan-opdateringer.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

saveFeatureValidate

public java.lang.String saveFeatureValidate(java.lang.String user,
                                            java.lang.String pwd,
                                            boolean validateDraft,
                                            java.lang.String gml)
                                     throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Gem (opret/opdater) Plan-features i henhold til data indeholdt i GML-streng, og hvis moder-plan skifter status, så opdater evt. børne-planer.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har skrive-rettighed til hver eneste plan-feature som ønskes opdateret. At der er tale om valide opdateringer.

Der returneres XML med følgende struktur:

  
    <?xml version="1.0" encoding="ISO-8859-1"?>
    <PlanSystemDK version="1.1.4" build="5" gistools_version="1.8 build 11" method="saveFeatureValidate(brugernavn,****,false,gml)">
      <savefeatureresult status="ok" okCount="2" errorCount="0">
        <updatefeatureresult status="ok">
          <featureinfo>
            <type>LokalPlan</type>
            <id>1110916</id>
            <plannavn>Område til offentlige formål i Brenderup..</plannavn>
            <plannr>B103</plannr>
            <komnr>410</komnr>
            <frastatus>Vedtaget</frastatus>
            <tilstatus>Vedtaget</tilstatus>
          </featureinfo>
          <emaillist status="ok" adresses="" time="2009-08-04 16:08:45.143"/>
          <cbkortlink><![CDATA[http://test.kort.plansystem.dk/cbkort?profile=plandk2&selectorgroups=*&page=vis-lokalplan&planid=1110916&type=20]]></cbkortlink>
          <doklink><![CDATA[http://test.soap.plansystem.dk/pdfarchive/20_1110916_APPROVED_1237292414829.pdf]]></doklink>
        </updatefeatureresult>
        <updatefeatureresult status="ok">
          <featureinfo>
            <type>LokalPlan</type>
            <id>1110918</id>
            <plannavn>Boligområde ved Kirkevej i Brenderup..</plannavn>
            <plannr>B113</plannr>
            <komnr>410</komnr>
            <frastatus>Vedtaget</frastatus>
            <tilstatus>Vedtaget</tilstatus>
          </featureinfo>
          <emaillist status="ok" adresses="" time="2009-08-04 16:08:45.143"/>
          <cbkortlink><![CDATA[http://test.kort.plansystem.dk/cbkort?profile=plandk2&selectorgroups=*&page=vis-lokalplan&planid=1110918&type=20]]></cbkortlink>
          <doklink><![CDATA[http://test.soap.plansystem.dk/pdfarchive/20_1110918_APPROVED_1237292415703.pdf]]></doklink>
        </updatefeatureresult>
      </savefeatureresult>
    </PlanSystemDK>
  
  

Eksempel på svar med fejl, hvor der forsøges gemt en enkelt plan-feature.

  
    <?xml version="1.0" encoding="ISO-8859-1"?>
    <PlanSystemDK version="1.1.4" build="5" gistools_version="1.8 build 11" method="saveFeature(brugernavn,****,gml)">
      <savefeatureresult status="fejl" okCount="0" errorCount="1">
        <updatefeatureresult status="med fejl">
          <featureinfo>
            <type>LokalPlan</type>
            <id>1110916</id>
            <plannavn>Område til offentlige formål i Brenderup..</plannavn>
            <plannr>B103</plannr>
            <komnr>410</komnr>
            <frastatus>Vedtaget</frastatus>
            <tilstatus>Forslag</tilstatus>
          </featureinfo>
          <errors count="1">
            <message>Tilstandsskiftet [Vedtaget] til [Forslag] er ikke validt for feature-typen: LokalPlan</message>
          </errors>
        </updatefeatureresult>
      </savefeatureresult>
    </PlanSystemDK>
  
  

Hvis den eller de berørte planer skifter status, vil dette medføre at der automatisk udsendes email's til de tilknyttede abonnenter. Dette gælder dog kun for visse plantyper. Hvis der ikke ønskes udsendt email til alle abonnenter, så kan metoden saveFeatureAndNotify anvendes i stedet.

Bemærk at der kan gemmes flere plan-features i et enkelt kald til metoden. Hvis en eller flere plan-features ikke kan gemmes (savefeatureresult, hvor atributten status="fejl" og errorCount større end 0) vil INGEN af de plan-features som er indeholdt i GML'en blive gemt. Hvis den/de plan-features som gemmes er af typen kommuneplan, kommuneplantillæg eller lokalplan og status skiftes, vil dette automatisk medføre at underliggende planer med samme status som den eksisterende plan vil skifte status - dette afspejles i den XML, som metoden returnerer. Dette medfører ligeledes at status-skift på f.eks. en lokalplan ikke kan udføres hvis de tilhørende lokalplandelområder ikke kan skifte status til den ny status - den returnerede XML vil indeholde informationer om hvilke lokalplandelområder som ikke kan skifte status. Bemærk iøvrigt at ikke alle underliggende planer nødvendigvis vil blive opdateret, fx vil en underliggende plan ikke blive opdateret, hvis den er i status kladde og hovedplanen skifter status fra forslag til vedtaget (Se info om behandling af børne-planer herunder). For at teste om hvorvidt en plan kan skifte status, kan metoden testPlanStatusChange anvendes.

 Behandling af børne-planer er implementeres således:
 Hvis moder-plan skifter status
 For alle børne-planer (lokalplandelområder, kommuneplanrammer og kommuneplantillæg)
 (Hvis NY moder-plan er i status aflyst OG barne-plan ikke er i status kladde eller aflyst)
 ELLER (hvis barne-plan er i samme status som GAMMEL moder-plan 
 OG hvis der ikke er tale om at barne-planen er et kommuneplantillæg)  
 Sæt datoforsl, datovedt og datoaflyst fra moder-plan hvis ikke sat, og behandl barne-plan.
 

Specified by:

saveFeatureValidate in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

validateDraft - true/false om validering skal ske ved genming af en kladde

gml - GML-streng med Plan-features.

Returns:

XML-streng med kvitteringer for plan-opdateringer.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

saveFeatureAndNotify

public java.lang.String saveFeatureAndNotify(java.lang.String user,
                                             java.lang.String pwd,
                                             java.lang.String gml,
                                             java.lang.String[] adresses)
                                      throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Gem (opret/opdater) Plan-feature i henhold til data indeholdt i GML-streng, og hvis moder-plan skifter status, så opdater evt. børne-planer. - se metoden saveFeature for yderligere beskrivelse. Denne udgår, da der ikke længere sendes mail via SOAP.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har skrive-rettighed til hver eneste plan-feature som ønskes opdateret. At der er tale om valide opdateringer. Se iøvrigt metoden saveFeature. Bemærk at der altid vil blive udsendt email's til påkrævede abonennenter uanset om de forefindes i adresses.

Specified by:

saveFeatureAndNotify in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

gml - GML-streng med netop en Plan-feature.

adresses - Array indeholdende email-adresser som IKKE skal notificeres.

Returns:

XML-streng med kvitteringer for plan-opdateringer.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

deleteFeature

public java.lang.String deleteFeature(java.lang.String user,
                                      java.lang.String pwd,
                                      int featureType,
                                      java.lang.String featureId)
                               throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Slet senest opdaterede version af Plan-feature af given type og ID. Hvis der er børn (og børnebørn) tilknyttet planen vil disse også blive slettet, hvis det er muligt. Forudsætninger: user,pwd kombination er valid. Aktuel bruger har slette-rettighed til plan-feature som forsøges slettet. At plan-feature eksisterer. At plan-feature overhovedet må slettes i sin nuværende tilstand. At børn og børnebørn til planen kan slettes. Hvis plan typen har en status, skal denne være kladde for at plan-feature kan slettes.

Specified by:

deleteFeature in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

featureId - Identifikation af plan.

Returns:

XML-streng med OK-status såfremt operation går godt. For hver slettet plan vil der blive indlejret et ekstra deletefeatureresult element.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

validateGML

public java.lang.String validateGML(java.lang.String user,
                                    java.lang.String pwd,
                                    java.lang.String gml)
                             throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Kontroller at GML-streng med Plan-features er valid i henhold til PlanDK2 XML-skemadefinitioner.

Forudsætninger: user,pwd kombination er valid.

Specified by:

validateGML in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

Returns:

XML-streng med OK-status såfremt GML er valid.

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

testPlanStatusChange

public java.lang.String testPlanStatusChange(java.lang.String user,
                                             java.lang.String pwd,
                                             int featureType,
                                             java.lang.String featureId,
                                             java.lang.String newState)
                                      throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Test om en given plan (og børneplaner) vil lade sig opdatere til den angivne status. Den returnerede XML svarer til, hvad man ville få, hvis man forsøgte at gemme en feature med saveFeature, men der vil ALDRIG blive skrevet data i databasen. Metoden kan således give overblik over om hvorvidt en plan (specielt moder plan) er klar til at skifte status. Se iøvrigt metoden saveFeature.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har skrive-rettighed til hver eneste plan-feature som ønskes opdateret. At der er tale om valide opdateringer. Se iøvrigt metoden saveFeature.

Specified by:

testPlanStatusChange in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

featureId - PlanId på plan som skal forsøges gemt

newState - Status som planen skal forsøges at sættes i angives som: F = Forslag, V = Vedtaget og A = Aflyst

Returns:

XML-streng med kvitteringer for plan-opdateringer (de angivne opdateringer er dog ikke blevet skrevet)

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.

sendEmailByPlanId

public java.lang.String sendEmailByPlanId(java.lang.String user,
                                          java.lang.String pwd,
                                          int featureType,
                                          java.lang.String featureId,
                                          java.lang.String tilStatus,
                                          java.lang.String subject,
                                          java.lang.String body,
                                          java.lang.String[] includeAdresses,
                                          java.lang.String[] excludeAdresses)
                                   throws java.lang.Exception

Description copied from interface: Pdk2WsInterface

Send Email til abonnenter for en given plan.

Forudsætninger: user,pwd kombination er valid. Aktuel bruger har skrive-adgang til den pgld. plan-feature. At planen eksisterer. At der har været udsendt emails i forbindelse med det specificerede statusskift. Hvis denne parameter er null anvendes seneste statusskift.

Der returneres XML med følgende struktur:

 
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <PlanSystemDK version="1.1.1" build="1" gistools_version="1.8 build 6" method="sendEmailByPlanId(brugernavn,****,20,1025185,V,Hello World,<body>)">
   <emaillist status="ok|error" [exception="tekst"] adresses="subScriberList" time="timeStamp" />
 </PlanSystemDK>
 
 

Specified by:

sendEmailByPlanId in interface Pdk2WsInterface

Parameters:

user - Initialer for aktuel bruger.

pwd - Password for aktuel bruger.

featureType - Identifikation af feature-type.

featureId - Identifikation af plan.

tilStatus - Optional identifikation statusskift: F = Forslag, V = Vedtaget og A = Aflyst.

subject - Emne felt til email'en.

body - Indhold af email - Kan være tekst eller HTML formateret.

includeAdresses - Adresser som der yderligere skal sendes til.

excludeAdresses - Adresser som der oprindeligt blev sendt til, men som der ikke skal sendes til i denne omgang.

Returns:

XML-streng med info vedr email-udsendelse(r).

Throws:

java.lang.Exception - I tilfælde af enhver form for fejl.