|  | <Context> 元素
<Context> 元素包含关于传输的研究文档的上下文的数据。它有两个属性:external 和 priority。external 属性必须设置为 No。priority 属性设置为 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> 的值。如前所述,可以使用其他名称类型,比如 Legal、Local 和 Parent。
如果研究由一个或多个发起者共同生成,则将所需的 <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> 元素提供研究的其他细节。在需要对研究进行复杂跟踪的场景中可以使用这些元素。本教程不讲解这些元素。
|  |
|