DocumentatieAEM 6.4Handleiding voor ontwikkeling

De websiteconsole aanpassen (klassieke gebruikersinterface) customizing-the-websites-console-classic-ui

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Developer
CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Een aangepaste kolom toevoegen aan de console Websites (sitebeheerder) adding-a-custom-column-to-the-websites-siteadmin-console

De console van het Beleid van Websites kan worden uitgebreid om douanekolommen te tonen. De console is gebaseerd op een JSON-object dat kan worden uitgebreid door een SDAB-service te maken die het ListInfoProvider interface. Zulk de dienst wijzigt het voorwerp JSON dat naar de cliënt wordt verzonden om de console te bouwen.

Dit geleidelijke leerprogramma verklaart hoe te om een nieuwe kolom in de console van het Beleid van Websites te tonen door uit te voeren ListInfoProvider interface. Het bestaat uit de volgende stappen:

  1. De dienst OSGI maken en de bundel die het bevat op de AEM server te implementeren.
  2. (optioneel) De nieuwe service testen door een JSON-aanroep uit te voeren om het JSON-object aan te vragen dat wordt gebruikt om de console te maken.
  3. De nieuwe kolom weergeven door de knooppuntstructuur van de console in de opslagplaats uit te breiden.
NOTE
Deze zelfstudie kan ook worden gebruikt om de volgende toedieningsconsoles uit te breiden:
  • de Digital Assets-console
  • de Community console

De OSGI-service maken creating-the-osgi-service

De ListInfoProvider interface definieert twee methoden:

  • updateListGlobalInfoom de algemene eigenschappen van de lijst bij te werken,
  • updateListItemInfo, om één lijstitem bij te werken.

De argumenten voor beide methoden zijn:

  • request, het bijbehorende Sling HTTP request object,
  • info, het JSON-object dat moet worden bijgewerkt. Dit is respectievelijk de algemene lijst of het huidige lijstitem.
  • resource, een Sling resource.

De volgende voorbeeldimplementatie:

  • Hiermee voegt u een uitgehongerd eigenschap voor elk item, dat true als de paginanaam begint met een e, en false anders.

  • Hiermee voegt u een starredCount eigenschap, die globaal is voor de lijst en het aantal starre lijstitems bevat.

Om de dienst te creëren OSGI:

  1. In CRXDE Lite, een bundel maken.
  2. Voeg de voorbeeldcode hieronder toe.
  3. Maak de bundel.

De nieuwe dienst is in gebruik.

package com.test;

import com.day.cq.commons.ListInfoProvider;
import com.day.cq.i18n.I18n;
import com.day.cq.wcm.api.Page;
import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Service;
import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.resource.Resource;
import org.apache.sling.commons.json.JSONException;
import org.apache.sling.commons.json.JSONObject;

@Component(metatype = false)
@Service(value = ListInfoProvider.class)
public class StarredListInfoProvider implements ListInfoProvider {

    private int count = 0;

    public void updateListGlobalInfo(SlingHttpServletRequest request, JSONObject info, Resource resource) throws JSONException {
        info.put("starredCount", count);
        count = 0; // reset for next execution
    }

    public void updateListItemInfo(SlingHttpServletRequest request, JSONObject info, Resource resource) throws JSONException {
        Page page = resource.adaptTo(Page.class);
        if (page != null) {
            // Consider starred if page name starts with 'e'
            boolean starred = page.getName().startsWith("e");
            if (starred) {
                count++;
            }
            I18n i18n = new I18n(request);
            info.put("starred", starred ? i18n.get("Yes") : i18n.get("No"));
        }
    }

}
CAUTION
  • Uw implementatie moet op basis van het ingediende verzoek en/of de bron beslissen of de informatie al dan niet aan het JSON-object moet worden toegevoegd.
  • Als uw ListInfoProvider de implementatie definieert een eigenschap die al bestaat in het reactieobject. De waarde ervan wordt overschreven door de eigenschap die u opgeeft.
    U kunt servicerangschikking om de uitvoeringsvolgorde van meerdere ListInfoProvider implementaties.

