<?xml version="1.0" encoding="utf-8"?>
<ManualTopic ID="/baanerp/da/onlinemanual/000501" xml:lang="en">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Selection</Title>
		<Keyword ContextSensitive="No"><Level1>Synchronization Server</Level1>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Synchronization Object</Level1>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Selection</Level1>
		</Keyword>
	</Header>
	<GeneralSection><Paragraph class="Default">To select the components and attributes to be included you must attach an XML text to the <Link href="/baanerp/da/glossary/glossary#58" role="glossary">synchronization object</Link>. You must do this in the <Link href="/baanerp/da/nch/danch2510m000" role="session">Synchronization Objects (danch2510m000)</Link> session. If a synchronization object is created automatically via the <Link href="/baanerp/da/glossary/glossary#61" role="glossary">PublishChanges</Link> method, the default selection text is generated.</Paragraph>
		<Paragraph class="Default">This selection text specifies what business object components and attributes must be included, and which components and attributes must also be included if they are unchanged. The attributes must be defined as public attributes in the Business Object Repository. In the Business Object Repository, the public layer does not have components defined explicitly, but still each public attribute belongs to a component (or to the object, if it has no components defined).</Paragraph>
		<Important><SectionTitle>
                                 Important!
                              </SectionTitle>
			<Paragraph class="Default">The selection as defined for a synchronization object differs from the selection as used in the PublishList, PublishChanges, List and Show methods. The synchronization object selection contains more information and allows the user to fine-tune the publishing of change events.</Paragraph>
		</Important>
		<ExampleSection><SectionTitle>
                                 Example
                              </SectionTitle>
			<Paragraph class="Default">The selection text contains an XML structure. The format of the selection text is as follows:</Paragraph>
			<CodeBlock space-and-orientation="indented-estimated">&lt;Order&gt;
    &lt;orderNumber key="true"/&gt;
    &lt;orderStatus includeUnchanged="true"/&gt;
    &lt;orderDate/&gt;
    &lt;OrderLine&gt;
        &lt;orderLineNumber key="true"/&gt;
        &lt;item includeUnchanged="true"/&gt;
        &lt;quantity/&gt;
        &lt;price/&gt;
    &lt;/OrderLine&gt;
&lt;/Order&gt;
</CodeBlock>
			<Paragraph class="Default">The root node holds the name of the root component (which can be the business object name or the main component name). All nodes having children are components; nodes that do not have children are attributes belonging to the component that is their parent. Components having a parent are child components of their parent component. The components (except the top-level component) and attributes must exist in the business object as specified in the Business Object Repository.</Paragraph>
			<List><ListIntro>For all components and attributes you can specify additional settings:</ListIntro>
				<ListItem>key: if the attribute is within the key</ListItem>
				<ListItem>includeUnchanged: whether the component or attribute must always be included (true) or only if it has been changed (false). Default value if omitted is true for the root component and the key attributes and false otherwise.</ListItem>
			</List>
			<Paragraph class="Default">Refer to the <DocRef>Synchronization and Event Publishing Deployment Guide</DocRef> for more information, including constraints you must take into account.</Paragraph>
		</ExampleSection>
	</GeneralSection>
	<GeneralSection><SectionTitle>More information</SectionTitle>
		<List><ListIntro>For more information, refer to:</ListIntro>
			<ListItem><Link href="/baanerp/da/onlinemanual/000500a" role="manual">Synchronization Server - User Interface Overview</Link>
			</ListItem>
			<ListItem><Link href="/baanerp/da/onlinemanual/000500b" role="manual">Synchronization Server - User Tasks</Link>
			</ListItem>
			<ListItem><Link href="/baanerp/da/onlinemanual/000400" role="manual">Event Publishing Overview</Link>
			</ListItem>
			<ListItem><DocRef>Synchronization and Event Publishing Deployment Guide</DocRef> This deployment guide describes among other things: <List><ListItem>The specifications for the PublishList, PublishChanges and UnpublishChanges methods.</ListItem>
					<ListItem>How to use these methods.</ListItem>
					<ListItem>How to use the Synchronization Server to set up, optimize and manage the event publishing.</ListItem>
					<ListItem>Important things to take into account when setting up the synchronization or event handling.</ListItem>
					<ListItem>What to do in case of problems.</ListItem>
				</List>
			</ListItem>
		</List>
	</GeneralSection>
</ManualTopic>
