v7 v8

格式化

JavaScript 模板

JavaScript模板是包含JavaScript代码的HTML或文本文档。 其构建方式与投放操作中的电子邮件内容相同。

JavaScript模板的标识

JavaScript模板由其名称和命名空间标识，就像架构和表单一样。 但是，建议添加 .js 选项到模板名称。

JavaScript模板的结构

基于“cus：book”架构的JavaScriptHTML格式设置模板示例：

<html>
  <body>
    <!-- Title of book -->
    <h1><%= content.@name %></h1>
    <ul>
      <% for each(var chapter in content.chapter) { %>
        <li><%= chapter.@name %></li>
      <% }%>
    </ul>
  </body>
</html>

各种JavaScript指令以下列形式显示：

  • 合并字段：显示数据的内容 <%= <source> %> 语法，其中 <source>是要显示的数据的源字段。
  • 说明块：执行<%和%>标记之间包含的一系列JavaScript说明。

此 内容 对象表示输入XML文档的主元素。

在我们的示例中，以下行显示名称簿名称的内容：

<h1><%= content.@name %></h1>

以下代码会对以下对象进行迭代： <chapter> 收集要素：

<% for each(var chapter in content.chapter) { %>
  <li><%= chapter.@name %></li>
<% }%>

内容的属性和元素表示为JavaScript对象，并遵循源文档的结构。

示例:

  • 内容。@name：检索主元素的“name”属性的值
  • 内容。@['name']：与 内容。@name 语法
  • content.chapter.length：返回上的元素数。 <chapter 收集要素
  • content.chapter[0].@name：检索第一个的名称 <chapter> 元素
  • chapter.name()：返回的名称 <chapter> 元素
  • chapter.parent()。name()：返回父元素的名称 <chapter>
注意

由于“ — ”字符是在JavaScript语言中保留的，因此必须通过 ['<field>'] 语法。

例如： content.@['offer-id'].

编程语言的所有能力（变量、循环、条件测试、函数等）。 )可用于构造输出文档。 可以访问SOAP API以扩充输出文档。

示例:

  • 条件测试：

    <% if (content.@number == 1 || content.@language == 'en') { %>
<!-- Content to be displayed if test is true-->
<% } %>

  • 函数调用：

    <!-- Displays a horizontal bar -->
;<% function DisplayHorizontalBar() { %>
  <hr/>
<% } %>

<!-- The same function in a block  -->
<%
function DisplayHorizontalBar2()
{
  document.write('<hr/>');
}
%>

<!-- Returns the value in uppercase -->
<%
function formatName(value)
{
  return value.toUpperCase();
}
%>

<!-- Call functions -->
<%= DisplayHorizontalBar1() %>
<%= DisplayHorizontalBar2() %>
<%= formatName(content.@name) %>

  • 声明和变量调用：

    <%  var counter = 0; %>

<%= counter += 10 %>

  • 使用静态方法检索和显示收件人名称：

    <% var recipient = nms.recipient.get(1246); %>
<%= recipient.lastName %>

  • 使用非静态方法恢复和显示收件人名称：

    <% var query = xtk.queryDef.create(
  <queryDef schema="nms:recipient" operation="get">
    <select>
      <node expr="@lastName"/>
    </select>
    <where>
      <condition expr="@id=1246"/>
    </where>
  </queryDef>);

  var recipient = query.ExecuteQuery();
%>

<%= recipient.@lastName %>

包含JavaScript模板

您可以构建一个函数或变量库以供将来使用。 要实现此目的，请使用导入JavaScript模板 估计 函数。 这使您可以使用在其他JavaScript模板中声明的其他函数来扩充上下文。

示例：导入 common.jsp 模板。

<% eval(xtk.javascript.get("cus:common.js").data);  %>

编辑JavaScript模板

通过编辑区域，可填充JavaScript模板的内容：

注意

为初始化JavaScript对象，必须填充关联的数据模型架构。

要随时生成输出文档的预览，请选择内容和输出格式(HTML、文本、XML)，然后单击 Generate ：

注意

无需保存更改即可预览输出文档。

有关如何创建和使用JavaScript模板的示例

在下面，您将找到使用JavaScript模板实施以下内容管理所需的配置：

