Differences

This shows you the differences between two versions of the page.

--- fmk:bem:2.0:opret_bemyndigelser [2016-01-14 12:41] – [XML-Eksempler] krs
+++ fmk:bem:2.0:opret_bemyndigelser [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 3: / Line 3: @@
 Servicen ”Opret bemyndigelser” opretter alt efter medsendte status bemyndigelser eller anmodninger om bemyndigelser. De oprettede (anmodninger om) bemyndigelser returneres.
-"Opret bemyndigelser" tager som argument en nøgle bestående af: bemyndigende CPR, bemyndigede CPR, bemyndigede CVR, system, arbejdsfunktion, og status, dertil kommer en liste af rettigheder. Status indgår, så "Opret bemyndigelser" både kan anvendes til at oprette anmodninger om bemyndigelser og faktiske bemyndigelser. Optionelt kan en "gyldig fra dato" og en "gyldig til dato" angives. Angiver man ikke disse bliver "gyldig fra dato" sat til dags dato og "gyldig til dato" 2 år efter dette.
+"Opret bemyndigelser" tager som argument en nøgle bestående af: bemyndigende CPR, bemyndigede CPR, bemyndigede CVR, system, bemyndigendes arbejdsfunktion, og status, dertil kommer en liste af rettigheder. Status indgår, så "Opret bemyndigelser" både kan anvendes til at oprette anmodninger om bemyndigelser og faktiske bemyndigelser. Optionelt kan en "gyldig fra dato" og en "gyldig til dato" angives. Angiver man ikke disse bliver "gyldig fra dato" sat til dags dato og "gyldig til dato" 2 år efter dette. Bemyndigelsen må ikke vare længere end 2 år.
-:!: Det udestår at afklare om der skal være en validering, som begrænser maksimal gyldighedsperiode for en bemyndigelse.
-Angivelse af værdien * for en rettighed indikerer at samtlige delegerbare rettigheder, nuværende og fremtidige, for den pågældende arbejdsfunktion er delegeret i bemyndigelsen. Bemyndigelserne, der bliver gjort tilgængelige i stamdata, er de konkrete rettigheder, som arbejdsfunktionen kan uddelegere. Fx hvis en medhjælper for en læge bliver bemyndiget med stjernerettigheden til TAS, bliver stamdata opdateret med rettighederne LæsKladder, SkrivKladder og LæsSager. Hvis der senere bliver tilføjet en rettighed til TAS, som er delegerbar for læger, bliver denne rettighedi stamdata tilføjet til listen af rettigheder medhjælperen har, med det samme gyldighedsinterval og eventuel CVR-begrænsning, som de andre rettigheder i bemyndigelsen.
+Angivelse af værdien * for en rettighed indikerer at samtlige delegerbare rettigheder, nuværende og fremtidige, for den pågældende arbejdsfunktion er delegeret i bemyndigelsen. Bemyndigelserne, der bliver gjort tilgængelige i stamdata, er de konkrete rettigheder, som arbejdsfunktionen kan uddelegere. Fx hvis en medhjælper for en læge bliver bemyndiget med stjernerettigheden til TAS, bliver stamdata opdateret med rettighederne LæsKladder, SkrivKladder og LæsSager. Hvis der senere bliver tilføjet en rettighed til TAS, som er delegerbar for læger, bliver denne rettighed i stamdata tilføjet til listen af rettigheder medhjælperen har, med det samme gyldighedsinterval og eventuel CVR-begrænsning, som de andre rettigheder i bemyndigelsen.
 OpretBemyndigelser erstatter en eksisterende bemyndigelse med samme nøgle, da der ikke kan eksistere mere end én bemyndigelse på et bestemt tidspunkt med samme nøgle. Konkret vil den eksisterende bemyndigelse få sat slutdato til startdatoen for den nye bemyndigelse.
 === Opret anmodning ===
-Servicen anvendes af assistenter eller brugeradministratorer til at bestille en bemyndigelse hos en specifik bemyndigende, f.eks. en læge på en afdeling. Den opretter en anmoding om en eller flere bemyndigelser. Servicekaldet angiver status "Anmodet", og bemyndigelsen får status ”Anmodet” og træder først i kraft, når den er godkendt af angivne bemyndigende. Brugere kan kun bestille bemyndigelser, hvor de selv fremgår som bemyndigede. Undtaget fra denne regel er administratorer der kalder fra et whitelisted system, som kan oprette anmodninger om bemyndigelser mellem andre personer. Disse bemyndigelser skal til gengæld være begrænsede til det cvr-nummer, der fremgår af det certifikat, de autentificerer sig med.
+Servicen anvendes af assistenter eller brugeradministratorer til at anmode om en bemyndigelse hos en specifik bemyndigende, f.eks. en læge på en afdeling. Den opretter en anmoding om en eller flere bemyndigelser. Servicekaldet angiver status "Anmodet", og bemyndigelsen får status ”Anmodet” og træder først i kraft, når den er godkendt af angivne bemyndigende. Brugere kan kun anmode om bemyndigelser, hvor de selv fremgår som bemyndigede.
 === Opret bemyndigelse ===
-Servicen anvendes af den autoriserende part eller af brugeradministratorer til at godkende anmodede bemyndigelser og til at oprette bemyndigelser. Hvis man kalder "Opret bemyndigelser" med status "Oprettet", og der er en eksisterende liste af bemyndigelser med status Anmodet og ellers identiske værdier i nøglen, slettes denne. Dvs. operationen svarer til en godkendelse af de anmodede bemyndigelser. Brugere kan kun godkende og oprette bemyndigelser, hvor de selv fremgår som bemyndigende. Undtaget fra denne regel er administratorer, som kan oprette bemyndigelser mellem andre personer. Disse bemyndigelser skal til gengæld være begrænsede til det cvr-nummer, der fremgår af det certifikat, de autentificerer sig med.
+Servicen anvendes af den autoriserende part eller af brugeradministratorer til at godkende anmodede bemyndigelser og til at oprette bemyndigelser. Hvis man kalder "Opret bemyndigelser" med status "Godkendt", og der er en eksisterende bemyndigelse med en liste af rettigheder med status "Anmodet" og ellers identiske værdier i nøglen, slettes denne. Dvs. operationen svarer til en godkendelse af de anmodede bemyndigelser. Brugere kan kun godkende og oprette bemyndigelser, hvor de selv fremgår som bemyndigende.
 ===== Svar =====
@@ Line 32: / Line 31: @@
   * Dato for gyldig_fra ligger i fortiden
   * Dato for gyldig_til ligger i fortiden
 =====XML-Eksempler=====
 Herunder vises en oprettelse af en anmodning om bemyndigelse. Den skal gælde til alle nuværende og fremtidige delegerbare rettigheder for en tandlæge (stjerne-rettigheden) i FMK. Den skal gælder fra "nu" og to år frem (dato er således ikke angivet). Det er en anmodning om at blive personlig assistent, og CVR-nummer er derfor ikke angivet.
-<code xml OpretBemyndigelserRequest.xml>
+<code xml CreateDelegationsRequest.xml>
-<code xml CreateDelegationRequest.xml>
+<CreateDelegationsRequest>
-<CreateDelegationRequest>
     <Create>
         <DelegatorCpr>1206879196</DelegatorCpr>
         <DelegateeCpr>0304838140</DelegateeCpr>
-        <System>TAS</System>
+        <SystemId>TAS</SystemId>
-        <Role>Tandlæge</Role>
+        <RoleId>Tandlæge</RoleId>
         <State>Anmodet</State>
-        <ListOfPermissions>
+        <ListOfPermissionIds>
-            <Permission>*</Permission>
+            <PermissionId>*</PermissionId>
-        </ListOfPermissions>
+        </ListOfPermissionIds>
     </Create>
-</CreateDelegationRequest>
+</CreateDelegationsRequest>
 </code>
@@ Line 55: / Line 54: @@
 Herunder vises et eksempel på oprettelse af bemyndigelser. Der oprettes en bemyndigelse til systemet FMK med rettigheden Sundhedsfagligt opslag. Denne bemyndigelse gælder kun når den bemyndigede autentificerer sig med et et certifikat med det angivne CVR-nummer, endvidere er specificeret at bemyndigelsen gælder fra 1. februar 2016 og et år frem. Den næste oprettelse er to rettigheder til DDV, oprettesen angiver ikke en fra dato, så den er gyldig fra dags dato, mens gyldig til sættes til den angivne værdi.
-<code xml CreateDelegationRequest2.xml>
+<code xml CreateDelegationsRequest2.xml>
-<CreateDelegationRequest>
+<CreateDelegationsRequest>
     <Create>
         <DelegatorCpr>2005511871</DelegatorCpr>
         <DelegateeCpr>0304838140</DelegateeCpr>
         <DelegateeCvr>20921897</DelegateeCvr>
-        <System>FMK</System>
+        <SystemId>FMK</SystemId>
-        <Role>Læge</Role>
+        <RoleId>Læge</RoleId>
-        <State>Oprettet</State>
+        <State>Godkendt</State>
-        <ListOfPermissions>
+        <ListOfPermissionIds>
-            <Permission>SundhedsfagligtOpslag</Permission>
+            <PermissionId>SundhedsfagligtOpslag</PermissionId>
-        </ListOfPermissions>
+        </ListOfPermissionIds>
         <EffectiveFrom>2016-02-01T00:00:00Z</EffectiveFrom>
         <EffectiveTo>2017-01-31T00:00:00Z</EffectiveTo>
@@ Line 73: / Line 72: @@
         <DelegatorCpr>2005511871</DelegatorCpr>
         <DelegateeCpr>0304838140</DelegateeCpr>
-        <System>DDV</System>
+        <SystemId>DDV</SystemId>
-        <Role>Læge</Role>
+        <RoleId>Læge</RoleId>
-        <State>Oprettet</State>
+        <State>Godkendt</State>
-        <ListOfPermissions>
+        <ListOfPermissionIds>
-            <Permission>VaccinationVedligehold</Permission>
+            <PermissionId>VaccinationVedligehold</PermissionId>
-            <Permission>VaccinationVedligeholdAnbefalet</Permission>
+            <PermissionId>VaccinationVedligeholdAnbefalet</PermissionId>
-        </ListOfPermissions>
+        </ListOfPermissionIds>
         <EffectiveTo>2017-01-31T00:00:00Z</EffectiveTo>
     </Create>
-</CreateDelegationRequest>
+</CreateDelegationsRequest>
 </code>
@@ Line 88: / Line 87: @@
 Herunder vises svaret på ovenstående forespørgsel. Hver oprettet bemyndigelse har fået tilknyttet et Id og indeholder udover navnet for rettigheden, som blev angivet i forespørgslen, også en beskrivelse af rettigheden. Endvidere er indsat de datoer, som ikke blev fastlagt i forespørgslen.
-<code xml CreateDelegationResponse.xml>
+<code xml CreateDelegationsResponse.xml>
-<CreateDelegationResponse>
+<CreateDelegationsResponse>
     <Delegation>
         <DelegationId>9DD1BC7E-76AF-43BC-9C2C-ABAE4257E64F</DelegationId>
@@ Line 95: / Line 94: @@
         <DelegateeCpr>0304838140</DelegateeCpr>
         <DelegateeCvr>20921897</DelegateeCvr>
-        <System>FMK</System>
+        <System>
-        <SystemLongName>Fælles Medicinkort</SystemLongName>
+            <SystemId>FMK</SystemId>
-        <Role>Læge</Role>
+            <SystemLongName>Det fælles medicinkort</SystemLongName>
-        <RoleDescription>Autoriseret læge</RoleDescription>
+        </System>
-        <State>Oprettet</State>
+        <Role>
-        <PermissionNameDescription>
+            <RoleId>Læge</RoleId>
-            <Permission>SundhedsfagligOpslag</Permission>
+            <RoleDescription>Autoriseret læge</RoleDescription>
+        </Role>
+        <State>Godkendt</State>
+        <Permission>
+            <PermissionId>SundhedsfagligOpslag</PermissionId>
             <PermissionDescription>Sundhedsfagligt opslag</PermissionDescription>
-        </PermissionNameDescription>
+        </Permission>
         <Created>2016-01-04T10:10:00Z</Created>
         <EffectiveFrom>2016-02-01T00:00:00Z</EffectiveFrom>
@@ Line 112: / Line 115: @@
         <DelegatorCpr>2005511871</DelegatorCpr>
         <DelegateeCpr>0304838140</DelegateeCpr>
-        <System>DDV</System>
+        <System>
-        <SystemLongName>Vaccinationsregistret</SystemLongName>
+            <SystemId>DDV</SystemId>
-        <Role>Læge</Role>
+            <SystemLongName>Vaccinationsregistret</SystemLongName>
-        <RoleDescription>Autoriseret læge</RoleDescription>
+        </System>
-        <State>Oprettet</State>
+        <Role>
-        <PermissionNameDescription>
+            <RoleId>Læge</RoleId>
-            <Permission>VaccinationVedligehold</Permission>
+            <RoleDescription>Autoriseret læge</RoleDescription>
+        </Role>
+        <State>Godkendt</State>
+        <Permission>
+            <PermissionId>VaccinationVedligehold</PermissionId>
             <PermissionDescription>Opret, ret eller slet vaccinationer</PermissionDescription>
-        </PermissionNameDescription>
+        </Permission>
-        <PermissionNameDescription>
+        <Permission>
-            <Permission>VaccinationVedligeholdAnbefalet</Permission>
+            <PermissionId>VaccinationVedligeholdAnbefalet</PermissionId>
             <PermissionDescription>Opret, ret eller slet anbefalede vaccinationer</PermissionDescription>
-        </PermissionNameDescription>
+        </Permission>
         <Created>2016-01-04T10:10:00Z</Created>
         <EffectiveFrom>2016-01-04T10:10:00Z</EffectiveFrom>
         <EffectiveTo>2017-01-31T00:00:00Z</EffectiveTo>
     </Delegation>
-    <Delegation>
+</CreateDelegationsResponse>
-        <DelegationId>2079412A-FC09-4072-A5DA-039B80357369</DelegationId>
-        <DelegatorCpr>1206879196</DelegatorCpr>
-        <DelegateeCpr>0304838140</DelegateeCpr>
-        <System>TAS</System>
-        <SystemLongName>Tilskudsansøgningsservicen</SystemLongName>
-        <Role>Læge</Role>
-        <RoleDescription>Autoriseret tandlæge</RoleDescription>
-        <State>Anmodet</State>
-        <PermissionNameDescription>
-            <Permission>*</Permission>
-            <PermissionDescription>Alle nuværende og fremtidige delegerbare rettigheder</PermissionDescription>
-        </PermissionNameDescription>
-        <Created>2016-02-03T13:14:00Z</Created>
-        <EffectiveFrom>2016-02-03T13:14:00Z</EffectiveFrom>
-        <EffectiveTo>2017-02-03T10:10:00Z</EffectiveTo>
-    </Delegation>
-</CreateDelegationResponse>
 </code>