ActionParameter

The URL attribute of the Action object can take parameters. The ActionParameter object defines the parameters the action accepts.

Important

ActionParameters are associated with TypeDescriptors that belong to the TypeDescriptor returned by the SpecificFinder MethodInstance of the entity. Therefore, the ActionParameter name should be a name of a TypeDescriptor returned by the SpecificFinder MethodInstance. Also, as with any other MetadataObject, ActionParameter names must be unique under the scope of the action.

Example

<Actions>
   <Action Name="Search product on MSN" Position="1" IsDisplayed="true" 
   IsOpenedInNewWindow="true" 
   Url="https://search.msn.com/results.aspx?&amp;q={0}" ImageUrl="">
      <ActionParameters>
         <ActionParameter Name="Name" Index="0" />
      </ActionParameters>
   </Action>
</Actions>

Schema

Child Type Occurs Default Limits / Accepted Values Description

Index

Attribute (bdc: Ordinal)

1..1

Min.: 0

Index of the placeholder (or "format item") in the URL to which this parameter corresponds.

Name

String

1.1

Min.: 1

Action Parameter names correspond to the name of a TypeDescriptor in the Specific Finder View of the Entity. Action Parameter is bound to the TypeDescriptor using the Name property. In the event of multiple TypeDescriptors with same name, the Action Parameter will be bound to the first TypeDescriptor in Specific Finder View. Action Parameter name must be unique in the scope of the action.

See Also

Tasks

AdventureWorks SQL Server 2000 Sample
How to: Get Started with Using the Runtime Object Model
How to: Get Started with Using the Administration Object Model

Concepts

FAQ: Business Data Catalog
Business Data Catalog: Glossary