Benutzer-Werkzeuge
Seitenleiste
berichtscenter:dynamische_tabellen:parameter
Inhalt
Was brauche ich dazu?
Dialog externer Excel Report (Parameter)
Zugang: Berichtscenter > Dynamische Tabellen (Parametrierung) > Bearbeiten eines Eintrags > Schalter Bearbeiten im Abschnitt Generierung mit ext. Excel Report
| Feld | Beschreibung |
|---|---|
Vorlage | Auswahl der Template-Datei (Excel-Datei). F2 öffnet Dateiauswahl. |
Spalten… | Schalter Einstellung zur optionalen Löschung von Spalten. Wenn die Vorlage dies nicht unterstützt, erhalten Sie eine Hinweismeldung. |
Ausgabetyp | Auswahl Nutzen Sie hier Objekte als expandiernde Tabelle. Beachten Sie, dass nur ein Tabellenblatt der so generierten XLS-Importdatei als dynamische Tabelle eingelesen werden kann. Wenn keine spezielle Vorgabe gemacht wurde, wird das erste Tabellenblatt der Exceltabelle ausgewertet. Die Ausgabe Pro Objekt ein Excel-Blatt ist hier meist ungeeignet. |
Auswertung von | Datum Das Startdatum der Auswertung ist bei manueller Datumswahl offen für Bearbeitung. |
Bis | Datum Das Enddatum der Auswertung ist bei manueller Datumswahl offen für Bearbeitung. |
| ix-Haus-Datumsbereich | Währung des Berichts I. d. R. feste Vorgabe mit EUR, eine individuelle Einstellung ist bei aktivierter Fremdwährung möglich. Beachten Sie, dass in der Kurstabelle für die verwendeten Fremdwährungen Kursinformationen für den Auswertungsbereich vorliegen müssen, falls eine Währungsumrechung erfolgen muss. |
Objektbereich | Angabe einer Objektnummer oder eines Objektbereichs, alternativ via F2-Klick mittels Objektgruppenauswahl. |
Personenbereich | Auswahl von Personen über eine Bereichsangabe. Wenn Sie die Checkbox Alle Personen aktiviert haben, ist die individuelle Bereichsangabe deaktiviert. |
Flächenbereich | Auswahl von Flächen über eine Bereichsangabe. Wenn Sie die Checkbox Alle Flächen aktiviert haben, ist die individuelle Bereichsangabe deaktiviert. |
Alle Personen | Option ❒ Personenauswahl nach manueller Vorgabe. ☑ Alle Personen eines Objekts berücksichtigen, die Personenbereichsengabe ist inaktiv. |
Alle Flächen | Option ❒ Flächenauswahl nach manueller Vorgabe. ☑ Alle Flächen eines Objekts berücksichtigen, die Flächenbereichsengabe ist inaktiv. |
Fl.Existenz ignr. | Option ❒ Die datumsabhängige Auswertung prüft auf das Flächenexistenzdatum. ☑ Keine datumsabhängige Auswertung der Flächenexistenzdaten. (Kann bei großen Datenmengen Performance steigern, jedoch auch Flächen berücksichtigen, die im Abfragezeitraum nicht existent sind.) |
Berichtswährung | Auswahl (i. d. R. EUR, nur aktiv mit der Lizenz Fremdwährung. |
Reportinformation | Textfeld Hier können Sie eine zusätzliche Information hinterlegen, welche dann im Report angezeigt werden kann. |
Zuk. Änderungen | Option Optional können zukünftige Änderungen selektiv ausgegeben werden. Ist diese Option aktiv, können Sie über ein Profil definieren, welche zukünftigen Änderungen im Bericht ausgewiesen werden. Nutzen Sie ein vordefiniertes Profil oder erstellen Sie sich neue Profile nach Bedarf. Als Muster dient das Profil 1. Standard iX-Haus. Zu jedem Profil können Sie einen erklärende Notiz hinterlegen. Das Profil wirkt wie ein komplexer Filter über mehrere Merkmale (Veränderungen in den nächsten nn Monaten berücksichtigen, zu berücksichtigende Personentypen) sowie Ausgabekriterien, welche Sie einzeln parametrisieren können (Größe m², Sollbetrag, Kündigungsmodalität, Optionen, bei aktueller Vermietung auf Leerstand prüfen, bei aktueller Vermietung auf Folgevermietung prüfen, bei aktuellem Leerstand auf Folgevermietung prüfen). Mit dem Schalter Filter setzen übernehmen Sie die aktuell eingestellten Filterparameter. Wir empfehlen, diese Funktion im Rahmen eines Consultingtermins zum Thema Excel-Reporting an einem geeigneten Fallbeispiel einzusetzen, um sich mit der Funktionalität vertraut zu machen. |
Profil ausgeben | Option ☑ Das verwendete Profil wird im Excel-Bericht benannt. |
Autom. XLS-Passw | Option ❒ Die XLS-Datei wird nicht passwortgeschützt generiert. ☑ Die XLS-Datei wird passwortgeschützt. Änderungen der Datei können hierüber vermieden werden. Das Eingabefeld zur Definition eines Passworts ist nur bei markierter Checkbox aktiv. Lassen Sie das Eingabefeld dann leer, wird ein Zufallspasswort generiert. |
| DMS-Optionen | DMS-Optionen werden nur angeboten, wenn auch ein entsprechendes Dokumentenmanagementsystem in iX-Haus eingebunden ist. Die Belegausgabe dürfte in den meisten Fällen für die Erstellung von Daten einer dynamischen Tabelle nicht sinnvoll sein. |
Belegausgabe | Checkbox ❒ Es werden keine Daten für die Belegausgabe zwischengespeichert. ☑ Es werden während der Generierung des Reports alle Sachkontennummern, die mit Hilfe der im Template verwendeten Blöcke und Schlüsselworte angesteuert werden, zwischengespeichert. Die Belege werden dann selektiv in Abhängigkeit der im Bericht verwendeten Kontenabfragen aus dem angebundenen DMS abgerufen. Ob ein Block diese Funktion unterstützt, kann bei der Beschreibung des jeweiligen Blocks in der Dokumentation AllgKontoDef_Module.pdf nachgesehen werden. Standardmäßig werden, wenn die Belegausgabe aktiv ist, alle Sachkontennummern der Blöcke eingesammelt. Es gibt aber die Möglichkeit, das Einsammeln für einen Block per Blockparameter im Template explizit zu deaktivieren. Eine Übersicht mit Schlüsselworten, die das Einsammeln der Sachkontennummern ermöglichen, finden Sie im Abschnitt Bericht Objektsicht der Excel-Berichte. Für die Ausgabe der Belege stehen diverse Parameter zur Verfügung, welche Sie über den Schalter Konfigurieren anzeigen und bearbeiten können. Die Funktion der Belegausgabe macht nur Sinn, wenn Sie mindestens eine Ausgabeoption konfigurieren! |
Konfigurieren | Einstellungen zur aktivierten Belegausgabe
|
| Schalter | |
Start… | Startet den Excelbericht |
Abbrechen | Beendet die Parametereingabe ohne zu speichern. |
Speichern | Speichert die Parameter. |
Param. kopieren | Öffnet eine Benutzerauswahl, nur unter Lizenz des Featurepakets verfügbar. Die Parameter des ausgewälten Benutzers werden für diesen Bericht geladen. |
Dialog Importdefinition
Zugang: Berichtscenter > Dynamische Tabellen (Parametrierung) > Einfügen oder Bearbeiten eines Eintrags
| Feld | Beschreibung |
|---|---|
| Allgemeine Parameter | |
Nummer | Automatisch vergebene Nummer der Parametrierung. Sie wird in der Kommandozeile beim Aufruf des Importprozesses verwendet, um den Import mit den Daten der Importdefinition zu starten. |
Bezeichnung | Eindeutige Bezeichnung des Datensatzes. Dieser Name wird z. B. im iX-Haus plus Menü angezeigt. |
Zusatzinformation | Diese Information kann verwendet werden, um den Anwendern weitergehende Informationen und Hinweise zu der aus dem Import resultierenden Tabelle zu geben. Sie wird u. A. in iX-Haus plus als Tooltip zu dem jeweiligen Grid angezeigt. |
Tabelle in DB (ut_*) | Name der Tabelle, in der die importierten Daten in der Datenbank abgelegt werden. Es können maximal 20 Zeichen eingegeben werden. Zulässige Zeichen: [A-Z, a-z, 0-9, _] (keine Umlaute oder Sonderzeichen). Der gewählte Datenbanktabellenname erhält automatisch das Präfix ut_. Während des Schreibens der Tabelle wird das Präfix ut0 vorangestellt (d. h. ut0-Tabellen sind Tabellen, die sich aktuell in Bearbeitung befinden). Nach der Fertigstellung der Tabelle wird das Präfix auf ut_ geändert.Eine evtl. bereits vorhandene ut_-Tabelle wird vor Beginn des Imports gelöscht. Ebenso eine bestehende ut0-Tabelle (bei ut0-Tabellen erfolgt erst eine Nachfrage bzgl. eines parallel laufenden Importprozesses). |
Aktiv in iX-Haus plus | Schalter[ ] Wird in iX-Haus plus nicht angezeigt. Sinnvoll z. B. für die Bereitstellung von Tabellen, welche mit Datenbanktools abgefragt werden. [X] Wird in iX-Haus plus in den Auswertungen angezeigt und kann dort als Basis für weitere Workflows genutzt werden. |
| Protokollierungsanweisung | Auswahl Kein LOG schreiben (Default) / LOG schreiben / LOG schreiben+anzeigenHier kann ausgewählt werden, ob ein LOG geschrieben werden soll oder nicht und ob es am Ende des Laufs angezeigt werden soll. Die hier gemachte Vorgabe kann durch eine direkte Eingabe in die Kommandozeile überschrieben werden. Werden in einem Lauf mehrere Parametersätze abgearbeitet, wird die informativste Einstellung auf alle Parametersätze angewendet. Die LOG-Datei wird im TMP-Verzeichnis von iX-Haus abgelegt. Ihr Name hat den Aufbau DynTabImport_JJJJMMTT_USRID.log. So wird je Anwender und Tag eine LOG-Datei erzeugt. |
| Importparameter | |
XLS-Importdatei | Dateiname und Pfad der zu importierenden Excel-Datei (XLS-Importdatei). F2 öffnet eine Dateiauswahl (Dialog Öffnen). |
Anzeigen | Schalter. Öffnen der benannten Importdatei im Excelprogramm. Wenn eine Importdatei gegeben ist und sie bereits existiert, kann sie hierüber in Excel geöffnet werden. Eine parallele Ansicht der Importdaten kann das Erstellen der Spaltendefinitionen vereinfachen. |
XLS-Blattname | Hier wird der Name des Blattes angegeben, aus dem die Daten importiert werden sollen. Bleibt dieses Feld leer, werden die Daten des ersten Blattes importiert. Es kann immer nur ein Blatt aus einer Excel-Datei importiert werden. |
XLS-Startzeile | Zahl, (Standard: 1). Nummer der ersten Zeile, aus der Daten importiert werden sollen. Ab (und inklusive) dieser Zeile werden die Zeilen solange importiert, bis vier aufeinanderfolgende Zeilen in keiner Spalte Daten geliefert haben. Die größte einlesbare Zeilennummer ist 64.000. Hiermit kann ein Kopfbereich in der Importdatei übersprungen werden, der z. B. zu Informationszwecken dateiintern genutzt wird, ohne dass dieser später in der dynamischen Tabelle auftritt. Dort sollen ja nur tabellarische Informationen ausgegeben werden. |
| Spaltendefinitionen | Grid: Spalte, Bezeichnung, DB-Name, Datentyp, Spalteninhalt, Deakt. In diesem Grid werden die zu importierenden Spalten mit allen hierfür benötigten Daten aufgelistet und bearbeitet. Nur hier genannte Spalten werden aus der Excel-Datei importiert und in der DB-Tabelle angelegt. Einzige Ausnahme bildet die Spalte ixut_LfdNr in der DB-Tabelle. Sie wird generell eingetragen und enthält eine fortlaufende und eindeutige Nummer der Tabellendatensätze. Siehe auch Dialog Spaltendefinitionen. |
| Generierung mit ext. Excelreport | |
| Dynamische Info | Es ist möglich, vor einem Import die betreffende Excel-Datei über das Excel Reporting generieren zu lassen. Wenn Parameter hierfür gegeben sind, ist diese Option verfügbar. Je nach Bedarf kann sie dann aktiviert werden. |
Generierung aktiv: | Checkbox [ ] Die Exceldatei wird nicht automatisch vom externen Excelreport erzeugt. Die vorliegende Exceldatei wird direkt importiert. [X] Die zu importierende Exceldatei wird zuerst automatisch vom externen Excelreport erzeugt und dann importiert. Hierdurch wird immer der aktuellste iX-Haus-Datenbestand berücksichtigt. |
Bearbeiten | Schalter Hiermit wird der Dialog zur Konfiguration des Excel Reportings geöffnet. Die Parameter entsprechen weitgehend denen des Berichts Objektsicht. Der Report wird dann zur Laufzeit mit Hilfe des Excel Reportings generiert. |
Löschen | Schalter Löscht den zugeordneten Generierungsparametersatz. |
Vorlage | Schalter Wenn ein Generierungsparametersatz gegeben ist, kann die darüber adressierte Vorlage hierüber in Excel geöffnet werden. Eine parallele Ansicht der Importdaten kann das Erstellen der Spaltendefinitionen vereinfachen. |
| Schalter | |
OK | Schalter Speichert die Änderungen und schließt den Dialog. |
Abbrechen | Schalter Schließt den Dialog ohne die Änderungen zu Speichern. |
Dialog Spaltendefinitionen
Zugang: Berichtscenter > Dynamische Tabellen (Parametrierung) > Bearbeitung eines Eintrags (Dialog Importdefinition) > Grid Spaltendefinitionen ⇒ Kontextmenü Eintrag bearbeiten oder Eintrag einfügen
Innerhalb des Grids der Spaltendefinitionen steht ein Rechtsklickmenü mit Funktionen zur Bearbeitung zur Verfügung. Zusätzlich wird bei einem Doppelklick auf einen Eintrag der Dialog zur Bearbeitung desselben angezeigt. Ein Doppelklick auf eine leere Zeile legt einen neuen Eintrag an. In dem Popup-Menü sind die folgenden Funktionen enthalten:
- Einfügen eines neuen Datensatzes.
- Bearbeiten eines bestehenden Datensatzes.
- Löschen eines Datensatzes.
Der Dialog zur Bearbeitung einer Spaltendefinition hat den folgenden Aufbau:
| Feld | Beschreibung |
|---|---|
Bezeichnung | Bezeichnung zu der Spalte. Diese wird z. B. als Beschriftung im iX-Haus plus Grid verwendet. |
XLS-Spalte | Spaltenname der zu importierenden Excel-Spalte. Benennung laut Excel, also A, B, C usw. |
XLS-Spalteninhalt | Auswahl Für bestimmte Spalteninhalte kann hier der Inhalt genauer spezifiziert werden. Diese Information dient bei der Grid-Anzeige in iX-Haus plus zur besseren Weiterverarbeitung der jeweiligen Daten. Z.B . nur wenn bekannt ist, dass es sich bei der Zahl um eine Objektnummer handelt, werden im Grid objektspezifische Zusatzfunktionen freigeschaltet. |
DB-Spalte (ix*) | Name für die in der Datenbanktabelle zu erstellende Spalte. Es können maximal 28 Zeichen eingegeben werden. Jede Spalte bekommt das Präfix „ix“ vorangestellt. Die Namen müssen innerhalb der bearbeiteten Importdefinition eindeutig sein. |
DB-Datentyp | Auswahl Datentyp der DB-Tabellenspalte. Der Typ Text ist auf eine Länge von 300 Zeichen beschränkt. |
Deaktiviert | Schalter [X] Die Spalte ist temporär vom Import ausgeschlossen. |
Kommandozeile für Importprozess
Die in der Parameterdefinition festgelegten Einstellungen werden für den Import und das Erstellen der DB-Tabelle benötigt. Je nachdem, ob es sich um eine externe Excel-Datei, oder um eine durch das Excel Reporting erstellte Datei handelt, kann vor dem Start des eigentlichen Imports auch noch eine Generierung vorgeschaltet sein. Der gesamte Prozess wird von einem iX-Haus Kommandozeilenprogramm abgewickelt.
Der Aufruf des Programms lautet z. B. wie folgt:
.\exe\ieexcel2db.exe -P1 -U120 -D1 -L2
Als Arbeitsverzeichnis muss das iX-Haus Verzeichnis gesetzt sein. Parameter:
-Px | x steht für die Nummer der auszuführenden Importdefinition. Sollen mehrere hintereinander ausgeführt werden, können die jeweiligen Nummern kommagetrennt angegeben werden (z. B. -P1,2,3). Es darf kein Leerzeichen enthalten sein. |
-Ux | x steht für die UserId des iX-Haus Anwenders, in dessen Kontext der Prozess ablaufen soll. Zugriffsrechte im Rahmen der Generierung werden anhand dieser UserId geprüft. |
-Dx | Erlaubte Werte für x sind 0 oder 1. Hiermit wird festgelegt, ob ein Fortschrittsdialog angezeigt werden soll oder nicht. |
-Lx | Erlaubte Werte für x sind 0, 1 oder 2. 0: Kein LOG schreiben 1: LOG schreiben 2: LOG schreiben und anzeigen |
- Es ist auch möglich, das Kommandozeilenprogramm via iX-Haus Scheduler als Hintergrundprozess zu starten. In dem Fall wird, unabhängig von der LOG-Einstellung, eine evtl. generierte LOG-Datei nicht am Bildschirm angezeigt. Bei einem Start über den Scheduler wird der LOG-Inhalt unabhängig von der LOG-Einstellung immer auch in der iX-Haus plus Protokollverwaltung abgelegt. Dort kann er eingesehen oder auf Wunsch auch automatisiert per Mail versendet werden.
- Wenn Sie eine Tabelle aus der iX-Haus-Datenbank über einen externen Datenbankzugriff abrufen wollen (ohne hierzu die graphische Oberfläche von iX_Haus zu starten), können Sie hierzu den Oracledatenbankuser
iXUtReadeinsetzen. Dieser Oracledatenbankuser muss ggf. zuvor eingerichtet werden.
berichtscenter/dynamische_tabellen/parameter.txt · Zuletzt geändert: 2023/09/15 11:55 (Externe Bearbeitung)
Seiten-Werkzeuge
