Objektverwaltung:Makros

Um ein neues Makro zu erstellen, wechseln Sie zunächst in den Entwicklermodus und wählen den Menüpunkt Objektverwaltung.

Ein Makro ist eine Gruppe von Aktionen, die jeweils eine bestimmte Operation ausführen, wie z.B. das Öffnen eines Formulars oder das Ausführen eines Serverbefehles. Mit Hilfe von Makros können Sie häufig vorkommende Aufgaben automatisieren. Sie können z.B. ein Makro erstellen, das einen Import ausführt, d. h. Daten löscht, diese neu importiert und z. B. im Anschluss einen Erfolgsbericht öffnet, wenn ein Benutzer dieses über einen Menüpunkt aufruft.

Um das Makro mit Eigenschaften zu versehen, öffnet man mit Klick auf die Schaltfläche „Entwurf“, per Klick mit der rechten Maustaste das Kontext-Menü oder per Doppelklick den Batchdesigner. Über den Menüpunkt „Neu“ kann hier auch ein neues Makro angelegt werden.

Zur Verfügung stehende Aktionen:

• NavAktion
• ServerBefehl
• Meldung
• Url

Die erstellten Aktionen werden im Batchdesigner dann nach einander abgearbeitet. Um die Reihenfolge der Abarbeitung zu ändern stehen der Button als auch zur Verfügung.

Framework, Batchdesigner

Je nach ausgewählter Aktion stehen dem Anwender verschiedene Konfigurationsmöglichkeiten zur Verfügung.

NavAktion

NavAktionen ermöglichen es zum Beispiel, Masken, Dimensionen etc. zu öffnen. Zusätzlich können NavAktionen auch zum Beispiel Formeln, Importe etc. ausführen. Eine Beschreibung aller NavAktionen finden Sie hier.

Framework, NavAktion

ServerBefehl

Hier stehen verschiedenste Serverbefehle zur Auswahl.

