Versions Compared

Version Old Version 1 New Version Current
Changes made by

Lango: Language and translation manager

Lango: Language and translation manager

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Automatically translated by Lango

DifficultySchwierigkeitsgrad: noviceAnfänger

Content

Inhalt

Table of Contents
minLevel1
maxLevel1

Learning Objectives

After reading this article, you’ll be able to:

  • Create new report

  • Understand and make some changes to reports

  • Set the general settings

  • Add totals/sorting to reports

Basics

If you have not read the articles under Reporting basics be sure to check those out beforehand. In this article we will go over some of the basics and go more into detail.

A report consists out of three components:

  1. The report definition (NB: objectReport): here the report settings are made and the other two report components are linked (the filter and list page)

  2. The filter page: the filtering determined what results are displayed

  3. The list page: on the list page we determine what fields should be shown when running the report

Expand
titleCreating a new report

Creating a new report

  1. Navigate to the reports module in the navigationmenu.

  2. Click on ‘Folder’

  3. Click on the folder in which you want to create the report. The name of that folder is now highlighted. The report can easily be moved to another folder at a later stage.

  4. Click: new report

  5. What you have now created is an empty report. We first have to give it a name using Languages and translation strings. After that we can decide the filters which will be explained using an example.

Note: Alternatively REPORTS > Reports > new report can be used. We do not advise this becaeue than the report is not linked to a folder making it more difficult to find.

Example: create a report that searches for all cars

Tip

Before adding any filters or list items you have to decide what the main object of your report will be. The first field you add to the filter and list page should ALWAYS be from the same object.

In this example we want to see the number of cars per property. The car will be the main object and since car are added as asset, we add fields from the Asset object as filtering.

This is the main object since 1 car (1 Asset) only has 1 property linked to it. While 1 property has multiple cars that could be linked to it. So by using the asset as the main object we make sure we know for each car what property is linked to it (in the propertyId field).

Create filter page

  1. To create the filter page, click add filter:

    Image Removed

  2. First select the object we want to filter on: “Asset” > Search

    Image Removed

  3. Select asset in the list of results > OK

    Image Removed

  4. Now al the fields of the object ‘Assets’ are shown. Select the fields that you want to show on the filter page. In this example, we select: categoryFolderId, propertyId, purchaseDate > now click 'Ok' to add the fields.

    Image Removed

  5. The filterpage is now automatically created (the name of the page is based on the report reference). The filter fields are shown at the bottom of the report.

  6. When you want to add more fields, repeat the steps above.

  7. If you want to delete a field: select the field in the ‘Filter fields’ include > Selection > Delete selected objects

    Image Removed

Create list page

