文件CampaignCampaign Classic v7 文件

指令碼和程式碼指南 scripting-coding-guidelines

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

指令碼

如需詳細資訊，請參閱Campaign JSAPI檔案。

如果您使用工作流程、網頁應用程式、jssp編寫指令碼，請遵循以下最佳實務：

  • 儘可能避免使用SQL敘述句。

  • 如果需要，請使用引數化（準備陳述式）函式，而非字串串串連。

    不當做法：

    code language-none 
    sqlGetInt( "select iRecipientId from NmsRecipient where sEmail ='" + request.getParameter('email') +  "'  limit 1" )

    良好實務：

    code language-none 
    sqlGetInt( "select iRecipientId from NmsRecipient where sEmail = $(sz) limit 1", request.getParameter('email'));
    note important
    IMPORTANT
    sqlSelect不支援此功能，因此您必須使用DBEngine類別的查詢函式：
    code language-none 
    var cnx = application.getConnection()
var stmt = cnx.query("SELECT sFirstName, sLastName FROM NmsRecipient where sEmail = $(sz)", request.getParameter('email'))
for each(var row in stmt) logInfo(row[0] + " : " + row[1])
cnx.dispose()

若要避免SQL插入，必須將SQL函式新增至允許清單，才能在Adobe Campaign中使用。 將變數新增至允許清單後，運運算元就會在運算式編輯器中看見該變數。 請參見此頁面。

IMPORTANT
如果您使用的組建版本早於8140，則​ XtkPassUnknownSQLFunctionsToRDBMS ​選項可能會設為'1'。 如果要保護資料庫的安全，請刪除此選項（或將它設定為'0'）。

如果您使用使用者輸入在查詢或SQL陳述式中建立篩選器，您必須一律將其逸出（請參閱Campaign JSAPI檔案 — 資料保護：逸出函式）。 這些函式包括：

  • NL.XML.escape(data)
  • NL.SQL.escape(data)
  • NL.JS.escape(data)
  • NL.XML.escapeAttribute(data)

保護您的新資料模型

資料夾基底

請參閱下列頁面：

已命名的權限

除了資料夾式安全性模型之外，您還可以使用已命名的許可權來限制操作員動作：

  • 您可以新增一些系統篩選器(sysFilter)，以防止讀取/寫入您的資料（請參閱此頁面）。

    code language-none 
    <sysFilter name="writeAccess">
    <condition enabledIf="hasNamedRight('myNewRole')=false" expr="FALSE"/>
</sysFilter>

  • 您也可以保護結構描述中定義的某些動作(SOAP方法)。 只需設定存取屬性，並將對應的已命名許可權設為值即可。

    code language-none 
    <method name="grantVIPAccess" access="myNewRole">
    <parameters>
...
    </parameters>
</method>

    如需詳細資訊，請參閱此頁面。

IMPORTANT
您可以在導覽樹狀結構的命令節點中使用已命名的許可權。 它提供更佳的使用者體驗，但不提供任何保護（僅使用使用者端隱藏/停用它們）。 您必須使用access屬性。

溢位表格

如果您需要根據運運算元存取層級保護機密資料（結構描述的一部分），請勿在表單定義（enabledIf/visibleIf條件）中隱藏這些資料。

熒幕會載入完整圖元，您也可以在欄定義中顯示它們。 要執行此操作，您必須建立溢位表格。 請參閱此頁面。

在網頁應用程式中新增字幕

在公開登陸頁面/訂閱頁面中新增驗證碼是建議的做法。 不幸的是，在DCE （數位內容編輯器）頁面中新增驗證碼並不容易。 我們將說明如何新增v5驗證碼或Google reCAPTCHA。

在DCE中新增驗證碼的一般方法是建立個人化區塊，以便輕鬆將其納入頁面內容中。 您必須新增​ 指令碼 ​活動和​ 測試。

