1.6.3建立並部署外部DAM應用程式
1.6.3.1下載範例應用程式檔案
移至https://github.com/woutervangeluwe/genstudio-external-dam-app。 按一下 代碼,然後選取 下載ZIP。
將zip檔案解壓縮至案頭。
1.6.3.2設定Adobe Developer命令列介面
在 genstudio-external-dam-app-main 資料夾上按一下滑鼠右鍵,然後選取 資料夾的新終端機。
您應該會看到此訊息。 輸入命令aio login
。 此命令會重新導向至您的瀏覽器,並預期您會登入。
成功登入後,您應該會在瀏覽器中看到此資訊。
瀏覽器會重新導向回終端機視窗。 您應該會看到顯示 登入成功 的訊息,以及瀏覽器傳回的長權杖。
下一步是設定您用於外部DAM應用程式的例項和Adobe IO專案。
為此,您需要從您之前設定的Adobe IO專案下載檔案。
移至https://developer.adobe.com/console/home,並開啟您之前建立的專案(名為--aepUserLdap-- GSPeM EXT
)。 開啟 生產 工作區。
按一下 全部下載。 如此將下載JSON檔案。
將JSON檔案從您的 Downloads 目錄複製到外部DAM應用程式的根目錄中。
返回您的終端機視窗。 輸入命令aio app use XXX-YYY-Production.json
。
命令執行後,您的外部DAM應用程式現在會連線至使用您之前建立的App Builder的Adobe IO專案。
1.6.3.3安裝GenStudio擴充性SDK
接下來,您必須安裝 GenStudio擴充性SDK。 您可以在這裡找到有關SDK的更多詳細資料: https://github.com/adobe/genstudio-extensibility-sdk。
若要安裝SDK,請在終端機視窗中執行此命令:
npm install @adobe/genstudio-extensibility-sdk
幾分鐘後,就會安裝SDK。
1.6.3.4在Visual Studio Code中檢閱外部DAM應用程式
開啟Visual Studio Code。 按一下 開啟…… 以開啟資料夾。
選取包含您之前下載的應用程式的資料夾 genstudio-external-dam-app-main。 按一下 「開啟」。
按一下以開啟檔案 .env。
.env 檔案是由您在上一步中執行的命令aio app use
所建立,包含使用App Builder連線至您的Adobe IO專案所需的資訊。
您現在需要將下列詳細資料新增至 .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
可供使用。 系統要求您寫下這些值,您現在可以複製這些值。
欄位 AWS_REGION
可以從AWS S3 Home檢視取得,位於您的儲存貯體名稱旁。 在此範例中,區域是 us-west-2。
欄位 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
檔案中。 別忘了儲存您的變更。
接下來,返回您的終端機視窗。 執行此命令:
export $(grep -v '^#' .env | xargs)
最後,您需要變更將顯示在GenStudio for Performance Marketing中的標籤,以便區分外部DAM應用程式與其他整合。 若要這麼做,請開啟檔案 Constants.ts,您可以在總管中向下鑽研至 src/genstudiopm > web-src > src,以找到該檔案。
需要將第14行變更為
export const extensionLabel: string = "--aepUserLdap-- - External S3 DAM";
別忘了儲存您的變更。
1.6.3.5執行您的外部DAM應用程式
在終端機視窗中,執行命令aio app run
。 1-2分鐘後,您應該會看到此訊息。
aio app run
時,系統可能會將您重新導向瀏覽器,讓您接受新的憑證。 如果發生此情況,請接受憑證,然後您將能夠繼續執行以下步驟。
您現在已確認應用程式執行中。 下一步是進行部署。
首先,按下 CTRL+C 以停止應用程式執行。 然後,輸入命令aio app deploy
。 此命令會將您的程式碼部署至Adobe IO。
因此,您會收到類似的URL以存取已部署的應用程式:
https://133309-201burgundyguan.adobeio-static.net/index.html
為了進行測試,您現在可以將?ext=
新增為上述URL的前置詞,將該URL作為查詢字串引數使用。 這會產生此查詢字串引數:
?ext=https://133309-201burgundyguan.adobeio-static.net/index.html
移至https://experience.adobe.com/genstudio/create。
接下來,在 # 前新增查詢字串引數。 您的新URL應如下所示:
https://experience.adobe.com/?ext=https://133309-201burgundyguan.adobeio-static.net/index.html#/@experienceplatform/genstudio/create
頁面會正常載入。 按一下 橫幅 開始建立新橫幅。
選取範本並按一下 使用。
按一下 從內容選取。
之後,您應該能夠選取外部DAM,其應該從下拉式清單中命名為--aepUserLdap-- - External S3 DAM
。
您應該會看到此訊息。 選取影像 neon_rabbit_banner.jpg 並按一下 使用。
您現在已選取在S3儲存貯體中執行的外部DAM中的影像。 選取影像後,您現在可以依照練習1.3.3.4建立和核准中繼廣告中記錄的正常工作流程。
在本機電腦上變更程式碼時,您需要重新部署應用程式。 當您重新部署時,請使用以下終端機命令:
aio app deploy --force-build --force-deploy
您的應用程式現已準備好發佈。
後續步驟
返回GenStudio for Performance Marketing — 擴充性
返回所有模組