Direkten Aufruf aus dem Allevo-Hauptmodul aktivieren

ALLEVO_ACTIVE

* gültig ab Version 3.3 (erweitert in 3.5)

Der Festwert aktiviert das aktuelle Schema für den direkten Aufruf aus dem Allevo-Hauptmodul: auf diese Weise wird beim Speichern Daten im Allevo-Hauptmodul auch sofort die COPA-Schnittstelle aufgerufen. Bitte beachten: im Allevo-Hauptmodul muss zusätzlich SATxx_COPA für den jeweiligen Satelliten gesetzt sein (siehe Doku dort).

Der Festwert ALLEVO_ACTIVE auf Seite der CO-PA Schnittstelle wird aktiviert über einen der folgenden Einträge Spalte Wert von:

· Ein R ist einzutragen, wenn das Schema nur zum Einlesen von Daten aus COPA in den Satelliten aufgerufen werden soll.

· Ein W ist einzutragen für Übernahme von Plandaten nach COPA.

· X aktiviert das Schema sowohl beim Lesen also auch beim Planen.

· T wirkt wie X mit Sonderfunktion des blockweisen Schreibens (siehe unten)

· A wirkt wie X mit zusätzlichem Check auf aktive Objektzuordnungen (ab 3.5 siehe unten).

Bei Übernahme von Plandaten im Allevo-Hauptmodul werden alle COPA-Schemata ausgeführt, bei denen der Festwert ALLEVO_ACTIVE aktiviert ist.

Sonderfunktion A für Schreiben mit Check auf aktive Objektzuordnungen:

In diesem Fall wird zusätzlich überprüft, ob die von Allevo übergebenen Objekte im jeweiligen COPA-Schema auch eine aktive Objektzuordnung haben (ab 3.5). Das kann z.B. sinnvoll sein, wenn Objekte mit unterschiedlichen Merkmalskombinationen (und jeweils unterschiedlichem Schema) verbucht werden sollen.

Sonderfunktion T für blockweises Schreiben:

Werden alle Spaltendefinitionen eines Allevo-Layouts zur Bestimmung der Lese-Schreib-Parameter verwendet (und die entsprechende Schnittstellen-eigene Tabelle ist komplett leer), dann wird über T festgelegt, dass die Daten pro Spaltendefinition als Tabelle gemeinsam an COPA übergeben werden (entsprechend der „total-oder-single-Markierung“ in der letzten Spalte in den Lese-Schreib-Parametern).

Aufruf aus Allevo Planung:

· Die Ausführung eines Schemas kann auf einzelne Allevo-Layouts eingeschränkt werden: das Layout muss in Spalte Wert bis eingetragen sein (ggf. mehrere getrennt über Komma).

· Dieser Bezug auf ein Allevo-Layout ist insbesondere dann erforderlich, wenn Festwerte im Allevo-Layout auch für die COPA-Schnittstelle genutzt werden (z.B. Lesen von Angaben einer Allevo-Spaltendefinition): bei Aufruf direkt aus dem Allevo-Hauptmodul wird das relevante Layout mitgeliefert. Im Dialog-Modus der COPA-Schnittstelle wird das erste Layout aus Spalte Wert bis verwendet (bzw. das *-Layout, wenn im Festwert nichts hinterlegt ist).

Hinweis:

Wird bei Ausführung COPA-Schnittstelle über die Dialogtransaktion kein Schema mitgegeben, dann werden auch dort alle Schemata ausgeführt, für die der Festwert ALLEVO_ACTIVE aktiv ist. Wird stattdessen ein * im Eingabefeld zum Schema eingetragen, dann werden alle Schemata des Satelliten ausgeführt!

* Neu ab Allevo-Version 3.5

Sonderfunktion A mit Überprüfung auf aktiviert Objekte bei Aufruf aus Allevo Planung.

Erfassung Plandaten mit abweichender Währung

CURRENCY

* gültig ab Version 3.0