個人化區塊

  1. 前往「Resources > Campaign Management > Personalization blocks」並建立新的檔案。

  2. 使用​ Web application ​內容型別並檢查​ Visible in the customization menus。

    如需詳細資訊，請參閱本頁面。

    以下是​ 行銷活動驗證碼 ​的範例：

    code language-javascript 
    <%
var captchaID = CaptchaIDGen();
%>
<img src="/nms/jsp/captcha.jsp?captchaID=<%=captchaID%>&width=200&height=50&minWordSize=8&maxWordSize=8"/>
<input id="captchaValue" name="captchaValue" <%= String(ctx.vars.captchaValid) === "false" ? class="ui-state-error" : "" %>>
<input type="hidden" name="captchaID" value="<%=captchaID%>"/>
<%
if( serverForm.isInputErroneous("captchaValue") ) {
%>
<script type="text/javascript">
$("#captchaValue").addClass("ui-state-error")
</script>
<%
}
%>

    • 第1行至第6行會產生所有需要的輸入。

    • 第7行到結尾控制代碼錯誤。

    • 第4行可讓您變更驗證碼灰色方塊大小（寬度/高度）和產生的文字長度(minWordSize/maxWordSize)。

    • 在使用Google reCAPTCHA之前，您必須在Google上註冊並建立新的reCAPTCHA網站。

      <div class="g-recaptcha" data-sitekey="YOUR_SITE_KEY"></div>

    您應該能夠停用驗證按鈕，但由於我們沒有任何標準按鈕/連結，所以最好在HTML中自行操作。 若要瞭解如何執行此動作，請參閱此頁面。

更新您的Web應用程式

  1. 存取網頁應用程式的屬性，以新增名為​ captchaValid ​的布林值變數。

  2. 在最後一頁與​ Storage ​活動之間，新增​ Script ​與​ Test。

    將分支​ True ​插入​ Storage，並將另一個分支插入具有驗證碼的頁面。

  3. 編輯分支True的條件，其中"[vars/captchaValid]"等於True。

  4. 編輯​ Script ​活動。 內容將取決於所選的驗證碼引擎。

  5. 最後，您可以在頁面中新增個人化區塊：請參閱此頁面。

IMPORTANT
若為reCAPTCHA整合，您必須在HTML中新增使用者端JavaScript （在<head>...</head>中）：
<script src="https://www.google.com/recaptcha/api.js" async defer></script>

Campaign驗證碼

var captchaID = request.getParameter("captchaID");
var captchaValue = request.getParameter("captchaValue");

if( !CaptchaValidate(captchaID, captchaValue) ) {
  serverForm.logInputError("captchaValue",
                           "The characters you typed for the captcha must match the image ones.",
                           "captchaValue")
  ctx.vars.captchaValid = false
}
else
  ctx.vars.captchaValid = true

第6行：您可以輸入任何型別的錯誤訊息。

Google recaptcha

請參閱正式檔案。

ctx.vars.captchaValid = false
var gReCaptchaResponse = request.getParameter("g-recaptcha-response");

// Call reCaptcha API to validate it
var req = new HttpClientRequest("https://www.google.com/recaptcha/api/siteverify")
req.method = "POST"
req.header["Content-Type"] = "application/x-www-form-urlencoded"
req.body = "secret=YOUR_SECRET_HERE&response=" + encodeURIComponent(gReCaptchaResponse)
req.execute()
var response = req.response
if( response.code == 200 ) {
  captchaRes = JSON.parse(response.body.toString(response.codePage));
  ctx.vars.captchaValid = captchaRes.success
}

if( ctx.vars.captchaValid == false ) {
  serverForm.logInputError("reCaptcha",
                           "Please validate the captcha",
                           "reCaptcha")
  logInfo("reCaptcha not validated")
}

若要使用JSON.parse，您必須在webApp中加入「shared/json2.js」：

從建置8797開始，若要使用驗證API URL，您必須透過在urlPermission節點中新增來將它新增到serverConf檔案的允許清單中：

<url dnsSuffix="www.google.com" urlRegEx="https://www.google.com/recaptcha/api/siteverify"/>

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1