These steps are pretty much the same as for creating the filter page:

  • To create the list page, click add field.

  • First select the object we want to show: “Asset” > Search

    Image Removed

  • Select asset from the list of results > Ok

    Image Removed
    • Now al the fields of the object ‘Assets’ are shown. Select the fields that you want to show on the filter page. For this example we select

    Lernziele

    Nach der Lektüre dieses Artikels werden Sie in der Lage sein:

    • Neuen Bericht erstellen

    • Verstehen und Ändern von Berichten

    • Legen Sie die allgemeinen Einstellungen fest

    • Summen/Sortierung zu Berichten hinzufügen

    Grundlagen

    Wenn Sie die Artikel nicht gelesen haben unter Reporting basics sollten Sie sich vorher informieren. In diesem Artikel gehen wir auf einige der Grundlagen ein und gehen mehr ins Detail.

    Ein Bericht besteht aus drei Komponenten:

    1. Die Berichtsdefinition (NB: objectReport): hier werden die Einstellungen für den Bericht vorgenommen und die beiden anderen Berichtskomponenten verknüpft (die Filter- und die Listenseite)

    2. Die Seite filtern: die Filterung bestimmt, welche Ergebnisse angezeigt werden

    3. Die Listenseite: Auf der Listenseite legen wir fest, welche Felder beim Ausführen des Berichts angezeigt werden sollen.

    Search

    Filter and show field from objects than the main object

    Until now all the filter field that we added where from the main object (Asset). It is however, also possible to filter other objects. The logic behind this is fairly easy to understand.

    Before you can add fields from another object, you first need to setup the proper link to that object using an id-field. After that you can add fields from other objects. This is easiest to understand by looking at these example:

    Example 1 (filter):

    • The main object is ‘Asset’

    • After adding the field asset.propertyId a link is made to the property object.

    • So now you can add a filter field from the property object. In this case the property.ownerContactId.

    • This added filters now, not only allow you to find cars that are linked to a certain property. But also filter on properties that are owned by a specific contact.

    Image Removed

    Example 2 (list page):

    • The same logic that goes for the filter pages also applies for your list page

    • The main object is ‘Request’

    • After adding the field request.fromContactId, a link exists to the Contact object. So you can now add a field from the Contact object.

    • In this example, the cost center and phone number of the from contact of the request are shown

    Image Removed

    Expand
    titleEinen neuen Bericht erstellen

    Einen neuen Bericht erstellen

    1. Navigieren Sie im Navigationsmenü zum Modul Berichte.

    2. Klicken Sie auf 'Ordner'.

    3. Klicken Sie auf den Ordner, in dem Sie den Bericht erstellen möchten. Der Name des Ordners wird nun hervorgehoben. Der Bericht kann zu einem späteren Zeitpunkt einfach in einen anderen Ordner verschoben werden.

    4. Klick: neuer Bericht

    5. Sie haben nun einen leeren Bericht erstellt. Wir müssen ihm zunächst einen Namen geben, indem wir Languages and translation strings. Danach können wir uns für die Filter entscheiden, was anhand eines Beispiels erläutert wird.

    Hinweis: Alternativ können Sie auch REPORTS > Berichte > Neuer Bericht verwenden. Davon raten wir ab, da der Bericht dann nicht mit einem Ordner verknüpft ist und somit schwerer zu finden ist.

    Beispiel: Erstellen eines Berichts, der nach allen Autos sucht

    Tip

    Vor dem Hinzufügen von Filtern oder Listenelementen müssen Sie entscheiden, was die wichtigsten Objekt Ihres Berichts sein wird. Das erste Feld, das Sie der Filter- und Listenseite hinzufügen, sollte IMMER von demselben Objekt stammen.

    In diesem Beispiel wollen wir die Anzahl der Autos pro Eigenschaft sehen. Das Auto wird das Hauptobjekt sein, und da Autos als Asset hinzugefügt werden, fügen wir Felder aus dem Asset-Objekt als Filterung hinzu.

    Dies ist das Hauptobjekt, da 1 Auto (1 Asset) nur mit 1 Eigenschaft verknüpft ist. Während 1 Eigenschaft mehrere Autos hat, die mit ihr verknüpft sein könnten. Indem wir also das Asset als Hauptobjekt verwenden, stellen wir sicher, dass wir für jedes Auto wissen, welche Eigenschaft mit ihm verknüpft ist (im Feld propertyId).

    Filterseite erstellen

    1. Um die Filterseite zu erstellen, klicken Sie auf Filter hinzufügen:

      Image Added

    2. Wählen Sie zunächst das Objekt aus, nach dem Sie filtern möchten: "Asset" > Suchen

      Image Added

    3. Wählen Sie ein Asset in der Ergebnisliste aus > OK

      Image Added

    4. Jetzt werden alle Felder des Objekts "Assets" angezeigt. Wählen Sie die Felder aus, die Sie auf der Filterseite anzeigen möchten. In diesem Beispiel wählen wir: categoryFolderId, propertyId, purchaseDate > Klicken Sie nun auf "Ok", um die Felder hinzuzufügen.

      Image Added

    5. Die Filterseite wird nun automatisch erstellt (der Name der Seite basiert auf dem Berichtsbezug). Die Filterfelder werden am unteren Rand des Berichts angezeigt.

    6. Wenn Sie weitere Felder hinzufügenwiederholen Sie die obigen Schritte.

    7. Wenn Sie möchten, dass ein Feld löschen: Wählen Sie das Feld im Include 'Filterfelder' > Auswahl > Ausgewählte Objekte löschen

      Image Added

    Listenseite erstellen

    Diese Schritte sind im Wesentlichen die gleichen wie bei der Erstellung der Filterseite:

    1. Um die Listenseite zu erstellen, klicken Sie auf Feld hinzufügen.

    2. Wählen Sie zunächst das Objekt aus, das Sie anzeigen möchten: "Asset" > Suchen

      Image Added

    3. Wählen Sie ein Asset aus der Ergebnisliste aus > Ok

      Image Added

    4. Jetzt werden alle Felder des Objekts "Assets" angezeigt. Wählen Sie die Felder aus, die Sie auf der Filterseite anzeigen möchten. In diesem Beispiel wählen wir: propertyId, reference, name, puchaseDate, originalValue , and und description > now click 'Ok' to add the fields.

    5. The list page is then automatically created after adding the fields. The list fields are shown at the bottom of the report.

    6. When you want to add more fields, repeat the steps above.

    7. If you want to delete a field: select the field in the ‘Page fields’ include > Selection > Delete selected objects

      Image Removed

    Warning

    Keep in mind: you can use the filterbox on the top right of the page when selecting fields (step 4. of the description above). However, before clicking ‘Ok’ make sure that you empty the filter box on the top right. Only the fields that are visible will be added to the report!

    Image Removed

    Changing the order of the fields

    • After adding all the filter and list fields you can change the order of the fields. To do this simply change the values in “row” and “Col” (see screenshot).

    • We advise to use tens (so 10, 20, 30). This make it easy to insert additional fields at a later stage.

    Image Removed

    View the report

    The report is now created. To view it click: “view”. To see all the cars we have to fill in Car in the Category drop down.

    Keep reading this article to find out how you can optimize your report.

    Image Removed

    Expand
    titleFilter and show field from objects than the main object
    Expand
    titleCopy and change an existing report

    Copy and change an existing report

    When creating reports you can use an existing reports. We often choose a report that partially shows what we already want to see and add on to that.

    • Both client specific and baseline reports can be copied.

    • Baseline reports always need to be copied to be able to make changes to it.

    To change an existing report we first have to make a copy of it. To copy the report click the copy button at the top right.

    Image Removed

    Expand
    titleOperators

    Operators

    For each filter that is added to the report we can change the operator. Operators arecharacters that represent a specific action or process. In Workplace Management operators are mainly used for reporting purposes.

    Most operators like =, >, <, are fairly straightforward. We can compare two dates or characters. The ones that need more explanation are discussed in this section

    Image Removed

    = Equals

    =| Pipe equal operator (see additional explanation below)

    < Smaller than

    <= Smaller or equal to

    <> Not equal

    >= Bigger or equal to

    > Bigger than

    = (exact) Equals exactly

    Set and Special are not used in reporting.

    != Pipe operator

    Info

    =| Pipe operator: The pipe operator is easily explained by using an example. When we use the pipe operator we look for objects that are either equal, or have sub-objects that are equal.

    Take a problemtree for example with problemtype-1.0 Facility request and problemtype 1.1 Coffee machine. Problemtype 1.1 has a parent: problemtype-1, say we are looking for all requests that are within problemtype-1 the operator will look like this:

    Image RemovedImage Removed

    This will return all the requests that are either problemtype 1.0, 1.1 and every other problemtype that has 1.0 as a parent problemtype.

    Adding the same filterfield twice

    Using operators on date fields: In the screenshot below the field startDate is added twice as a filter, but with differente operators. This allows a user to for example search for reservation that started within a specific time span.

    Image Removed

    Contains, not contains, Starts, Ends, Matches

    When using any of the operators Contains, not contains, Starts, Ends or Matches we assume to be comparing a set of characters. Contains can be compared to the = operator. When looking for names typing in “Spacew”, will result in finding the organisation “Spacewell”.

    This works when using contains, =, Starts and Matches.

    Info

    = (exact): When looking for names using the = (exact) operator only returns the names that are exactly equal. When looking for “Spacew” the report will not return organisation “Spacewell”.

    Note

    A default operator that is very often used is for the field: closeTime. When this field is filled in it means the object that you are looking for is closed (Requests, reservations etc.). When we use this field with the operator “Empty” we only look for those objects that are not yet closed.

    Hide operator

    An operator can be hidden in case you don’t want users to be able to change the operator.

    1. click on the magnifying glas of the filterfield in the ‘Filter field’ include

    2. Change the setiting “Visible = no'

    Image Removed

    AND / OR logic

    By default the operator AND is set when adding a filter field. This makes sure that all filter values are met when running the report.

    When using the option ‘Or’ multiple values in the same field are allowed. In the example below, defaults are set on the categoryFolderId field (default are also explained in this article).

    • So when running this report, assets with the category ‘Car’ (row 10) or with the category ‘Car training' (row 20) will be returned.

    • If the ‘And’ operator would have been used on row 20, the report would not return any results, because an asset cannot have the category ‘Car’ AND the category ‘Car training'. An asset only has one value set in the field 'categoryFolderId’

    Image Removed

    Expand

    titleSet default values

    Set default values

    In reports we can set default values:

    • To make your reports easier to execute

    • To use a report as a list on a page

    Fixed value

    When we look for a a assets within a specific category we can set the category by default:

    1. Navigate to the ‘categoryFolderId’ filter by clicking on the magnifying glass in the ‘Filter field’ include

      Image Removed

    2. Click: Set default

      Image Removed

    3. Select the default value in the drop down

      Image Removed

    4. Save and return

    5. To delete click ‘'Delete default. Changing the field ‘Value’ to empty does not delete the default and can cause to unexpected report result! So always make sure to use 'Delete default’.

    Initialization value

    When we want to set default dynamic values, like dates or user contacts we use initialization scripts. This works in the same way. We use these when we for example look for all requests that have been created today.

    1. Navigate to the category filter

    2. Click: Set default

      Image Removed

    3. Select the default value in the drop down

      Image Removed

    4. Select the Value, 0 means today +/- 0 days (So the date of today at 00:00). When you change the value to 1 the date will be changed to tomorrow at 00:00.

    5. Save and return

    6. To delete click ‘'Delete default. Changing the field ‘Value’ to empty does not delete the default and can cause to unexpected report result! So always make sure to use 'Delete default’.

    About the initialization scripts

    • The available initialization scripts are mostly self-explanatory.

    • All script are selectable for all fields, but not all scripts will work of course. You can, for example, apply the ‘Today (+/- days) script to the categoryFolderId field, but that won’t work. Initialization script regarding date/ time only work for date/ time fields like startDate, approveDate, and cancelDate.

    Expand
    titleHiding filters

    Hiding filters

    When setting default values we can hide these filters. Since there is already a default value set, the user does not need to see the filter anymore. When all filters are set by default and hidden the user will be shown a list. To hide a filter:

    1. Open the filter field using the magnifying glass

    2. Set 'Filter = Hidden'

    3. Image Removed

      Save and return

    This setting is also available via the filter include in the report overview:

    Image Removed

    Expand
    titleSorting

    Sorting

    After you have created a report or changed an existing report we are still able to change some of the basic settings. For explaining the sorting, we will continue with the Asset report we created earlier in this article.

    Image Removed

    Default sorting order

    By default, results are sorted based on the first column in the list. So if reference is the first column in your list page, the results will be sorted based on their reference.

    Change sorting

    • We can change this by referring to field (left example) or column (right example). Do not combine these two options. Use either the fields or the column numbers.

    • A maximum of 3 sorting columns can be defined. This for example allows you to first sort on property, and then on reference.

    Image Removed

    We can directly link the sorting to a specific field from the result list. This method is best practice

    Image Removed

    We can also define a column from the result list. So if ‘Name’ is the third column, set 3 as 'Sort column 1.

    When the ‘sorting column 1 = propertyId’ and ‘sorting column 2 = reference’ the report would look like this:

    Image Removed

    Although the sorting now makes sense, say we want to see the total car prices per property. Keep reading!

    Expand
    titleSubtotals

    Subtotals

    To be able to represent the car prices we have to use subtotals.

    1. Because subtotals work together with sorting we first define our SORTING to be based on propertyId.

    2. When this is done change the setting subtotals 1 = yes.

    Image Removed

    3. Then we define what subtotals we want to see, in this case the originalValue. To configure this find the field in the ‘Page fields' include’and set the “Totals = Sum”.
    Info: aside from the sum we could also decide to show the average, maximum, minimum and many others.

    Image Removed

    4. The results will come out like this:

    Image Removed

    Collapse/ expand and bold totals

    In this example we only want to know the total price per property, to do so we can change the sub totals field to: “Collapsed level 1” and for good measure we set the Totals style to bold.

    When we set the sub totals to Collapsed level 1, the user is always able to see the full list by clicking on expand.

    Image Removed

    In the subtotals we can also decide the subtotals look, these can also be set to: Normal, bold or suppressed (suppressing the subtotal all together).

    Image Removed

    Object counter

    Aside from using existing fields to sum up we could also be interested in the amount of cars per property, this is not a field that is readily available. To do this we use a field called: objectCounter. Up until this point we used fields from the object Asset only, the objectCounter however is a field on the Client object.

    Info

    Info: The objectCounter can be used for any object, in all cases the field comes from the client object as shown below.

    We add a field like we normally would:

    1. Click ‘Add field’

    2. First select the object “client” > Search

    3. Select ‘Client’ from the list of results > Ok

    4. Select the field ‘objectCounter’ > Ok

    5. the field client.objectCounter is now added to the include ‘Page fields’include

    6. In this include, set the totals column to sum (same as for the originalValue)

    7. The finished report will then look like this:

    Image RemovedImage Removed Expand
    titleOther settings

    Other settings

    In the table below we go over some other general settings that can be set in reports.

    Field

    Description

    Section

    This specifies the section (which top or side menu) the report belongs to.

    Concerns

    The section object.

    Maximum find

    Maximum number of rows that the filter page may find. If more rows are found an error message is displayed. The number is determined before filtering on access rights. F.e. searching all request would not show all request for every user (because of limited access per user) but might still throw an error when searching since the total amount of requests is used. This field is often used as a security measure.

    File name

    The JSP file name or Java class that is used to generate the report.

    Report script

    A report script allows to create the report in an Axxerion Script. The script determines the contents of the report.

    Logging

    Whether or not to turn on logging for the current report. If logging is turned on, then all views of the report data will be logged as object history items.

    Hyperlinks

    Whether hyperlinks should be shown for the first column of the report.

    Empty filter

    If not legal values have been set for a filter, then this field determines what will happen. The report can show all data (the default behavior) or an empty list. It is also possible to show an error message.

    Pivot

    Should the report be displayed as a pivot table? Pivot tables have fixed layouts.

    Heading style

    Heading style of pivot table.

    Header formula

    The header formula can be made by using the Word template syntax.

    Hide empty rows

    Whether or not to hide rows for which all floating point columns have empty values.

    Resorting

    Should the report be resorted. When set to yes the user can resort by clicking on the column header.

    Resort column

    Column number of the report, that should be used to resort the report before it is being cropped. You must take collapse into account.

    Hierarchy

    Hierarchy can be shown as collapsed or expanded. For large hierarchies you can select the option ‘incremental'. In this case the lower level objects are collected after the user has opened a certain level. This reduces the time to display the initial screen.

    Number of rows

    Specifies the maximum number of rows that are displayed after sorting. You can create a list of the top ten items.

    Auto select

    Setting to specify if items should be opened or not. ‘Single result’ means that auto select is only one row in the list. ‘Always’ means that auto select is done always, even if there is more than one row.

    Cover

    You can select a template document here that will be used to create a nice cover page when a PDF is created for the report.

    Cover usage

    Specify in which situation the cover page should be used.

    Expand
    titleMove a report to another folder

    Move a report to another folder

    Moving a report to a folder actually means linking the report that folder. The report will also still be linked to the folder it was created in. You can link one report to as many folders as you like.

    Linking/ move a report to a folder

    1. Navigate to the folder to which you want to move (of should we say link) the report to

    2. Make sure you click the folder so it is highlighted

    3. Click the little arrow pointing down on the top right of your screen

    4. Click ‘Move to’

    5. In the search screen that now appears type the reference of name of your report > Search

    6. Select the report from the list

    7. OK

    8. The report is now added to the folder

    Image RemovedIf you are not able to find the report you want to move. First open the report and set the field ‘Section’ to empty. This section acts as a filter.Image Removed

    Unlink/ delete a report from a folder

    1. Open the report

    2. On the top right click on the gears symbol > related

    3. Select the folder(s) (NB: objectFolder) from which you want to delete the report

    4. Selection > delete selected objects

    Info: The objectReport object links a report to a folder

    Image Removed

    Summary

    Rw ui textbox macro

    • For creating a report we need to make: a filter page, a list page, and define the report settings

    • We often use existing reports and add on to those, adding fields however works in the same way

    • Operators can be changed for fields

    • Default values can be set

    • Filters can be hidden

    1. Klicken Sie nun auf "Ok", um die Felder hinzuzufügen.

    2. Die Listenseite wird dann automatisch erstellt, nachdem die Felder hinzugefügt wurden. Die Listenfelder werden am unteren Rand des Berichts angezeigt.

    3. Wenn Sie weitere Felder hinzufügenwiederholen Sie die obigen Schritte.

    4. Wenn Sie möchten, dass ein Feld löschen: Wählen Sie das Feld im Include "Seitenfelder" > Auswahl > Ausgewählte Objekte löschen

      Image Added

    Warning

    Denken Sie daran: Sie können die Filterbox oben rechts auf der Seite verwenden, wenn Sie Felder auswählen (Schritt 4. der obigen Beschreibung). Bevor Sie jedoch auf "Ok" klicken, vergewissern Sie sich, dass Sie die Filterbox oben rechts leeren. Nur die Felder, die sichtbar sind, werden dem Bericht hinzugefügt!

    Image Added

    Ändern der Reihenfolge der Felder

    • Nachdem Sie alle Filter- und Listenfelder hinzugefügt haben, können Sie die Reihenfolge der Felder ändern. Dazu ändern Sie einfach die Werte in "Zeile" und "Spalte" (siehe Screenshot).

    • Wir empfehlen die Verwendung von Zehnerzahlen (also 10, 20, 30). Dies erleichtert das Einfügen zusätzlicher Felder zu einem späteren Zeitpunkt.

    Image Added

    Den Bericht ansehen

    Der Bericht ist nun erstellt. Um ihn anzusehen, klicken Sie: "Ansicht". Um alle Fahrzeuge zu sehen, müssen Sie in der Dropdown-Liste "Kategorie" "Auto" eingeben.

    Lesen Sie diesen Artikel weiter, um herauszufinden, wie Sie Ihren Bericht optimieren können.

    Image Added

    Expand
    titleFiltern und Anzeigen von Feldern aus anderen Objekten als dem Hauptobjekt

    Filtern und Anzeigen von Feldern aus anderen Objekten als dem Hauptobjekt

    Bis jetzt wurden alle Filterfelder, die wir hinzugefügt haben, im Hauptobjekt (Asset) verwendet. Es ist jedoch auch möglich, andere Objekte zu filtern. Die Logik dahinter ist recht einfach zu verstehen.

    Bevor Sie Felder aus einem anderen Objekt hinzufügen können, müssen Sie zunächst die richtige Verknüpfung zu diesem Objekt mit einem id-Feld herstellen. Danach können Sie Felder aus anderen Objekten hinzufügen. Dies ist am einfachsten zu verstehen, wenn man sich diese Beispiele ansieht:

    Beispiel 1 (Filter):

    • Das Hauptobjekt ist 'Asset'.

    • Nach dem Hinzufügen des Feldes asset.propertyId wird eine Verknüpfung mit dem Property-Objekt hergestellt.

    • Jetzt können Sie also ein Filterfeld aus dem Eigenschaftsobjekt hinzufügen. In diesem Fall das Feld property.ownerContactId.

    • Mit diesen zusätzlichen Filtern können Sie jetzt nicht nur Autos finden, die mit einer bestimmten Immobilie verbunden sind. Sondern auch nach Eigenschaften filtern, die einem bestimmten Kontakt gehören.

    Image Added

    Beispiel 2 (Listenseite):

    • Die gleiche Logik, die für die Filterseiten gilt, gilt auch für Ihre Listenseite

    • Das Hauptobjekt ist 'Anfrage'.

    • Nach dem Hinzufügen des Feldes request.fromContactId besteht eine Verknüpfung mit dem Objekt Contact. So können Sie nun ein Feld aus dem Kontaktobjekt hinzufügen.

    • In diesem Beispiel werden die Kostenstelle und die Telefonnummer des Absenderkontakts der Anfrage angezeigt

    Image Added

    Expand
    titleKopieren und Ändern eines bestehenden Berichts

    Kopieren und Ändern eines bestehenden Berichts

    Bei der Erstellung von Berichten können Sie vorhandene Berichte verwenden. Oft wählen wir einen Bericht, der einen Teil dessen zeigt, was wir bereits sehen wollen, und fügen diesen hinzu.

    • Sowohl kundenspezifische als auch Basisberichte können kopiert werden.

    • Basisberichte müssen immer kopiert werden, um Änderungen daran vornehmen zu können.

    Um einen bestehenden Bericht zu ändern, müssen wir zunächst eine Kopie des Berichts erstellen. Um den Bericht zu kopieren, klicken Sie auf die Schaltfläche Kopieren oben rechts.

    Image Added

    Expand
    titleBetreiber

    Betreiber

    Für jeden Filter, der dem Bericht hinzugefügt wird, können wir den Operator ändern. Die Operatoren sindZeichen, die eine bestimmte Aktion oder einen Prozess darstellen. Im Workplace Management werden Operatoren hauptsächlich zu Berichtszwecken verwendet.

    Die meisten Operatoren wie =, >, <, sind ziemlich einfach. Wir können zwei Daten oder Zeichen vergleichen. Diejenigen, die mehr Erklärung benötigen, werden in diesem Abschnitt behandelt

    Image Added

    = Gleiche

    =| Pipe-gleich-Operator (siehe zusätzliche Erklärung unten)

    < Kleiner als

    <= Kleiner oder gleich

    <> Nicht gleich

    >= Größer oder gleich

    > Größer als

    = (exakt) Entspricht genau

    Set und Special werden in der Berichterstattung nicht verwendet.

    != Rohrleitungsoperator

    Info

    =| Rohrleitungsoperator: Der Pipe-Operator lässt sich anhand eines Beispiels leicht erklären. Wenn wir den Pipe-Operator verwenden, suchen wir nach Objekten, die entweder gleich sind oder Unterobjekte haben, die gleich sind.

    Nehmen wir zum Beispiel einen Problembaum mit Problemtyp-1.0 Anfrage der Fazilität und Problemtyp 1.1 Kaffeemaschine. Problemtyp 1.1 hat einen übergeordneten Typ: problemtype-1. Angenommen, wir suchen nach allen Anfragen, die zu problemtype-1 gehören, dann sieht der Operator wie folgt aus:

    Image AddedImage Added

    Dies gibt alle Anfragen zurück, die entweder dem Problemtyp 1.0 oder 1.1 angehören, sowie alle anderen Problemtypen, die 1.0 als übergeordneten Problemtyp haben.

    Doppeltes Hinzufügen desselben Filterfeldes

    Verwendung von Operatoren für Datumsfelder: Im Screenshot unten ist das Feld startDate zweimal als Filter hinzugefügt, aber mit unterschiedlichen Operatoren. So kann ein Benutzer zum Beispiel nach Reservierungen suchen, die innerhalb einer bestimmten Zeitspanne begonnen haben.

    Image Added

    Enthält, nicht enthält, Beginnt, Endet, Entspricht

    Bei der Verwendung der Operatoren Enthält, Nicht enthält, Beginnt, Endet oder Entspricht gehen wir davon aus, dass wir eine Menge von Zeichen vergleichen. Enthält kann mit dem Operator = verglichen werden. Bei der Suche nach Namen führt die Eingabe von "Spacew" zur Suche nach der Organisation "Spacewell".

    Dies funktioniert bei der Verwendung von contains, =, Starts und Matches.

    Info

    = (genau): Bei der Suche nach Namen mit dem Operator = (exakt) werden nur die Namen zurückgegeben, die exakt gleich sind. Bei der Suche nach "Spacew" wird der Bericht nicht die Organisation "Spacewell" zurückgeben.

    Note

    Ein Standardoperator, der sehr häufig verwendet wird ist für das Feld: closeTime. Wenn dieses Feld ausgefüllt ist, bedeutet dies, dass das gesuchte Objekt geschlossen ist (Anfragen, Reservierungen usw.). Wenn wir dieses Feld mit dem Operator "Empty" verwenden, suchen wir nur nach Objekten, die noch nicht geschlossen sind.

    Operator ausblenden

    Ein Operator kann ausgeblendet werden, wenn Sie nicht möchten, dass die Benutzer den Operator ändern können.

    1. Klicken Sie auf die Lupe des Filterfeldes im Bereich 'Filterfeld'.

    2. Ändern Sie die Einstellung "Sichtbar = nein".

    Image Added

    UND/ODER-Logik

    Standardmäßig wird beim Hinzufügen eines Filterfeldes der Operator AND gesetzt. Dadurch wird sichergestellt, dass bei der Ausführung des Berichts alle Filterwerte erfüllt werden.

    Bei Verwendung der Option "Oder" sind mehrere Werte im selben Feld zulässig. Im folgenden Beispiel werden Standardwerte für das Feld "categoryFolderId" festgelegt (Standardwerte werden auch in diesem Artikel erläutert).

    • Wenn dieser Bericht ausgeführt wird, werden also Anlagen mit der Kategorie "Auto" (Zeile 10) oder mit der Kategorie "Autoschulung" (Zeile 20) zurückgegeben.

    • Wäre der Operator "Und" in Zeile 20 verwendet worden, würde der Bericht keine Ergebnisse liefern, da ein Vermögenswert nicht die Kategorie "Auto" UND die Kategorie "Autoschulung" haben kann. Eine Kühlstelle hat nur einen Wert im Feld "categoryFolderId".

    Image Added

    Expand
    titleStandardwerte festlegen

    Standardwerte festlegen

    In Berichten können wir Standardwerte festlegen:

    • Um die Ausführung Ihrer Berichte zu erleichtern

    • So verwenden Sie einen Bericht als Liste auf einer Seite

    Fester Wert

    Bei der Suche nach einem Asset in einer bestimmten Kategorie können wir die Kategorie standardmäßig festlegen:

    1. Navigieren Sie zum Filter "categoryFolderId", indem Sie auf die Lupe im Feld "Filter" klicken.

      Image Added

    2. Klicken Sie: Standard einstellen

      Image Added

    3. Wählen Sie den Standardwert in der Dropdown-Liste

      Image Added

    4. Speichern und zurückkehren

    5. Zum Löschen klicken Sie auf "Standard löschen". Wenn Sie das Feld "Wert" leer lassen, wird die Vorgabe nicht gelöscht und kann zu unerwarteten Berichtsergebnissen führen! Stellen Sie daher sicher, dass Sie immer 'Standard löschen' verwenden.

    Initialisierungswert

    Wenn wir dynamische Standardwerte wie Daten oder Benutzerkontakte festlegen wollen, verwenden wir Initialisierungsskripte. Dies funktioniert auf die gleiche Weise. Wir verwenden diese, wenn wir zum Beispiel nach allen Anfragen suchen, die heute erstellt wurden.

    1. Navigieren Sie zum Kategoriefilter

    2. Klicken Sie: Standard einstellen

      Image Added

    3. Wählen Sie den Standardwert in der Dropdown-Liste

      Image Added

    4. Wählen Sie den Wert, 0 bedeutet heute +/- 0 Tage (also das Datum von heute um 00:00). Wenn Sie den Wert auf 1 ändern, wird das Datum auf morgen um 00:00 Uhr geändert.

    5. Speichern und zurückkehren

    6. Zum Löschen klicken Sie auf "Standard löschen". Wenn Sie das Feld "Wert" leer lassen, wird die Vorgabe nicht gelöscht und kann zu unerwarteten Berichtsergebnissen führen! Stellen Sie daher sicher, dass Sie immer 'Standard löschen' verwenden.

    Über die Initialisierungsskripte

    • Die verfügbaren Initialisierungsskripte sind meist selbsterklärend.

    • Alle Skripte sind für alle Felder wählbar, aber natürlich funktionieren nicht alle Skripte. Sie können z. B. das Skript "Heute (+/- Tage)" auf das Feld categoryFolderId anwenden, aber das wird nicht funktionieren. Initialisierungsskripte für Datum/Uhrzeit funktionieren nur für Datums-/Zeitfelder wie startDate, approveDate und cancelDate.

    Expand
    titleAusblenden von Filtern

    Ausblenden von Filtern

    Beim Setzen von Standardwerten können wir diese Filter ausblenden. Da bereits ein Standardwert eingestellt ist, braucht der Benutzer den Filter nicht mehr zu sehen. Wenn alle Filter standardmäßig eingestellt und ausgeblendet sind, wird dem Benutzer eine Liste angezeigt. Um einen Filter auszublenden:

    1. Öffnen Sie das Filterfeld mit der Lupe

    2. Set 'Filter = Ausgeblendet'

    3. Image Added

      Speichern und zurückkehren

    Diese Einstellung ist auch über den Filter include in der Berichtsübersicht verfügbar:

    Image Added

    Expand
    titleSortierung

    Sortierung

    Nachdem Sie einen Bericht erstellt oder einen bestehenden Bericht geändert haben, können Sie immer noch einige der Grundeinstellungen ändern. Um die Sortierung zu erklären, fahren wir mit dem Anlagenbericht fort, den wir in diesem Artikel erstellt haben.

    Image Added

    Standard-Sortierreihenfolge

    Standardmäßig werden die Ergebnisse nach der ersten Spalte in der Liste sortiert. Wenn also "Referenz" die erste Spalte auf Ihrer Listenseite ist, werden die Ergebnisse nach ihrer Referenz sortiert.

    Sortierung ändern

    • Wir können dies ändern, indem wir uns auf Feld (linkes Beispiel) oder Spalte (rechtes Beispiel) beziehen. Kombinieren Sie diese beiden Optionen nicht. Verwenden Sie entweder die Feld- oder die Spaltennummern.

    • Es können maximal 3 Sortierspalten definiert werden. So können Sie zum Beispiel zuerst nach Eigenschaft und dann nach Referenz sortieren.

    Image Added

    Wir können die Sortierung direkt mit einem bestimmten Feld aus der Ergebnisliste verknüpfen. Diese Methode ist die beste Praxis

    		Image Added

    Wir können auch eine Spalte aus der Ergebnisliste definieren. Wenn also "Name" die dritte Spalte ist, setzen Sie 3 als "Spalte 1 sortieren".

    Wenn die "Sortierspalte 1 = propertyId" und die "Sortierspalte 2 = reference" gewählt werden, würde der Bericht wie folgt aussehen:

    Image Added

    Auch wenn die Sortierung jetzt sinnvoll ist, wollen wir doch die gesamten Autopreise pro Immobilie sehen. Lesen Sie weiter!

    Expand
    titleZwischensummen

    Zwischensummen

    Um die Autopreise darstellen zu können, müssen wir Zwischensummen verwenden.

    1. Da Zwischensummen mit der Sortierung zusammenarbeiten, definieren wir zunächst unsere SORTIERUNG auf der Grundlage von propertyId.

    2. Wenn dies geschehen ist, ändern Sie die Einstellung Zwischensummen 1 = ja.

    Image Added

    3. Dann legen wir fest, welche Zwischensummen wir sehen wollen, in diesem Fall den Originalwert. Um dies zu konfigurieren, suchen Sie das Feld in der Rubrik "Seitenfelder" und setzen Sie "Summen = Summe".
    Infos: Neben der Summe können wir auch den Durchschnitt, das Maximum, das Minimum und viele andere Werte angeben.

    Image Added

    4. Das Ergebnis sieht folgendermaßen aus:

    Image Added

    Verkleinern/Erweitern und Fettdruck der Summen

    In diesem Beispiel wollen wir nur den Gesamtpreis pro Immobilie wissen, dazu können wir das Feld für die Zwischensummen auf: "Zusammengeklappt Ebene 1" und zur Sicherheit setzen wir den Summenstil auf fett.

    Wenn wir die Zwischensummen auf die Stufe 1 "Eingeklappt" setzen, kann der Benutzer immer die gesamte Liste sehen, wenn er auf "Erweitern" klickt.

    Image Added

    Bei den Zwischensummen können wir auch das Aussehen der Zwischensummen bestimmen, die ebenfalls eingestellt werden können: Normal, fett oder unterdrückt (die Zwischensumme wird komplett unterdrückt).

    		Image Added

    Objektzähler

    Abgesehen von der Verwendung vorhandener Felder für die Zusammenfassung könnten wir auch an der Anzahl der Autos pro Grundstück interessiert sein, aber dieses Feld ist nicht ohne weiteres verfügbar. Zu diesem Zweck verwenden wir ein Feld namens: ObjektZähler. Bis zu diesem Punkt haben wir nur Felder aus dem Objekt Asset verwendet, der objectCounter ist jedoch ein Feld des Client-Objekts.

    Info

    Infos: Der objectCounter kann für jedes beliebige Objekt verwendet werden, in jedem Fall stammt das Feld aus dem Client-Objekt, wie unten gezeigt.

    Wir fügen ein Feld hinzu, wie wir es normalerweise tun würden:

    1. Klicken Sie auf "Feld hinzufügen".

    2. Wählen Sie zunächst das Objekt "Mandant" > Suchen

    3. Wählen Sie "Client" aus der Ergebnisliste > Ok

    4. Wählen Sie das Feld 'objectCounter' > Ok

    5. das Feld client.objectCounter wird nun zum Include 'Seitenfelder' hinzugefügt

    6. In diesem Include setzen Sie die Summenspalte auf Summe (wie bei originalValue)

    7. Der fertige Bericht sieht dann wie folgt aus:

    Image AddedImage Added
    Expand
    titleAndere Einstellungen

    Andere Einstellungen

    In der folgenden Tabelle werden einige weitere allgemeine Einstellungen erläutert, die in Berichten vorgenommen werden können.

    Feld

    Beschreibung

    Abschnitt

    Hier wird angegeben, zu welchem Abschnitt (dem oberen oder seitlichen Menü) der Bericht gehört.

    Betrifft

    Das Abschnittsobjekt.

    Maximaler Fund

    Maximale Anzahl von Zeilen, die die Filterseite finden kann. Wenn mehr Zeilen gefunden werden, wird eine Fehlermeldung angezeigt. Die Anzahl wird vor der Filterung nach Zugriffsrechten festgelegt. So würde z. B. die Suche nach allen Anfragen nicht alle Anfragen für jeden Benutzer anzeigen (wegen des begrenzten Zugriffs pro Benutzer), aber möglicherweise trotzdem einen Fehler bei der Suche auslösen, da die Gesamtanzahl der Anfragen verwendet wird. Dieses Feld wird häufig als Sicherheitsmaßnahme verwendet.

    Name der Datei

    Der Name der JSP-Datei oder der Java-Klasse, die für die Erstellung des Berichts verwendet wird.

    Berichtsskript

    Ein Berichtsskript ermöglicht die Erstellung des Berichts in einem Axxerion-Skript. Das Skript bestimmt den Inhalt des Berichts.

    Protokollierung

    Gibt an, ob die Protokollierung für den aktuellen Bericht eingeschaltet werden soll oder nicht. Wenn die Protokollierung eingeschaltet ist, werden alle Ansichten der Berichtsdaten als Objektverlaufsdaten protokolliert.

    Hyperlinks

    Ob Hyperlinks in der ersten Spalte des Berichts angezeigt werden sollen.

    Leerer Filter

    Wenn für einen Filter nicht zulässige Werte festgelegt wurden, bestimmt dieses Feld, was geschehen soll. Der Bericht kann alle Daten (das Standardverhalten) oder eine leere Liste anzeigen. Es ist auch möglich, eine Fehlermeldung anzuzeigen.

    Pivot

    Soll der Bericht als Pivot-Tabelle angezeigt werden? Pivot-Tabellen haben feste Layouts.

    Stil der Überschrift

    Überschriftenstil der Pivot-Tabelle.

    Formel für die Kopfzeile

    Die Kopfformel kann mit Hilfe der Word-Vorlagensyntax erstellt werden.

    Leere Zeilen ausblenden

    Ob Zeilen ausgeblendet werden sollen, bei denen alle Fließkomma-Spalten leere Werte haben oder nicht.

    Rückgriff auf

    Soll der Bericht neu sortiert werden. Wenn diese Option auf "Ja" gesetzt ist, kann der Benutzer den Bericht neu sortieren, indem er auf die Spaltenüberschrift klickt.

    Resort-Kolumne

    Spaltennummer des Berichts, nach der der Bericht sortiert werden soll, bevor er beschnitten wird. Sie müssen das Zusammenklappen berücksichtigen.

    Hierarchie

    Die Hierarchie kann kollabiert oder erweitert dargestellt werden. Für große Hierarchien können Sie die Option "inkrementell" wählen. In diesem Fall werden die Objekte der unteren Ebenen gesammelt, nachdem der Benutzer eine bestimmte Ebene geöffnet hat. Dadurch wird die Zeit für die Anzeige des Einstiegsbildes verkürzt.

    Anzahl der Zeilen

    Gibt die maximale Anzahl der Zeilen an, die nach der Sortierung angezeigt werden. Sie können eine Liste mit den zehn wichtigsten Einträgen erstellen.

    Automatisch auswählen

    Einstellung, die angibt, ob Elemente geöffnet werden sollen oder nicht. Einzelergebnis" bedeutet, dass die automatische Auswahl nur eine Zeile in der Liste umfasst. Immer" bedeutet, dass die automatische Auswahl immer durchgeführt wird, auch wenn es mehr als eine Zeile gibt.

    Abdeckung

    Hier können Sie eine Dokumentvorlage auswählen, die bei der Erstellung einer PDF-Datei für den Bericht als Deckblatt verwendet wird.

    Verwendung der Abdeckung

    Geben Sie an, in welcher Situation das Deckblatt verwendet werden soll.

    Expand
    titleVerschieben eines Berichts in einen anderen Ordner

    Verschieben eines Berichts in einen anderen Ordner

    Das Verschieben eines Berichts in einen Ordner bedeutet eigentlich, dass der Bericht mit diesem Ordner verknüpft wird. Der Bericht ist auch weiterhin mit dem Ordner verknüpft, in dem er erstellt wurde. Sie können einen Bericht mit so vielen Ordnern verknüpfen, wie Sie möchten.

    Verknüpfen/Verschieben eines Berichts in einen Ordner

    1. Navigieren Sie zu dem Ordner, in den Sie den Bericht verschieben (oder besser gesagt verlinken) möchten

    2. Stellen Sie sicher, dass Sie auf den Ordner klicken, damit er hervorgehoben wird.

    3. Klicken Sie auf den kleinen Pfeil nach unten oben rechts auf Ihrem Bildschirm

    4. Klicken Sie auf 'Verschieben nach'.

    5. In der nun erscheinenden Suchmaske geben Sie die Referenz des Namens Ihres Berichts ein > Suchen

    6. Wählen Sie den Bericht aus der Liste aus

    7. OK

    8. Der Bericht wird nun in den Ordner

    Image Added


    Wenn Sie den Bericht, den Sie verschieben möchten, nicht finden können. Öffnen Sie zunächst den Bericht und setzen Sie das Feld "Abschnitt" auf leer. Dieser Abschnitt dient als Filter.

    Image Added

    Verknüpfung aufheben/einen Bericht aus einem Ordner löschen

    1. Öffnen Sie den Bericht

    2. Klicken Sie oben rechts auf das Zahnradsymbol > Verwandte

    3. Wählen Sie den/die Ordner (NB: objectFolder), aus denen Sie den Bericht löschen möchten

    4. Auswahl > Ausgewählte Objekte löschen

    Info: Das objectReport-Objekt verknüpft einen Bericht mit einem Ordner

    		Image Added

    Zusammenfassung

    Rw ui textbox macro

    • Um einen Bericht zu erstellen, müssen wir eine Filterseite und eine Listenseite erstellen und die Berichtseinstellungen definieren

    • Wir verwenden oft vorhandene Berichte und fügen diese hinzu, das Hinzufügen von Feldern funktioniert jedoch auf dieselbe Weise

    • Operatoren können für Felder geändert werden

    • Standardwerte können eingestellt werden

    • Filter können ausgeblendet werden

    Suche

    Live Search