# Care Plan Generation Service

`IDecisionSupportService` in assembly SanteDB.Core.Api version 3.0.1980.0

## Summary

Service contract for service implementations which generate [CarePlan](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Model_Acts_CarePlan.htm) instances

### Description

The care plan generator is responsible for using the [!:IClinicalProtocolRepositoryService](#!:IClinicalProtocolRepositoryService) (which stores and manages [ICdssProtocol](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Cdss_ICdssProtocol.htm) instances) to generate instances of patient [CarePlan](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Model_Acts_CarePlan.htm) objects which can then be conveyed to the caller and/or stored in the primary CDR.

## Operations

| Operation      | Response/Return             | Input/Parameter                                                                                                                                                                                                                         | Description                                                                                                                    |
| -------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| CreateCarePlan | CarePlan                    | *Patient* **patient**                                                                                                                                                                                                                   | Create a new care plan (using all available protocols for which the patient is eligible)                                       |
| CreateCarePlan | CarePlan                    | <p><em>Patient</em> <strong>patient</strong><br><em>Boolean</em> <strong>groupAsEncounters</strong></p>                                                                                                                                 | Create a new care plan (using all available protocols for which the patient is eligible)                                       |
| CreateCarePlan | CarePlan                    | <p><em>Patient</em> <strong>patient</strong><br><em>Boolean</em> <strong>groupAsEncounters</strong><br><em>IDictionary\<String,Object></em> <strong>parameters</strong><br><em>ICdssLibrary\[]</em> <strong>librariesToUse</strong></p> | Create a new care plan (using all available protocols for which the patient is eligible)                                       |
| Analyze        | IEnumerable\<DetectedIssue> | <p><em>Act</em> <strong>collectedData</strong><br><em>ICdssLibrary\[]</em> <strong>librariesToApply</strong></p>                                                                                                                        | Instructs the implementation to analyze the data for according to the protocols specified in                                   |
| AnalyzeGlobal  | IEnumerable\<DetectedIssue> | *Act* **collectedData**                                                                                                                                                                                                                 | Instructs the implementation to analyze the data provided in using every registered clinical protocol in the SanteDB instance. |

## Implementations

### SimpleCarePlanService - (SanteDB.Core.Api)

Type redirect

#### Service Registration

```markup
...
<section xsi:type="ApplicationServiceContextConfigurationSection" threadPoolSize="4">
	<serviceProviders>
		...
		<add type="SanteDB.Core.Cdss.SimpleCarePlanService, SanteDB.Core.Api, Version=3.0.1980.0, Culture=neutral, PublicKeyToken=null" />
		...
	</serviceProviders>
```

### Default Care Planning Service - (SanteDB.Core.Api)

Represents a care plan service that can bundle protocol acts together based on their start/stop times

#### Description

This implementation of the care plan service is capable of calling [ICdssProtocol](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Cdss_ICdssProtocol.htm) instances registered from the clinical protocol manager to construct [Act](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Model_Acts_Act.htm) instances representing the proposed actions to take for the patient. The care planner is also capable of simple interval hull functions to group these acts together into [PatientEncounter](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Model_Acts_PatientEncounter.htm) instances based on safe time for grouping.

#### Service Registration

```markup
...
<section xsi:type="ApplicationServiceContextConfigurationSection" threadPoolSize="4">
	<serviceProviders>
		...
		<add type="SanteDB.Core.Cdss.SimpleDecisionSupportService, SanteDB.Core.Api, Version=3.0.1980.0, Culture=neutral, PublicKeyToken=null" />
		...
	</serviceProviders>
```

## Example Implementation

```csharp
/// Example Implementation
using SanteDB.Core.Services;
/// Other usings here
public class MyDecisionSupportService : SanteDB.Core.Services.IDecisionSupportService { 
	public String ServiceName => "My own IDecisionSupportService service";
	/// <summary>
	/// Create a new care plan (using all available protocols for which the patient is eligible)
	/// </summary>
	public CarePlan CreateCarePlan(Patient patient){
		throw new System.NotImplementedException();
	}
	/// <summary>
	/// Create a new care plan (using all available protocols for which the patient is eligible)
	/// </summary>
	public CarePlan CreateCarePlan(Patient patient,Boolean groupAsEncounters){
		throw new System.NotImplementedException();
	}
	/// <summary>
	/// Create a new care plan (using all available protocols for which the patient is eligible)
	/// </summary>
	public CarePlan CreateCarePlan(Patient patient,Boolean groupAsEncounters,IDictionary<String,Object> parameters,ICdssLibrary[] librariesToUse){
		throw new System.NotImplementedException();
	}
	/// <summary>
	/// Instructs the implementation to analyze the data for  according to the protocols specified in
	/// </summary>
	public IEnumerable<DetectedIssue> Analyze(Act collectedData,ICdssLibrary[] librariesToApply){
		throw new System.NotImplementedException();
	}
	/// <summary>
	/// Instructs the implementation to analyze the data provided in  using every registered clinical protocol in the             SanteDB instance.
	/// </summary>
	public IEnumerable<DetectedIssue> AnalyzeGlobal(Act collectedData){
		throw new System.NotImplementedException();
	}
}
```

## References

* [IDecisionSupportService C# Documentation](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Services_IDecisionSupportService.htm)
* [SimpleCarePlanService C# Documentation](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Cdss_SimpleCarePlanService.htm)
* [SimpleDecisionSupportService C# Documentation](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Cdss_SimpleDecisionSupportService.htm)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.santesuite.org/developers/server-plugins/implementing-.net-features/service-definitions/care-plan-generation-service.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.