微前端资源选择器 Overview

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

管理员
用户

搜索最佳实践

元数据最佳实践

Content Hub

具有OpenAPI功能的Dynamic Media

AEM Assets开发人员文档

微前端资源选择器提供了一个用户界面，它可以轻松地与 Experience Manager Assets 存储库集成，以便您能够浏览或搜索存储库中可用的数字资源，并在您的应用程序创作体验中使用它们。

微前端用户界面可用于采用了资源选择器包的应用程序体验。对该包的任何更新都会自动导入，并且最新部署的资源选择器会自动加载到您的应用程序中。

资源选择器提供了许多好处，例如：

使用Vanilla JavaScript库轻松与任何Adobe或非Adobe应用程序集成。
易于维护，因为对资源选择器包的更新将自动部署到可用于应用程序的资源选择器。您的应用程序中无需更新即可加载最新的修改。
易于定制，因为提供了用于控制应用程序中的资源选择器显示的属性。
全文搜索、开箱即用和自定义过滤器，可快速导航到资源以便在创作体验中使用。
能够在 IMS 组织内切换存储库以选择资源。
能够按名称、维度和大小对资源进行排序，并在列表、网格、库或瀑布图视图中查看这些资源。

先决条件 prereqs

必须确保以下通信方法：

应用程序正在HTTPS上运行。
应用程序的URL位于IMS客户端的重定向URL允许列表中。
IMS登录流通过Web浏览器上的弹出窗口进行配置和渲染。因此，应在目标浏览器上启用或允许弹出窗口。

如果您需要资产选择器的IMS身份验证工作流，请使用上述先决条件。或者，如果您已通过IMS工作流身份验证，则可以改为添加IMS信息。

查看更多

IMPORTANT

此存储库旨在作为补充文档，描述用于集成Asset Selector的可用API和使用示例。在尝试安装或使用资产选择器之前，请确保贵组织已获得资产选择器的访问权限，且已作为Experience Manager Assetsas a Cloud Service配置文件的一部分进行配置。如果您尚未配置，则无法集成或使用这些组件。要请求配置，您的项目管理员应从Admin Console中提出标记为P2的支持票证并包含以下信息：

托管集成应用程序的域名。
配置之后，将为您的组织提供imsClientId、imsScope以及对应于所请求环境的redirectUrl，这些环境对于配置资产选择器至关重要。如果没有这些有效属性，您将无法运行安装步骤。

安装 installation

资产选择器可通过ESM CDN（例如，esm.sh/skypack）和UMD版本使用。

在使用 UMD 版本 的浏览器中（推荐）：

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

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

在使用 ESM CDN 版本 并支持 import maps 的浏览器中：

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

在使用 ESM CDN 版本 的 Deno/Webpack 模块联合中：

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

使用资源选择器 using-asset-selector

在设置完资源选择器后，您可以通过身份验证将资源选择器与您的 Adobe Experience Manager as a Cloud Service 应用程序结合使用，可以选择资源或执行各种其他操作以在存储库中搜索您的资源。

using-asset-selector

A：隐藏/显示面板
B：存储库切换器
C：资源
D：过滤器
E：搜索栏
F：排序
G：按升序或降序排序
H：查看

隐藏/显示面板 hide-show-panel

要在左侧导航中隐藏文件夹，请单击 隐藏文件夹 图标。要撤消更改，请再次单击 隐藏文件夹 图标。

存储库切换器 repository-switcher

通过资产选择器，您还可以切换存储库以进行资产选择。您可以从左侧面板中可用的下拉列表中选择所选存储库。下拉列表中可用的存储库选项基于 index.html 文件中定义的 repositoryId 属性。它基于登录用户访问的选定IMS组织的环境。消费者可以传递首选 repositoryID，在这种情况下，资源选择器将停止呈现存储库切换器，并且仅呈现给定存储库中的资源。

资源存储库

它是可用于执行操作的资源文件夹的集合。

开箱即用的过滤器 filters

资源选择器还提供开箱即用的过滤器选项来细化您的搜索结果。可用过滤器如下：

状态： 包括all、approved、rejected或no status之间的资源的当前状态。
文件类型： 包括folder、file、images、documents或video。

到期状态： 根据资产的到期持续时间提及该资产。您可以选中Expired复选框以筛选已过期的资产；或将资产的Expiration Duration设置为根据资产的到期持续时间显示资产。当资产已过期或即将过期时，系统会显示一个描述该资产的徽章。此外，您可以控制是否允许使用（或拖放）已过期的资源。查看有关自定义过期资产的详细信息。默认情况下，对于在未来30天内过期的资产，会显示 即将过期 徽章。但是，您可以使用expirationDate属性配置到期时间。

note tip
TIP
如果要根据资产的未来到期日期查看或筛选资产，请在`Expiration Duration`字段中提及未来日期范围。它显示具有即将过期徽章的资源。