此示例涉及以下步骤：

  1. 创建以下架构(在本例中为： neo：news)：

    <srcSchema _cs="Invitation (neo)"   entitySchema="xtk:srcSchema" img="xtk:schema.png" label="Invitation" mappingType="sql" name="news" namespace="neo" xtkschema="xtk:srcSchema">

  <enumeration basetype="string" default="en" name="language">
    <value label="Français" name="fr" value="fr"/>
    <value label="English" name="gb" value="gb"/>
  </enumeration>

  <enumeration basetype="string" name="css">
    <value label="Blue" name="bl" value="blue"/>
    <value label="Orange" name="or" value="orange"/>
  </enumeration>

  <element label="Intervenants" name="attendee">
    <key internal="true" name="id">
      <keyfield xpath="@id"/>
    </key>
    <attribute label="Name" name="name" type="string"/>
    <element label="Image" name="image" target="xtk:fileRes" type="link"/>
    <attribute label="Description" name="description" type="string"/>
    <attribute default="Gid()" label="Id" name="id" type="long"/>
  </element>

  <element label="Invitation" name="news" template="ncm:content" xmlChildren="true">

    <compute-string expr="@name"/>
    <attribute enum="language" label="Language" name="language" type="string"/>
    <attribute enum="css" label="Stylesheet" name="css" type="string"/>
    <attribute label="Title" name="title" type="string"/>
    <element label="Presentation" name="presentation" type="html"/>
    <attribute label="Date" name="date" type="date"/>
    <element label="Attendees list" name="attendeesList" ordered="true" ref="attendee" unbound="true"/>

  </element>
</srcSchema>

  2. 创建链接的 Content management 键入表单(neo：news)

    <form _cs="News (neo)" entitySchema="xtk:form"  img="xtk:form.png" label="News"  name="news" namespace="neo" type="contentForm" xtkschema="xtk:form">

  <container type="iconbox">
    <container label="Invitation">
      <input xpath="@langue"/>
      <input xpath="@css"/>
      <input xpath="@title"/>
      <input xpath="@date"/>
      <input xpath="presentation"/>
    </container>

    <container label="Intervenants">
      <container toolbarCaption="Liste des intervenants" type="notebooklist" xpath="attendeesList" xpath-label="@nom">
        <container>
          <input xpath="@nom"/>
          <input img="nl:sryimage.png" newEntityFormChoice="true" xpath="image">
            <sysFilter>
              <condition expr="@isImage = true"/>
            </sysFilter>
          </input>
          <input xpath="@description"/>
        </container>
      </container>
    </container>
  </container>

