<?xml version="1.0" encoding="utf-8"?>
<Session ID="/baanerp/da/trg/datrg1225m000" xml:lang="en">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Configure XML File Action (datrg1225m000)</Title>
	</Header>
	<HelpTopic xml:lang="en"><AimSection><Paragraph class="Default">
                                 Use this session to enter the settings for XML files to be created by a trigger.</Paragraph>
		</AimSection>
		<GeneralSection><Paragraph class="Default">This session is started via the <GUIRef href="/baanerp/da/trg/datrg1100m000#exec.user.2" role="command">Configure Actions...</GUIRef> command in the <Link href="/baanerp/da/trg/datrg1100m000" role="session">Triggers (datrg1100m000)</Link> session (if <GUIRef href="/baanerp/da/trg/datrg1100m000#datrg100.actt" role="manual">Action Template</GUIRef> = Create XML File).</Paragraph>
			<ProcedureList><ListIntro>To configure an XML file action:</ListIntro>
				<ListItem>Specify the action settings by filling in the fields in this dialog. You must specify directory paths, the transfer type, the target host name, and so on. Refer to the online field help for details.</ListItem>
				<ListItem>Optionally, run the <GUIRef href="" role="manual">Transform. Script...</GUIRef> command. This will start the text editor where you can enter a transformation script, if required. For more information, refer to <Link href="/baanerp/da/onlinemanual/000304" role="manual">Transformation script</Link>.</ListItem>
				<ListItem>Specify a password, in a separate dialog, for XML File Actions with <GUIRef href="/baanerp/da/trg/datrg1225m000#datrg125.ftpt" role="manual">File Transfer Type</GUIRef> = Standard FTP. The <Link href="/baanerp/da/trg/datrgpwd" role="session">Enter Password (datrgpwd )</Link> dialog is started automatically when you save the XML file action. You can also manually start this dialog through the <GUIRef href="" role="manual">Change Password...</GUIRef> command.</ListItem>
			</ProcedureList>
			<Paragraph class="Default">When you save an XML File Action based on standard FTP, the system checks whether a file transfer can be done using the specified parameters. A message is displayed if this check fails.</Paragraph>
			<List><ListIntro>When you use the Create XML file action, the following will happen at runtime:</ListIntro>
				<ListItem>If available, the transformation script is executed.</ListItem>
				<ListItem>Then a unique filename is generated and the XML code is written to the file in the specified local path.</ListItem>
				<ListItem>Finally, a file transfer, if defined, is performed.</ListItem>
			</List>
			<GeneralSection><SectionTitle>Points of attention</SectionTitle>
				<Paragraph class="Default">To be able to use this functionality successfully:</Paragraph>
				<Paragraph class="Default">The target host and path must be available and an ftp daemon must be running on the target host.</Paragraph>
				<Paragraph class="Default">The ftp daemon must be installed at a known port, specified in the etc/services file on the same system where the Bshell is running.</Paragraph>
				<Paragraph class="Default">The location of the etc/services file is platform dependent.</Paragraph>
				<Paragraph class="Default">Support of user name 'anonymous' and/or 'ftp' depends on how the ftp daemon on remote host is configured.</Paragraph>
				<Paragraph class="Default">If the standard file transfer is used, the file is moved in binary mode, because a standard ASCII transfer may not be available on every platform. You can realize an ASCII transfer by customizing the generated program.</Paragraph>
				<Paragraph class="Default">Also note that no formatting is done, so the difference between Unix and Windows environments (regarding carriage return and linefeed) is irrelevant.</Paragraph>
				<Paragraph class="Default">When a specific program is selected for file transfer, the system only checks whether the specified File Transfer Program file exists.</Paragraph>
			</GeneralSection>
			<GeneralSection><SectionTitle>Notes on performance</SectionTitle>
				<Paragraph class="Default">The 'create XML file' action is not suitable for very high volumes. This is explained below. Note that the figures mentioned here are only used as an indication and they will differ depending on the specific situation.</Paragraph>
				<Paragraph class="Default">Assume you have an Exchange scheme that exports 5,000 rows per minute to a file. Instead of writing a file, you create events and invoke a trigger for each event.</Paragraph>
				<Paragraph class="Default">If the trigger doesn't have an action implemented, the speed will be comparable to the original speed. But if you define a 'create XML file' action for the trigger, the speed will be reduced to, for example, 350 events per minute. And if you additionally use a file transfer, the speed will drop further to, for example, 25 events per minute.</Paragraph>
				<Paragraph class="Default">Note that the 'create XML file' action creates one file per event, so the overhead is relatively high. Also note that if the files are not picked up, processed and deleted by another application, the number of files in the directory will gradually increase, which will also impact performance.</Paragraph>
			</GeneralSection>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<Paragraph class="Default">This session is a modal dialog. When you leave this session and return to the <GUIRef href="/baanerp/da/trg/datrg1100m000" role="session">Triggers (datrg1100m000)</GUIRef> session, the trigger program is regenerated automatically, if the action settings were changed.</Paragraph>
			</Note>
		</GeneralSection>
		<RelatedTopics><SectionTitle>
                                 Related topics
                              </SectionTitle>
			<RelTopic><Link href="/baanerp/da/onlinemanual/000300" role="manual">Triggering</Link>
			</RelTopic>
		</RelatedTopics>
	</HelpTopic>
	<Fields><FieldHelp ID="datrg125.path"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Local Path</Title>
			</Header>
			<FuncDesc>The folder or directory that is used to store the trigger files that are created.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="datrg125.ftpt"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">File Transfer Type</Title>
			</Header>
			<FuncDesc>The type of file transfer that must be done. The following options are available:</FuncDesc>
			<SimpleSection><List><ListItem>None: after the file is created in the Local Path, no further action is done.</ListItem>
					<ListItem>Standard FTP: the file is moved using a standard FTP program.</ListItem>
					<ListItem>Specific Program: a user-defined program on the operating system is invoked. You must specify this program in the <GUIRef href="/baanerp/da/trg/datrg1225m000#datrg125.ftpr" role="manual">File Transfer Program</GUIRef> field.</ListItem>
				</List>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="datrg125.ftpr"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">File Transfer Program</Title>
			</Header>
			<FuncDesc>You can only edit this field if the <GUIRef href="/baanerp/da/trg/datrg1225m000#datrg125.ftpt" role="manual">File Transfer Type</GUIRef> = 'Specific Program'.</FuncDesc>
			<SimpleSection><Paragraph class="Default">You can enter a program name of an operating system program (such as a batch script or an executable). You can use this script for example to copy the created XML file to another system. At runtime, the file transfer program is invoked with one parameter, viz. the file name (including path) of the local XML trigger file.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="datrg125.host"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Host Name</Title>
			</Header>
			<FuncDesc>The host (system) where the file should be transferred to. You can only edit this field if <GUIRef href="/baanerp/da/trg/datrg1225m000#datrg125.ftpt" role="manual">File Transfer Type</GUIRef> = Standard FTP.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="datrg125.user"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">User Name</Title>
			</Header>
			<FuncDesc>The user (account) name to be used for the standard FTP. You can only edit this field if <GUIRef href="/baanerp/da/trg/datrg1225m000#datrg125.ftpt" role="manual">File Transfer Type</GUIRef> = Standard FTP. You must enter the password for the specified user in a separate dialog.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="datrg125.tpat"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Target Path</Title>
			</Header>
			<FuncDesc>The path, on the target host, the file should be transferred to. This path is used by the standard FTP solution, or as the third parameter for the File Transfer Program.</FuncDesc>
			<SimpleSection><Paragraph class="Default">How to refer to a path on the target system may depend on the FTP setup on that system. Not all paths may be 'visible' and an alias may be used to refer to a specific location in the file system. For example, C:\Workflow\Data\Triggers may have to be referred to as 'workflow-triggers'.</Paragraph>
			</SimpleSection>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<Paragraph class="Default">You can leave this field empty, if the target path is coded in the specific file transfer program.</Paragraph>
			</Note>
			<SimpleSection><Paragraph class="Default">You can only edit this field if <GUIRef href="/baanerp/da/trg/datrg1225m000#datrg125.ftpt" role="manual">File Transfer Type</GUIRef> = Standard FTP.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="datrg125.delf"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Delete Local File after Transfer</Title>
			</Header>
			<FuncDesc>If you select this check box, the local file is deleted automatically after the transfer is completed.</FuncDesc>
			<SimpleSection><Paragraph class="Default">Only clear this check box if you want to keep all XML files (not recommended!) or if the specific File Transfer Program takes care of removing the local file.</Paragraph>
				<Paragraph class="Default">You can not edit this field if <GUIRef href="/baanerp/da/trg/datrg1225m000#datrg125.ftpt" role="manual">File Transfer Type</GUIRef> = None.</Paragraph>
			</SimpleSection>
		</FieldHelp>
	</Fields>
</Session>
