Share via


Action Class

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
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
Public Class Action _
    Inherits MetadataObject
'Usage
Dim instance As Action
[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