POST PlanCare2Api/ClientReports/ChangeOfUnplannedMeasures

Updates an existing unplanned involuntarycare measure report instance

Deprecated (unavailable from 21.01.1P): Use the endpoint PlanCare2Api/ClientReports/ChangeOfUnplannedMeasureClientReports instead

Requires 'Start' permission for function ClientReportOverview {4250ABB5-A4FD-4362-8B29-79E0D78571E5}

Request Information

URI Parameters

None.

Body Parameters

The clientReport instance based on an unplanned involuntarycare measure that is being updated

ChangeOfUnplannedMeasureClientReport

Name	Description	Type	Additional information
UnplannedMeasureId	The unplanned measure this report is reported on. For reading purposes only	globally unique identifier	-
AppliedFrom	The date when the measure is applied	date	Required
AppliedUntil	The date when the measure is ended. Use 2099-12-31 when end of the measure is unknown.	date	Required
LegalContactRemarks	The remarks of the legal representative. Only used when LegalContact has value NoWithRemarks	string	-
LegalContact	Defines if there has been contact with the legal representative	MeasureLegalContact	Required
ClientResistance	Describes if the client showed any kind of resistance applying the measure	boolean	Required
ClientResistanceDescription	Description of client resistance	string	-
Alternatives	What where the alternatives	string	Required
ApplicationReason	The reason why the measure is applied	string	Required
Measure	The unplanned measure for this report	string	Required
MeasureCategoryId	The unplanned measure category for this report	globally unique identifier	Nullable
MeasureExplanation	Why was this measure chosen	string	Required
Prevention	Which disadvantage had to be prevented	string	Required
RelationNotifyId	The relationId of the employee that should be notified.	integer	Nullable
RelationNotifyLookupName	The lookupname of the employee that should be notified. This property is for reading purposes only.	string	-
Id	The internal id of the report	integer	Required
AggregateId	AggregateId of the report. For reading purposes only.	globally unique identifier	-
ClientId	The internal id of the client	integer	Required
ClientName	The name of the client	string	-
CreationDate	The creation date of the client report	date	-
ModifiedDate	The modified date of the client report	date	-
AvailableFor	Determines the read permission for the report. When the value is 'Disciplines', only the specified disciplines can read the report. When the value is 'Everyone', everyone can read the report. The default value is Everyone	AvailableFor	Required
AvailableForDisciplineIds	The list of disciplines ids that are allowed to read the report.	Collection of integer	-
AvailableForDisciplineNames	The list of disciplines that are allowed to read the report. This property is for reading purposes only.	Collection of string	-
AvailableForDisciplineGroupIds	The list of disciplinegroups ids that are allowed to read the report.	Collection of integer	-
AvailableForDisciplineGroupNames	The list of disciplinegroups that are allowed to read the report. This property is for reading purposes only.	Collection of string	-
Subject	The subject of the client report.	string	Conditional Required: Only required for 'General' client report type
Date	The date of the client report.	date	Required
Priority	The priority of the report.	boolean	Required
PriorityText	The priority of the client report. This property is for reading purposes only.	string	-
EmployeeId	The internal id of employee. This property is for reading purposes only. EmployeeId of the provided token will be used when creating a new ClientReport.	integer	Required
EmployeeName	The original creator of the client report. This property is for reading purposes only.	string	-
ShiftId	The internal id of the shift.	integer	Required
Shift	The shift of the client report. This property is for reading purposes only.	string	-
DisciplineId	The internal id of the discipline.	integer	Required
Discipline	The discipline of the client report. This property is for reading purposes only.	string	-
TypeDescription	The type of the client report. This property is for reading purposes only.	string	-
ReportTags	The tags of the client report.	Collection of ReportTag	-
ReportTagsText	The tags of the client report formatted in a string. This property is for reading purposes only.	string	-
AttributeIds	The list of selected attribute id's.	Collection of integer	Deprecated (unavailable from 21.01.1P): Please use 'ReportTags' instead.
Attributes	The attributes of the client report. This property is for reading purposes only.	string	Deprecated (unavailable from 21.01.1P): Please use 'ReportTagsText' instead.
ParentId	The internal id of the parent client report on which this client report is based.	integer	Nullable
ChildReports	The child reports of the client report.	Collection of ClientReport	-
ContactTypeId	References to a Choice of ChoiceType 'CONTACTTYPE'.	integer	Nullable

Request Formats

application/json, text/json

Sample:

