<?xml version="1.0" encoding="utf-8"?>
<Session ID="/baanerp/tt/adv/ttadv7113m000" xml:lang="en">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Business Object Method Arguments (ttadv7113m000)</Title>
	</Header>
	<HelpTopic xml:lang="en"><AimSection><Paragraph class="Default">
                                 Use this session to define the arguments that are required for the methods of a <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link>.</Paragraph>
		</AimSection>
		<GeneralSection><Paragraph class="Default">Each method requires arguments. Per method, you can generate a list of all possible arguments. If the method for which you generate arguments is a <GUIRef href="/baanerp/tt/domains/adv.stmd#specific" role="option">Specific</GUIRef> method, you can modify the argument properties. If the method is a <GUIRef href="/baanerp/tt/domains/adv.stmd#standard" role="option">Standard</GUIRef> method, you cannot modify the properties of the arguments, but only delete the generated arguments you do not require.</Paragraph>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<List><ListIntro>This session is used for the arguments of both public methods and protected methods:</ListIntro>
					<ListItem>For protected methods, the arguments are protected attributes of the business object, that are displayed in the session directly. For example: businessPartnerCode, address and affiliatedSite.</ListItem>
					<ListItem>For public methods, the arguments displayed are always the standard arguments Request, Response, and Result. The attributes, which are the actual arguments, are specified in the XML Schema file that is the content of the Response argument.</ListItem>
				</List>
			</Note>
			<GeneralSection><SectionTitle>XML Schema Files</SectionTitle>
				<Paragraph class="Default">If you generate a public method or save a public method you created manually, XML Schema Files are generated for the arguments (Request, Response and Result) of that method. These files actually store the arguments. Through the <GUIRef href="" role="manual">Generate XML Schema</GUIRef> command in the <GUIRef href="" role="menu">Specific</GUIRef> menu, you can fill these empty XML Schema files with the business object's public attributes . After generation, you must edit these files manually, because not everything can be generated automatically.</Paragraph>
				<Paragraph class="Default">An empty XML Schema file has the following structure:</Paragraph>
				<Formula space-and-orientation="indented-estimated"><Paragraph class="Default">&lt;xs:element name="Request"&gt;
  &lt;xs:complexType/&gt;