Der Festwert erlaubt es, Planwerte in einer Währung zu erfassen, die von den der Währung im Ergebnisbereich bzw. Buchungskreis abweicht. Bei Verwendung dieses Festwertes wird angenommen, dass alle Werte in der Satellitentabelle in dieser Währung vorliegen.

Bei Bedarf macht die Allevo-COPA-Schnittstelle automatisch eine Umrechnung auf die Währung im Ergebnisbereich (als Basis für die Buchung über den verwendeten SAP BAPI). Zum Umrechnungskurs siehe Festwert EXRATE_TYPE.

Der Festwert wird aktiviert durch Eintrag der gewünschten Währung in Spalte Wert von.

Hinweis:

Alternativ dazu kann die Währung auch aus einem Feld der Satellitentabelle übernommen werden (siehe Festwert FD_CURRENCY). Dann kann mit individueller Währung je Satelliten-Zeile erfasst werden.

Sind beide Festwert nicht gepflegt, muss Erfassung der Planwert entsprechend den Default-Einstellungen zur Währung im SAP System erfolgen (siehe Handbuch „Verwendung der Währung“).

Verteilung von Planwerten

DISTRIBUTION

Die Allevo CO-PA Schnittstelle kennt zwei unterschiedliche Verteilungsfunktionen, die automatisch vor dem Buchen eines Planwertes durchlaufen werden können:

1. Verteilung von Jahreswerten auf Monate

Die Planung für CO-PA erfolgt häufig auf Basis von Jahreswerten je Wertefeld. Im Standardfall werden die Eingaben gleichmäßig auf Perioden verteilt. Es kann jedoch gewünscht sein, die Verteilung auf Perioden (Monate) individuell vorzugeben.

2. Verteilung über ein beliebiges Merkmal

Die Planung für CO-PA kann weniger detailliert erfolgen, als im Ergebnisbereich erwünscht. Es ist möglich, die geplanten Werte/Mengen nach selbstbestimmten Regeln über ein beliebiges Merkmal zu verteilen (z.B. Monatswerte auf Vertriebstage).

Beide Funktionen werden über den Festwert DISTRIBUTION aktiviert und mit Hilfe von Zusatztabellen konfiguriert (siehe Handbuch):

· Wert von enthält den Namen dieser Zusatztabelle, in der die Prozentsätze gepflegt sind;

· Wert bis enthält einen Feldnamenpräfix.

Für die „Verteilung über ein beliebiges Merkmal“ muss in der Feldzuordnung zusätzlich das COPA-Merkmal, über welches verteilt werden möchte, eingetragen und in der RWX-Spalte mit einem „D“ markiert werden.

Ohne dieses markierte Merkmalsfeld wird die „Verteilung von Jahreswerten auf Monate“ versucht, wenn im verwendeten Schema das COPA-Feld PERDE (Periode) nicht zugeordnet ist und MONTH_ACTIVE nicht gesetzt ist, sprich: Jahreswerte geplant werden.

Hinweis:

Die erforderlichen Einstellungen sind ausführlich im Handbuch der CO-PA Schnittstelle erläutert (siehe Abschnitte „Verteilung von Jahreswerten auf Monate“ und „Verteilung über ein beliebiges Merkmal“).

Kurstyp bei Umrechnung von Währungen

EXRATE_TYPE

* gültig ab Version 3.0

Hintergrund: gesteuert über Festwert CURRENCY bzw. FD_CURRENCY kann Allevo mit Währungseinheiten arbeiten, die von der Einheit im Ergebnisbereich abweichen. Die Umrechnung erfolgt automatisch vor Übergabe der Plandaten an die COPA-Buchungsschnittstelle.

Über den Festwert EXRATE_TYPE wird festgelegt, welcher Kurstyp bei einer Umrechnung von Währungen gelten soll. Dieser Kurstyp muss in Spalte Wert von eingetragen sein, z.B. „M“ für Standardumrechnung zum Mittelkurs.

Hinweis:

Ist kein Kurstyp eingetragen, übernimmt die Allevo den Eintrag aus den Attributen zur Planversion im Ergebnisbereich (Tabelle TKEVS).