Befehl	Beschreibung
Alle Tabellen komprimieren	Komprimiert alle Tabellen, bei denen eine Partitionierung aktiv ist.
Azure Data Factory Pipeline ausführen (Ab CoPlanner 11 Release 1 2026)	Läuft der CoPlanner über die CoPlanner SaaS Umgebung, kann man hier Pipelines ansteuern.
Benutzerparameter setzen (Ab CoPlanner 11 Release 1 2025)	Mit diesem Befehl kann man den Wert für einen Benutzerparameter für den Benutzer, der das Makro ausführt, setzen. Ab CoPlanner 11 Release 2 2025 kann man aus einer Liste der Benutzerparameter auswählen, im Release 1 muss man noch den Namen des Parameters (mit @ davor und danach) reinschreiben. Um Funktionen für die Vergabe des Wertes verwenden zu können, muss man ein Transform= vorne anfügen. z.B. Transform=FKT_TABLE_MAX('TBL_GuV_Gesamtkostenverfahren_IST.Zeit', '') holt aus der Tabelle TBL_GuV_Gesamtkostenverfahren_IST die höchste COPSYS_ID, die bei einem Datensatz bei der Zeit vergeben ist.
Datenbank synchronisieren	Erzwingt die Synchronisation des CoPlanner Servers und des SQL Servers bevor weitere CoPlanner - Serverbefehle abgearbeitet werden.
Datenobjekt synchronisieren	Erzwingt die Synchronisation der angegebenen Tabelle/Dimension und des SQL Servers bevor weitere CoPlanner - Serverbefehle abgearbeitet werden.
DBC Execute Procedure	Es können Stored Procedures ausgeführt werden. Der Name der Stored Procedure muss dabei genau dem Namen der Stored Procedure des SQL Server entsprechen (bspw. sp_calc_table). Zusätzlich können hier auch noch Parameter der Stored Procedure übergeben werden. Die einzelnem Parameter werden dabei durch „;“ getrennt, und beginnen jeweils mit einem „@“ (bspw: @param1=ErsterParameter;@param2=ZweiterParameter). Als Parameter können auch Session Variablen (bspw.: @Session_PLAN_ID@) oder Kontext (bspw. @Context.PcKst@) übergeben werden. Der Datenbank Connection String sieht wie folgt aus: Server=ServerName;Initial Catalog=DatabaseName;user id=MyUserId; password=MyPassword Hinweis  Keine Hochkommas verwenden bei der Übergabe von Strings.
Ende des IST-Zeitraums in FC setzen	Setzt das Ende des Istzeitraums auf den angegebenen Benutzerparameter
Formel ausführen	Führt die ausgewählte Formel aus.
Formeln auf erster Ebene fertigrechnen	Hinweis: Diese Funktion kann ab CoPlanner 11 Release 3 2025 über den Makroserverbefehl "Formel fertigrechnen" im Modus "Warten auf Berechnungen der ersten Ebene mit hoher Priorität" abgebildet werden. Für inhaltliche Funktionsweise: siehe Beschreibung Serverbefehel "Formel fertigrechnen" in der nächsten Zeile: Formel fertigrechnen -> Modus: Warten auf Berechnungen der ersten Ebene mit hoher Priorität.
Formeln fertigrechnen (Ab CoPlanner 11 Release 3 2025)	Hiermit kann die Funktion "Waitforcalc/Warten auf Berechnungen" eingestellt werden. Es gibt verschiedene Modi die ausgewählt werden können. Die Funktionsweise kann der folgenden Tabelle entnommen werden. Modus Programmverhalten Alle Berechnungen abschließen Wartet, bis alle Formeln fertig gerechnet sind Warten auf alle Formeln aus der eigenen Session Ähnliche Funktionsweise wie "Alle Berechnungen abschließen". Allerdings werden nur Formelausführungen der "eigenen" Session unabhängig von der Priorität berücksichtigt. Achtung!  Dadurch kann sich die Reihenfolge der Berechnungen ändern! Warten auf Berechnungen der ersten Ebene mit hoher Priorität Nach dem Schreiben wird einmal geprüft, welche Formeln zu berechnen sind, auf alle Formeln mit Priorität < 0 (hohe Priorität) & direkt getriggert wird gewartet. Hinweis: Für Zeilensichten, ist dies die Standardeinstellung. Für Matrixmasken, kann dies optional eingestellt werden. Warten auf Berechnungen mit hoher Priorität Nach dem Schreiben werden alle Formeln mit einer Priorität < 0 (hohe Priorität) ausgeführt. Es wird dabei so lange in die Formelqueue geschaut, solange Formeln mit Priorität < 0 vorhanden sind. Warten auf Formeln aus der eigenen Session mit hoher Priorität Ähnliche Funktionsweise wie "Warten auf Berechnungen mit hoher Priorität", allerdings werden nur Formelausführungen der "eigenen" Session mit einer Priorität < 0 (hohe Priorität) berücksichtigt. Achtung!  Dadurch kann sich die Reihenfolge der Berechnungen ändern!
Formelwerk aktivieren	Aktiviert das CoPlanner Formelwerk.
Formelwerk deaktivieren	Deaktiviert das CoPlanner Formelwerk.
Formula activate	Dieser Serverbefehl kann Formeln aktivieren bzw. deaktivieren. Zusätzlich kann die Formel „Makroaktiv“ gesetzt werden.
Import am Server starten	Startet ein Importobjekt am Server. Da jedes Importobjekt eine Erfolgsmeldung zurückgibt, kann diese Erfolgsmeldung über den Parameter „Rückmeldung aktivieren“ unterdrückt werden.
Log Level setzen	Zu Entwicklungszwecken kann man sich sämtliche Meldungen die im Log generiert werden in der Console/Telnet ausgeben lassen. Im Echtbetrieb wird das nicht empfohlen da es zu Performanceverschlechterungen kommen kann. Konfiguration: Framework, Makro - Loglevel konfigurieren
OffeneBerechnungen abschliessen	Erzwingt die Abarbeitung aller offenen Berechnungen (Formeln). Anschließend wird einen Datenbanksynchronisation erzwungen, bevor weitere Serverbefehle abgearbeitet werden. Hinweis: Diese Funktion kann ab CoPlanner 11 Release 3 2025 über den Makroserverbefehl "Formel fertigrechnen" abgebildet werden. Dazu bitte ein Makro erstellen mit den folgenden 2 Schritten Serverbefehl: Formel fertigrechnen -> Modus: "Alle Berechnungen abschließen" Serverbefehl: Datenbank synchronisieren
OLAP refresh	Makrobefehl zur Aktualisierung von OLAP-Verbindungen (Verbindungen vom CoPlanner-Server zu SSAS werden geschlossen und bei Bedarf neu aufgebaut). Neben dem Aktualisieren der Dimensionen zielt dieser Befehl auch darauf ab eventuelle AdoMD-Caches (Security) zuverlässig löschen zu können. Nach einem Neustart des Clients sollten geänderte Dimensionselemente im CoPlanner ersichtlich sein.
Partitionen aller Tabellen aktualisieren	Alle Tabellen wird neu partitioniert und die Daten den entsprechenden Partitionen zugewiesen.
Partitionen einer Tabelle aktualisieren	Die gewählte Tabelle wird neu partitioniert und die Daten den entsprechenden Partitionen zugewiesen.
Plan kopieren	Kopiert alle Datensätze von einem Plan in einen anderen Plan.
Plansätze löschen	Der ServerBefehl Plansätze löschen, löscht alle Datensätze des ausgewählten Plans aller planabhängigen Tabellen. Wird der Plan auf „Aktueller Plan“ gestellt werden nur Datensätze des Planes gelöscht an den der Benutzer angemeldet ist.
PlanSecurity neu laden	Lädt die Security für den aktuellen Plan neu.
Session Parameter ändern	Ändert Sessioneigenschaften. Hier kann bspw. angegeben werden, dass der Sessionkontext im Makromode ausgeführt wird, damit in weiterer Folge Formeln ausgeführt werden deren Eigenschaft ‚Ausführen im Makromode’ gesetzt ist. Dazu geben Sie bitte folgende Parameter an: Um in den Makromodus zu wechseln: MakroMode=1 Um den Makromodus zu verlassen: MakroMode=0
Tabelle dieses Plans neu rechnen	Es werden alle Datensätze innerhalb des ausgewählten Planes einer Tabelle neu berechnet. Zusätzlich können hier XML Filter für die Datensätze angegeben werden. (Ab CoPlanner 11 Release 4 2023) Es kann nun ausgewählt werden ob nur der aktuelle Plan durchgerechnet werden soll oder alle aktiven, nicht gesperrten Pläne berücksichtigt werden sollen.
Tabelle komprimieren	Gewählte Tabelle wird komprimiert.
Tabellensätze kopieren	Es werden alle Datensätze innerhalb des ausgewählten Planes einer Tabelle in eine andere Tabelle kopiert. Zusätzlich können hier XML Filter für die Datensätze angegeben werden.
Tabellensätze löschen	Es werden alle Datensätze innerhalb des ausgewählten Planes einer Tabelle gelöscht. Zusätzlich können hier XML Filter für die Datensätze angegeben werden. Neben der Auswahl der Tabelle muss auch ein zu löschender Plan gewählt werden. Dies kann durch explizite Auswahl eines bestimmten Plans oder mit der Funktion „Aktueller Plan“ automatisch bezogen auf den Plan der Anmeldung erfolgen. Bei Wahl der Option „planunabhängig“ werden die Daten der gewählten Tabelle aus allen Plänen gelöscht! Siehe nachfolgendes Beispiel.
Webimport am Server starten	Startet einen Webimport am Server. Da jeder Import eine Erfolgsmeldung zurückgibt, kann diese Erfolgsmeldung über den Parameter „Rückmeldung aktivieren“ unterdrückt werden. Zur Auswahl stehen nur Webimporte mit der Quelle Stage, da bei den anderen eine Benutzerinteraktion benötigt werden würde. Achtung: der Webimport verfügt über keine Filter und wertet daher keinen Kontext aus.
Skript am Server ausführen	Wenn die Option AllowBatchProcessingViaMacro in der svrconifg.xml auf true gesetzt ist, dann kann man diesen Befehl auswählen. Am Server muss dafür ein Ordner "Scripts" vorhanden sein, welcher die Skriptdateien enthält, die ausgeführt werden können. Zusätzlich kann man Session-Variablen als Parameter übergeben. Die Scripts müssen auf .bat enden. Dann werden Sie im Makroexecutor automatisch angezeigt.
Trigger a link (Ab CoPlanner 11 Release 4 2023, experimentelles Feature)	Mit diesem Befehl kann ein Link getriggert werden. Dieses Feature ist experimentell und wurde zur Kommunikation mit dem Microsoft Planner eingeführt. Aufgrund des experimentellen Characters der Änderung, wird es im Windows Client noch nicht in der Auswahlliste angeboten sondern muss manuell eingetragen/eingetippt werden werden. Das bedeutet: Serverbefehl: Trigger a link Parameter 1: Die URL angeben, die gepostet werden soll. (Bzw: das ist eigentlich/im Normalfall die Server/Internetadresse an die der Inhalt der Payload verschickt wird. Diese muss natürlich empfangsbereit sein und die Daten verarbeiten können). Parameter 2: Den Namen einer CoPlanner Tabelle angeben. Das Makro erstellt eine "Payload" aus allen Textspalten der angegeben Tabelle die nicht mit "COPSYS_" beginnen.

