Changes between Version 19 and Version 20 of Documentatie/Ontwikkelaar/OpenAC3/Scriptfuncties

Timestamp:

07/14/20 13:17:44 (6 years ago)

Author:

henk

Comment:

--

Documentatie/Ontwikkelaar/OpenAC3/Scriptfuncties

@@ -42 +42 @@
 Scriptfuncties worden uitgevoerd voor alle geregistreerde contexten. Als er meerdere scriptfuncties zijn geregistreerd voor één context dan worden ze allemaal uitgevoerd. Zie [#Registratie Registratie] voor informatie over het registreren van scriptfuncties.
 
-Om scriptfuncties uit te voeren moet eerst klasse !TabelScripts worden geïnstantieerd:
+Om scriptfuncties uit te voeren moet eerst klasse !TabelScriptRunner worden geïnstantieerd:
 {{{
 #!csharp
 
-var tabelscripts = new TabelScripts();
+var scriptRunner = new TabelScriptRunner ();
 }}}
 
@@ -54 +54 @@
 #!csharp
 
-var result = await tabelscripts.ExecuteAsync(new PathElement("patient(ACH-H12345)/behandelingen(ACH-H54321)"), HubCommand.UPDATE, TabelScriptWhen.AFTER, new TabelScriptResult());
+var result = await scriptRunner.ExecuteAsync(new PathElement("patient(ACH-H12345)/behandelingen(ACH-H54321)"), HubCommand.UPDATE, TabelScriptWhen.AFTER, new TabelScriptResult());
 }}}
 
@@ -60 +60 @@
 
 In echte code wordt de !PathElement instantie al eerder aangemaakt, met als argument een aan de controller meegegeven pad. !TabelScripts gebruikt !PathElement.ACLPath om alle scriptfuncties uit te voeren die zijn geregistreerd voor "patient/behandelingen" en AFTER UPDATE. Scriptfuncties gebruiken !PathElement.Key om zorgtraject ACH-H54321 op te halen als deze niet is meegegeven of door een eerder uitgevoerde scriptfunctie is opgehaald.
+
+
+== Een nieuwe scriptfunctie maken ==
+Je kunt een nieuwe scriptfunctie maken door interface {{{ ITabelScript }}} te implementeren:
+
+{{{
+#!csharp
+
+public interface ITabelScript
+{
+    IEnumerable<TabelScriptRegistration> RegisterFor { get; }
+    Task<TabelScriptResult> ExecuteAsync(IServiceProvider serviceProvider, PathElement path, string command, TabelScriptWhen when, TabelScriptResult scriptResult);
+}
+
+
+}}}
+
+Scriptfuncties die horen bij de kern van OpenAC staan in OpenACLogica\Modules\Tabellen\Scripts. Scriptfuncties specifiek voor module <x> staan in OpenACLogica\Modules\<x>\Scripts. Geef scriptfuncties een naam die past bij de entiteit waar ze betrekking op hebben met prefix Script, zoals !ZorgtrajectScript.
+
+=== Te implementeren functies ===
+==== RegisterFor ====
+Deze functie geeft één of meerdere contexten terug waarvoor het script moet worden geregistreerd:
+
+{{{
+#!csharp
+
+public IEnumerable<TabelScriptContext > RegisterFor => new List<TabelScriptRegistration> {
+    new TabelScriptContext { Command = HubCommand.DELETE, When = TabelScriptWhen.BEFORE, Path = "patient/behandelingen/fin_trajecten" },
+    new TabelScriptContext { Command = HubCommand.DELETE, When = TabelScriptWhen.AFTER, Path = "patient/behandelingen/fin_trajecten" },
+    new TabelScriptContext { Command = HubCommand.UPDATE, When = TabelScriptWhen.AFTER, Path = "patient/behandelingen/fin_trajecten" }        
+};
+
+}}}
+
+
+
+==== ExecuteAsync ====
+
 
 == [=#Registratie Registratie] ==
@@ -92 +130 @@
 #!csharp
 
-public IEnumerable<TabelScriptRegistration> RegisterFor => new List<TabelScriptRegistration> {
-    new TabelScriptRegistration { Command = HubCommand.DELETE, When = TabelScriptWhen.BEFORE, Path = "patient/behandelingen/fin_trajecten" },
-    new TabelScriptRegistration { Command = HubCommand.DELETE, When = TabelScriptWhen.AFTER, Path = "patient/behandelingen/fin_trajecten" },
-    new TabelScriptRegistration { Command = HubCommand.UPDATE, When = TabelScriptWhen.AFTER, Path = "patient/behandelingen/fin_trajecten" }        
+public IEnumerable<TabelScriptContext > RegisterFor => new List<TabelScriptRegistration> {
+    new TabelScriptContext { Command = HubCommand.DELETE, When = TabelScriptWhen.BEFORE, Path = "patient/behandelingen/fin_trajecten" },
+    new TabelScriptContext { Command = HubCommand.DELETE, When = TabelScriptWhen.AFTER, Path = "patient/behandelingen/fin_trajecten" },
+    new TabelScriptContext { Command = HubCommand.UPDATE, When = TabelScriptWhen.AFTER, Path = "patient/behandelingen/fin_trajecten" }        
 };