<?xml version="1.0" encoding="utf-8"?>
<Session ID="/baanerp/tl/bct/tlbct5220m000" xml:lang="en">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Subscribe (tlbct5220m000)</Title>
		<Keyword ContextSensitive="No"><Level1>Event Subscriptions</Level1>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Subscriptions to Events</Level1>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>BDE Events</Level1>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Business Object Events</Level1>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Publish and Subscribe</Level1>
		</Keyword>
	</Header>
	<HelpTopic xml:lang="en"><AimSection><Paragraph class="Default">
                                 Use this session to create or modify event subscriptions.</Paragraph>
		</AimSection>
		<GeneralSection><Paragraph class="Default">You start this session from the <GUIRef href="" role="manual">Specific</GUIRef> menu of the <GUIRef href="/baanerp/tl/bct/tlbct5500m000" role="session">Event Subscriptions (tlbct5500m000)</GUIRef> session.</Paragraph>
			<Paragraph class="Default">For information on the filter that can be used in the subscription, refer to the Infor Integration- <DocRef>Integration Guide for BDEs (U9051 US)</DocRef>.</Paragraph>
		</GeneralSection>
		<Caution><SectionTitle>
                                 Caution!
                              </SectionTitle>
			<Paragraph class="Default"><Emphasis>You must not overwrite subscriptions that are managed from outside ERP LN.</Emphasis>
			</Paragraph>
			<Paragraph class="Default">Subscriptions on BDE Business Interfaces can be managed from outside ERP LN, using the SubscribeEvent method of the BDE interface. Using the <GUIRef href="/baanerp/tl/bct/tlbct5220m000" role="session">Subscribe (tlbct5220m000)</GUIRef> session, you can overwrite these external subscriptions. You are advised not to maintain subscriptions through both the SubscribeEvent method and the Subscribe session.</Paragraph>
		</Caution>
	</HelpTopic>
	<Fields><FieldHelp ID="company"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Company</Title>
			</Header>
			<FuncDesc>The number of the ERP LN company containing the business object that provides the event publishing service.</FuncDesc>
			<AllowedValues><SectionTitle>
                                    Allowed values
                                 </SectionTitle>
				<Paragraph class="Default">The company number is mandatory and must be a whole number in the range from 0 to 999.</Paragraph>
			</AllowedValues>
		</FieldHelp>
		<FieldHelp ID="bde.name"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Business Object Name</Title>
			</Header>
			<FuncDesc>The name of the business object that provides the event publishing service, for example SalesOrder. The subscription will be created for this business object.</FuncDesc>
			<SimpleSection></SimpleSection>
			<AllowedValues><SectionTitle>
                                    Allowed values
                                 </SectionTitle>
				<Paragraph class="Default">This field is mandatory. To specify a value, zoom to the <GUIRef href="/baanerp/tt/adv/ttadv7501m000" role="session">Business Objects (ttadv7501m000)</GUIRef> session and select in this session a business object. This session only shows the public business objects of the current VRC. To specify a private business object, enter the name of the business object directly in the field.</Paragraph>
				<Paragraph class="Default"><Emphasis>The <GUIRef href="/baanerp/tt/adv/ttadv7501m000" role="session">Business Objects (ttadv7501m000)</GUIRef> session can contain business objects that are not suited for event publishing, because they do not have a SubscribeEvent and a PublishEvent method.</Emphasis>
				</Paragraph>
			</AllowedValues>
		</FieldHelp>
		<FieldHelp ID="event.actions.yn"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Select Standard Event Actions</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, the subscription uses all standard event actions of the selected business object.</FuncDesc>
			<SimpleSection><Paragraph class="Default">These standard or default event actions are the standard events according to the BDE specification (that is, create, change and delete) (see <GUIRef href="" role="manual">Event Actions</GUIRef> ).</Paragraph>
			</SimpleSection>
			<DefaultValue><SectionTitle>
                                    Default value
                                 </SectionTitle>
				<Paragraph class="Default">By default, the check box is selected.</Paragraph>
			</DefaultValue>
		</FieldHelp>
		<FieldHelp ID="event.actions.txt"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Event Actions</Title>
			</Header>
			<FuncDesc>The actions that can be performed on the selected business object and that trigger an event. These actions can include standard event actions or custom event actions.</FuncDesc>
			<SimpleSection><Paragraph class="Default">The standard event actions consist of the invocation of standard methods Create, Change and Delete, as explained in the following paragraphs.</Paragraph>
			</SimpleSection>
			<SimpleSection><Paragraph class="Default">For the BDE Business Interfaces changes in the state of a business object instance produce events by default. These changes are referred to as standard event actions and correspond to the standard business object methods <Code>create</Code>, <Code>change</Code> and <Code>delete</Code>.</Paragraph>
			</SimpleSection>
			<AllowedValues><SectionTitle>
                                    Allowed values
                                 </SectionTitle>
				<Paragraph class="Default">A list of one or more event actions for the selected business object. The event action names must be separated by spaces. You must select at least one event action.</Paragraph>
				<Paragraph class="Default"></Paragraph>
				<Paragraph class="Default">The default event actions are:</Paragraph>
				<List><ListItem><Code>create</Code>
					</ListItem>
					<ListItem><Code>change</Code>
					</ListItem>
					<ListItem><Code>delete</Code>
					</ListItem>
				</List>
				<Paragraph class="Default">Note that these event action values are case-sensitive.</Paragraph>
			</AllowedValues>
		</FieldHelp>
		<FieldHelp ID="selection.yn"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Select All Attributes</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, the published event messages will contain data from all components and attributes of the selected business object.</FuncDesc>
			<SimpleSection><Paragraph class="Default">Which business data is published will depend on the selected business object.</Paragraph>
			</SimpleSection>
			<DefaultValue><SectionTitle>
                                    Default value
                                 </SectionTitle>
				<Paragraph class="Default">By default, the check box is selected.</Paragraph>
			</DefaultValue>
		</FieldHelp>
		<FieldHelp ID="selection.txt"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Component/Attribute Selection</Title>
			</Header>
			<FuncDesc>The business data (components and attributes) that are included in the published event messages.</FuncDesc>
			<AllowedValues><SectionTitle>
                                    Allowed values
                                 </SectionTitle>
				<Paragraph class="Default">A list of one or more attributes or components of the selected business object. The attribute or component names must be separated by spaces or new line characters. You must select at least one attribute.</Paragraph>
				<Paragraph class="Default">The selections are the same as the ‘selectionAttribute’ contents in the BDE List and Show methods. Therefore, you can use &lt;Component&gt;.&lt;Attribute&gt; or &lt;Component&gt;.&lt;Group&gt;.&lt;Attribute&gt;, or you can use a ‘*’ to select multiple attributes from the same component or attribute group. The following values illustrate how you can specify a selection:</Paragraph>
				<List><ListItem><Code>Order.date</Code> <Emphasis>(only the order date)</Emphasis>
					</ListItem>
					<ListItem><Code>Order.Line.PriceData.*</Code> <Emphasis>(the complete contents of the PriceData group in the Line component)</Emphasis>
					</ListItem>
					<ListItem><Code>Order.*</Code> <Emphasis>(all attributes from the Order component, but the Line subcomponent will not be included)</Emphasis>
					</ListItem>
				</List>
			</AllowedValues>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<Paragraph class="Default">If at least one attribute is selected, then the identifiers from the component and its parent components are also selected. For example, if you select <Code>Order.Line.Item</Code>, then also <Code>Order.Line.LineNumber</Code> and <Code>Order.OrderNumber</Code> are selected.</Paragraph>
			</Note>
		</FieldHelp>
		<FieldHelp ID="filter.yn"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Select All Instances</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, no filter is applied and the specified business object publishes event messages for all its instances.</FuncDesc>
			<DefaultValue><SectionTitle>
                                    Default value
                                 </SectionTitle>
				<Paragraph class="Default">By default, the check box is selected.</Paragraph>
			</DefaultValue>
		</FieldHelp>
		<FieldHelp ID="filter.txt"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Instance Filter (XML)</Title>
			</Header>
			<FuncDesc>The filter that determines for which instances event messages are published. The filter is in an XML format that is specific to ERP LN and that conforms to the BDE standards of ERP LN. Only the object or component instances that pass through this filter are includes in the event messages.</FuncDesc>
			<SimpleSection><Paragraph class="Default">The following XML code represents an example of an filter for the logical expression for numerical attributes A, B, C and D:</Paragraph>
				<Paragraph class="Default"><Code>((A&gt;10) AND ((B=1) OR (B=2)) AND (C&gt;D)</Code>:</Paragraph>
				<Figure space-and-orientation="indented-estimated"><HTML:IMG height="567" width="567" SRC="../images/filter_example.gif" path="/enterpriseserver/tools/tl/tlbct" btb-count="1" btb-count2="1" btb-image-name="filter_example.gif" btb-source-path="C:\SVN\docnl\Technology\EnterpriseServer~8.5\EnterpriseServer" btb-image-path="/enterpriseserver/tools/tl/images/filter_example.gif" ID="IDA3TBAC" alt="[...]" xmlns:HTML="http://www.w3.org/TR/REC-html40"/></Figure>
			</SimpleSection>
			<AllowedValues><SectionTitle>
                                    Allowed values
                                 </SectionTitle>
				<Paragraph class="Default">An XML document that complies to the BDE filter specifications.</Paragraph>
			</AllowedValues>
		</FieldHelp>
		<FieldHelp ID="destination"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Destination</Title>
			</Header>
			<FuncDesc>The address of the event consumer to which the event message must be sent.</FuncDesc>
			<SimpleSection><Paragraph class="Default">The destination consists of a Bus Component that represents an Infor Integration back end. On this back end, the enterprise application runs that consumes the event messages. The name of this application is specified in the <GUIRef href="/baanerp/tl/bct/tlbct5220m000#event.consumer" role="manual" Update="No">Event Consumer</GUIRef> field.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="event.consumer"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Event Consumer</Title>
			</Header>
			<FuncDesc>The name of the event consumer application, as specified in the event messages published by BDE Business Interfaces.</FuncDesc>
			<SimpleSection></SimpleSection>
			<AllowedValues><SectionTitle>
                                    Allowed values
                                 </SectionTitle>
				<Paragraph class="Default">An ASCII text.</Paragraph>
				<Paragraph class="Default">This field is mandatory.</Paragraph>
			</AllowedValues>
		</FieldHelp>
	</Fields>
	<FormCommands><CommandHelp ID="execute.subscribe"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Subscribe</Title>
			</Header>
			<FuncDesc>Creates a subscription in the specified ERP LN company, as indicated by the settings you entered in the current session.</FuncDesc>
			<SimpleSection><Paragraph class="Default">After you clicked <GUIRef href="" role="manual">Subscribe</GUIRef>, ERP LN reports whether the subscription succeeded or failed.</Paragraph>
				<Paragraph class="Default">Subscriptions only take effect after you restart the bshell. This is necessary to activate the subscription's auditing profile. To restart the bshell, you must log out from the ERP LN application and log on again. When you use Webtop, for example, you simply restart the Webtop service.</Paragraph>
			</SimpleSection>
		</CommandHelp>
	</FormCommands>
</Session>