Beispiel Tabellensätze löschen

Es sollen mit einem Makro alle Datensätze aus einer Tabelle gelöscht werden die zum angemeldeten Plan gehören. Legen Sie dazu ein neues Makro an und wählen Sie als Aktion „Serverbefehl“ und treffen Sie die Einstellungen wie in folgender Abbildung dargestellt.

Framework, Makro – Tabellensätze löschen

Rufen Sie den Filter – Editor auf mit einem Klick auf die Schaltfläche .

Framework, Makro – Filter - Editor

Wählen Sie aus dem Kombinationslistenfeld den Eintrag „BAB_Plan“ und im Filter „Unternehmen“ die „Bike GmbH“ aus. Mit einem Klick auf die Schaltfläche „Hinzufügen“ wird diese Einstellung übernommen. Durch das Ersetzen des Kriteriums mit der Sessionvariable @Session_Unternehmen_ID@ bezieht sich dieser Filter immer auf das angemeldete Unternehmen.

Sollten Sie diese Filter mehrmals benötigen, können Sie diesen mit dem Befehl „Filter speichern“ sichern und mit „Filter laden“ wieder einfügen.

Beispiel Tabellensätze in Abhängigkeit eines Dimensionsattributes löschen

Es sollen mit einem Makro alle Datensätze aus einer Tabelle gelöscht werden, die einer Attributausprägung in einer Dimension entsprechen. In diesem Beispiel werden aus der Tabelle "Tab1" alle Datensätze gelöscht, die in der Dimension im Attribut "AttribFeld" den Wert "True" enthalten.

