<?xml version="1.0" encoding="utf-8"?>
<ManualTopic ID="/baanerp/da/onlinemanual/trg_external_interface" xml:lang="en">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">External interface</Title>
		<Keyword ContextSensitive="No"><Level1>Triggering</Level1>
			<Level2>Sessions</Level2>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>i-Flow</Level1>
		</Keyword>
	</Header>
	<GeneralSection><SectionTitle>Triggering API</SectionTitle>
		<Paragraph class="Default">This section briefly describes the application programming interface (API) for Triggering.</Paragraph>
		<List><ListIntro>The Triggering API is stored in the <Emphasis>datrgapi</Emphasis> library. This library contains functions to:</ListIntro>
			<ListItem>Create a trigger</ListItem>
			<ListItem>Check whether a trigger exists to be used from the Exchange module</ListItem>
			<ListItem>Invoke a trigger</ListItem>
			<ListItem>Delete a trigger</ListItem>
		</List>
		<Paragraph class="Default">The library does not contain functions to change an existing trigger, except functions for adding components such as conditions or actions.</Paragraph>
		<GeneralSection><SectionTitle>Points of attention</SectionTitle>
			<List><ListItem>Triggers are run synchronously</ListItem>
				<ListItem>Component and attribute names cannot exceed 40 characters in length</ListItem>
			</List>
		</GeneralSection>
		<GeneralSection><SectionTitle>More information</SectionTitle>
			<Paragraph class="Default">For detailed information on the Triggering API, refer to the specifications of the <Emphasis>datrgapi</Emphasis> library.</Paragraph>
			<Paragraph class="Default">You can retrieve the library specifications from the library objects. At operating-system level, use explode6.2 to locate the library object, and subsequently use bic_info6.2 with the <GUIRef href="" role="manual">-eu</GUIRef> options.</Paragraph>
			<Paragraph class="Default">For example:</Paragraph>
			<Paragraph class="Default"><Code>$ explode6.2 odatrgevent</Code>
			</Paragraph>
			<Paragraph class="Default"><Code>/mybse/application/myvrc/odatrg/otrgevent</Code>
			</Paragraph>
			<Paragraph class="Default"><Code>$ bic_info6.2 –eu /mybse/application/myvrc/odatrg/otrgevent</Code>
			</Paragraph>
			<Paragraph class="Default">This shows the documentation of the event handling functions.</Paragraph>
			<List><ListIntro>This method provides the following:</ListIntro>
				<ListItem>Prototypes, including the function name and type and parameters and their types, of the functions in the library</ListItem>
				<ListItem>A description of the functions and their input and output</ListItem>
				<ListItem>The preconditions and post-conditions.</ListItem>
			</List>
		</GeneralSection>
	</GeneralSection>
</ManualTopic>