Für mehr Details siehe Hinweise zum Festwert CURRENCY bzw. Abschnitt „Verwendung der Währung“ im Handbuch.

Multiplikation von Daten der Schnittstelle mit einem Faktor

FACTOR

* gültig ab Version 3.3.22

Über diesen Festwert ist es möglich, Werte der CO/PA-Schnittstelle mit einem beliebigen Faktor zu multiplizieren. Die Funktion ist möglich beim Lesen und Schreiben.

· Der gewünschte Faktor wird eingetragen im Wert von. Um z.B. das Vorzeichen eines Wertes umzudrehen, sollte „-1“ eingetragen werden.

· In Spalte Wert bis muss komma-getrennt eingetragen werden, für welche COPA-Felder der Faktor gelten soll. Zum Beispiel „RABAT,PRABA“ um diese Rabattfelder negativ darzustellen.

Über den Festwert ergibt sich insbesondere für die Lesefunktion der Allevo CO/PA-Schnittstelle eine wichtige Anwendung: im Mapping ist es möglich, mehrere Wertfelder auf das gleiche Satellitenfeld zu legen. Allevo addiert in diesem Fall automatisch die Inhalte. Zusammen mit dem Festwerte FACTOR lässt sich Addition und Subtraktion kombinieren.

Beispiel:

Sind die Wertfelder ERLOS, RABAT und PRABA auf ein gemeinsames Satellitenfeld gelegt, dann würde mit den Einträgen oben die Rechnung für das zugehörige Satellitenfeld wie folgt aussehen: ERLOS minus RABAT minus PRABA.

Feldmapping für Planwerte in individueller Währung

FD_CURRENCY

* gültig ab Version 3.3 (früher FLD_WAERS)

Mit Hilfe dieses Festwertes kann die Erfassung von Planwerten mit einer individuellen Währung je Datenzeile im Satelliten erfolgen. Die Funktionen entsprechen denen von Festwert CURRENCY (siehe Doku dort). Das Feld mit der relevanten Währung wird aus der Satellitentabelle übernommen.

Der Name des Satelliten-Feldes muss in Spalte Wert von eingetragen sein.

Hinweis:

Alternativ dazu kann die Währung im Schema auch fest vorgegeben werden (siehe Festwert CURRENCY).

Sind beide Festwert nicht gepflegt, orientiert sich die CO-PA Schnittstelle an den Einstellungen zum Ergebnisbereich (siehe Handbuch „Verwendung der Währung“).

Wert- und Mengenfeld-Mapping („FP-Modus“)

FD_ELEMENT

* gültig ab Version 3.4.35

Durch die Verwendung dieses Festwertes kann eine andere Satellitenstruktur für das Verbuchen nach COPA eingesetzt werden. Die Ausprägungen verschiedener Wert- und Mengenfelder werden nicht mehr in jeweils eigenen Tabellen-Spalten geführt, sondern nur noch in einer einzigen Spalte. In einer weiteren Spalte werden die COPA-Wert- und Mengen-Feldnamen diesen Werten/Mengen zugeordnet.

Diese zwei Tabellen-Spalten werden über den Festwert FD_ELEMENT folgendermaßen festgelegt:

· Im Wert_von wird die Satellitenspalte eingetragen, welche die COPA-Wert- und Mengen-Feldnamen enthält.

· Im Wert_bis wird die Satellitenspalte eingetragen, welche die Ausprägungen, sprich die Werte bzw. Mengen enthält. Das können sowohl Monatsspalten (ohne Monats-Suffix), als auch eine Jahresspalte sein. Jahreswerte können nach wie vor auch über eine Distributionstabelle verteilt werden.

Da bei Mengenverbuchungen immer zwingend eine Einheit mitgegeben werden muss, braucht es in diesem Fall auch den Festwert FD_UNIT (siehe dort). Dieser ist nicht erforderlich, wenn ausschließlich Werte verbucht werden.

Hinweise:

In der Tabelle "Feldzuordnung" der COPA-Festwertpflege sollten keine Wert- ('V'), Mengen- ('Q') und Einheitenfelder ('U') gemappt sein.

Durch die Einstellung 'T' in der Spalte ‚TS‘ der Lese-/Schreibparameter wird eine Aggregationsroutine durchlaufen, welche die zusammengehörigen Datensätze zusammenzieht. Diese Routine sorgt dabei auch dafür, dass Satellitenzeilen mit identischen Merkmalskombinationen aufsummiert werden.

Zum Verhalten bei „leeren“ Datensätzen im FP-Modus siehe Hinweise im Handbuch.

Partnerobjekt für Plandaten spiegeln

FD_SENDER

* gültig ab Version 3.3 (früher: FLD_SENDER)

Um Sender-Empfänger-Beziehungen abzubilden bietet die CO-PA Schnittstelle eine Funktion zum Spiegeln von Satellitendaten (Aufruf über Schaltfläche |Plandaten spiegeln| in der Festwertpflege; siehe auch entsprechendes Abschnitt im Handbuch).

Benötigt werden für diese Funktion zwei im Aufbau identischen Satellitentabellen. Es werden zwei Funktionen ausgeführt:

· Die Inhalte von zwei Felder der Satellitentabelle werden getauscht: das ist zum einen das Feld COOBJECT (Sender), der Name des zweiten Feldes (Empfängerobjekt) muss in Spalte Wert von eingetragen sein.

· Zusätzlich werden die Vorzeichen bei Daten relevanter Wertfelder gewechselt (einzutragen bei „Feldzuordnung Wertfelder“)

Hinweis:

Die Quell- und Zieltabelle benötigen einen identischen Tabellen-Append.

Der Append muss über ein Feld ZZ_STATUS (NUMC1) verfügen.

Status eines Datensatzes in der Satellitentabelle

FD_STATUS

* gültig ab Version 3.3 (früher: FLD_STATUS)

Die CO-PA Schnittstelle lässt sich so aufrufen, dass nur Datensätze mit Änderungen am Inhalt gebucht werden (siehe Flag „Nur nicht markierte“ in der Startansicht des Schnittstellenprogramms).

Dazu muss in der Satellitentabelle ein Statusfeld vorhanden sein (Feldtyp CHAR1): eine 1 in diesem Feld blockiert den Datensatz für die Verarbeitung.

Der Name des Statusfeldes muss in Spalte Wert von von Festwert FD_STATUS eingetragen sein.

Aus der Perspektive des Planungsprozesses gibt es demnach zwei Optionen, mit dem Statusfeld der Satellitentabelle umzugehen

· Es wird auf der Excel-Seite einfach weggelassen. Damit ist dieses Feld immer wieder leer, wenn die Daten aktualisiert werden.

· Das Feld wird auf der Excel-Seite aktiv bedient, entweder durch manuellen Eintrag des Planers oder aber über eine Formel.

Hinweis:

Ohne Statusfeld bzw. ohne Mapping wird jeder Datensatz gebucht.

Einheitenfeld-Mapping („FP-Modus“)

FD_UNIT

* gültig ab Version 3.4.35

Die Verwendung dieses Festwertes ist nur sinnvoll im Zusammenspiel mit dem Festwert FD_ELEMENT (siehe dort). Er ist erforderlich, wenn über jenen Festwert auch Mengenfelder angesteuert werden sollen, da diesen immer eine Einheit mitgegeben werden muss. Analog braucht es eine Spalte für die Einheitenfeldnamen und eine für die Ausprägungen der Einheiten.

Diese zwei Tabellen-Spalten werden über den Festwert FD_UNIT folgendermaßen festgelegt:

· Im Wert_von wird die Satellitenspalte eingetragen, welche die COPA-Einheiten-Feldnamen enthält.

· Im Wert_bis wird die Satellitenspalte eingetragen, welche die Ausprägungen, sprich die Einheiten enthält.

Hinweise:

