IBM®
跳转到主要内容
    中国 [选择]    使用条款
 
 
Select a scope: Search for:    
    首页    产品    服务与解决方案     支持与下载    个性化服务    
跳转到主要内容

developerWorks 中国  >  XML | SOA and Web services  >

通过 Web 服务利用 RIXML

交换研究内容和元数据

developerWorks
前一页第 8 页,共 14 页后一页

文档选项

样例代码


对本教程的评价

帮助我们改进这些内容


<Context> 元素

<Context> 元素包含关于传输的研究文档的上下文的数据。它有两个属性:externalpriorityexternal 属性必须设置为 Nopriority 属性设置为 Medium。如果需要优先处理特定类型的研究文档,可以将这个值设置为 High。但是必须获得交换文档双方的同意。

清单 4 给出了 <Context> 元素的 XML 块示例。


清单 4. <Context> 元素的代码
					
    <Context external="No" priority="Medium">
      <IssuerDetails>
        <Issuer sequence="1" primaryIndicator="Yes" issuerType="Corporate">
          <IssuerID idType="PublisherDefined" idValue="333" publisherDefinedValue="333"/>
          <IssuerName nameType="Display">
            <NameValue>XYZ Corp.</NameValue>
          </IssuerName>
        </Issuer>
      </IssuerDetails>
      <ProductDetails periodicalIndicator="No" publicationDateTime="2008-10-10T12:00:00">
        <ProductCategory productCategory="PublisherDefined" publisherDefinedValue="TP"/>
        <ProductFocus focus="Issuer" primaryIndicator="Yes"/>
        <ProductName>Test Product</ProductName>
      </ProductDetails>
    </Context>

提供与研究相关的细节

<IssuerDetails> 元素表示从事研究的发起者的信息。(注意,这里的术语发起者 并不是指前面已经讨论的 <Issuer> 的主题值。它代表作为研究对象的公司)。

<IssuerDetails> 中的 <ProductDetails> 元素捕捉要发送的研究产品的元数据。

<IssuerDetails> 元素

<Issuer> 元素是 <IssuerDetails> 的子元素,它包含研究发起者的关键信息:

  • 按照以下说明设置 <Issuer> 元素的属性:
    • sequence 设置为 1
    • primaryIndicator 设置为 Yes,表明这是主要发起者。
    • issuerType 设置为合适的值(例如,Corporate)。
  • <IssuerId> 是非常重要的元素:它识别研究发起者。许多公司给合作发起者分配一个标识符。将该元素的 idType 属性设置为 PublisherDefined,将 idValue 设置为分配给发起者的值。PublisherDefinedValue 必须设置为与 idValue 相同的值。也可以将上市公司的股票代号作为 idValue 的值。但是如果使用混合类型来识别发起者,则要确保采用适当的逻辑,以理解以后的研究。
  • <IssuerName> 元素通常包含在 Web 站点中显示的发起者的名称。将 nameType 属性设置为 Display,并且必须将发起者的显示值提供为 <NameValue> 的值。如前所述,可以使用其他名称类型,比如 LegalLocalParent

如果研究由一个或多个发起者共同生成,则将所需的 <Issuer> 元素的数目添加到 <IssuerDetails>。增加列表中每个发起者的序列号。在这种情况下,对于主要发起者,将 primaryIndicator 设置为 Yes,对于其他发起者,则设置为 No

<ProductDetails> 元素

<ProductDetails> 元素是 <Context> 元素的子元素,它包含提交的产品的信息。<ProductDetails> 元素的属性包括:

  • 如果当前的内容不是定期发送的,将 periodicalIndicator 的值设置为 No。如果当前的内容是定期发送的,将值设置为 Yes
  • Research 元素中将 publicationDateTime 属性设置为 creationDateTime

按照以下步骤设置作为产品细节的一部分的关键元素:

  • <ProductCategory> 元素的 productCategory 属性设置为 PublisherDefined。将 publisherDefinedValue 设置为交换数据双方协商同意的值。
  • <ProductFocus> 元素包含关于文档的焦点的数据。将 primaryIndicator 属性设置为 Yes,表明这是产品的焦点。在这个示例中,将 focus 属性设置为 Issuer(其他产品的焦点可以按前面 RIXML 负载小节 描述的方式使用)。一般情况下,一个产品只有一个焦点。
  • <ProductName> 元素设置为产品的名称 — 通常是交换的文档的标题。

<Context> 元素中的 <EventDetails><ProductClassifications> 元素提供研究的其他细节。在需要对研究进行复杂跟踪的场景中可以使用这些元素。本教程不讲解这些元素。





回页首



前一页第 8 页,共 14 页后一页
    关于 IBM 隐私条约 联系 IBM 使用条款