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