In der Tabelle "Feldzuordnung" der COPA-Festwertpflege sollten keine Wert- ('V'), Mengen- ('Q') und Einheitenfelder ('U') gemappt sein.

Darstellung Monatswerte in Spalten und Sortierung

MONTH_ACTIVE

* gültig ab Version 3.3.22 (erweitert in 3.5)

Hintergrund: normalerweise erwartet die Allevo-CO/PA-Schnittstelle Daten der einzelnen Perioden in unterschiedlichen Zeilen der Satellitentabelle.

In Einzelfällen kann aber eine Darstellung über getrennte Spalten der Satellitentabelle sinnvoll sein (12 Monatsspalten, z.B. für leichterer Eingabe von Plandaten). In diesem Fall muss der Festwert MONTH_ACTIVE aktiv sein. Diese Darstellung von Monatswerten in Spalten steht für das Lesen und Schreiben (Planung) zur Verfügung. Auch paralleles Arbeiten mit Jahreswerten für andere Wertfelder ist möglich.

Ein Eintrag von X in Spalte Wert von aktiviert die Umsetzung auf Monatsspalten. In der Feldzuordnung wird dann versucht, Wert- und Mengenfelder (RWX-Spalte = „V“ oder „Q“) als Präfix eines Satelliten-Append-Feldes zur interpretieren: sind im Satelliten 12 Felder mit diesem Präfix und der Endung 01 bis 12 vorhanden, so werden die Monatsdaten dort abgelegt bzw. erwartet.

Hinweis:

Bei Anwendung der CO/PA-Lesefunktion mit aktivem Festwert MONTH_ACTIVE muss zwingend das Merkmal PERDE für Lesen („R“) eingerichtet sein.

Für weitere Details siehe Allevo COPA Handbuch.

Zusatzfunktion: Daten beim Lesen sortieren

Der Eintrag von X in Spalte Wert bis zum Festwert ermöglicht eine definierte Sortierung von CO/PA-Monatsdaten beim Lesen: „Wert von“ bei MONTH_ACTIVE muss in diesem Fall nicht gleichzeitig aktiv sein, die Neusortierung kann also auch unabhängig von der Periodendarstellung eingeschaltet werden.

Hintergrund: der BAPI für das Lesen von CO/PA-Daten stellt die Daten üblicherweise sortiert zur Verfügung (nach Monaten). In neueren SAP-Versionen ist diese Sortierung nicht immer gewährleistet (z.B. unter HANA). Dies führt insbesondere beim Einlesen der Daten in Monatsspalten zu unerwünschten Ergebnissen.

Es empfiehlt sich, die Sortierung nur einzuschalten, wenn sie wirklich benötigt wird (z.B. wenn in Testläufen festgestellt wurde, dass die Daten aus dem SAP-System unsortiert zurückkommen).

* gültig ab Version 3.4.5

Option zur Neusortierung beim Lesen von CO/PA-Daten.

Ergebnisbereich

OP_CONCERN

* gültig ab Version 3.0

Festlegung des Ergebnisbereichs, aus dem Daten gelesen und in den Plandaten gebucht werden sollen.

Der Name des Ergebnisbereiches ist in Spalte Wert von einzutragen.

Hinweis:

Pflichtfeld

Lesen von Istdaten: Währungsschlüssel und Valuation-Type

PALEDGER

* gültig ab Version 3.0 (erweitert in 3.5.35)

Hintergrund: Währungsschlüssel im SAP System:

10 Buchungskreiswährung

12 BuKrsWährung, PrCtr-Bewertung

B0 Ergebnisbereichswährung

B2 ErgBerWährung, PrCtr-Bewertung

Der Währungsschlüssel wird vor allem zum Lesen von Ist-Daten benötigt und ist in Spalte Wert von einzutragen.

Hinweis:

Siehe auch CO/PA-Handbuch, Abschnitt „Verwendung der Währung“.

Zusatzfunktion „Valuation-Type“