{
  "UnplannedMeasureId": "800e48f1-f595-406b-b3dd-78310d80bc40",
  "AppliedFrom": "2026-05-26T22:08:35.4684127+02:00",
  "AppliedUntil": "2026-05-26T22:08:35.4684127+02:00",
  "LegalContactRemarks": "sample string 4",
  "LegalContact": 0,
  "ClientResistance": true,
  "ClientResistanceDescription": "sample string 6",
  "Alternatives": "sample string 7",
  "ApplicationReason": "sample string 8",
  "Measure": "sample string 9",
  "MeasureCategoryId": "275999c5-3b27-4cd1-92d7-e6450b2a86a1",
  "MeasureExplanation": "sample string 10",
  "Prevention": "sample string 11",
  "RelationNotifyId": 1,
  "RelationNotifyLookupName": "sample string 12",
  "Id": 13,
  "AggregateId": "34bbc1ad-403d-4b61-b74f-c1633a34905a",
  "ClientId": 15,
  "ClientName": "sample string 16",
  "CreationDate": "2026-05-26T22:08:35.4684127+02:00",
  "ModifiedDate": "2026-05-26T22:08:35.4684127+02:00",
  "AvailableFor": 0,
  "AvailableForDisciplineIds": [
    1,
    2
  ],
  "AvailableForDisciplineNames": [
    "sample string 1",
    "sample string 2"
  ],
  "AvailableForDisciplineGroupIds": [
    1,
    2
  ],
  "AvailableForDisciplineGroupNames": [
    "sample string 1",
    "sample string 2"
  ],
  "Subject": "sample string 19",
  "Date": "2026-05-26T22:08:35.4684127+02:00",
  "Priority": true,
  "PriorityText": "sample string 22",
  "EmployeeId": 23,
  "EmployeeName": "sample string 24",
  "ShiftId": 25,
  "Shift": "sample string 26",
  "DisciplineId": 27,
  "Discipline": "sample string 28",
  "TypeDescription": "sample string 29",
  "ReportTags": [
    {
      "$id": "2",
      "Id": 1,
      "Name": "sample string 2"
    },
    {
      "$ref": "2"
    }
  ],
  "ReportTagsText": "sample string 2; sample string 2",
  "AttributeIds": [
    1,
    2
  ],
  "Attributes": "sample string 30",
  "ParentId": 1,
  "ChildReports": null,
  "ContactTypeId": 1
}

application/xml, text/xml

Sample:

<ChangeOfUnplannedMeasureClientReport xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.ClientReport">
  <AggregateId>34bbc1ad-403d-4b61-b74f-c1633a34905a</AggregateId>
  <AttributeIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:long>1</d2p1:long>
    <d2p1:long>2</d2p1:long>
  </AttributeIds>
  <Attributes>sample string 30</Attributes>
  <AvailableFor>Everyone</AvailableFor>
  <AvailableForDisciplineGroupIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:long>1</d2p1:long>
    <d2p1:long>2</d2p1:long>
  </AvailableForDisciplineGroupIds>
  <AvailableForDisciplineGroupNames xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </AvailableForDisciplineGroupNames>
  <AvailableForDisciplineIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:long>1</d2p1:long>
    <d2p1:long>2</d2p1:long>
  </AvailableForDisciplineIds>
  <AvailableForDisciplineNames xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </AvailableForDisciplineNames>
  <ChildReports i:nil="true" />
  <ClientId>15</ClientId>
  <ClientName>sample string 16</ClientName>
  <ContactTypeId>1</ContactTypeId>
  <CreationDate>2026-05-26T22:08:35.4684127+02:00</CreationDate>
  <Date>2026-05-26T22:08:35.4684127+02:00</Date>
  <Discipline>sample string 28</Discipline>
  <DisciplineId>27</DisciplineId>
  <EmployeeId>23</EmployeeId>
  <EmployeeName>sample string 24</EmployeeName>
  <Id>13</Id>
  <ModifiedDate>2026-05-26T22:08:35.4684127+02:00</ModifiedDate>
  <ParentId>1</ParentId>
  <Priority>true</Priority>
  <PriorityText>sample string 22</PriorityText>
  <ReportTags xmlns:d2p1="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface">
    <d2p1:ReportTag>
      <d2p1:Id>1</d2p1:Id>
      <d2p1:Name>sample string 2</d2p1:Name>
    </d2p1:ReportTag>
    <d2p1:ReportTag>
      <d2p1:Id>1</d2p1:Id>
      <d2p1:Name>sample string 2</d2p1:Name>
    </d2p1:ReportTag>
  </ReportTags>
  <Shift>sample string 26</Shift>
  <ShiftId>25</ShiftId>
  <Subject>sample string 19</Subject>
  <TypeDescription>sample string 29</TypeDescription>
  <Alternatives>sample string 7</Alternatives>
  <ApplicationReason>sample string 8</ApplicationReason>
  <AppliedFrom>2026-05-26T22:08:35.4684127+02:00</AppliedFrom>
  <AppliedUntil>2026-05-26T22:08:35.4684127+02:00</AppliedUntil>
  <ClientResistance>true</ClientResistance>
  <ClientResistanceDescription>sample string 6</ClientResistanceDescription>
  <LegalContact>Yes</LegalContact>
  <LegalContactRemarks>sample string 4</LegalContactRemarks>
  <Measure>sample string 9</Measure>
  <MeasureCategoryId>275999c5-3b27-4cd1-92d7-e6450b2a86a1</MeasureCategoryId>
  <MeasureExplanation>sample string 10</MeasureExplanation>
  <Prevention>sample string 11</Prevention>
  <RelationNotifyId>1</RelationNotifyId>
  <RelationNotifyLookupName>sample string 12</RelationNotifyLookupName>
  <UnplannedMeasureId>800e48f1-f595-406b-b3dd-78310d80bc40</UnplannedMeasureId>
</ChangeOfUnplannedMeasureClientReport>

Response Information

Resource Description

Returns the HttpResponseMessage which contains the saved involuntarycare clientreport instance

HttpResponseMessage

Name	Type	Additional information
Version	Version	-
Content	HttpContent	-
StatusCode	HttpStatusCode	-
ReasonPhrase	string	-
Headers	Collection of Object	-
RequestMessage	HttpRequestMessage	-
IsSuccessStatusCode	boolean	-