<?xml version="1.0" encoding="utf-8"?>
<ManualTopic ID="/baanerp/tl/onlinemanual/event_subscriptions" xml:lang="en">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">How to subscribe to an event publishing service</Title>
		<Keyword ContextSensitive="No"><Level1>Event Publishing</Level1>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Subscribe to Event Publishing Service</Level1>
		</Keyword>
	</Header>
	<AimSection><Paragraph class="Default">This section explains how to subscribe an application to an event publishing service of an ERP LN Business Interface.</Paragraph>
	</AimSection>
	<GeneralSection ID="subscribe"><SectionTitle>Event Publishing Concept</SectionTitle>
		<Paragraph class="Default">A Business Object can publish event messages to report state changes on its instances or to request asynchronous services, such as an update, from external applications. Other applications can subscribe to these event messages. Such subscriptions are referred to as <Emphasis>Event Subscriptions</Emphasis>.</Paragraph>
		<Paragraph class="Default">An event subscription for a business object in an ERP LN company means that another application is interested in events from the company for that business object. So it doesn’t mean the specified business object will receive events, but that the specified business object will publish events, because another party is subscribed to those events.</Paragraph>
		<Paragraph class="Default">In ERP LN, business objects are represented by Business Interfaces. Two types of Business Interfaces are distinguished:</Paragraph>
		<List><ListItemHead>BDE Business Interfaces</ListItemHead>
			<ListItem><Paragraph class="Default">which are business interfaces that use BDE-specific XML messages to exchange business data.</Paragraph>
			</ListItem>
			<ListItemHead>BOD Business Interfaces</ListItemHead>
			<ListItem><Paragraph class="Default">which are business interfaces that use standard OAGIS BOD messages to exchange business data.</Paragraph>
			</ListItem>
		</List>
		<Paragraph class="Default">Although BODs for ERP LN are implemented through business objects, they are not managed in the Infor Enterprise Server user interface. Therefore, they are not discussed further here or in the session help.</Paragraph>
		<Paragraph class="Default">Standard event messages are published to spread information on state changes of business objects. Custom event messages are used to carry out an asynchronous service request on a business object of an external application.</Paragraph>
	</GeneralSection>
	<GeneralSection><SectionTitle>Event Publishing through BDE interfaces</SectionTitle>
		<Paragraph class="Default">A BDE Business Interface can publish event messages when changes occur to its instances, for example, the removal of a particular BDE object. The message indicates what has changed and this information is sent to another application. To receive event messages, the application requires a subscription to the corresponding publishing service. Applications that subscribed to an event publishing service are referred to as the <Emphasis>event consumers</Emphasis> of that particular service.</Paragraph>
		<Paragraph class="Default">The event messages are used to exchange business data with BDE Business interfaces in an XML vocabulary that is based on the BDE standard. In addition to the business data, each event message includes controlling data such as a timestamp and the event action. The event action can either be a standard action (create, change or delete) or a business object specific event action (such as approve or cancel).</Paragraph>
		<Paragraph class="Default">To receive event messages from a BDE interface on an ERP LN server, an external application must be connected to the ERP LN server through the Infor Integration infrastructure and must have taken a subscription to the involved BDE event publishing service. To create a subscription for a particular application, you must specify the name of the application as the event consumer and the address of the server that runs the application as the destination of the publishing service. This address is represented by an Infor Integration Bus Component (a communication channel specific to Infor Integration ).</Paragraph>
		<Paragraph class="Default">For more information on the ERP LN event publishing services of BDE Business Interfaces, refer to the following guides:</Paragraph>
		<List><ListItem>
                                 Infor Integration- <DocRef>Integration Guide for BDE Clients (U9051 US)</DocRef>
			</ListItem>
			<ListItem>
                                 Infor ERP LN Business Adapter- <DocRef>Developer's Guide for BODs and BDEs (U9215 US)</DocRef>
			</ListItem>
		</List>
	</GeneralSection>
	<ProcedureSection><SectionTitle>To create a subscription</SectionTitle>
		<ProcIntro><Paragraph class="Default">These steps describe how you create a subscription to a BDE event publishing service. These services are also referred to as <Emphasis>publishers</Emphasis>. The applications that receive the published event messages are referred to as the <Emphasis>event consumers</Emphasis>.</Paragraph>
		</ProcIntro>
		<Steps><Step><StepTitle>Start Event Subscription session</StepTitle>
				<Paragraph class="Default">Start the <GUIRef href="/baanerp/tl/bct/tlbct5500m000" role="session">Event Subscriptions (tlbct5500m000)</GUIRef> session from the <GUIRef href="" role="manual">Tools</GUIRef>/ <GUIRef href="" role="manual">Integration Tools</GUIRef>/ <GUIRef href="" role="manual">Event Publishing</GUIRef> menu. This session lists the current subscriptions for a particular ERP LN company.</Paragraph>
			</Step>
			<Step><StepTitle>Start Subscribe session</StepTitle>
				<Paragraph class="Default">To start the <GUIRef href="/baanerp/tl/bct/tlbct5220m000" role="session">Subscribe (tlbct5220m000)</GUIRef> session, click <GUIRef href="" role="manual">Subscribe</GUIRef> on the <GUIRef href="" role="menu">Specific</GUIRef> menu of the <GUIRef href="/baanerp/tl/bct/tlbct5500m000" role="session">Event Subscriptions (tlbct5500m000)</GUIRef> session.</Paragraph>
			</Step>
			<Step><StepTitle>Create a Subscription</StepTitle>
				<Paragraph class="Default">To create a subscription, specify the required fields of the <GUIRef href="/baanerp/tl/bct/tlbct5500m000" role="session">Event Subscriptions (tlbct5500m000)</GUIRef> session and then click <GUIRef href="" role="manual">Subscribe</GUIRef>.</Paragraph>
				<Paragraph class="Default">For more information, refer to <GUIRef href="/baanerp/tl/bct/tlbct5500m000" role="session">Event Subscriptions (tlbct5500m000)</GUIRef>.</Paragraph>
			</Step>
		</Steps>
	</ProcedureSection>
</ManualTopic>
