1.6.3创建和部署外部DAM应用程序

1.6.3.1下载示例应用程序文件

转到https://github.com/woutervangeluwe/genstudio-external-dam-app。 单击​ 代码,然后选择​ 下载ZIP

外部DAM

将zip文件解压缩到桌面上。

外部DAM

1.6.3.2配置Adobe Developer命令行界面

右键单击​ genstudio-external-dam-app-main ​文件夹,然后选择​ 新建位于文件夹中的终端

外部DAM

您应该会看到此内容。 输入命令aio login。 此命令将重定向到您的浏览器,并期待您登录。

外部DAM

成功登录后,您应该会在浏览器中看到此内容。

外部DAM

然后,浏览器将重定向回终端窗口。 您应该会看到一条显示​ 登录成功 ​的消息,以及浏览器返回的长令牌。

外部DAM

下一步是配置将用于外部DAM应用程序的实例和Adobe IO项目。

为此,您需要从之前配置的Adobe IO项目下载文件。

转到https://developer.adobe.com/console/home并打开您之前创建的名为--aepUserLdap-- GSPeM EXT的项目。 打开​ 生产 ​工作区。

外部DAM

单击​ 全部下载。 这将下载一个JSON文件。

外部DAM

将JSON文件从​ Downloads ​目录复制到外部DAM应用程序的根目录中。

外部DAM

返回终端窗口。 输入命令aio app use XXX-YYY-Production.json

NOTE
您需要在上面的命令中更改文件的名称以匹配文件的名称。

命令运行后,您的外部DAM应用程序现在将连接到您之前创建的App Builder的Adobe IO项目。

外部DAM

1.6.3.3安装GenStudio可扩展性SDK

接下来,您需要安装​ GenStudio可扩展性SDK。 您可以在此处找到有关SDK的更多详细信息:https://github.com/adobe/genstudio-extensibility-sdk

要安装SDK,请在终端窗口中运行此命令:

npm install @adobe/genstudio-extensibility-sdk

外部DAM

几分钟后,将安装SDK。

外部DAM

1.6.3.4在Visual Studio Code中查看外部DAM应用程序

打开Visual Studio Code。 单击​ 打开…… ​打开文件夹。

外部DAM

选择包含您之前下载的应用程序的​ genstudio-external-dam-app-main ​文件夹。 单击​ 打开

外部DAM

单击以打开文件​ .env

外部DAM

.env ​文件由您在上一步中运行的命令aio app use创建,它包含使用App Builder连接到Adobe IO项目所需的信息。

外部DAM

现在,您需要将以下详细信息添加到​ .env ​文件,以便外部DAM应用程序可以连接到您之前创建的AWS S3存储段。

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_REGION=
AWS_BUCKET_NAME=

在上一个练习中创建IAM用户后,字段​ AWS_ACCESS_KEY_ID ​和​ AWS_SECRET_ACCESS_KEY ​可用。 系统要求您写下这些值,您现在可以复制这些值。

ETL

字段​ AWS_REGION ​可以从AWS S3 Home视图中获取,位于存储段名称旁边。 在此示例中,区域是​ us-west-2

ETL

字段​ AWS_BUCKET_NAME ​应为--aepUserLdap---gspem-dam

此信息允许您更新每个变量的值。

AWS_ACCESS_KEY_ID=XXX
AWS_SECRET_ACCESS_KEY=YYY
AWS_REGION=us-west-2
AWS_BUCKET_NAME=--aepUserLdap---gspem-dam

您现在应将此文本粘贴到.env文件中。 别忘了保存更改。

外部DAM

接下来,返回终端窗口。 运行此命令:

export $(grep -v '^#' .env | xargs)

外部DAM

最后,您需要更改将显示在GenStudio for Performance Marketing中的标签,以便您可以将外部DAM应用程序与其他集成区分开来。 为此,请打开文件​ Constants.ts,可通过在资源管理器中向下钻取到​ src/genstudiopm > web-src > src ​来查找该文件。

需要将第14行更改为

export const extensionLabel: string = "--aepUserLdap-- - External S3 DAM";

别忘了保存更改。

外部DAM

1.6.3.5运行外部DAM应用程序

在终端窗口中,运行命令aio app run。 1-2分钟后,您应该会看到此内容。

NOTE
当您首次运行aio app run时,您可能会被重定向到浏览器以接受新证书。 如果发生这种情况,请接受证书,然后您可以继续执行以下步骤。

外部DAM

现在,您已确认您的应用程序正在运行。 下一步是部署它。

首先,按​ CTRL+C ​以停止应用程序运行。 然后,输入命令aio app deploy。 此命令会将您的代码部署到Adobe IO。

因此,您将收到一个类似的URL来访问已部署的应用程序:

https://133309-201burgundyguan.adobeio-static.net/index.html

外部DAM

为了进行测试,您现在可以通过将?ext=添加为上述URL的前缀来将该URL用作查询字符串参数。 这将导致此查询字符串参数:

?ext=https://133309-201burgundyguan.adobeio-static.net/index.html

转到https://experience.adobe.com/genstudio/create

外部DAM

接下来,将查询字符串参数添加到​ # ​之前。 您的新URL应如下所示:

https://experience.adobe.com/?ext=https://133309-201burgundyguan.adobeio-static.net/index.html#/@experienceplatform/genstudio/create

页面将正常加载。 单击​ 横幅 ​开始创建新横幅。

外部DAM

选择模板并单击​ 使用

外部DAM

单击​ 从内容中选择

外部DAM

然后,您应该能够选择外部DAM,它应该从下拉列表中命名为--aepUserLdap-- - External S3 DAM

外部DAM

您应该会看到此内容。 选择图像​ neon_rabbit_banner.jpg ​并单击​ 使用

外部DAM

现在,您已从S3存储桶中运行的外部DAM中选择了一个图像。 选择图像后,您现在可以按照练习1.3.3.4创建和批准元广告中记录的常规工作流程。

外部DAM

在本地计算机上更改代码时,您需要重新部署应用程序。 当您重新部署时,请使用以下终端命令:

aio app deploy --force-build --force-deploy

外部DAM

您的应用程序现已准备就绪,可供发布。

后续步骤

转到单独发布您的应用程序

返回至GenStudio for Performance Marketing — 可扩展性

返回所有模块

recommendation-more-help
4bbf020c-24db-4a43-b239-88fab142f02d