De nieuwe service testen testing-the-new-service

Wanneer u de console van het Beleid van Websites opent en door uw plaats doorbladert, geeft browser een ajax vraag uit om het voorwerp te krijgen JSON dat wordt gebruikt om de console te bouwen. Wanneer u bijvoorbeeld naar de /content/geometrixx De volgende aanvraag wordt naar de AEM server verzonden om de console te maken:

http://localhost:4502/content/geometrixx.pages.json?start=0&limit=30&predicate=siteadmin

Om ervoor te zorgen dat de nieuwe dienst na het hebben opgesteld de bundel die het bevat loopt:

  1. Verwijs uw browser naar de volgende URL:

    http://localhost:4502/content/geometrixx.pages.json?start=0&limit=30&predicate=siteadmin

  2. In de reactie moeten de nieuwe eigenschappen als volgt worden weergegeven:

screen_shot_2012-02-13at163046

De nieuwe kolom weergeven displaying-the-new-column

De laatste stap bestaat uit het aanpassen van de knooppuntstructuur van de console van het Beleid van Websites om het nieuwe bezit voor alle pagina's van de Geometrixx te tonen door te bedekken /libs/wcm/core/content/siteadmin. Ga als volgt te werk:

  1. Maak in CRXDE Lite de knooppuntstructuur /apps/wcm/core/content met knooppunten van het type sling:Folder om de structuur weer te geven /libs/wcm/core/content.

  2. Het knooppunt kopiëren /libs/wcm/core/content/siteadmin en plak deze hieronder /apps/wcm/core/content.

  3. Het knooppunt kopiëren /apps/wcm/core/content/siteadmin/grid/assets tot /apps/wcm/core/content/siteadmin/grid/geometrixx en wijzigt de eigenschappen ervan:

    • Verwijderen pageText

    • Set pathRegex tot /content/geometrixx(/.*)?

      Hierdoor wordt de rasterconfiguratie actief voor alle geometrische websites.

    • Set storeProxySuffix tot .pages.json

    • Bewerk de storeReaderFields multigevalueerde eigenschap en voeg de starred waarde.

    • Als u de MSM-functionaliteit wilt activeren, voegt u de volgende MSM-parameters toe aan de eigenschap multi-String storeReaderFields:

      • msm:isSource
      • msm:isInBlueprint
      • msm:isLiveCopy

  4. Voeg een starred node (type) nt:ongestructureerd) hieronder /apps/wcm/core/content/siteadmin/grid/geometrixx/columns met de volgende eigenschappen:

    • dataIndex: starred van het type String
    • header: Starred van het type String
    • xtype: gridcolumn van het type String

  5. (optioneel) Verplaats de kolommen waarop u niet wilt weergeven /apps/wcm/core/content/siteadmin/grid/geometrixx/columns

  6. /siteadmin is een pad met ijdelheid dat standaard wijst naar /libs/wcm/core/content/siteadmin.

    Dit doorsturen naar uw versie van sitebeheerder op /apps/wcm/core/content/siteadmin de eigenschap definiëren sling:vanityOrder een waarde hebben die hoger is dan de waarde die op /libs/wcm/core/content/siteadmin. De standaardwaarde is 300, dus om het even wat hoger is is geschikt.

  7. Ga naar de console van het Beleid van Websites en navigeer aan de plaats van de Geometrixx:

    http://localhost:4502/siteadmin#/content/geometrixx.

  8. De nieuwe kolom Gestart is beschikbaar, waarbij aangepaste informatie als volgt wordt weergegeven:

screen_shot_2012-02-14at104602

CAUTION
Als meerdere rasterconfiguraties overeenkomen met het gevraagde pad dat is gedefinieerd door de pathRegex eigenschap, de eerste wordt gebruikt, en niet de meest specifieke, wat betekent dat de volgorde van de configuraties belangrijk is.

Voorbeeldpakket sample-package

Het resultaat van deze zelfstudie is beschikbaar in het gedeelte De beheerconsole voor websites aanpassen pakket op Pakket delen.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e