<?xml version="1.0" encoding="utf-8"?>
<Session ID="/baanerp/tt/adv/ttadv7114m000" xml:lang="en">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Public Attributes (ttadv7114m000)</Title>
	</Header>
	<HelpTopic xml:lang="en"><AimSection><Paragraph class="Default">
                                 Use this session to define the public attributes of a <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link>.</Paragraph>
		</AimSection>
		<GeneralSection><List><ListIntro>Public attributes are used for the following purposes:</ListIntro>
				<ListItem>As arguments in public methods.</ListItem>
				<ListItem>As entry points for external applications to the data of the business object.</ListItem>
			</List>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<Paragraph class="Default">You cannot map public attributes directly to table fields or to form fields. In stead, they must be mapped to protected attributes that, in turn, are mapped to table fields or form fields. The protected attributes may belong to the same business object/component as the public attributes or to a related business object/component.</Paragraph>
				<Paragraph class="Default">If the protected attributes belong to a related business object/component, the specific business object/component relationship details must be specified.</Paragraph>
			</Note>
			<GeneralSection><SectionTitle>Prerequisites</SectionTitle>
				<Paragraph class="Default">Before you can run the current session, you must have defined protected attributes.</Paragraph>
			</GeneralSection>
		</GeneralSection>
		<RelatedTopics><SectionTitle>
                                 Related topics
                              </SectionTitle>
			<RelTopic><Link href="/baanerp/tt/onlinemanual/100107" role="manual">To Model a Business Object</Link>
			</RelTopic>
		</RelatedTopics>
	</HelpTopic>
	<Fields><FieldHelp ID="ttadv714.attr"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Attribute</Title>
			</Header>
			<FuncDesc>The name of the attribute.</FuncDesc>
			<SimpleSection><List><ListIntro>The following rules apply to the attribute name:</ListIntro>
					<ListItem>The name must be unique within the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link>.</ListItem>
					<ListItem>The name must refer to business concepts and/or the functionality of the business object. Do not use a name that refers to a technical solution.</ListItem>
					<ListItem>Use standardized business terminology, for example, OAGIS.</ListItem>
					<ListItem>The name must be meaningful.</ListItem>
					<ListItem>Only alphanumeric characters ([A-Z], [a-z], [0-9]) are allowed.</ListItem>
					<ListItem>Spaces are not allowed.</ListItem>
					<ListItem>If the name consists of one word, start it with a lowercase character.</ListItem>
					<ListItem>If the name consists of several words, start each word, including the first word, with a capital.</ListItem>
				</List>
				<Paragraph class="Default">
                                    Example: customer, OrderedQuantity.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="attr.domain"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Domain</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/glossary/glossary#domain.tt" role="glossary">domain</Link> of the attribute.</FuncDesc>
			<SimpleSection><Paragraph class="Default">Domains are defined in the <GUIRef href="/baanerp/tt/adv/ttadv4500m000" role="session">Domains (ttadv4500m000)</GUIRef> session.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="attr.dom.type"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Data Type</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/adv/ttadv4500m000#ttadv400.type" role="formfield">Data Type</Link> of the attribute's domain, e.g. String, Long or Double.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv714.mope"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Map Operator</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/domains/adv.moap" role="domain">Map operator for public attributes</Link> for the attribute.</FuncDesc>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<Paragraph class="Default">If the map operator is <GUIRef href="/baanerp/tt/domains/adv.moap#field" role="option">Protected Attribute</GUIRef>, you can specify only one attribute. If the map operator is <GUIRef href="/baanerp/tt/domains/adv.moap#function" role="option">Calculate</GUIRef>, you can specify several attributes.</Paragraph>
			</Note>
		</FieldHelp>
		<FieldHelp ID="ttadv714.opac"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Origin BO</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/glossary/glossary#000000000000008" role="glossary">package</Link> code of the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link> of the linked protected attribute.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv714.omod"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Origin BO</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/glossary/glossary#100004" role="glossary">module</Link> code of the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link> of the linked protected attribute.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv714.oimp"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Origin BO</Title>
			</Header>
			<FuncDesc>The three-digit identifying code of the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link> of the linked protected attribute.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv714.ocmp"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Origin Component</Title>
			</Header>
			<FuncDesc>The component of the linked protected attribute.</FuncDesc>
			<SimpleSection><Paragraph class="Default">If the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link> of the linked protected attribute has no components, this field is empty.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="ttadv714.mppg"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Attribute</Title>
			</Header>
			<FuncDesc>The protected attribute that is linked to the public attribute specified in the <GUIRef href="/baanerp/tt/adv/ttadv7114m000#ttadv714.attr" role="manual">Attribute</GUIRef> field.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv714.zd_rfno"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">BO Relation</Title>
			</Header>
			<FuncDesc>This field is only available if you map a public attribute to a protected attribute from a related business object. You must enter the position number of a business object relationship detail line, which specifies the exact relationship between the two business objects. You can zoom to the <GUIRef href="/baanerp/tt/adv/ttadv7119m000" role="session">Relationship Details (ttadv7119m000)</GUIRef> session.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="dflt.domain"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Default domain</Title>
			</Header>
			<FuncDesc>If you selected <GUIRef href="/baanerp/tt/domains/adv.moap#field" role="option">Protected Attribute</GUIRef> in the <Link href="#ttadv714.mope" role="internal">Map Operator</Link> field, the default domain is that of the selected protected attribute. If you selected <GUIRef href="/baanerp/tt/domains/adv.moap#function" role="option">Calculate</GUIRef> or <GUIRef href="/baanerp/tt/domains/adv.moap#none" role="option">Not Applicable</GUIRef>, this field is empty and you must specify a domain manually.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv714.zb_ldom"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Override default domain</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, you must manually specify a domain for the attribute. You must enter this domain in the next fields.</FuncDesc>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<Paragraph class="Default">If you selected <GUIRef href="/baanerp/tt/domains/adv.moap#field" role="option">Protected Attribute</GUIRef> in the <Link href="#ttadv714.mope" role="internal">Map Operator</Link> field, the default domain is that of the selected protected attribute. If you selected <GUIRef href="/baanerp/tt/domains/adv.moap#function" role="option">Calculate</GUIRef> or <GUIRef href="/baanerp/tt/domains/adv.moap#none" role="option">Not Applicable</GUIRef>, you must always specify a domain manually.</Paragraph>
			</Note>
		</FieldHelp>
		<FieldHelp ID="ttadv714.atdp"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Domain</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/glossary/glossary#000000000000008" role="glossary">package</Link> code of the domain.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv714.atdc"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Domain</Title>
			</Header>
			<FuncDesc>The identification code of the domain.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="cdom.type"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Data Type</Title>
			</Header>
			<FuncDesc>The <Link href="/baanerp/tt/adv/ttadv4500m000#ttadv400.type" role="formfield">Data Type</Link> of the attribute's domain, e.g. String, Long or Double.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv714.ze_xmlc"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Use as XML Element</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, the content of this attribute will be read and interpreted as XML content. As a result, if you clear this check box, the content is not interpreted as XML content. This option allows you to communicate XML content while preventing that it is automatically processed.</FuncDesc>
			<SimpleSection><Paragraph class="Default">This check box is only available if the <Link href="#attr.dom.type" role="internal">data type</Link> of the domain of the attribute is long.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="ttadv714.reon"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Read-only</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, the value of this attribute is controlled by ERP LN, and you cannot change the value directly.</FuncDesc>
			<SimpleSection><List><ListIntro>An attribute can be read-only for various reasons:</ListIntro>
					<ListItem>The attribute has a calculated value.</ListItem>
					<ListItem>External applications are only allowed to read the value, and not to change it.</ListItem>
					<ListItem>The protected attribute linked to the public attribute belongs to a related <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link> or component.</ListItem>
				</List>
			</SimpleSection>
			<Note><SectionTitle>
                                    Note
                                 </SectionTitle>
				<Paragraph class="Default">Read-only attributes that are not identifying can only be used as output arguments, that is, as arguments that deliver output.</Paragraph>
			</Note>
		</FieldHelp>
		<FieldHelp ID="ttadv714.idnf"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Identifier</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, the attribute is part of the identification of the <Link href="/baanerp/tt/glossary/glossary#100032" role="glossary">business object</Link>.</FuncDesc>
		</FieldHelp>
		<FieldHelp ID="ttadv714.mndt"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Mandatory</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, the attribute must always have a value.</FuncDesc>
			<SimpleSection><List><ListIntro>An attribute can be mandatory for various reasons:</ListIntro>
					<ListItem>Attributes must be mandatory if they are mandatory input for the standard method Create.</ListItem>
					<ListItem>If the public attribute is linked to a protected attribute that is mandatory, the public attribute must also be mandatory.</ListItem>
				</List>
				<Paragraph class="Default">Note that it is recommended to make a public attribute not mandatory if it is linked to a protected attribute that is not mandatory.</Paragraph>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="ttadv714.zc_davl"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Default available</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, the attribute has a default value.</FuncDesc>
		</FieldHelp>
	</Fields>
	<FormCommands><CommandHelp ID="gen.public.attributes"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Generate Public Attributes</Title>
			</Header>
			<FuncDesc>Click to generate all possible public attributes based on the available protected attributes.</FuncDesc>
			<SimpleSection><Paragraph class="Default">The map operator of the generated public attributes will be <GUIRef href="/baanerp/tt/domains/adv.moap#field" role="option">Protected Attribute</GUIRef>.</Paragraph>
			</SimpleSection>
		</CommandHelp>
	</FormCommands>
</Session>
