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
Microsoft.Office.Server.ApplicationRegistry.MetadataModel Namespace