Versions Compared

Key

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

DifficultyMoeilijkheidsgraad: novicebeginner

Content

Inhoud

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

Leerdoelen

Na het lezen van dit artikel zul je in staat zijn om:

  • Beheerpagina bevat.


Heb je het artikel al gelezen Difference between a report and an include (OLD)?

What are page includes?

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

    Wat zijn pagina's inclusief?

    Pagina-inclusies zijn afzonderlijke pagina's die aan een andere pagina zijn gekoppeld. Een page include kan bijvoorbeeld een rapport, een drag-and-drop veld of een lijst met subobjecten zijn (bijvoorbeeld de reserveringsitems op de reserveringspagina). Pagina-inclusies hebben hun eigen paginadefinitie knop die direct toegankelijk zijn op het scherm.

    Image Added

    Pagina's maken en beheren

    Een pagina toevoegen

    Om een pagina-inclusie toe te voegen aan een instantiepagina:

    1. Open de pagina waaraan u de pagina wilt toevoegen.

    2. Open de paginadefinitie.
      Opmerking: Je kunt ook op de knop 'Pagina's' op je startpaneel klikken en zoeken naar de pagina waaraan je de pagina wilt toevoegen.

    3. Klik op Pagina toevoegen rechtsboven op de pagina.

      Image Added
    4. Vul de include-instellingen in. Er zijn geen verplichte instellingen, maar je moet er op zijn minst voor zorgen dat je een opnemen of verslag. Als je dit vergeet, eindig je met een lege include.

      • Inclusief: gebruikt om een vooraf gedefinieerde inclusief weer te geven

      • Rapport: koppel een rapport. Opmerking: de filterpagina wordt overgeslagen, dus zorg ervoor dat het rapport is geconfigureerd met standaardinstellingen en initialisatiewaarden.

        • Filter: Optioneel kun je hier een filter selecteren die beschikbaar is voor het geselecteerde rapport.

        • Grafiek: Optioneel kun je hier een grafiek selecteren die beschikbaar is voor het geselecteerde rapport.

    5. Door een Kop kun je de titel wijzigen van de bijlage die zichtbaar is voor de gebruiker.

    6. Nadat een pagina-inclusie aan de pagina is toegevoegd, is deze zichtbaar in de include 'Pagina-inclusies' van de paginadefinitie. In de kolommen van deze include kun je snel zien of de include een include, een rapport, een filter of een grafiek is.

    Image Added

    Tip

    Nu wordt de inclusief getoond (onder de hoofdpagina of als tabbladen) ingesteld op de pagina-instellingen van de instantiepagina met de instelling "Pagina bevat lay-out".

    Een pagina bewerken en verwijderen

    1. Open de pagina die u wilt bewerken.

    2. Open de paginadefinitie. BelangrijkOm toegang te krijgen tot de instellingen van de pagina-inclusie, moet je de paginadefinitie van de pagina openen, niet de paginadefinitie van de pagina-inclusie.

    3. Scroll naar beneden naar de 'page includes'.

    4. Klik op de hyperlink in de kolom 'Row' van de include.

    5. Bewerk de instellingen of verwijder de pagina-inclusie (druk op de 'x' rechtsboven). Je kunt ook de instelling 'Weergeven = nee' wijzigen om de pagina te verbergen.

    Image Added

    Info

    In de bovenstaande stappen beschrijven we dat je de paginadefinitie van de pagina moet openen, niet de paginadefinitie van de pagina-inclusie. Je opent de paginadefinitie van de pagina-inclusie alleen direct als je de instellingen wilt openen die op die pagina beschikbaar zijn, zoals kolommen toevoegen/verbergen of de weergave-instelling van de pagina wijzigen.

    Instellingen op een pagina zijn onder andere

    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
    Expand
    titleSettings on a page include

    SettingsInstellingen

    ExplanationUitleg

    FrequencyFrequentie

    Page

    The page will be automatically linked when creating a Pagina

    De pagina wordt automatisch gelinkt bij het maken van een page include.

    MandatoryVerplicht

    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 numberRij

    Bepaalt de verticale volgorde van een pagina-inclusie ten opzichte van een andere pagina-inclusie. Een pagina-inclusie met een lager rijnummer wordt weergegeven vóór een pagina-inclusie met een hoger nummer.

    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 Kolom

    Bepaalt de horizontale volgorde van de pagina-inclusie. Als twee pagina-inclusies op dezelfde rij worden geplaatst. De page include met de laagste kolomnummering wordt als eerste geplaatst. Opmerking: deze instelling is alleen van toepassing op pagina-inclusies op een 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 Breedte

    Deze instelling wordt niet langer gebruikt.

    Zelden

    Hoogte

    Deze instelling wordt niet langer gebruikt.

    Zelden

    Volgorde weergeven

    Bepaalt de volgorde van de include. Twee items op dezelfde rij en kolom, maar met verschillende weergavevolgorde, worden gesorteerd op basis van de laagste weergavevolgorde. Opmerking: deze instelling is alleen van toepassing op 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 Bepaalt het aantal kolommen waarover de include zich uitstrekt. Het hele scherm is een raster van 12 kolommen. Opmerking: deze instelling is alleen van toepassing op dashboards.

    Frequent

    Clear Duidelijke 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

  • Deze instelling is standaard ingesteld op "nee". Als de context wordt gewist, koppelt Workplace de inhoud van de include niet automatisch aan het Context-object.

    Zelden

    Contextobject

    Het object waaraan de include is gekoppeld. Als het verkeerde object wordt opgegeven, werkt de include niet.

    Frequent

    Veld

    Hiermee kun je het hoofdobject voor een pagina-inclusie instellen op basis van een gerelateerd veld. Je kunt bijvoorbeeld een include 'ConditionProblemTypeHierarchy' toevoegen aan een pagina 'WorkOrderSettings' en het veld instellen op 'conditionProblemTypeSchemeId'. De include toont alle probleemtypen die gerelateerd zijn aan dit probleemtypeschema.

    Zelden

    Opnemen

    De pagina inclusief moet hier gelinkt worden, tenzij het een veld-, rapport-, grafiek- of filterpagina is.

    Frequent

    Rapporteer

    Als de pagina een rapport is, moet deze hier gelinkt worden.

    Frequent

    Filter

    Als de include een filterpagina is, moet de filterpagina hier gelinkt worden.

    Frequent

    Kaart

    Als de bijlage een grafiek is, moet de grafiek hier gelinkt worden.

    Frequent

    Grafiekparameter

    Het is mogelijk om de grafiek toe te voegen als parameter op de pagina. In dit geval worden twee parameters toegevoegd:

    • De header van de grafiek/include - dit is de parameter die begint met een hoofdletter.

    • De URL van de grafiek - dit is de parameter die begint met een kleine letter.

    Zelden

    Parameter voorvoegsel

    Het opgeven van een parameterprefix voor de include maakt het makkelijker om de parameters die uit de include komen te identificeren.

    Zelden

    Kop

    Je kunt de koptekst opgeven die boven aan de include wordt weergegeven.

    Frequent

    Containerstijl

    Het is mogelijk om verschillende randen aan te geven rond includes.

    Frequent

    Weergave

    De weergave-instelling bepaalt of de bijlage wel of niet mag worden weergegeven. Vergelijkbaar met de zichtbaarheidsinstelling voor velden en functies.

    Frequent

    Mobiel

    Bepaalt of de include zichtbaar is in de mobiele applicatie Workplace.

    Zelden

    PDF

    Bij het genereren van een standaard PDF (niet vanuit een sjabloon) is het mogelijk om de pagina inclusief of exclusief te maken.

    Zelden

    Verbergen wanneer leeg

    Als de include leeg is, is het mogelijk om deze te verbergen.

    Frequent

    Pagina per rij weergeven

    Deze instelling is alleen van toepassing op lijstpagina's met includes. Elke rij van zo'n lijstpagina heeft een rij-object. Als de instelling op "Ja" staat, wordt de pagina-inclusive per contextobject geëvalueerd. Als de instelling op "no" staat, wordt alleen het hoofdcontextobject van de pagina geëvalueerd. Vanaf nu ondersteunen alleen MapView-pagina's deze instelling.

    Een CarReservationMapview zou bijvoorbeeld een include kunnen hebben met gereserveerde Assets (bijv. auto's) met de laatst geregistreerde locatie van die gereserveerde auto.

    Zelden

    Selectie

    Bepaal in welke mate het is toegestaan om items in een lijst te selecteren. Het is bijvoorbeeld mogelijk om geen items, slechts één item of alle items in een lijst te selecteren. Geselecteerde items kunnen bijvoorbeeld worden geëxporteerd of verwijderd.

    Frequent

    Nieuwe pagina in PDF

    Bij het genereren van een standaard PDF (niet vanuit een sjabloon) is het mogelijk om de pagina-inhoud op een nieuwe pagina in de PDF te tonen.

    Zelden

    Klant

    Toont de naam van de omgeving. Deze kan niet worden bewerkt in een clientlaag.

    Zelden

    Asynchroon laden

    Als asynchroon laden is ingeschakeld, wordt de hoofdpagina onafhankelijk van de include geladen. Als asynchroon laden is uitgeschakeld, moet de gebruiker wachten tot de inhoud in de include is geladen voordat hij de inhoud van de hoofdpagina kan zien.

    Frequent

    Toon de pagina inclusief ingeklapt

    Door de include in te klappen, is de inhoud van de include alleen zichtbaar wanneer de gebruiker op de include klikt voor uitbreiding.

    Frequent

    Paginering

    Als een lijst niet op één scherm past, wordt hij opgesplitst over meerdere pagina's. Als je alle items op één scherm wilt weergeven, kun je de paginering uitschakelen.

    Zelden

    Toegang tot inclusief instellen voor alle gebruikers (de gemakkelijke manier)

    1. Open de pagina waarop je de zichtbaarheid wilt wijzigen.

    2. Open de paginadefinitie.

      1. Opmerking: Je kunt ook op de knop 'Pagina's' op je startpaneel klikken en zoeken naar de pagina waarop je de functie wilt overschrijven.

    3. Scroll naar beneden naar de 'page includes'.

    4. Klik op de hyperlink in de kolom 'Row' van de include.

    5. Druk op de knop 'override

      1. Je kunt deze stap overslaan als de include geen basislijn is en de instellingen dus al bewerkbaar zijn.

    6. Wijzig de instelling "Display =no/ yes".

    Toegangsrechten instellen op omvat per gebruikersgroep (de meer complexe manier)

    1. Open de pagina waarop je de zichtbaarheid wilt wijzigen.

    2. Open de paginadefinitie.

      1. Opmerking: Je kunt ook op de knop 'Pagina's' op je startpaneel klikken en zoeken naar de pagina waarop je de functie wilt overschrijven.

    3. Scroll naar beneden naar de 'pagina is inclusief

    4. Klik op de hyperlink in de kolom 'Row' van de include.

    5. Pas de toegang aan op basis van toegangsgroepen:

      1. druk op het tandwielsymbool rechtsboven

      2. toegang instellen voor de groepen

      3. Bevestig de wijzigingen

    Info

    Onthoud: een gebruiker heeft maar één gebruikersgroep nodig die toegang heeft tot een include. Dus als je deze manier wilt gebruiken om een include voor een gebruiker te verbergen, moet je ervoor zorgen dat deze specifieke toegang wordt toegepast op alle gebruikersgroepen die de gebruiker heeft.

    We raden een zeer beperkt gebruik aan van autoriseren met deze methode.

    Samenvatting

    Rw ui textbox macro
    • Inclusief wordt gebruikt om de inhoud van een pagina, rapport, grafiek of filter weer te geven op een pagina.


    Zoek op

    Live Search