Dokumentation AEM as a Cloud Service Användarhandbok

Mikrofrontsväljare för mediefiler Overview

Last update: Wed Oct 09 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

Administratör
Användare

Sök efter bästa praxis

Metadata - bästa praxis

Content Hub

Dynamic Media med OpenAPI-funktioner

AEM Assets-dokumentation för utvecklare

Micro-Frontend Asset Selector har ett användargränssnitt som enkelt kan integreras med Experience Manager Assets-databasen så att du kan bläddra bland eller söka efter digitala resurser som är tillgängliga i databasen och använda dem i programutvecklingen.

Användargränssnittet Micro-FrontEnd är tillgängligt i ditt program med hjälp av paketet Resursväljare. Alla uppdateringar av paketet importeras automatiskt och den senaste distribuerade resursväljaren läses in automatiskt i programmet.

Översikt

Resursväljaren har många fördelar, till exempel:

Enkel integrering med något av Adobe- eller icke-Adobe-programmen som använder Vanilla JavaScript-biblioteket.
Enkelt att underhålla när uppdateringar av Assets Selector-paketet automatiskt distribueras till resursväljaren som är tillgänglig för ditt program. Det finns inga uppdateringar som behövs i programmet för att läsa in de senaste ändringarna.
Enkel anpassning eftersom det finns tillgängliga egenskaper som styr visningen av resursväljaren i programmet.
Fulltextsökning, färdiga och anpassade filter för att snabbt navigera till material som ska användas i redigeringsmiljön.
Möjlighet att växla databaser inom en IMS-organisation för val av resurser.
Möjlighet att sortera resurser efter namn, dimensioner och storlek och visa dem i List-, Grid-, Gallery- eller Waterfall-vyn.

Förutsättningar prereqs

Du måste se till att följande kommunikationsmetoder används:

Programmet körs på HTTPS.
Programmets URL finns i IMS-klientens tillåtelselista i omdirigerings-URL:er.
Inloggningsflödet för IMS konfigureras och återges med hjälp av en popup-meny i webbläsaren. Därför bör popup-fönster vara aktiverade eller tillåtna i målwebbläsaren.

Använd ovanstående krav om du behöver arbetsflödet för IMS-autentisering för resursväljaren. Om du redan är autentiserad med IMS-arbetsflödet kan du lägga till IMS-informationen i stället.

Se mer

IMPORTANT

Denna databas är avsedd att fungera som kompletterande dokumentation som beskriver tillgängliga API:er och användningsexempel för integrering av resursväljare. Innan du försöker installera eller använda resursväljaren måste du se till att din organisation har fått tillgång till resursväljaren som en del av Experience Manager Assets as a Cloud Service profil. Om du inte har etablerats kan du inte integrera eller använda dessa komponenter. Om du vill begära etablering bör din programadministratör skaffa en supportbiljett som är markerad som P2 från Admin Console och innehålla följande information:

Domännamn där det integrerande programmet finns.
Efter etableringen kommer din organisation att få imsClientId, imsScope och en redirectUrl som motsvarar de miljöer som efterfrågas och som är nödvändiga för konfigurationen av resursväljaren. Utan dessa giltiga egenskaper kan du inte köra installationsstegen.

Installation installation

Resursväljaren är tillgänglig via både ESM CDN (till exempel version esm.sh/skypack) och version UMD.

I webbläsare som använder UMD-version (rekommenderas):

<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>

<script>
  const { renderAssetSelector } = PureJSSelectors;
</script>

I webbläsare med import maps-stöd och ESM CDN-version:

<script type="module">
  import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
</script>

I Deno/Webpack Module Federation med ESM CDN version:

import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'

Använda resursväljare using-asset-selector

När resursväljaren har konfigurerats och du är autentiserad att använda resursväljaren med din Adobe Experience Manager som ett Cloud Service-program, kan du välja resurser eller utföra olika åtgärder för att söka efter dina resurser i databasen.

using-asset-selector

A: Visa/Göm panel
B: Databasväljare
C: Assets
D: Filter
E: Sökfältet
F: Sortering
G: Sortera i stigande eller fallande ordning
H: Visa

Visa/dölj panelen hide-show-panel

Om du vill dölja mappar i den vänstra navigeringen klickar du på ikonen Hide folders. Om du vill ångra ändringarna klickar du på ikonen Hide folders igen.

Databasväxlare repository-switcher

Med Resursväljaren kan du också växla databaser för val av resurser. Du kan välja vilken databas du vill använda i listrutan som finns i den vänstra panelen. De databasalternativ som är tillgängliga i listrutan baseras på egenskapen repositoryId som är definierad i filen index.html. Den baseras på miljön från den valda IMS-organisationen som den inloggade användaren har åtkomst till. Konsumenterna kan skicka en föredragen repositoryID och i så fall slutar resursväljaren att återge repomkopplaren och återge resurser endast från den angivna databasen.

Assets-databas

Det är en samling resursmappar som du kan använda för att utföra åtgärder.

Färdiga filter filters

Resursväljaren innehåller även färdiga filteralternativ som kan förfina sökresultaten. Följande filter är tillgängliga:

Status: innehåller det aktuella tillståndet för resursen bland all, approved, rejected eller no status.
File type: innehåller folder, file, images, documents eller video.

Expiration status: omnämns resurserna baserat på dess förfallotid. Du kan antingen markera kryssrutan Expired om du vill filtrera resurser som har gått ut eller ställa in Expiration Duration för en resurs så att resurser visas baserat på deras förfallotid. När en resurs redan har gått ut eller snart går ut visas ett märke som avbildar detta. Dessutom kan du styra om du vill tillåta användning (eller dra och släpp) av en utgången resurs. Se mer om anpassa utgångna resurser. Som standard visas märket Förfaller snart för resurser som förfaller inom 30 dagar. Du kan dock konfigurera förfallotiden med egenskapen expirationDate.

note tip
TIP
Om du vill visa eller filtrera resurser baserat på deras framtida förfallodatum anger du det framtida datumintervallet i fältet `Expiration Duration`. Resurserna visas med märket upphör snart för dem.

MIME type: innehåller JPG, GIF, PPTX, PNG, MP4, DOCX, TIFF, PDF, XLSX.
Image Size: innehåller minsta/högsta bredd, lägsta/högsta höjd för bilden.

Anpassad sökning

Förutom textsökningen kan du med Resursväljaren söka efter resurser i filer med hjälp av anpassad sökning. Du kan använda anpassade sökfilter både i den modulala vyn och i vyn Rail.

anpassad sökning

Du kan också skapa ett standardsökfilter för att spara de fält som du ofta söker efter och använda dem senare. Om du vill skapa en anpassad sökning efter dina resurser kan du använda egenskapen filterSchema.

Sökfältet search-bar

Med Resursväljaren kan du utföra en fullständig textsökning av resurser i den valda databasen. Om du till exempel skriver nyckelordet wave i sökfältet visas alla resurser med nyckelordet wave som nämns i någon av metadataegenskaperna.

Sortering sorting

Du kan sortera resurser i Resursväljaren efter namn, dimensioner eller storlek för en resurs. Du kan också sortera resurserna i stigande eller fallande ordning.

Typer av vy types-of-view

Med Resursväljaren kan du visa resursen i fyra olika vyer:

I listvyn visas rullningsbara filer och mappar i en enda kolumn.
I stödrastervyn visas rullningsbara filer och mappar i ett rutnät med rader och kolumner.
Gallerivyn visar filer eller mappar i en centrerad vågrät lista.
I vattenfallsvyn visas filer eller mappar i form av en Bridge.