Über Festwert TYPE_OF_PA unterstützt Allevo auch die Arbeit mit buchhalterischen Ergebnisbereich. Das Lesen von Ist-Daten erfordert dort eine Angabe zum sog. „Valuation-Type“ mit folgenden Einträgen:

0 Legal Valuation

1 Group Valuation

2 Profit Center Valuation

Als default verwendet Allevo den Wert „0 = Legal Valuation“. Ein Eintrag in Spalte Wert_bis erlaubt einen anderen Valuation Type.

* neu ab Version 3.4.35

Abbildung des Valuation-Type über „Wert bis“.

Protokoll erstellen für SLG1

SAVE_LOG

Allevo COPA hat die Möglichkeit, (Fehler-) Meldungen als Protokoll in das SAP Application Log zur schreiben. Die Anzeige von Einträgen erfolgt über die SAP-Transaktion SLG1 mit den Selektionsparametern /KERN/ALLEVO als Objekt und COPA als Unterobjekt.

Das Schreiben dieses Protokolls muss explizit aktiviert werden; die Angabe im Wert von zum Festwert SAVE_LOG steuert, unter welchen Umständen Einträge entstehen:

• Bei „N“ wird kein Protokoll geschrieben (wie auch bei nicht gesetztem Festwert)

• bei E“ nur im Fehlerfall,

• bei „W“ schon bei Warnungen

• sonst (I oder X oder S) werden alle Ausgaben gespeichert.

Bei Aufruf aus dem Allevo-Hauptprogramm erfolgt die Steuerung über den Allevo-Festwert MESSAGE_LEVEL (siehe Dokumentation Allevo Festwerte).

Hinweis:

Separat (und unabhängig) davon kann die Bildschirm-Ausgabe über den Parameter „Ausgabe Level“ im COPA-Selektionsbild gesteuert werden.

Unterscheidung kalkulatorische / buchhalterische Planung

TYPE_OF_PA

* gültig ab Version 3.3 (erweitert in 3.5)

Über den Festwert TYPE_OF_PA kann Lesen und Planen mit einem buchhalterischen Ergebnisbereich aktiviert werden. Mögliche Einträge in Spalte Wert von sind:

1. Für kalkulatorischen Ergebnisbereich: 1 oder C(osting-based)

2. Für buchhalterischen Ergebnisbereich: 2 oder A(ccount-based)

Im Standardfall arbeitet Allevo COPA mit einem kalkulatorischen Ergebnisbereich. Der Default gilt, wenn der Festwert TYPE_OF_PA nicht gesetzt ist oder der Eintrag in Spalte „Wert von“ leer ist.

Hinweis:

Das Lesen von Ist-Daten zu einem buchhalterischen Ergebnisbereich erfordert eine Angabe zum Valuation-Type. Allevo verwendet per default den Wert „0“. Ein abweichender Wert kann über Festwert PALEDGER mitgeben werden (siehe Doku dort).

* neu ab Version 3.5

Lesen zum buchhalterischen Ergebnisbereich ist jetzt möglich (vorher nur Planen)

Vorgangsart

VRGAR

* gültig ab Version 3.0

Hier ist die Vorgangsart festgelegt, mit der die Plandaten gelesen bzw. geschrieben werden sollen.

Die Vorgangsarten werden getrennt festgelegt:

· Die für das Lesen relevanten Vorgangsarten sind in Spalte Wert von einzutragen (also z. B. F für Fakturadaten oder D für Gemeinkosten): mehrere Einträge sind möglich (getrennt durch Komma).

· Beim Schreiben (Planen) wird mit der Vorgangsart gebucht, die in Spalte Wert bis eingetragen ist. Die Vorgangsart kann auch einem Feld der Satellitentabelle entnommen werden (Mapping z.B. über ZZIPP_VRGAR): das Feld muss markiert sein (also RWX-Flag Z, X oder W). Die Angabe im Satelliten übersteuert den Festwert.

Hinweis:

Der Festwert VRGAR wird heute anders interpretiert, als in der Vorgängerversion (bis Version 2.9). Das ist bei einer Migration unter Umständen zu beachten.