Action Class

NOTE: This API is now obsolete.

Represents an action in the Business Data Catalog.

Inheritance Hierarchy

System.Object
  Microsoft.Office.Server.ApplicationRegistry.MetadataModel.MetadataObject
    Microsoft.Office.Server.ApplicationRegistry.MetadataModel.Action

Namespace:  Microsoft.Office.Server.ApplicationRegistry.MetadataModel
Assembly:  Microsoft.SharePoint.Portal (in Microsoft.SharePoint.Portal.dll)

Syntax

'Declaration
<ObsoleteAttribute("O12 Application Registry API is deprecated. Please use BusinessData.",  _
    False)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
Public Class Action _
    Inherits MetadataObject
'Usage
Dim instance As Action

[ObsoleteAttribute("O12 Application Registry API is deprecated. Please use BusinessData.", 
    false)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
public class Action : MetadataObject

Remarks

Entities can have actions in the Business Data Catalog. Actions bridge the gap between Microsoft Office SharePoint Server 2007 and a native application user interface by providing a link to the back-end data source. You can use Business Data actions to build applications with write-back scenarios, such as a Customer Profile view that allows a user to update profile information directly in SAP. Actions are implemented as links, so you can also use actions to perform simple actions such as to send an e-mail message or open a customer’s home page.

Actions travel everywhere with an entity. That is, after you define an action for an entity, the action shows up everywhere you display that entity—be it in a Business Data Web Part or in a Business Data column.

Actions can take parameters. The ActionParameter object defines the parameters the action accepts.

Schema

Child	Type	Occurs	Default	Limits / Accepted Values	Description
Position	Attribute (bdc:ActionPosition)	1..1		Min.: 1
IsOpenedInNewWindow	Attribute (Boolean)	0..1	false		If true, the action opens in a new browser window.
Url	Attribute (String)	1..1		Min. length: 1 Max. length: 2080	URL to go to when the action is clicked. The URL string is a .NET Framework format string. Each format specifier (e.g., {0}) corresponds to an action parameter.
ImageUrl	Attribute (String)	0..1		Min. length: 0 Max length: 2080 Should min. be 1 for consistency?	Absolute or relative path to the action's icon image. The icon image should be 16x16 pixels.
ActionParameters	Element	0..1		No max. ActionParameters elements per action enforced	Container element for ActionParameter.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Action Members

Microsoft.Office.Server.ApplicationRegistry.MetadataModel Namespace