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 will be able to:

  • Manage page includes.

Have you already read the article

Lernziele

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

  • Die Seite Verwalten enthält.

Haben Sie schon den Artikel gelesen Difference between a report and an include (OLD)?

What are page includes

Was sind Seiteninhalte?

Page includes are separate pages that are attached to another page. A page include can for example be a report, a drag - and drop field, or a list of sub-objects (e.g. the reservation items on the reservation page). Page includes have their own page definition button that are accessible directly on the include.

Image Removed

Create and manage page includes

Add a page include

To add a page include to an instance page:

  1. Open the page to which you want to add the page include.

  2. Open the page definition.
    Note: Alternatively, click the ‘Pages’ button on your startBoard and search for the page you want to add the page include to.

  3. Click on Add page include on the top right of the page.

    Image Removed

  4. Fill out the include settings. There are no mandatory settings, but you should at least make sure to link an include or report. If you forget this you will end up with an empty include.

    • Include: used to display a pre-defined include

    • Report: link a report. Note: the filter page is skipped, so make sure the report is configured with default settings and initialization values.

      • Filter: Optionally you can select a filter here that is available for the selected report.

      • Chart: Optionally you can select a chart/ graph here that is available for the selected report.

  5. By filling in a Header you can change the title of the include that is visible to the user.

  6. After a page include has been added to the page, it will be visible in the ‘Page includes’ include of the page definition page. In the columns of this include, you can quickly see if the include is an include, a report, a filter, or a chart.

Image Removed

Tip

Now the include is shown (under the main page or as tabs) is set on the page settings of the instance page using the setting “Page includes layout”.

