Namensraum Isom.Plan.ActionPlan
Beschreibung
Der Ausführungsplan ist gewissermaßen die Ausführungs-Ansicht der im Therapieplan geplanten konkreten Therapieplanaktionen.
Während jedoch der Therapieplan die fachlichen Zusammenhänge zwischen Aktionen beschreibt (Aktionen und deren resultierende Aktionen), umfasst der daraus berechnete Aktionsplan (=Ausführungsplan) die Ausführungsreihenfolge, die Parallelität und den aktuellen Ausführungszustand der Aktionen während der Therapiesitzung.
Der Aktionsplan ist maschenartig strukturiert und gliedert sich hierarchisch in
- Phasen (sequentiell abzuarbeiten),
- Pfade (je N-Kanal, innerhalb einer Phase parallel abzuarbeiten) und
- Aktionsplanelemente (innerhalb eines Pfades sequentiell)
Funktionen
|
Isom.Plan.ActionPlan.Cancel |
Bricht eine Aktionsplanausführung ab.
Bricht eine Aktionsplanausführung ab.
Diese Funktion bewirkt, dass eine Aktionsplanausführung vorzeitig abgebrochen wird. Dabei wird versucht, alle Ausführungsfäden des Aktionsplans geordnet zu beenden. Die für dieses geordnete Beenden zur Verfügung stehende Zeitspanne wird als Parameter angegeben. Können die Ausführungsfäden in dieser Zeit angehalten werden, kehrt die Funktion mit 'true' zurück. In diesem Fall kann nach Rückkehr der Funktion die Sitzung fortgeführt werden. Können die Ausführungsfäden in dieser Zeit nicht angehalten werden, kann die Konsistenz des ISOM-Datenmodells nicht mehr gewährleistet werden. Daher geht ISOM dann in den Zustand über, der auch mit Aufruf von Isom.Context.ContextConfiguration.FinalizeSession() erreicht wird. Danach lässt sich die Sitzung nur noch beenden.
-
Parameter:
-
|
timeout
|
Zeitspanne, in der der Aktionsplan abgebrochen werden soll |
-
Rückgabe:
- Isom.Base.Boolean
'true', falls die Aktionsplanausführung geordnet abgebrochen wurde. 'false' sonst.
-
Datum:
- letzte Änderung am 21.09.2010
|
Isom.Plan.ActionPlan.Clone |
Erzeugt eine identische Kopie des Objekts.
Erzeugt eine identische Kopie des Objekts.
-
Rückgabe:
- Das geklonte Objekt.
|
Isom.Plan.ActionPlan.ContainsAsyncBlock |
Ermittelt ob der Aktionsplans asynchrone Aktionen enthält.
Ermittelt ob der Aktionsplans asynchrone Aktionen enthält.
Es wird geprüft, ob der Aktionsplans asynchrone Aktionen enthält. Der Ausführungszustand der Aktionen wird nicht berücksichtigt.
-
Rückgabe:
- 'true', wenn der Aktionsplan mindestens eine asynchrone Aktion enthält, sonst 'false'.
|
Isom.Plan.ActionPlan.DeletePreservedSession |
Löscht eine persistierte Sitzung.
Löscht eine persistierte Sitzung.
-
Vorbedingung:
- Es existiert eine konservierte Sitzung (d.h. PreservedSessionExists() liefert 'true')
-
Rückgabe:
- 'true' wenn die konservierte Sitzung gelöscht werden konnte.
|
Isom.Plan.ActionPlan.DoTp2Ap |
Ermittelt zum aktuellen Therapieplan den zugehörigen Aktionsplan und setz diesen als aktuellen Aktionsplan.
Ermittelt zum aktuellen Therapieplan den zugehörigen Aktionsplan und setz diesen als aktuellen Aktionsplan.
Für Top-Level-Aufrufe sollte stattdessen die verschattete Funktion Isom.Global.Processes.DoTp2Ap() verwendet werden.
-
Rückgabe:
- 'true', falls ein ausführbarer Aktionsplan erfolgreich ermittelt wurde, 'false' sonst.
-
Siehe auch:
-
Isom.Global.Processes.DoTp2Ap() für den Einsprungspunkt, der diese Funktion typischerweise verwendet.
|
Isom.Plan.ActionPlan.ExecuteActionPlan |
Startet die Ausführung des Aktionsplans.
Startet die Ausführung des Aktionsplans.
Für Top-Level-Aufrufe sollte stattdessen die verschattete Funktion Isom.Global.Processes.ExecuteActionPlan() verwendet werden.
-
Rückgabe:
- 'true', falls alle Aktionen im Aktionsplan erfolgreich ausgeführt wurden, 'false' sonst.
-
Siehe auch:
-
Isom.Global.Processes.ExecuteActionPlan() für den Einsprungspunkt, der diese Funktion typischerweise verwendet.
|
Isom.Plan.ActionPlan.GetAllPropertyNames |
Liefert die Namen aller Eigenschaften des Aktionsplans.
Liefert die Namen aller Eigenschaften des Aktionsplans.
-
Veraltet:
- Wird seit Version 6.5.0.0 nur noch aus Kompatibilitätsgründen unterstützt. Der Abruf der Eigenschaftsnamen wird seitdem durch die Funktion Isom.Context.Ecu.GetPropertyNames() bereitgestellt.
-
Rückgabe:
- Liste aller Eigenschaftsnamen des Aktionsplans.
|
Isom.Plan.ActionPlan.GetCurrentActionChannel |
Liefert den N-Kanal, über den die aufrufende Aktion durchgeführt wird.
Liefert den N-Kanal, über den die aufrufende Aktion durchgeführt wird.
-
Rückgabe:
- N-Kanal, über den die aufrufende Aktion durchgeführt wird Statische Funktion.
|
Isom.Plan.ActionPlan.GetEstimatedRuntime |
Ermittelt die prognostizierte Gesamtausführungszeit.
Ermittelt die prognostizierte Gesamtausführungszeit.
-
Rückgabe:
- Die prognostizierte Gesamtausführungszeit in Sekunden.
|
Isom.Plan.ActionPlan.GetInstance |
Ermittelt den für diese ISOM-Sitzung gültigen Aktionsplan.
Ermittelt den für diese ISOM-Sitzung gültigen Aktionsplan.
-
Rückgabe:
- Der für diese ISOM-Sitzung singuläre Aktionsplan.
-
Ausnahmebehandlung:
- Es wird das Void-Objekt zurückgegeben, falls die Funktion in einer Phase des Phasenmodells aufgerufen wird, in der noch kein Aktionsplan existiert.
|
Isom.Plan.ActionPlan.GetPhase |
Ermittelt für den angegebenen Phasenbezeichner die zugehörige Aktionsplanphase.
Ermittelt für den angegebenen Phasenbezeichner die zugehörige Aktionsplanphase.
-
Rückgabe:
- Aktionsplanphase oder Void-Objekt, falls es für diesen Phasenbezeichner keine Aktionsplanphase gibt.
|
Isom.Plan.ActionPlan.GetPhases |
Ermittelt Liste von Phasenbezeichnern.
Ermittelt Liste von Phasenbezeichnern.
Mit Hilfe dieser Phasenbezeichner kann über die Funktion 'GetPhase' auf die entsprechende Phase zugegriffen werden. Der Bezeichner ist der Index der Phase und damit eine Ganzzahl von 1 bis einschließlich Phases.Count (Anzahl der vorhandenen Phasen)
-
Zu beachten:
- Phasen, die ausschließlich Aktionen im Zustand 'Rescheduled' beinhalten, werden im Normalfall ausgeblendet. Dies kann Autoren-seitig durch folgenden Konfigurationscode vermieden werden:
Isom.Context.ContextConfiguration.SetProp("ActionPlan.Iterators.SuppressRescheduledActions","false")
-
Rückgabe:
- Liste von Phasenbezeichnern.
|
Isom.Plan.ActionPlan.GetPreservedSessionVersion |
Gibt die Versionskennung einer existierenden konservierten Sitzung zurück.
Gibt die Versionskennung einer existierenden konservierten Sitzung zurück.
-
Vorbedingung:
- Es existiert eine konservierte Sitzung (d.h. PreservedSessionExists() liefert 'true')
-
Rückgabe:
- Die Versionskennung der konservierten Sitzung, bzw. das Void-Objekt, falls keine konservierte Sitzung existiert.
|
Isom.Plan.ActionPlan.GetProcessedRuntime |
Ermittelt die Gesamtausführungszeit des Aktionsplans.
Ermittelt die Gesamtausführungszeit des Aktionsplans.
-
Rückgabe:
- Die tatsächliche Gesamtausführungszeit in Sekunden.
|
Isom.Plan.ActionPlan.GetProp |
Ermittelt den Wert der vorgegebenen Eigenschaft (property) des Aktionsplans.
Ermittelt den Wert der vorgegebenen Eigenschaft (property) des Aktionsplans.
Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.
-
Rückgabe:
-
Wert der Eigenschaft.
-
Ausnahmebehandlung:
- Es wird das Void-Objekt zurückgegeben, falls der Wert ungesetzt oder gleich "" ist.
|
Isom.Plan.ActionPlan.GetPropNames |
Liefert die Namen aller technischen Eigenschaften für den AktionsPlan.
Liefert die Namen aller technischen Eigenschaften für den AktionsPlan.
Es werden die Eigenschaftsnamen für die technischen Eigenschaften (siehe Isom.Plan.ActionPlan.GetProp()) zurückgeliefert. Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.
-
Rückgabe:
- Isom.Base.StringList
Liste der Namen aller technischen Eigenschaften für den AktionsPlan.
-
Siehe auch:
-
Isom.Plan.ActionPlan.GetProp()
-
Datum:
- letzte Änderung am 09.09.2010
|
Isom.Plan.ActionPlan.IsActionPlanRestarting |
Prüft, ob der Aktionsplan neu gestartet (vs.
|
Isom.Plan.ActionPlan.IsVoid |
Bestimmt, ob es sich um das Void-Objekt handelt.
Bestimmt, ob es sich um das Void-Objekt handelt.
-
Rückgabe:
- 'true', falls dies das Void-Objekt ist, 'false' sonst.
|
Isom.Plan.ActionPlan.Pause |
Die Funktion Pause hält die Ausführung des Aktionsplans zum nächst möglichen Zeitpunkt an.
Die Funktion Pause hält die Ausführung des Aktionsplans zum nächst möglichen Zeitpunkt an.
Bereits laufende Aktionen werden zu Ende ausgeführt, aber es wird nicht mit der Ausführung weiterer Aktionen begonnen. Die Funktion kehrt erst zurück, wenn die Ausführung angehalten wurde oder der Versuch, die Ausführung anzuhalten, fehlgeschlagen ist.
-
Rückgabe:
- 'true' wenn die Aktionsplanausführung erfolgreich angehalten wurde und mit Resume() fortgesetzt werden kann.
- 'false' wenn die Aktionsplanausführung bereits angehalten war.
-
Ausnahmebehandlung:
- Es wird das Void-Objekt zurückgegeben, falls die Aktionsplanausführung nicht angehalten werden konnte, da die Funktionalität nicht zur Verfügung steht oder weil ein Fachdienstaufruf gescheitert ist. Dies ist auch der Fall, wenn der verwendete Fachdienst das Funktionsmerkmal nicht unterstützt.
-
Siehe auch:
-
Isom.Plan.ActionPlan.Resume() zum Fortsetzen einer unterbrochenen Sitzung.
|
Isom.Plan.ActionPlan.PreservedSessionExists |
Überprüft, ob eine konservierte Sitzung gefunden werden kann.
Überprüft, ob eine konservierte Sitzung gefunden werden kann.
-
Rückgabe:
- 'true' wenn eine Sitzung gefunden wurde, 'false' sonst
|
Isom.Plan.ActionPlan.PreserveSession |
Löst die Konservierung der aktuellen ISOM-Sitzung aus.
Löst die Konservierung der aktuellen ISOM-Sitzung aus.
Dadurch wechselt ISOM in den Processing-State "Pause", in dem die ISOM-Sitzung beendet oder aus dem heraus die Sitzung fortgesetzt werden kann. Begonnene Aktionen werden noch zu Ende geführt.
-
Rückgabe:
- immer 'true'
|
Isom.Plan.ActionPlan.RestartActionPlan |
Initiiert die Neuausführung des Aktionsplans.
Initiiert die Neuausführung des Aktionsplans.
-
Achtung:
- Die Funktion setzt im Wesentlichen nur ein Flag, welches die kontrollierte Beendigung von ExecuteActionPlan() zum nächstmöglichen Zeitpunkt veranlasst/signalisiert und kehrt dann sofort zurück. Auf diese Weise kann z.B. Maßnahmensteigerung durch wiederholte Ausführung des Aktionsplans umgesetzt werden. Die eigenliche Maßnahmensteigerung ist nach Beendigung von ActionPlan.ExecuteActionPlan() in Processes.ExecuteActionPlan() vorzusehen (s. Zusammenhängendes Beispiel für die Autorengesteuerte Maßnahmensteigerung).
- Vor- und Nachbereiter für den Aktionsplan (
PreparePlan()
, FinishPlan()
) werden auch im Restart-Fall-ausgeführt.
-
Zu beachten:
- Die Funktion ist primär für die Autorengesteuerte Maßnahmensteigerungsbehandlung sinnvoll.
- Im Sinne einer für den Autoren möglichst transparenten Maßnahmensteigerungsbehandlung führt
RestartActionPlan()
folgende Schritte selbständig aus: - Deaktivieren des Therapieplan-orientierten Abbruchmodells für die aktuell ausgeführte Aktion (entspricht Autorenaufruf
TherapyPlanAction.SetContinueOnError(true)
und kann demzufolge mittels TherapyPlanAction.SetContinueOnError(false)
nach RestartActionPlan()
rückgängig gemacht werden). - Deaktivieren des Steuergeräte-orientierten Abbruchmodells für die aktuell ausgeführte Aktion (entspricht Autorenaufruf
TherapyPlanAction.SetContinueWithEcuOnError(true)
und kann demzufolge mittels TherapyPlanAction.SetContinueWithEcuOnError(false)
nach RestartActionPlan()
rückgängig gemacht werden). - Aktualisieren des Aktionsplans (entspricht Autorenaufruf
ActionPlan.DoTp2Ap()
)
-
Rückgabe:
- 'true' im Erfolgsfall, 'false' sonst.
-
Ausnahmebehandlung:
- Es wird das Void-Objekt zurückgegeben, falls sich ISOM nicht im Aktionsplan-Ausführungszustand befindet.
-
Siehe auch:
-
Zusammenhängendes Beispiel für die Autorengesteuerte Maßnahmensteigerung für ein zusammenhängendes Beispiel.
-
Isom.Plan.ActionPlan.IsActionPlanRestarting() für die Funktion zur Prüfung, ob ein Neustart stattgefunden hat.
|
Isom.Plan.ActionPlan.Resume |
Die Funktion Resume setzt die Aktionsplanausführung fort, nachdem sie durch Pause() angehalten wurde.
Die Funktion Resume setzt die Aktionsplanausführung fort, nachdem sie durch Pause() angehalten wurde.
-
Rückgabe:
- 'true' wenn die Aktionsplanausführung erfolgreich fortgesetzt werden konnte.
- 'false' wenn die Aktionsplanausführung nicht fortgesetzt werden konnte, weil sie zuvor nicht erfolgreich angehalten wurde.
-
Ausnahmebehandlung:
- Es wird das Void-Objekt zurückgegeben, falls die Aktionsplanausführung nicht wieder aufgenommen werden konnte, da die Funktionalität nicht zur Verfügung steht oder weil ein Fachdienstaufruf gescheitert ist. Dies ist auch der Fall, wenn der verwendete Fachdienst das Funktionsmerkmal nicht unterstützt.
-
Siehe auch:
-
Isom.Plan.ActionPlan.Pause() zum Unterbrechen einer Sitzung mit Möglichkeit zum Fortsetzen.
|
Isom.Plan.ActionPlan.ResumePreservedSession |
Setzt eine evtl.
existierende konservierte Sitzung fort.
Für Top-Level-Aufrufe sollte stattdessen die verschattete Funktion Isom.Global.Processes.CheckForPreservedSession() verwendet werden.
-
Rückgabe:
- 'true' wenn eine Sitzung wiederaufgeweckt wurde, 'false' sonst
|
Isom.Plan.ActionPlan.SetExecutionOrderGroup |
Legt die Ausführungsreihenfolge aller asynchronen Aktionen innerhalb einer Ausführungsgruppe fest.
Legt die Ausführungsreihenfolge aller asynchronen Aktionen innerhalb einer Ausführungsgruppe fest.
-
Parameter:
-
|
actionplangroupRegex
|
(Isom.Base.String) Regulärer Ausdruck, der auf eine oder mehrere Ausführungsgruppen passt. |
-
Rückgabe:
-
Isom.Base.Boolean
true
, falls Fachfunktionsaufruf erfolgreich
false
sonst.
-
Zu beachten:
- Die Ausführungsgruppen werden über die Annotation
[ActionPlanGroup]
festgelegt.
- Diese Funktion darf ausschließlich innerhalb der Rückruffunktion
SetExecutionOrder
verwendet werden.
- Diese Funktion hat nur Relevanz, wenn die Planausführung über ein ISOM-externes Ausführungssystem partiell oder ganz gesteuert wird.
- Die Reihenfolge der Aufrufe dieser Funktion und der Funktion
SetExecutionOrders
bestimmt die erzwungene Ausführungsreihenfolge.
- Wird für eine Aktion keine Aktionsreihenfolge explizit festgelegt, bleibt die Einfügereihenfolge im Therapieplan bzw. die von der Logistik vorgegebene Reihenfolge erhalten.
-
Siehe auch:
-
Isom.Plan.ActionPlan.SetExecutionOrders
- Annotation
[ActionPlanGroup]
|
Isom.Plan.ActionPlan.SetExecutionOrders |
Legt die Ausführungsreihenfolge der Aktionen fest.
Legt die Ausführungsreihenfolge der Aktionen fest.
Die Reihenfolge der Aufrufe dieser Funktion und der Funktion SetExecutionOrdersAsyncBlock() bestimmt die erzwungene Ausführungsreihenfolge.
Als 'actionname' werden sowohl virtuelle Aktionen (z.B. 'RetofitCCC') als auch konkrete Aktionen (z.B. 'Code') zugelassen. Neben vollständigen Aktionsnamen werden auch reguläre Ausdrücke in C#-Syntax als 'actionname' akzeptiert (z.B. 'Init.*').
Wird für eine Aktion keine Aktionsreihenfolge explizit festgelegt, bleibt die Einfügereihenfolge im Therapieplan bzw. die von der Logistik vorgegebene Reihenfolge erhalten.
Diese Funktion sollte ausschließlich innerhalb der ISOM/L-Funktion SetExecutionOrder() verwendet werden.
-
Rückgabe:
- 'true' wenn die Ausführungsreihenfolge erfolgreich festgelegt werden konnte, 'false' sonst.
|
Isom.Plan.ActionPlan.SetOrderList |
Die Funktion SetOrderList setzt die anzuzeigenden Bestellinformationen.
Die Funktion SetOrderList setzt die anzuzeigenden Bestellinformationen.
Die Übergabeparameter sind drei Einzellisten, die jeweils Zeichenketten für
- Aktion
- Steuergerät
- Bestellnummer bzw. einen Ersatz für selbige enthalten.
-
Rückgabe:
- 'true'
-
Ausnahmebehandlung:
- Es wird das Void-Objekt zurückgegeben bei Aufruf mit einem Void-Objekt oder wenn die Listen unterschiedlich viele Elemente besitzen.
|
Isom.Plan.ActionPlan.SetProp |
Setzt den Wert der vorgegebenen Eigenschaft (property) des Aktionsplans.
Setzt den Wert der vorgegebenen Eigenschaft (property) des Aktionsplans.
Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.
-
Rückgabe:
- liefert immer 'true'
|
Isom.Plan.ActionPlan.ShowAsMessageBox |
Zeigt eine Repräsentation des Aktionsplanes als Popup-Messagebox.
Zeigt eine Repräsentation des Aktionsplanes als Popup-Messagebox.
-
Rückgabe:
- immer 'true'
|
Isom.Plan.ActionPlan.SignalUserInteractionsDone |
Die Funktion SignalUserInteractionsDone gibt für die Aktion, aus der SignalUserInteractionsDone aufgerufen wird, an, dass in der weiteren Ausführung keine Benutzerinteraktionen mehr angezeigt werden und aktualisiert die Zeitprognose bis zur nächsten Benutzerinteraktion dementsprechend.
Die Funktion SignalUserInteractionsDone gibt für die Aktion, aus der SignalUserInteractionsDone aufgerufen wird, an, dass in der weiteren Ausführung keine Benutzerinteraktionen mehr angezeigt werden und aktualisiert die Zeitprognose bis zur nächsten Benutzerinteraktion dementsprechend.
-
Rückgabe:
- 'true'
-
Ausnahmebehandlung:
- Es wird das Void-Objekt zurückgegeben bei Aufruf mit einem Void-Objekt oder wenn die Funktion nicht aus einer ausgeführten Aktion heraus aufgerufen wird.
|
Isom.Plan.ActionPlan.Void |
Erzeugt ein ungültiges Objekt.
Erzeugt ein ungültiges Objekt.
Die Funktion kann in Fehlerfällen verwendet werden, um z.B. einen ungültigen Funktionsrückgabewert zu erzeugen.
-
Rückgabe:
- Ungültiges Objekt.