Step 5: Promote Schema Properties
In this step, you promote schema properties so that a BizTalk Server orchestration can reference those property values that you create in later steps. Promotion is a mechanism that you use to reference a specific value within a message instance and make it accessible to BizTalk Server components such as orchestration or for content-based routing purposes. Additionally, a promoted property is visible by Microsoft IntelliSense in the Expression Editor of Visual Studio.
Note
BTAHL7 auditing and logging functionality with the BizTalk Health and Activity Tracking (HAT) tool can track only promoted schema properties.
To promote schema properties
In Solution Explorer, under BTAHL7 Project, double-click the DoorBell.xsd node to open the schema.
Right-click the FirstName field element, point to Promote, and then click Quick Promotion.
Click OK to add the property schema to the project.
Note
Visual Studio adds an orange circle to the icon for the FirstName element, indicating that the element has been promoted.
Repeat these steps to promote the following field elements:
MiddleName
LastName
SSN
Important
It is important to note that promoting a patient ID (PID) such as a social security number (SSN) causes BTAHL7 to track that property for every inbound message through the system. The side effect of this situation is that the message-tracking database keeps a copy of patient SSNs. This can create a significant security issue. You must either protect this data store with extreme care or avoid the promotion of PID data completely.
For more information about tracking documents based on the schema elements that you promoted, see BizTalk Server Help for information on Health and Activity Tracking.
Proceed to Step 6: Validate the Schemas.