<Source> 元素
<Source> 元素捕捉 RIXML 交换参与方的联系信息。在不同的 RIXML 交换场景中，每个场景的 RIXML 通道两边都各有一个所有者。产品内部的 <Source> 元素捕捉关于所有者的信息。清单 2 给出了 <Source> 元素的 XML 块示例。
清单 2. <Source> 元素
<Source>
<Organization sequence="1" primaryIndicator="Yes" type="PublisherDefined">
<PublisherDefinedValue>IBM</PublisherDefinedValue>
<OrganizationID idType="IBM">IBM</OrganizationID>
<OrganizationName nameType="Display">
International Business Machines</OrganizationName>
<PersonGroup personGroupID="IBM_BANKING" primaryIndicator="Yes" sequence="1"
role="Sponsor">
<Name>IBM Banking Group</Name>
<PersonGroupMember sequence="1" primaryIndicator="Yes" role="Author">
<Person personID="111">
<JobRole>Analyst</JobRole>
<FamilyName>Smith</FamilyName>
<GivenName>James</GivenName>
<DisplayName>James Smith</DisplayName>
<JobTitle>Analyst</JobTitle>
<Division>Banking</Division>
<ContactInfo nature="Business">
<Email>James.smith@ibm.com</Email>
<Phone type="Voice" location="Office">
<CountryCode>001</CountryCode>
<Number>201.555.1020</Number>
</Phone>
<Address>
<AddressLine1> 1 New Orchard Road</AddressLine1>
<AddressLine2>Suite 100</AddressLine2>
<City>Armonk</City>
<StateProvince>NY</StateProvince>
<PostalCode>10504</PostalCode>
<Country>USA</Country>
</Address>
</ContactInfo>
</Person>
</PersonGroupMember>
</PersonGroup>
</Organization>
<Organization sequence="2" primaryIndicator="Yes" type="PublisherDefined">
<PublisherDefinedValue>APPERA</PublisherDefinedValue>
<OrganizationID idType="VENDOR">APPERA</OrganizationID>
<OrganizationName nameType="Display">
Appera Software Private Ltd.</OrganizationName>
<PersonGroup personGroupID="APP_BANKING" primaryIndicator="Yes" sequence="1"
role="Author">
<Name>Appera Banking Group</Name>
<PersonGroupMember sequence="1" primaryIndicator="Yes" role="Author">
<Person personID="N/A">
<JobRole>Analyst</JobRole>
<FamilyName>Dubagunta</FamilyName>
<GivenName>Saikumar</GivenName>
<MiddleName>V</MiddleName>
<DisplayName>Saikumar V Dubagunta</DisplayName>
<JobTitle>Analyst</JobTitle>
<Division>Banking</Division>
<ContactInfo nature="Business">
<Email>sai@appera.com</Email>
<Phone type="Voice" location="Office">
<CountryCode>001</CountryCode>
<Number>972-555-1000</Number>
</Phone>
<Address>
<AddressLine1>8232</AddressLine1>
<AddressLine2>Fountain Ridge Dr.</AddressLine2>
<City>Plano</City>
<StateProvince>Texas</StateProvince>
<PostalCode>75025</PostalCode>
<Country>USA</Country>
</Address>
</ContactInfo>
</Person>
</PersonGroupMember>
</PersonGroup>
</Organization>
</Source>
|
<Organization> 元素
<Source> 内部的关键元素是 <Organization> 元素。这个元素通常拥有两个实例 — 一个用于接收组织，一个用于发送组织。第一个 <Organization> 元素必须包含接收组织的详细信息。sequence 属性的值通常设为 1，表明它是接收组织。2 表示发送组织。primaryIndicator 表示这个条目是不是接收组织信息的主条目，并且值为 Yes。值 Yes 也用于序号为 2 的条目，表明它是发送组织的主条目。在这个示例中，type 设置为 PublisherDefined，因为发布者已经商量并定义好格式。将值设置为 PublisherDefined 适用于大多数组织，因为这些值是由接收和发送组织商议决定的。
按照以下步骤在接收组织中设置不同的元素：
- 通常不使用
<LogoURL> 元素。不过 logo 有一个可用的公共 URL；如果双方同意使用，可以在此设置 URL 的值。
-
<PublisherDefinedValue> 元素必须设置为双方达成一致的值。这通常是一个短字符串，比如 “MXFT” 和 “XYZ”，或类似于身份识别中的标识符。这个值可以是一个接收者给每个发送实体的标识符，用于帮助路由文档。这个元素充当一种简单的身份验证机制。
-
<OrganizationID> 必须包含接收组织的惟一 ID。<idType> 由组织协商决定。在这个示例中，值 IBM 是接收组织的 idType，值 VENDOR 是发送组织的 idType。
-
<OrganizationName> 通常包含在 Web 站点中显示的组织的名称。同样，将 nameType 属性设置为 Display。不过，nameType 还可以设置为以下其他值：
Legal。组织的法定名称
Local。在某个城市或国家中使用的当地名称
Parent。组织的总公司名称
<PersonGroup> 元素
<PersonGroup> 元素表示接收 RIXML 传输的人员。sequence 属性设置为 1，表明它是第一个元素。primaryIndicator 属性设置为 Yes，表示这是主要的组。role 属性设置为 Sponsor，表示该组包含研究发起者。将 role 的值设置为发送组织的 Author。
RIXML 支持 role 属性采用以下值：
AuthorPublisherHostSponsorCoordinatorAttendeeParticipantSpeakerSalesContactIRContactPublisherDefined
如果适合的话，还可以采用其他值。如果要将文档传输给不同组中的多个接收者，则可以包含多个 <PersonGroup> 实例。大多数情况下只使用一个 <PersonGroup>。
与名称相关的元素
<PersonGroup> 内部中的 <Name> 元素包含接收者所在的组的名称。它可以采用非常简单的值，比如 Derivatives Group 或 Banking Group。在 <PersonGroup> 的内部为每个接收者创建一个 <Person> 元素。
将 <Person> 元素的 personId 属性设置为惟一的人员标识符，比如公司内部某位职员的 ID。在某些情况下，公司策略不允许跨组织共享职员标识符。对于这些情况，可以将职员的电话号码用作 personId。一些组织还为接收特定合作伙伴的传输文档的人员生成特殊的标识符。然后，接收应用程序将这些特殊的标识符映射到内部职员标识符。一些组织忽略这个属性的值。
<Person> 元素内部的 <JobRole> 元素包含一个自由字符串。它可以是任意字符串，比如 Analyst、Strategist、Economist 或 Others。最常用的值是 Analyst。
<FamilyName> 元素的值设置为接收传输文档的人员的姓。例如，Smith。<GivenName> 元素的值设置为接收传输文档的人员的名。例如，Paul。<MiddleName> 元素设置为接收传输文档的人员的中间名首字母（如果有的话）。例如，J。如果没有中间名，则可以忽略该元素。<DisplayName> 元素的值必须设置为 <FirstName> <MiddleName> <LastName>。
与工作相关的元素
<JobTitle> 设置为接收传输文档的人员的工作头衔。<Division> 元素设置为接收传输文档的人员所在的部门。例如，Banking 或 Retail。
与联系信息相关的元素
必须在 <ContactInfo> 元素中提供接收传输文档的人员的联系信息。<ContactInfo> 元素的 nature 属性必须设置为 Business。
如果接收人员拥有即时消息 ID，那么在 <ContactInfo> 的 <InstantMessenger> 元素中提供该信息。例如，xyz@yahoo.com。如果没有即时消息 ID，可以忽略该元素。
在 <ContactInfo> 的 <Email> 元素中提供接收人员的电子邮件地址。<Phone> 元素包含接收者的电话信息。将 type 属性设置为 Voice。如果有传真号码，则可以将电话类型设置为 Fax；如果有传呼机号码，则可以设置为 Pager。将 location 属性设置为 Office；根据不同类型的电话，可以将电话设置为 Home 或 Mobile。将 <CountryCode> 元素的值设置为接收者的国家代码。例如美国为 001。将 <Number> 元素设置为接收者的电话号码。如果接收者使用的是分机，则在 extensionPIN 中提供号码。
<ContactInfo> 元素中的 <Address> 元素必须包含接收者的邮政地址。<AddressLine1> 元素是必须存在的。如果有必要，可以使用 <AddressLine2> 至 <AddressLine5>。<City> 元素必须包含邮政地址所在的城市。例如 New York。<StateProvince> 必须包含邮政地址所在的州或省份。例如，NY。<PostalCode> 元素必须包含邮政编码。例如，20000。<Country> 必须包含邮政地址所在的国家。例如，USA。
注意：<Organization> 元素必须具有第二个实例，用于表示发送研究文档的组织和负责创建研究文档的分析师的详细信息。其中许多元素的值和意义与接收组织中的元素是一样的。常见的差异是：
- 对于发送组织，
sequence 的值是 2，primaryIndicator 设置为 Yes，并且 idType 也设置为一个商议值。在这个示例中，还使用了值 VENDOR。
-
PersonGroup role 属性设置为 Author。
-
Person JobRole 属性设置为 Author 或 Analyst，发送组织可以自行选择。
| 
