XML 输入脚本文件的结构

当您使用 XML 配置接口命令行客户机时，您使用的 XML 脚本指定了根元素、XML 模式、门户网站资源以及要执行的操作。

XML 请求或响应的主要级别结构始终如下：

<?xml version="1.0" encoding="UTF-8"?>
   <request
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:noNamespaceSchemaLocation="PortalConfig_8.5.0.xsd"
    type="export|update"> 
      <portal . . . >
      definition of configuration parts to be exported or updated
      </portal>
      <status . . . >
      success or failure indication for the processing
      </status>
   </request>
主请求元素指定 XML 配置接口使用的 XML 模式。您必须一直使用示例中所示的模式引用，也就是对模式 PortalConfig_8.5.0.xsd 不带名称空间的引用。所有 XML 请求都必须符合该模式。您可以在 com/ibm/wps/command/xml/PortalConfig_8.5.0.xsd 位置下的 JAR 文件 wp.xml.jar 中找到模式声明进行参考。该 JAR 文件 wp.xml.jar 位于以下目录中： 其他所有的 XML 样本文件都位于以下目录： 在将请求发送到门户网站之前，您可以先用合适的编辑器或解析器对照此模式对请求进行验证，从而确保语法正确。此模式还包含了一些注释，它们对所有配置条目的含义及可填入其中的值都进行了详细说明。

type 属性指明 XML 请求到底包含门户网站资源的导出规范还是更新规范。

portal 部分描述要进行导出或更新的门户网站配置的各部分。下面几节将更为详细地讲述用到的层次结构中的内容。

status 部分是可选的；在 XML 响应中它指明请求的操作成败与否。如果 XML 请求中有状态元素，那服务器便将它忽略。

可发给服务器最简单的请求如下：

   <?xml version="1.0" encoding="UTF-8"?>
      <request xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xsi:noNamespaceSchemaLocation="PortalConfig_8.5.0.xsd"
            type="export"> 
         <portal action="export"/>
      </request>

此请求导出门户网站的全部配置。您可以看一下响应的内容来了解如何用 XML 元素和属性来表示单个门户网站资源（例如，Portlet 或页面）的配置。

除了 export 和 update 请求类型之外，还提供了第三种请求类型 export-orphaned-data 用于准备删除独立数据这一特殊场景。