Framework, Makro – Filter - Editor

Spalte	Ausdruck
Feld	Standard Dimension Column Name
Vergleichstyp	Muss zum Datentyp passen (me ist =, not_me ist <>, usw.)
Kriterium	Muss auch zum Datentyp passen
Type	BY_ATTRIBVAL_FeldNameInDim (In diesem Beispiel heißt das Attributsfeld in der Dimension "AttribFeld"

Beispiel Tabellensätze in Abhängigkeit einer Anwendungseigenschaft löschen

Es sollen mit einem Makro alle Datensätze aus einer Tabelle gelöscht werden, die einem Dimensionselement aus den Anwendungseigenschaften entsprechen.

Framework, Makro – Filter - Editor

Tabellensätze in Abhängigkeit einer anderen Tabelle löschen

Über ein FKT_GetRecord im Kriterium kann eine Eigenschaft aus einer anderen Tabelle abgerufen werden. Hier muss vor dem FKT_GetRecord ein Transform= stehen.

z.B.: Transform=FKT_GetRecord(TabRecordToDelete.Zeit_1,Unternehmen != @Session_Unternehmen_ID@)

Holt den Eintrag der Zeit aus der Zeile der Tabelle TabRecordToDelete, bei der das Unternehmen dem Unternehmen entspricht, auf dem man angemeldet ist.

Meldung

Dem Anwender können mit Meldungen Informationen über die Ausführung des Makros am Client angezeigt werden. Dazu wird der Meldungstext, Meldungstitel und der Meldungstyp eingegeben.

Framework, Makro - Meldung

Meldungstypen

Fehler Framework, Makro - Meldung - Fehler	Ausnahme Framework, Makro - Meldung - Ausnahme	Information Framework, Makro - Meldung - Information	Frage Framework, Makro - Meldung - Frage
Kein Symbol Framework, Makro - Meldung - Kein Symbol	Stop Framework, Makro - Meldung - Stop	Warnung Framework, Makro - Meldung - Warnung

URL

Ab CoP 10 HF 2.5

Bietet die Möglichkeit bei im Webclient ausgeführten Makros z.B. andere Masken zu öffnen.

Achtung!  Nach diesem Schritt werden keine weiteren Schritte des Makros ausgeführt. Sollte es sich bei dem Makro um ein Submakro handeln, werden auch die weiteren Schritte des aufrufenden Makros nicht weiter ausgeführt. Sollte der Schritt durch z.B. eine Fortsetzungsbedingung nicht ausgeführt werden läuft das Makro wie bisher weiter.

Der Kontext kann bei diesem Befehl verwendet werden. Wird das Makro z.B. aus einer Maske aufgerufen und es werden Filter übergeben, so kann man auf diese mit @Context.<Filtername>@ zugreifen. Wird z.B. der Filter PC/KST übergeben, dann könnte so ein Link folgendermaßen aussehen: @Session_WebAppUrl/pivottable/?pivotform=EM Umsatzerloese PLAN&contextFilters="PC/KST" mu @Context.PC/KST@

Fortsetzungsbedingung

Die Fortsetzungsbedingung dient dazu, um die Weiterführung des Makros steuern zu können. Wird sie aktiv geschalten, muss die Bedingung zutreffen, um mit dem Makro fortzufahren. Trifft die Bedingung nicht zu, wird das Makro genau an der Stelle beendet. Es besteht die Möglichkeit mittels einer Meldung auf den Abbruch hinzuweisen.

Framework, Makro - Fortsetzungsbedingung - Inaktiv

Framework, Makro - Fortsetzungsbedingung - Aktiv

Es müssen für die Bedingung beide Ausdrucksfelder befüllt werden. Ein Ausdruck kann eine Abfrage zum CoPlanner Server mittels der Funktionen die das Rechenwerk bereitstellt, ein SQL Statement auf die CoPlanner Systemdatenbank oder ein konstanter Wert sein. Die Abfrage zum CoPlanner Server wird mittels Transform=, eine SQL Server Abfrage mittels Sql= gekennzeichnet. Ein konstanter Wert wird ohne besondere Kennung eingetragen.

Beispiele:

Framework, Makro - Fortsetzungsbedingung – Sql kombiniert mit CoPlanner Abfrage

Framework, Makro - Fortsetzungsbedingung - Sql kombiniert mit konstantem Wert

Framework, Makro - Fortsetzungsbedingung - Session-Variable kombiniert mit konstantem Wert

Bei konstanten Werten muss der Datentyp beachtet werden. Liefert die SQL bzw. CoPlanner Abfrage als Ergebnis eine Zeichenfolge, muss der Wert unter einfache Anführungszeichen gestellt werden. Liefert die Abfrage als Ergebnis einen numerischen Wert, entfallen die Anführungszeichen. Wird eine SQL Abfrage definiert, welche nicht genau einen Wert, sondern eine Ergebnistabelle liefert, wird der Wert der linken, oberen Ecke für den Vergleich herangezogen.

Framework, Makro - Fortsetzungsbedingung - Ergebnis bei Abfrage mit Tabelle als Ergebnis

Im folgenden SQL Statement-Beispiel wird überprüft ob in der Tabelle CPM_TBL_BUD_PAYMENTS für den aktuellen Plan und das Project an dem der Benutzer gerade angemeldet ist Datensätze vorhanden sind:

Sql=select cast(count(*) as bigint) from CPM_TBL_BUD_PAYMENTS where COPSYS_PLAN_ID = @Session_PLAN_ID@ and Projects = (select top 1 value from tb_SessionParameters where Name = 'Projects' and COP_SESSION_ID = @Session_ID@)

Liefert die SQL Abfrage keine einzige Zeile, so kann dies mittels der Konstante ‘NULL‘ abgefragt werden.

Framework, Makro - Fortsetzungsbedingung - Abfrage ob Datensätze geliefert werden

Ausdrücke können auch mit CoPlanner Sessionvariablen versehen werden. Vor der eigentlichen Evaluierung des Ausdrucks werden diese durch den entsprechenden Wert ersetzt. Sessionvariablen können auch als konstanter Wert verwendet werden.

Framework, Makro - Fortsetzungsbedingung - Abfrage mit Session Variable

Ist die Option „Meldung bei Nichterfüllung“ aktiviert, wird bei Abbruch des Makros dem Benutzer die Meldung mit dem entsprechenden Text angezeigt. Ist die Option nicht aktiv, wird das Makro ohne weitere Meldung beendet.

Framework, Makro - Fortsetzungsbedingung - Meldung bei Nichterfüllung