&lt;/xs:element&gt;</Paragraph>
				</Formula>
				<Paragraph class="Default">Refer to the following Help topic for more information: <Link href="/baanerp/tt/onlinemanual/100106" role="manual">To edit XML Schema Files (BOR)</Link>.</Paragraph>
			</GeneralSection>
		</GeneralSection>
		<GeneralSection><SectionTitle>Prerequisites</SectionTitle>
			<List><ListIntro>The following entities must already exist:</ListIntro>
				<ListItem>A business object method.</ListItem>
				<ListItem>Attributes for the business object or the component.</ListItem>
			</List>
		</GeneralSection>
	</HelpTopic>
	<Fields><FieldHelp ID="imp.name"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Business Object</Title>
			</Header>
			<FuncDesc>The name of the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link>.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="imp.code"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Business Object Code</Title>
			</Header>
			<FuncDesc>The code of the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link>, which consists of the <Link href="/baanerp/tt/glossary/glossary#000000000000008" role="glossary">package</Link> code, the <Link href="/baanerp/tt/glossary/glossary#100004" role="glossary">module</Link> code, and the business object code that is defined in the <GUIRef href="/baanerp/tt/adv/ttadv7500m000#ttadv700.impl" role="manual">Business Object</GUIRef> field of the <GUIRef href="/baanerp/tt/adv/ttadv7500m000" role="session">Business Objects (ttadv7500m000)</GUIRef> session.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="impl.desc"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Business Object</Title>
			</Header>
			<FuncDesc>The description of the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link>.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv713.vers"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">VRC</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/glossary/glossary#000000000000009" role="glossary">version</Link> of the <Link href="/baanerp/tt/glossary/glossary#000000000000008" role="glossary">package</Link> for which the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link> is defined.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv713.rele"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">VRC</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/glossary/glossary#000000000000010" role="glossary">release</Link> of the <Link href="/baanerp/tt/glossary/glossary#000000000000008" role="glossary">package</Link> for which the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link> is defined.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv713.cust"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">VRC</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/glossary/glossary#000000000000011" role="glossary">customer</Link> of the <Link href="/baanerp/tt/glossary/glossary#000000000000008" role="glossary">package</Link> for which the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link> is defined.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="vrc.desc"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">VRC</Title>
			</Header>
			<FuncDesc>The description of the <Link href="/baanerp/tt/glossary/glossary#100016" role="glossary">VRC</Link>.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv713.comp"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Component</Title>
			</Header>
			<FuncDesc>The name of the component to which the method belongs.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv713.meth"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Method</Title>
			</Header>
			<FuncDesc>The name of the method.</FuncDesc>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<Paragraph class="Default">You can only modify argument properties for <GUIRef href="/baanerp/tt/domains/adv.stmd#specific" role="option">Specific</GUIRef> methods. For <GUIRef href="/baanerp/tt/domains/adv.stmd#standard" role="option">Standard</GUIRef> methods you can only delete the generated arguments that you do not require. Whether a method is a standard method or a specific method, is defined in the <GUIRef href="/baanerp/tt/adv/ttadv7112m100" role="session">Protected Methods (ttadv7112m100)</GUIRef> session for protected methods, and in the <GUIRef href="/baanerp/tt/adv/ttadv7112m000" role="session">Public Methods (ttadv7112m000)</GUIRef> session for public methods.</Paragraph>
			</Note>
		</FieldHelp>
		<FieldHelp ID="ttadv713.mtpe"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Method Type</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/domains/adv.mtpe" role="domain">Type of Business Object Method</Link>.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv713.argu"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Argument</Title>
			</Header>
			<FuncDesc>The argument of the method.</FuncDesc>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<Paragraph class="Default">For protected methods, the arguments, are protected attributes of the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link>, that are displayed in the session directly. For example: businessPartnerCode, address and affiliatedSite.</Paragraph>
				<Paragraph class="Default">For public methods, the arguments displayed are always the standard arguments Request, Response, and Result. The attributes, which are the actual arguments, are specified in the XML Schema file that is the content of the Response argument.</Paragraph>
			</Note>
		</FieldHelp>
		<FieldHelp ID="ttadv713.argt"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Input/Output</Title>
			</Header>
			<FuncDesc>Indicates whether the argument is used for input or output.</FuncDesc>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<Paragraph class="Default">Attributes that are defined as <GUIRef href="/baanerp/tt/adv/ttadv7104m000#ttadv704.za_reon" role="manual">Read-only</GUIRef> or <GUIRef href="/baanerp/tt/adv/ttadv7104m000#ttadv704.za_idnf" role="manual">Identifier</GUIRef> in the <GUIRef href="/baanerp/tt/adv/ttadv7104m000" role="session">Protected Attributes (ttadv7104m000)</GUIRef> session are not allowed as input arguments.</Paragraph>
			</Note>
			<Important><SectionTitle>
                                    Important!
                                 </SectionTitle>
				<Paragraph class="Default">Input and output are here related to the operation of the argument. An argument accepts input or delivers output. Therefore, input and output do not indicate the function of the argument in the method, which is quite the reverse. An argument that delivers output, can be input for the method, and an argument that accepts input can be used for the output of the method.</Paragraph>
				<List><ListIntro>Some examples, based on the protected methods of the Address business object:</ListIntro>
					<ListItem>The Create method and the Change method use all protected attributes as input arguments.</ListItem>
					<ListItem>The Delete method uses the addressCode attribute as input argument, and has no other arguments.</ListItem>
					<ListItem>The Read method uses the addressCode attribute as input argument. The remaining protected attributes are used as output arguments.</ListItem>
				</List>
			</Important>
		</FieldHelp>
		<FieldHelp ID="ttadv713.mand"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Mandatory Input</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, the <Link href="/baanerp/tt/glossary/glossary#100209" role="glossary">client</Link> is obliged to deliver input for this argument.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv713.xarg"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">XML Tree</Title>
			</Header>
			<FuncDesc>This check box indicates whether an XML Schema file exists for the argument.</FuncDesc>
			<SimpleSection><Paragraph class="Default">This field is only displayed if the argument belongs to a public method.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="ttadv713.xflp"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">XMLSchema File</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/glossary/glossary#000000000000008" role="glossary">package</Link> code of the XMLSchema file.</FuncDesc>
			<SimpleSection><Paragraph class="Default">This field is only displayed if the argument belongs to a public method.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="ttadv713.xflm"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">XMLSchema File</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/glossary/glossary#100004" role="glossary">module</Link> code of the XMLSchema file.</FuncDesc>
			<SimpleSection><Paragraph class="Default">This field is only displayed if the argument belongs to a public method.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="ttadv713.xfln"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">XMLSchema File</Title>
			</Header>
			<FuncDesc>The name of the XML Schema file.</FuncDesc>
			<SimpleSection><Paragraph class="Default">This field is only displayed if the argument belongs to a public method.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="xfln.desc"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">XMLSchema File</Title>
			</Header>
			<FuncDesc>The description of the XML Schema File.</FuncDesc>
			<SimpleSection><Paragraph class="Default">This field is only displayed if the argument belongs to a public method.</Paragraph>
			</SimpleSection>
		</FieldHelp>
	</Fields>
	<FormCommands><CommandHelp ID="ttadv2570m000"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Additional Files</Title>
			</Header>
			<FuncDesc>Click to zoom to the <GUIRef href="/baanerp/tt/adv/ttadv2570m000" role="session">Additional Files (ttadv2570m000)</GUIRef> session, where you can view and maintain the XML schema files of all arguments of all public methods of all business objects.</FuncDesc>
		</CommandHelp>
		<CommandHelp ID="execute.edit.xml"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Edit / View XML Schema File...</Title>
			</Header>
			<FuncDesc>Click to edit or view the XML Schema file that is linked to the selected argument. The file will be opened with the application that is used on your system to open files with a .xsd extension.</FuncDesc>
		</CommandHelp>
		<CommandHelp ID="generate.args"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Generate Arguments ...</Title>
			</Header>
			<FuncDesc>Click to generate a list of all possible input/output arguments for a protected method. The generated arguments are based on the protected attributes of the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link> or component. This function is especially useful for the standard protected methods Create, Change, and Read.</FuncDesc>
			<SimpleSection><List><ListIntro>
                                       Note
                                    </ListIntro>
					<ListItem>This command is only available for protected methods.</ListItem>
					<ListItem>When you start this function, you must specify whether you want to generate input arguments or output arguments. For more information, refer to the help on the <Link href="/baanerp/tt/adv/ttadv7113m000#ttadv713.argt" role="formfield">Input/Output</Link> field.</ListItem>
					<ListItem>You must also specify how existing arguments must be handled. The following options exist: <List><ListItem><GUIRef href="" role="manual">Delete all before generating</GUIRef>: all arguments are deleted before new ones are generated.</ListItem>
							<ListItem><GUIRef href="" role="manual">Do not change existing arguments</GUIRef>: only new arguments are generated.</ListItem>
							<ListItem><GUIRef href="" role="manual">Update/generate all arguments</GUIRef> all existing arguments are deleted, and all arguments are generated anew.</ListItem>
							<ListItem><GUIRef href="" role="manual">Update only existing arguments</GUIRef>: all existing arguments are regenerated. No new arguments are generated.</ListItem>
						</List>
					</ListItem>
				</List>
			</SimpleSection>
		</CommandHelp>
		<CommandHelp ID="generate.xml.schema"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Generate XML Schema</Title>
			</Header>
			<FuncDesc>Click to generate an XML Schema file for the selected argument.</FuncDesc>
			<SimpleSection><List><ListIntro>
                                       Note
                                    </ListIntro>
					<ListItem>This command is only available for public methods.</ListItem>
					<ListItem>By default, when you generate a method or save a method you created manually, XML Schema Files are generated for the arguments of that method. These files actually store the arguments, but they must yet be filled by the current function.</ListItem>
					<ListItem>If an XML Schema file that is not empty already exists, you are prompted whether you want to proceed.</ListItem>
					<ListItem>An empty XML Schema file has only the following content:</ListItem>
				</List>
				<Formula space-and-orientation="indented-estimated"><Paragraph class="Default">&lt;xs:element name="Request"&gt;
  &lt;xs:complexType/&gt;
&lt;/xs:element&gt;</Paragraph>
				</Formula>
				<List><ListIntro>
                                       Note
                                    </ListIntro>
					<ListItem>It is required to edit the generated XML Schema file manually, because not everything can be generated automatically. Refer to the following Help topic for more information: <Link href="/baanerp/tt/onlinemanual/100106" role="manual">To edit XML Schema Files (BOR)</Link>.</ListItem>
				</List>
			</SimpleSection>
		</CommandHelp>
	</FormCommands>
</Session>