Edit and delete a page include

  • Open the page to which you want to edit.

  • Open the page definition. Important: to access the settings of the page include, you must open the page definition of the page, not of the page definition of the page include.

  • Scroll down to the ‘page includes’ include.

    • Click on the hyperlink in the ‘Row’ column of the include.

  • Edit the settings, or delete the page include (press the ‘x' on the top right). You can also change the setting 'Display = no’ to hide the include,.

    • Image Removed

    Info

    In the steps above we describe that you should open the page definition of the page, not of the page definition of the page include. You only directly open the page definition of the page include when you want to access the setting that are available on that page, like adding/ hiding columns or changing the page display setting.

    Settings on a page include

    Expand
    titleSettings on a page include

    Settings

    Explanation

    Frequency

    Page

    The page will be automatically linked when creating a page include.

    Mandatory

    Row

    Determines the vertical ordering of a page include relatively to another page include. A page include with a lower row number will be displayed before a page include with a higher number.

    Frequent

    Column

    Determines the horizontal order of the page include. If two page includes are positioned on the same row. The page include with the lowest column numbering will be positioned first. Note: This setting only applies to page includes on a dashboard.

    Frequent

    Width

    This setting is no longer in use.

    Seldom

    Height

    This setting is no longer in use.

    Seldom

    Display order

    Determines the order of the include. Two includes on the same row and column, but with different display ordering, will be sorted based on the lowest display ordering. Note: this setting only applies for dashboards.

    Frequent

    Colspan

    Determines the number of columns the include spans across. The entire screen is a grid of 12 columns. Note: this setting only applies to dashboards.

    Frequent

    Clear context

    By default, this setting is set to “no”. If the context is cleared, Workplace does not automatically link the content of the include to the Context object.

    Seldom

    Context object

    The object the include is linked to. If the incorrect object is specified, the include will not work.

    Frequent

    Field

    This allows you to set the main object for a page include based on a related field. For example, you can add an include 'ConditionProblemTypeHierarchy' to a page 'WorkOrderSettings' and set the field to 'conditionProblemTypeSchemeId'. The include will show all problem types related to this problem type scheme.

    Seldom

    Include

    The page include must be linked here unless it is a field, report, chart or a filter page.

    Frequent

    Report

    If the page include is a report, it must be linked here.

    Frequent

    Filter

    If the include is a filter page, the filter page must be linked here.

    Frequent

    Chart

    If the include is a chart, the chart must be linked here.

    Frequent

    Chart parameter

    It is possible to add the chart as a parameter on the page. Two parameters are added in this case:

    • The header of the chart/include - this is the parameter that starts with a capital.

    • The URL of the chart - this is the parameter that starts with a lower case character.

    Seldom

    Parameter prefix

    Specifying a parameter prefix for the include makes it easier to identify the parameters coming from the include.

    Seldom

    Header

    You can specify the header that will be displayed at the top of the include.

    Frequent

    Container style

    It is possible to specify different boarders around includes.

    Frequent

    Display

    The display setting determines whether or not the include is allowed to be shown. Similar to the visibility setting for fields and functions.

    Frequent

    Mobile

    Determines if the include will be visible in the Workplace mobile application.

    Seldom

    PDF

    When generating a default PDF (not from a template) it is possible to include or exclude the page include.

    Seldom

    Hide when empty

    If the include is empty, it is possible to hide it.

    Frequent

    Show include page per row

    This setting only applies to list pages with includes. Each row of such a list page has a row object. When the setting is set to “Yes”, the page include is evaluated per context object. If the setting is on “no”, only the main context object of the page is evaluated. As of now, only MapView pages support this setting.

    E.g. a CarReservationMapview could have an include with reserved Assets (e.g. cars) showing the last recorded location of that reserved car.

    Seldom

    Selection

    Determine to which degree it is allowed to select items on an include list. It is for instance possible to allow for the selection of no items, only one item, or all items in a list. Selected items can for instance be exported or deleted.

    Frequent

    New page in PDF

    When generating a default PDF (not from a template) it is possible to showcase the page include on a new page in the PDF.

    Seldom

    Client

    Shows the name of the environment. This is not editable in a client layer.

    Seldom

    Load asynchronously

    When asynchronous loading is turned on, the main page will load independent from the include. When asynchronous loading is turned off, the user has to wait for the content inside the include to load before being able to see the content of the main page.

    Frequent

    Show the page include collapsed

    By collapsing the include, the content of the include is only visible when the user is clicking on the include for expansion.

    Frequent

    Pagination

    If a list does not fit a single screen it is split over multiple pages. If you want to show all items on a single screen you can turn pagination off.

    Seldom

    Set access to includes for all users (the easy way)

  • Open the page on which you want to change the visibility.

  • Open the page definition.

    1. Note: Alternatively, click the ‘Pages’ button on your startBoard and search for the page you want to override the function to.

  • Scroll down to the ‘page includes’ include.

    • Click on the hyperlink in the ‘Row’ column of the include.

  • Press the ‘override’ button

    1. You can skip this step when the include is not baseline and therefor the setting are already editable.

  • Change the setting “Display =no/ yes”.

    • Set access rights to includes per user group (the more complex way)

  • Open the page on which you want to change the visibility.

  • Open the page definition.

    1. Note: Alternatively, click the ‘Pages’ button on your startBoard and search for the page you want to override the function to.

  • Scroll down to the ‘page includes’ include

    • Click on the hyperlink in the ‘Row’ column of the include.

  • Adjust the access based on access groups:

    1. press the gear symbol on the top right

    2. set access for the groups

    3. Confirm the changes

    • Info

    Remember: a user only needs one user group that has access to an include. So if you want to use this way to hide an include for user, you need to make sure that this specific access is applied to all user groups that the user has.

    We recommend very limited use of authorizing includes using this method.

    Summary

    Rw ui textbox macro

    • Includes are used to display the content of a page, report, chart or filter on a page.

    Search

    Seitenincludes sind separate Seiten, die mit einer anderen Seite verbunden sind. Ein Seiteninclude kann zum Beispiel ein Bericht, ein Drag-and-Drop-Feld oder eine Liste von Unterobjekten sein (z. B. die Reservierungselemente auf der Reservierungsseite). Seiten-Includes haben ihre eigene Seitendefinition die direkt über das Include zugänglich sind.

    Image Added

    Erstellen und Verwalten von Seiteninhalten

    Eine Seite hinzufügen

    So fügen Sie ein Seiten-Include zu einer Instanzseite hinzu:

    1. Öffnen Sie die Seite, zu der Sie das Seiteninclude hinzufügen möchten.

    2. Öffnen Sie die Seitendefinition.
      Hinweis: Alternativ können Sie auch auf die Schaltfläche "Seiten" in Ihrem StartBoard klicken und nach der Seite suchen, der Sie die Seiteneinbindung hinzufügen möchten.

    3. Klicken Sie auf Seite hinzufügen oben rechts auf der Seite.

      Image Added

    4. Füllen Sie die Include-Einstellungen aus. Es gibt keine obligatorischen Einstellungen, aber Sie sollten zumindest sicherstellen, dass Sie eine einschließen. oder Bericht. Wenn Sie dies vergessen, werden Sie mit einem leeren Include enden.

      • Include: dient zur Anzeige eines vordefinierten Includes

      • Bericht: Verknüpfen Sie einen Bericht. Hinweis: Die Filterseite wird übersprungen. Stellen Sie daher sicher, dass der Bericht mit Standardeinstellungen und Initialisierungswerten konfiguriert ist.

        • Filter: Optional können Sie hier einen Filter auswählen, der für den ausgewählten Bericht verfügbar ist.

        • Diagramm: Optional können Sie hier ein Diagramm auswählen, das für den ausgewählten Bericht verfügbar ist.

    5. Durch das Ausfüllen eines Kopfzeile können Sie den Titel des Includes ändern, der für den Benutzer sichtbar ist.

    6. Nachdem der Seite ein Seiteninclude hinzugefügt wurde, wird es im Include "Seitenincludes" der Seitendefinitionsseite angezeigt. In den Spalten dieses Includes können Sie schnell erkennen, ob das Include ein Include, ein Bericht, ein Filter oder ein Diagramm ist.

    Image Added

    Tip

    Nun wird das Include (unter der Hauptseite oder als Tabs) in den Seiteneinstellungen der Instanzseite mit der Einstellung "Page includes layout" angezeigt.

    Bearbeiten und Löschen einer Seite umfassen

    1. Öffnen Sie die Seite, die Sie bearbeiten möchten.

    2. Öffnen Sie die Seitendefinition. Wichtig: Um auf die Einstellungen des Seitenincludes zuzugreifen, müssen Sie die Seitendefinition der Seite öffnen, nicht die Seitendefinition des Seitenincludes.

    3. Blättern Sie nach unten zum Eintrag "Seite enthält".

    4. Klicken Sie auf das Hyperlink in der Spalte 'Zeile' des Includes.

    5. Bearbeiten Sie die Einstellungen, oder löschen Sie das Seiteninclude (drücken Sie auf das "x" oben rechts). Sie können auch die Einstellung "Anzeigen = nein" ändern, um das Include auszublenden.

    Image Added

    Info

    In den obigen Schritten wird beschrieben, dass Sie die Seitendefinition der Seite öffnen sollten, nicht die Seitendefinition des Seitenincludes. Sie öffnen die Seitendefinition des Seitenincludes nur dann direkt, wenn Sie auf die Einstellungen zugreifen möchten, die auf dieser Seite verfügbar sind, z. B. das Hinzufügen/Ausblenden von Spalten oder das Ändern der Seitenanzeigeeinstellungen.

    Die Einstellungen auf einer Seite umfassen

    Expand
    titleDie Einstellungen auf einer Seite umfassen

    Einstellungen

    Erläuterung

    Frequenz

    Seite

    Die Seite wird bei der Erstellung eines Seiteninhalts automatisch verlinkt.

    Obligatorisch

    Reihe

    Bestimmt die vertikale Anordnung eines Seitenincludes relativ zu einem anderen Seiteninclude. Ein Seiteninclude mit einer niedrigeren Zeilennummer wird vor einem Seiteninclude mit einer höheren Nummer angezeigt.

    Häufig

    Säule

    Bestimmt die horizontale Reihenfolge des Seitenincludes. Wenn zwei Seitenincludes in der gleichen Zeile stehen. Das Seiteninclude mit der niedrigsten Spaltennummerierung wird zuerst positioniert. Hinweis: Diese Einstellung gilt nur für Seitenincludes in einem Dashboard.

    Häufig

    Breite

    Diese Einstellung wird nicht mehr verwendet.

    Selten

    Höhe

    Diese Einstellung wird nicht mehr verwendet.

    Selten

    Bestellung anzeigen

    Bestimmt die Reihenfolge des Includes. Zwei Includes in derselben Zeile und Spalte, aber mit unterschiedlicher Anzeigereihenfolge, werden auf der Grundlage der niedrigsten Anzeigereihenfolge sortiert. Hinweis: Diese Einstellung gilt nur für Dashboards.

    Häufig

    Colspan

    Bestimmt die Anzahl der Spalten, über die sich das Include erstreckt. Der gesamte Bildschirm ist ein Raster mit 12 Spalten. Hinweis: Diese Einstellung gilt nur für Dashboards.

    Häufig

    Klarer Kontext

    Standardmäßig ist diese Einstellung auf "nein" gesetzt. Wenn der Kontext gelöscht wird, verknüpft Workplace den Inhalt des Includes nicht automatisch mit dem Context-Objekt.

    Selten

    Kontext-Objekt

    Das Objekt, mit dem das Include verknüpft ist. Wenn das falsche Objekt angegeben wird, funktioniert das Include nicht.

    Häufig

    Feld

    Damit können Sie das Hauptobjekt für ein Seiten-Include auf der Grundlage eines Bezugsfeldes festlegen. Sie können zum Beispiel ein Include "ConditionProblemTypeHierarchy" zu einer Seite "WorkOrderSettings" hinzufügen und das Feld auf "conditionProblemTypeSchemeId" setzen. Das Include zeigt alle Problemtypen an, die mit diesem Problemtypschema zusammenhängen.

    Selten

    einbeziehen.

    Die Seite include muss hier verlinkt werden, es sei denn, es handelt sich um ein Feld, einen Bericht, ein Diagramm oder eine Filterseite.

    Häufig

    Bericht

    Handelt es sich bei der eingebundenen Seite um einen Bericht, muss dieser hier verlinkt werden.

    Häufig

    Filter

    Wenn es sich bei dem Include um eine Filterseite handelt, muss die Filterseite hier verlinkt werden.

    Häufig

    Tabelle

    Handelt es sich bei dem Include um ein Diagramm, muss dieses hier verlinkt werden.

    Häufig

    Diagramm-Parameter

    Es ist möglich, das Diagramm als Parameter auf der Seite hinzuzufügen. In diesem Fall werden zwei Parameter hinzugefügt:

    • Die Kopfzeile des Diagramms/der Datei - dies ist der Parameter, der mit einem Großbuchstaben beginnt.

    • Die URL des Diagramms - dies ist der Parameter, der mit einem Kleinbuchstaben beginnt.

    Selten

    Parameter-Präfix

    Die Angabe eines Parameterpräfixes für das Include erleichtert die Identifizierung der vom Include kommenden Parameter.

    Selten

    Kopfzeile

    Sie können die Überschrift angeben, die am Anfang des Includes angezeigt wird.

    Häufig

    Container-Stil

    Es ist möglich, verschiedene Grenzen für Includes festzulegen.

    Häufig

    Anzeige

    Die Anzeigeeinstellung bestimmt, ob das Include angezeigt werden darf oder nicht. Ähnlich wie bei der Sichtbarkeitseinstellung für Felder und Funktionen.

    Häufig

    Mobil

    Legt fest, ob das Include in der mobilen Workplace-Anwendung sichtbar sein soll.

    Selten

    PDF

    Bei der Erstellung einer Standard-PDF-Datei (nicht aus einer Vorlage) kann die Seiteneinbindung ein- oder ausgeschaltet werden.

    Selten

    Ausblenden, wenn leer

    Wenn das Include leer ist, kann es ausgeblendet werden.

    Häufig

    Einschließende Seite pro Zeile anzeigen

    Diese Einstellung gilt nur für Listenseiten mit Includes. Jede Zeile einer solchen Listenseite hat ein Zeilenobjekt. Wenn die Einstellung auf "Ja" steht, wird das Seiten-Include pro Kontextobjekt ausgewertet. Steht die Einstellung auf "Nein", wird nur das Hauptkontextobjekt der Seite ausgewertet. Zur Zeit unterstützen nur MapView-Seiten diese Einstellung.

    Eine CarReservationMapview könnte z. B. ein Include mit reservierten Assets (z. B. Autos) haben, das den zuletzt aufgezeichneten Standort des reservierten Autos anzeigt.

    Selten

    Auswahl

    Legen Sie fest, inwieweit die Auswahl von Elementen auf einer Include-Liste erlaubt ist. Es ist z.B. möglich, keine Elemente, nur ein Element oder alle Elemente in einer Liste auszuwählen. Ausgewählte Elemente können z. B. exportiert oder gelöscht werden.

    Häufig

    Neue Seite in PDF

    Bei der Erstellung eines Standard-PDFs (nicht aus einer Vorlage) ist es möglich, die Seiteneinbindung auf einer neuen Seite im PDF darzustellen.

    Selten

    Kunde

    Zeigt den Namen der Umgebung an. Dieser ist in einer Client-Ebene nicht editierbar.

    Selten

    Asynchrones Laden

    Wenn das asynchrone Laden eingeschaltet ist, wird die Hauptseite unabhängig vom Include geladen. Wenn das asynchrone Laden ausgeschaltet ist, muss der Benutzer warten, bis der Inhalt des Includes geladen ist, bevor er den Inhalt der Hauptseite sehen kann.

    Häufig

    Die Seite include eingeklappt anzeigen

    Durch das Ausklappen des Includes ist der Inhalt des Includes nur sichtbar, wenn der Benutzer zur Erweiterung auf das Include klickt.

    Häufig

    Paginierung

    Wenn eine Liste nicht auf einen einzigen Bildschirm passt, wird sie auf mehrere Seiten aufgeteilt. Wenn Sie alle Elemente auf einem einzigen Bildschirm anzeigen möchten, können Sie die Paginierung deaktivieren.

    Selten

    Zugriff auf Includes für alle Benutzer festlegen (der einfache Weg)

    1. Öffnen Sie die Seite, auf der Sie die Sichtbarkeit ändern möchten.

    2. Öffnen Sie die Seitendefinition.

      1. Hinweis: Alternativ können Sie auch auf die Schaltfläche "Seiten" auf Ihrem StartBoard klicken und nach der Seite suchen, für die Sie die Funktion außer Kraft setzen möchten.

    3. Blättern Sie nach unten zum Eintrag "Seite enthält".

    4. Klicken Sie auf das Hyperlink in der Spalte 'Zeile' des Includes.

    5. Drücken Sie die Taste "Override".

      1. Sie können diesen Schritt überspringen, wenn das Include keine Basislinie ist und die Einstellungen daher bereits bearbeitet werden können.

    6. Ändern Sie die Einstellung "Anzeige =nein/ ja".

    Zugriffsrechte auf Includes pro Benutzergruppe festlegen (der komplexere Weg)

    1. Öffnen Sie die Seite, auf der Sie die Sichtbarkeit ändern möchten.

    2. Öffnen Sie die Seitendefinition.

      1. Hinweis: Alternativ können Sie auch auf die Schaltfläche "Seiten" auf Ihrem StartBoard klicken und nach der Seite suchen, für die Sie die Funktion außer Kraft setzen möchten.

    3. Blättern Sie nach unten zum Eintrag "Seite enthält".

    4. Klicken Sie auf das Hyperlink in der Spalte 'Zeile' des Includes.

    5. Passen Sie den Zugriff auf der Grundlage von Zugriffsgruppen an:

      1. drücken Sie das Zahnradsymbol oben rechts

      2. Zugang für die Gruppen festlegen

      3. Bestätigen Sie die Änderungen

    Info

    Denken Sie daran: Ein Benutzer braucht nur eine Benutzergruppe, die Zugriff auf ein Include hat. Wenn Sie also auf diese Weise ein Include für einen Benutzer ausblenden wollen, müssen Sie sicherstellen, dass dieser spezielle Zugriff für alle Benutzergruppen gilt, die der Benutzer hat.

    Wir empfehlen, diese Methode nur in sehr begrenztem Umfang für die Genehmigung von Includes zu verwenden.

    Zusammenfassung

    Rw ui textbox macro

    • Includes werden verwendet, um den Inhalt einer Seite, eines Berichts, eines Diagramms oder eines Filters auf einer Seite anzuzeigen.

    Suche

    Live Search