</form>

  3. 创建包含HTML和文本格式消息内容的JavaScript模板。

    • 在我们的示例中，对于HTML：

      <html>
  <head>
    <title>Newsletter</title>
     <style type="text/css">
      .body {font-family:Verdana, Arial, Helvetica, sans-serif; font-size:10px; color:#514c48; margin-left: auto; margin-right: auto;}
      .body table {width:748; border: solid 1px; cellpadding:0; cellspacing:0"}
     </style>
  </head>
  <body>
    <p><center><%= mirrorPage %></center></p>
    <center>
      <table>
       <tr>
        <td>
          <img src="[LOGO]"/>
        </td>
        <td>
          <h1><%= content.@title %></h1>
        </td>
       </tr>
       <tr>

       <td>
        <div >
          <h0><%= hello,</h0>
          <p><%= content.presentation %></p>

          <h0>Useful information</h0>
          <p>
            <img src="[IMAGE 1]"/>When? <br/><%= formatDate(content.@date, "%2D %Bl %4Y") %> From 10 AM in your bookshop.</p><br/>
          <p>
            <img src="[IMAGE 2]"/>Who? <br>Meet our favorite authors and illustrators and get a signed copy of their book.</p><br/>
          <p>
            <img src="[IMAGE 3]"/>Attendance is free but there is a limited number of seats: sign up now!</p>
      </div>
      </td>

        <td>
         <div style="text-align:left; width:210; height:400px; background:url([IMAGE DE FOND])">

            <h0><%= participant %></h0>
            <%
            var i
            var iLength = content.attendeesList.length()
            for (i=0; i<iLength; i++)
            { %>
            <p>
              <%= generateImgTag(content.attendeesList[i].@["image-id"]) %>  <%= content.attendeesList[i].@description %>
            </p>
            <% }
            %>
         </div2>
        </td>
    </tr>
  </table>
</center>
</body>
</html>

    • 对于文本：

      <%= content.@title %>
<%= content.presentation %>

*** When? On <%= formatDate(content.@date, "%2D %Bl %4Y") %> From 10 AM in your bookshop.

*** Who? Come and meet our favorite authors and illustrators and get a signed copy of their books.

*** Attendance is free but there is a limited number of seats: sign up now!

Guests:
******************
<%
var i
var iLength = content.attendeesList.length()
//for (i=(iLength-1); i>-1; i--)
for( i=0 ; i<iLength ; i++ )
  { %>
  Description <%= i %> : <%= content.attendeesList[i].@description %>
  <% }
%>

  4. 现在，创建用于两种格式的发布模板：

    • 对于HTML：

    • 对于文本：

  5. 然后，您可以在投放中使用此内容模板。

    有关更多信息，请参阅 使用内容模板.

XSL样式表

XSLT语言允许将XML文档更改为输出文档。 根据样式表的输出方法，生成的文档可以用HTML、纯文本或其他XML树生成。

此转换在称为样式表的文档中的XML中依次是详细的。

标识样式表

样式表由其名称和命名空间标识，就像架构和表单一样。 但是，建议您添加 .xsl 样式表名称的扩展。

样式表的标识键是由命名空间和用冒号分隔的名称组成的字符串；例如： cus：book.xsl.

样式表的结构

基于示例架构“cus：book”的HTML格式化样式表示例：

<?xml version="1.0" encoding="ISO-8859-1" ?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:output encoding="ISO-8859-1" method="html"/>
  <!-- Point of entry of the stylesheet -->
  <xsl:template match="/book">
    <html>
      <body>
        <!-- Book title -->
        <h1><xsl:value-of select="@name"/></h1>
        <lu>
          <!-- List of chapters -->
          <xsl:for-each select="child::chapter">
            <li><xsl:value-of select="@name"/></li>
          </xsl:for-each>
       </lu>
      </body>
    </html>
   </xsl:template>
</xsl:stylesheet>

样式表是遵循以下规则的XML文档：

  • 属性的值在引号之间，
  • 元素必须具有开始标记和结束标记，
  • 将“<”或“&”字符替换为 '<' 或 '&' 实体，
  • 每个XSL元素必须使用 xsl 命名空间。

样式表必须以XSL根元素标记开头 <xsl:stylesheet> 并以 </xsl:stylesheet> 标记。 必须在开始标记中定义XSL命名空间，如下所示：

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">

此 <xsl:output> 元素指定生成的文档的格式。 指定所需的字符集和输出格式。

<xsl:output encoding="ISO-8859-1" method="html"/>

以下说明描述了用于格式化输出文档的样式表的配置。

<xsl:template match="/book">
  <html>
    <body>
      <!-- Book title -->
      <h1><xsl:value-of select="@name"/></h1>
      <lu>
        <!-- List of chapters -->
        <xsl:for-each select="child::chapter">
          <li><xsl:value-of select="@name"/></li>
        </xsl:for-each>
      </lu>
    </body>
  </html>
</xsl:template>

默认情况下，XSLT处理器会查找 模板 应用于输入XML文档的根节点或主节点。 输出文档的构建以如下内容开头 模板.

在我们的示例中，通过显示书名和章节列表，从“cus：book”架构生成了一个HTML页面。

注意

有关XSLT语言的更多信息，请参阅XSLT参考文档。

显示HTML/XML

要显示 html 字段，使用 disable-output-escaping="yes" 选项来自 <xsl:value-of> 指令。 这样，您就可以避免将字符替换为XML实体（例如，将<替换为<）。

此 <xsl:text> 指令和 disable-output-escaping="yes" 选项允许您为个性化字段或条件测试插入JavaScript标记。

示例:

  • 显示“html”类型字段的内容：

    <xsl:value-of select="summary" disable-output-escaping="yes"/>

  • 插入个性化字段 <%= recipient.email %>：

    <xsl:text disable-output-escaping="yes"><%= recipient.email %></xsl:text>

  • 添加条件测试 <%，如果(recipient.language == 'en') { %>：

    <xsl:text disable-output-escaping="yes"><% if (recipient.language == 'en') { %></xsl:text>

包括样式表

可以构建一个模板或变量库，以便在多个样式表之间共享。 “longMonth” 模板​如上所示，是在样式表中远程定位模板以便以后可以重复使用的好处的典型示例。

此 <xsl:include> 指令指示要包含在文档中的样式表的名称。

示例：包含“common.xsl”样式表。

<? xml version="1.0" encoding="ISO-8859-1" ?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:include href="common.xsl"/>
  <xsl:output encoding="ISO-8859-1" method="jsp" indent="yes"/>
  ...
</xsl:stylesheet>
注意

不得在要包含的样式表的引用中输入命名空间的名称。 作为标准，此样式表是使用用户命名空间创建的。

编辑样式表

通过编辑区域，可填充样式表的内容：

要随时生成输出文档的预览，请选择一个内容实例和格式(HTML、文本、XML)，然后单击 Generate ：

注意

无需在样式表中保存更改即可查看输出文档预览。

映像管理

图像引用

在HTML输出文档中输入的图像可使用绝对或相对参照进行参照。

相对引用允许您输入包含图像的URL NcmResourcesDir 和 NcmResourcesDirPreview 选项。 这些选项包含要在Adobe Campaign客户端控制台中发布和预览的图像的位置。

这两个选项可通过 Administration > Platform > Options 文件夹。

示例:

  • NcmResourcesDir = "https://server/images/"
  • NcmResourcesDirPreview = "x：/images/"

在样式表处理期间， _resPath 根据上下文（预览或发布），输入XML文档的主元素上的属性会自动以一个或多个选项填充。

有关如何将图像放置选项及其用于图像的示例：

<img src="<%= content.@_resPath %>/newsletter/image.png"/>
注意

我们建议声明一个包含存储图像的服务器引用的变量（在我们的示例中为“resPath”）。

使用公共资源

您还可以使用 Public resources 根据在部署向导中输入的实例设置，声明映像并将其上传到服务器。

然后，您可以在内容中调用这些图像。 为此，请在内容管理架构中使用以下语法：

<element label="Image" name="image" target="xtk:fileRes" type="link"/>

在表单中，用于选择图像的字段将通过以下语法添加：

<input img="nl:sryimage.png" newEntityFormChoice="true" xpath="image">
    <sysFilter>
      <condition expr="@isImage = true"/>
    </sysFilter>
  </input>
注意

有关更多详细信息 Public resources 以及如何配置和使用它们，请参阅 本节.

日期显示

在XML输入文档中，日期以内部XML格式存储： YYYY/MM/DD HH:MM:SS (示例2018/10/01 12:23:30)。

Adobe Campaign为JavaScript模板和XSL样式表提供日期格式功能，如下所述。

JavaScript日期格式

要以所需格式显示日期，Adobe Campaign提供 格式日期 函数作为输入，输入日期的内容以及使用以下语法指定输出格式的字符串： %4Y/%2M/%2D %2H%2N%2S

示例:

  • 在中显示日期 31/10/2018 格式：

     <%= formatDate(content.@date, "%2D/%2M/%4Y") %>

  • 在中显示日期 2018年7 格式：

    <%
 function displayDate(date)
  {
    var aMonth =
    [ 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December' ];

    var month = formatDate(content.@date, "%2M")
    var year = formatDate(content.@date, "%4Y")

    return aMonth[month-1]+" "+year;
  }
%>

<%= displayDate(content.@date) %>

XSL日期格式

在XSLT语法中没有标准日期管理函数。 要以所需格式显示日期，Adobe Campaign提供了外部功能 日期格式. 此函数将日期的内容和一个字符串作为输入，该字符串使用以下语法指定输出格式： %4Y/%2M/%2D %2H%2N%2S

示例:

  • 若要在中显示日期 01/10/2018 格式：

    <xsl:value-of select="external:date-format(@date, '%2D/%2M/%4Y')"/>

  • 若要在中显示日期 2018年7 格式：

    <!-- Returns the month in the form of a string with the month number as input -->
<xsl:template name="longMonth">
  <xsl:param name="monthNumber"/>

  <xsl:choose>
    <xsl:when test="$monthNumber = 1">January</xsl:when>
    <xsl:when test="$monthNumber = 2">February</xsl:when>
    <xsl:when test="$monthNumber = 3">March</xsl:when>
    <xsl:when test="$monthNumber = 4">April</xsl:when>
    <xsl:when test="$monthNumber = 5">May</xsl:when>
    <xsl:when test="$monthNumber = 6">June</xsl:when>
    <xsl:when test="$monthNumber = 7">July</xsl:when>
    <xsl:when test="$monthNumber = 8">August</xsl:when>
    <xsl:when test="$monthNumber = 9">September</xsl:when>
    <xsl:when test="$monthNumber = 10">October</xsl:when>
    <xsl:when test="$monthNumber = 11">November</xsl:when>
    <xsl:when test="$monthNumber = 12">December</xsl:when>
  </xsl:choose>
</xsl:template>

<!-- Display date -->
<xsl:call-template name="longMonth">
  <xsl:with-param name="monthNumber">
    <xsl:value-of select="external:date-format(@date, '%2M')"/>
  </xsl:with-param>
</xsl:call-template>
 <xsl:value-of select="external:date-format(@date, '%4y')"/>

在此页面上