Versions Compared

Old Version 23

changes.mady.by.user Pascal Seibert

Saved on

compared with

New Version Current

changes.mady.by.user Matthias Korz

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • $Calc(«Vsd.Gew»*3,'',0)
    • In diesem Beispiel wird das im Versanddatensatz angegebene Gewicht mit der Zahl 3 multipliziert. Das Ergebnis wird kaufmännisch gerundet und ohne Nachkommastellen dargestellt.
  • $Calc(«Variable»+1.55,Format,4,'.) = 1234'.1234
    • Freie Formatierung ohne Tausender Separator.
  • $Calc(«Variable»+1.55,Format,5,'.,",") = 1,234'.12345

    • Freie Formatierung mit Tausender Separator.


      Note
      titleBitte beachten Sie:

      Im letzten Beispiel ist der letzte Parameter ein , (Komma) womit es eigentlich einen weiteren Parameter darstellen würde. Um dennoch ein , (Komma) als Parameter übergeben zu können, wurde das , (Komma) durch zwei " (Anführungszeichen oben) separiert = ","


$Center(string,anzahl,fillchar)

...

Bei einem Aufruf $NurHausNr() wird nur die Hausnummer zurückgegeben.

Diese Funktion kann auch je Land mit Hilfe eines RegEx (Regulären Ausdrucks) weiter spezifiziert werden.
Hier finden Sie noch weitere Informationen: Export/Regel/Layout: Reguläre Ausdrücke für Funktionen $NurStrasse() und $NurHausNr()

$NurStrasse()

Bei einem Aufruf $NurStrasse() wird nur die Strasse zurückgegeben.

$NurOrt()

Diese Funktion kann auch je Land mit Hilfe eines RegEx (Regulären Ausdrucks) weiter spezifiziert werden.
Hier finden Sie noch weitere Informationen: Export/Regel/Layout: Reguläre Ausdrücke für Funktionen $NurStrasse() und $NurHausNr()

$NurOrt()

Bei einem Aufruf $NurOrt(Bad Kreuznach ORTSTEIL Winzenheim') wird 'Bad Kreuznach' zurückgegeben. Die Groß-/Kleinschreibung wird beim Text "ORTSTEIL" nicht beachtet.

...

Beachten Sie: Text und Suchtext müssen in Anführungszeichen angegeben werden. UI Buttoncolorturquoise

Note
title

...

Beachten Sie:

Die Replace-Funktion unterscheidet nicht zwischen Groß- und Kleinschreibung beim Ersetzen.

Beispiel: Bei einer Replace-Funktion: $Replace(«Art.Bez1»,Ä,ae), die den Großbuchstaben "Ä" durch "ae" ersetzen soll, wird ebenfalls auch der Kleinbuchstabe "ä" durch ein "ae" ersetzt.


UI Button
colorturquoise
titleXL

$Hash(String-Variable)

Mit der Funktion $Hash(String-Variable) wird ein MD5-Hashwert aufgrund des String-Wertes erzeugt. 

Beispiel: 

Es soll für die Projektnummer ein MD5-Hashwert erstellt werden, welcher dann in einer E-Mail (aus der Datenbank Kontakte) als Link an einen Kunden gesendet wird. Der Link darf nicht im Klartext lesbar sein. 

Muster-Syntax: http://www.ihre-webseite.de/umfrage.php?id=PLATZHALTER-HASH [^] 

Den Syntax $Hash(«Kkt.PrjNr») platzieren Sie an der Stelle von PLATZHALTER-HASH. 

Daraus ergibt sich: http://www.ihre-webseite.de/umfrage.php?id=$Hash(«Kkt.PrjNr») 

Bei der Ausgabe / dem Export ist an dieser Stelle dann der HASH-Wert zu dem Rückgabewert der Variable «Kkt.PrjNr» zu finden.

Note
titleBeachten Sie:

Klammern in Strings (Texten) müssen in doppelten Anführungszeichen eingeschlossen werden. Beispiel: $Cond(«OPo.ZahlBed»='per Lastschrifteinzug "("mtl. Zahlweise")"', [...] Erklärung: Da im Datensatz des Offenen Posten in den Zahlungsbedingungen der Ausdruck 'per Lastschrifteinzug (mtl. Zahlweise)' hinterlegt ist, würden die beiden Klammern in der Cond-Bedingung dazu führen, dass diese im String ausgewertet würden. Daher müssen die Klammern () mit doppelten Anführungszeichen "(" sowie ")" auskommentiert werden.

Nachfolgende Exportfunktionen werden häufig beim Datenaustausch mit einem Online-Shop oder mit anderen Datenbanken sowie für das Erstellen einer Hyperlink-Regel verwendet. 

UI Button
colorturquoise
titleL

UrlEncode() 

Die Funktion URL-Encoding (auch Prozentkodierung genannt) kodiert alle

$Hash(String-Variable)

Mit der Funktion $Hash(String-Variable) wird ein MD5-Hashwert aufgrund des String-Wertes erzeugt. 

Beispiel: 

Es soll für die Projektnummer ein MD5-Hashwert erstellt werden, welcher dann in einer E-Mail (aus der Datenbank Kontakte) als Link an einen Kunden gesendet wird. Der Link darf nicht im Klartext lesbar sein. 

Muster-Syntax: http://www.ihre-webseite.de/umfrage.php?id=PLATZHALTER-HASH [^] 

Den Syntax $Hash(«Kkt.PrjNr») platzieren Sie an der Stelle von PLATZHALTER-HASH. 

Daraus ergibt sich: http://www.ihre-webseite.de/umfrage.php?id=$Hash(«Kkt.PrjNr») 

Bei der Ausgabe / dem Export ist an dieser Stelle dann der HASH-Wert zu dem Rückgabewert der Variable «Kkt.PrjNr» zu finden.

Note
titleBeachten Sie:

Klammern in Strings (Texten) müssen in doppelten Anführungszeichen eingeschlossen werden. Beispiel: $Cond(«OPo.ZahlBed»='per Lastschrifteinzug "("mtl. Zahlweise")"', [...] Erklärung: Da im Datensatz des Offenen Posten in den Zahlungsbedingungen der Ausdruck 'per Lastschrifteinzug (mtl. Zahlweise)' hinterlegt ist, würden die beiden Klammern in der Cond-Bedingung dazu führen, dass diese im String ausgewertet würden. Daher müssen die Klammern () mit doppelten Anführungszeichen "(" sowie ")" auskommentiert werden.

Nachfolgende Exportfunktionen werden häufig beim Datenaustausch mit einem Online-Shop oder mit anderen Datenbanken sowie für das Erstellen einer Hyperlink-Regel verwendet. 

UI Button
colorturquoise
titleL

UrlEncode() 

Die Funktion URL-Encoding (auch Prozentkodierung genannt) kodiert alle Zeichen außerhalb von ASCII in das URL-Format. Die Kodierung findet unter Verwendung bestimmter Zeichen des ASCII-Zeichensatzes statt. Ohne diese Kodierung wären einige Informationen nicht in einer URL darstellbar. Beispielsweise muss das Leerzeichen in einer URL durch eine andere Zeichenfolge übergeben werden, da ein Browser sonst das Leerzeichen als Ende der URL interpretieren würde. In microtech büro+ wird z. B. als reserviertes Zeichen ein Plus ("+") für das Leerzeichen verwendet. Weitere Informationen finden Sie auch in nachfolgendem Wikipedia-Artikel: https://www.wikiwand.com/de/URL-Encoding (Externer Link).

...

Beispiel 1:
Ein Variablenwert "server" wird durch das Normieren zu "Server". Ein Variablenwert "SERVER" wird durch das Normieren ebenfalls zu "Server". Der erste Buchstabe wird groß ausgegeben, die folgenden Buchstaben klein.Beispiel 2:
Ist der Wert einer Variable - z. B. der einer Artikelbezeichnung - "BaDaBum Kaugummi", so wird durch diese Funktion der Name auf "Badabum Kaugummi" normiert, da der erste Buchstabe sowie auf ein Trennzeichen folgender Buchstabe groß geschrieben werden, der Rest klein.ausgegeben, die folgenden Buchstaben klein.

Beispiel 2:
Ist der Wert einer Variable - z. B. der einer Artikelbezeichnung - "BaDaBum Kaugummi", so wird durch diese Funktion der Name auf "Badabum Kaugummi" normiert, da der erste Buchstabe sowie auf ein Trennzeichen folgender Buchstabe groß geschrieben werden, der Rest klein.



UI Button
colorturquoise
titleXXL

Exportregeln für den Anlagenverlauf

$AnlVerlauf()

Mit der Funktion: $AnlVerlauf() können alle Betrags-Werte des Anlagenverlaufs (Register: VERLAUF) ausgelesen und über einen Export in eine Textdatei ausgegeben werden. Der Rückgabewert erfolgt in der Mandantenwährung.

UI Expand
titleHinweis zu Feldnamen für Rückgabewert und Abfrage des Wirtschaftsjahrs
  • Wirtschaftsjahr [WirtJahr]
  • AfA Betrag [AfABet]
  • Sonderabschreibungsbetrag [SonderBet]
  • Investitionsabzugsbetetrag [InvestAbzugsBet]
  • Zu- und Abgänge [SonstigeAfA]
  • Restwert [Restwert]
  • Kumuliert [Kumuliert]


  • Buchwert Betrag [BuchwertBet]
  • Gebucht [GebuchtKz]
  • Buch Tatsächlich gebuchter Wert [BuchGebuchtwert]
  • SAfA Gebucht [SAfAGebuchtKz]
  • SAfABuch Tatsächlich gebuchter Wert [SAfABuchGebuchtwert]
  • Invest Gebucht [InvestGebuchtKz]
  • Invest Tatsächlich gebuchter Wert [InvestGebuchtwert]
  • Betrag [Bet]
  • Vor Betrag [VorBet]
  • Stautsinfo Image [StsInfoImg]
AbfrageEingabe
Abfrage des aktuellen Wirtschaftsjahr«Als.WirtJahr»
Abfrage des vorjährigen Wirtschaftsjahr$Left(«Als.WirtJahr»,3)$calc($Right(«Als.WirtJahr»,1)-1,0,0)
Abfrage des nächsten Wirtschaftsjahr$Left(«Als.WirtJahr»,3)$calc($Right(«Als.WirtJahr»,1)+1,0,0)


Der Formel $AnlVerlauf() sind für den Export drei Parameter mitzugeben:

  1. Anlagennummer
  2. Wirtschaftsjahr (z. B. aus einem Selektionsfeld der Anlage)
  3. Feldname für Rückgabewert (z. B. "Afa-Betrag", "Restwert", Sonderabschreibungsbetrag, "InvestitionsAbzugsBetrag", "Kumuliert", "sonstige AfA", etc.)

Optional kann auch ein vierter Parameter mitgegeben werden:

  1. Anlagennummer
  2. Wirtschaftsjahr (z. B. aus einem Selektionsfeld der Anlage)
  3. Periode
  4. Feldname für Rückgabewert (z. B. "Afa-Betrag", "Restwert", Sonderbetrag, "InvestitionsAbzugsBetrag", "Kumuliert", "sonstige AfA", etc.)


Gestalten Sie entsprechend das Export-Layout.

Um Ihnen den Aufbau einer Formel mit der Funktion: $AnlVerlauf() zu demonstrieren, finden Sie anbei folgendes Beispiel.

Aus den Anlagen-Datensätzen soll für das Jahr 2022 aus dem Register: VERLAUF für jeden Datensatz der AfA-Betrag, der kumulierte Betrag sowie der Restwert exportiert werden. Zusätzlich soll der Export auch die Anlagennummer und Bezeichnung sowie Anschaffungsdatum, Anschaffungskosten und Nutzungsdauer ausweisen.

UI Expand
titleWeitere Hinweise zum Beispiel einblenden:

Die Werte aus dem Register: VERLAUF sehen in diesem Beispiel folgendermaßen aus.

 Image Added 


Das Exportlayout kann nun über die verfügbaren Export-Felder aufgebaut werden und der Abfrage nach den Werten aus dem Register: VERLAUF des Datensatzes:

Art der DatenBezeichnungFormel
Verfügbares Feld im Exportlayout

Anlagennummer

«Anl.AnlNr»

Bezeichnung

«Anl.Bez»

Anschaffungsdatum

«Anl.ADat»

Anschaffungskosten

«Anl.AKosten»

Nutzungsdauer

«Anl.NutzDauer»



Reiner TextWirtschaftsjahr der Ausgabe (auf welches zugegriffen wird)2022



Daten aus dem Register "Verlauf":AfA-Betrag$AnlVerlauf(«Anl.AnlNr»,2022,'AfABet')

Kumuliert$AnlVerlauf(«Anl.AnlNr»,2022,'Kumuliert')

Restbetrag$AnlVerlauf(«Anl.AnlNr»,2022,'Restwert')


Legen Sie nun das Export-Layout im Bereich: BUCHHALTUNG - STAMMDATEN - Register: ANLAGEN - Schaltfläche: SCHNITTSTELLEN - "Anlagen exportieren" an.

Die Bezugnahme auf das jeweilige Feld des Vorgaben-Registers ist in  einfache 'Hochkommas' (Apostrophe)  gesetzt.

Image Added

Das Export-Layout kann beispielsweise so aufgebaut sein

Code Block
«Anl.AnlNr»;«Anl.Bez»;«Anl.ADat»;«Anl.AKosten»;«Anl.NutzDauer»;Verlauf des Wirtschaftsjahrs 2022;$AnlVerlauf(«Anl.AnlNr»,2022,'AfABet');$AnlVerlauf(«Anl.AnlNr»,2022,'Kumuliert');$AnlVerlauf(«Anl.AnlNr»,2022,'Restwert')


Ergebnis des Exports:

Sie erhalten die angeforderten Werte zurück. Die über die Funktion: $AnlVerlauf abgerufenen drei Werte befinden sich ebenfalls im Export.

1;TESTAnlage;31.01.2019;11.111,00;5;Verlauf des Wirtschaftsjahrs 2022;2.189,00;9.373,00;1.638,00

2;Testi Anlage2;31.01.2019;10.000,00;5;Verlauf des Wirtschaftsjahrs 2022;1.800,00;7.200,00;1.800,00

Image Added


UI Button
colorturquoise
titleXXL

Lohnbuchhaltung: Spezielle Exportfunktionen

Als Exportfunktion und bei Bedingungen (nicht im Druck) stehen die Funktion $MitBvh(), $MitBvg(), $MitFehlTage() für eine Ausgabe in eine Textdatei zur Verfügung. 

FunktionInfoBeispiel

$MitBvh

"MitBvh" ist das Mitarbeiterbeschäftigungsverhältnis


Beschäftigungsverhältnis:

"MitBvh" greift auf folgenden Bereich zu:

Image Added

Über $MitBvh können Sie alle exportierbaren Felder des Beschäftigungsverhältnis aufgrund eines Datums auslesen.

Info
titleInfo:

Diese Werte finden Sie in den Mitarbeiter-Stammdaten auf dem Register: LOHN-ABRECHNUNGSDATEN im Bereich: BESCHÄFTIGUNGSVERHÄLTNISSE.


Aufbau der Formel:

Parameter für $MitBvh([Mitarbeiternummer],[Datum für den Stand],[Feldname für Rückgabewert], [Optional: Rückgabewert wenn Wert = Leer-String] )

Hinweis zur Nutzung:

$MitBvh([Mitarbeiternummer],[Datum für den Stand],['Feldname für Rückgabewert' ])


Beispiel:

«Mit.MitNr»;«Mit.VNa»;«Mit.NNa»;Gehalt;$MitBvh(«Mit.MitNr»,01.01.2023,' Gehalt ');

$MitBvg

"MitBvg" ist die Mitarbeiterbeschäftigungsvorgabe

Beschäftigungsvorgabe:

Über $MitBvg können Sie alle exportierbaren Felder der Beschäftigungsvorgabe aufgrund eines Datums auslesen. 

"MitBvg" greift auf folgenden Bereich und Register zu:

Image Added

Info
titleInfo:

Diese Werte finden Sie in den Mitarbeiter-Stammdaten auf dem Register: LOHN-ABRECHNUNGSDATEN im Bereich: ABRECHNUNGSVORGABEN.


Aufbau der Formel:

Parameter für $MitBvg([Mitarbeiternummer],[Datum für den Stand],[Feldname für Rückgabewert],  [Optional: Rückgabewert wenn Wert = Leer-String] )

Hinweis zur Nutzung:

$MitBvg([Mitarbeiternummer],[Datum für den Stand],['Feldname für Rückgabewert'])


Beispiel:

«Mit.MitNr»;«Mit.VNa»;«Mit.NNa»;Gehalt;$MitBvg(«Mit.MitNr»,01.01.2023,' Gehalt ');

$MitFehlTage

Über $MitFehlTage können Sie die Summe der Fehltage über die Fehlzeiten eines Mitarbeiters aufgrund eines Datums auslesen.
Parameter für $MitFehlTage([Mitarbeiternummer],[Datum für den Stand],[Optional: Semikolon separierte Fehlzeiten, die nicht beachtet werden sollen],  [Optional: Semikolon separierte Fehlzeiten, die beachtet werden sollen])

Hinweis zur Nutzung:

$MitFehlTage([Mitarbeiternummer],[Datum für den Stand])


Hinweis zur Mitgabe der Parameter:

$MitFehlTage( 1 ,'1.10.2023') liefert die Summer der Fehltage über alle Fehlzeiten des Mitarbeiter 1 für den Monat Oktober 2023


$MitFehlTage( 1 ,'1.10.2023',' 5.1 ') liefert die Summe der Fehltage über alle Fehlzeiten außer 5.1 des Mitarbeiter 1 für den Monat Oktober 2023


$MitFehlTage( 1 ,'1.10.2023',' 6.1 ';' 6.2 ') liefert die Summe der Fehltage über die Fehlzeiten 6.1 oder 6.2 des Mitarbeiter 1 für den Monat Oktober 2023

UI Expand
titleBeispiele einblenden

Beispiel 1 für $MitFehlTage:

Sie gestalten im Bereich: PERSONAL - STAMMDATEN - Register: MITARBEITER - Schaltfläche: SCHNITTSTELLEN - MITARBEITER EXPORTIEREN über: NEU ein neues Export-Layout. Über: GESTALTEN erfassen Sie folgende Formel für einen Export im Textformat:

Code Block
«Mit.MitNr»;«Mit.VNa»;«Mit.NNa»;«Mit.AbtNrInfo»;Fehltage des MA: $MitFehlTage(«Mit.MitNr»,'1.04.2022')

Abgefragt wird im Beispiel die Summe der Fehltage für die ausgegebenen Mitarbeiternummern für den Monat April 2022.

Image Added

Im  Anschluss geben Sie über: DATENEXPORT die Liste aus.


Sie erhalten eine Übersicht für diesen Monat mit den Fehltagen der MA des Monats April 2022:

Image Added


Beispiel 2 für $MitFehlTage:

Das Beispiel kann erweitert werden, um den Parameter, dass alle Fehltage der MA des Monats April 2022 außer Fehlzeiten der Nummer 1.9.1 durch den Export ausgegeben werden sollen:

Code Block
«Mit.MitNr»;«Mit.VNa»;«Mit.NNa»;«Mit.AbtNrInfo»;Fehltage des MA: $MitFehlTage(«Mit.MitNr»,'1.04.2022',' 1.9.1 ')

Durch diese Einschränkung, dass Fehlzeit 1.9.1 nicht beachtet werden soll, werden null Fehltage für MA 103 im April 2022 angezeigt, da die sieben Fehltage des Mitarbeiters genau zu dieser Fehlzeit gehören.

Image Added


Beispiel 3 für $MitFehlTage:

Wird das Beispiel so aufgebaut, dass nach dem Datum zwei semikolonseparierte Werte angegeben werden, werden die Fehltage der MA ausgegeben, die entweder zur Fehlzeit 1.9.1 oder zur Fehlzeit 6.2 gehören. Alle anderen Fehlzeiten werden mit diesem Export nicht ausgegeben.

Code Block
«Mit.MitNr»;«Mit.VNa»;«Mit.NNa»;«Mit.AbtNrInfo»;Fehltage des MA: $MitFehlTage(«Mit.MitNr»,'1.04.2022', '1.9.1 ';' 6.2 ')



Beispiel zur Ausgabe des Gehalts in Exporten:

Es wird ein Export-eingerichtet mit folgenden Ausgaben

  • Mitarbeiternummer [Mit.MitNr]
  • Vorname [Mit.VNa]
  • Nachname [Mit.NNa]
  • Gehalt: Diese Ausgabe soll rein als textliche Hervorhebung im Export dienen
  • $MitBvg( «Mit.MitNr» , 01.01.2023 , 'Gehalt' ): Über diese Funktion soll das Feld: "Gehalt" der Beschäftigungsvorgabe aufgrund des Datums ausgegeben werden. Die Bezugnahme auf das Feld: 'Gehalt' ist in einfache 'Hochkommas' (Apostrophe) gesetzt.

Der Export kann folgendermaßen aufgebaut sein:

Code Block
«Mit.MitNr»;«Mit.VNa»;«Mit.NNa»;Gehalt;$MitBvg(«Mit.MitNr»,01.01.2023,'Gehalt');

Mit Durchführen des Datenexportes werden die Mitarbeiter nach Nummern mit Vorname, Nachname, dem Wort "Gehalt" und der Summe, die aufgrund der Beschäftigungsvorgabe zu diesem Datum gilt, herangezogen.

Image Added