Share This Post

Dynamics AX Updates

Dynamics AX ActionPane Component

The Dynamics AX ActionPane component provides access to the actions that can be performed for the items on a page. The Dynamics AX ActionPane component has the equal function as the Action Pane Web Part. Consider using a Dynamics AX ActionPane component in a User Control when you do not want to rely on having an Action Pane web part on the page where the User Control will be used.

Dynamics AX ActionPane

Dynamics AX ActionPane

To reference the AX ActionPane in ASP.NET code for the Enterprise Portal in Microsoft Dynamics AX 2012, you must include the following reference in the markup for the User Control:

<%@ Register Assembly=”Microsoft.Dynamics.Framework.Portal.SharePoint, Version=6.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35″
Namespace=”Microsoft.Dynamics.Framework.Portal.SharePoint.UI.WebControls” TagPrefix=”dynamics” %>

To reference the AX ActionPane in ASP.NET code for the Enterprise Portal in Microsoft Dynamics AX 2012 R2, you must include the following reference in the markup for the User Control:

<%@ Register Assembly=”Microsoft.Dynamics.Framework.Portal.SharePoint, Version=6.2.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35″
Namespace=”Microsoft.Dynamics.Framework.Portal.SharePoint.UI.WebControls” TagPrefix=”dynamics” %>

If you are using the Enterprise Portal with SharePoint 2013, your EP Web Application Project must be set to target the .NET 4 framework to use this component.

After you have included the reference to the assembly that contains the control, you can add the control to the markup. The following ASP.NET code example shows that the Dynamics AX ActionPane that was added to a User Control:

<dynamics:AxActionPaneControl ID=”ActionPane1″ runat=”server”
DataMember=”FCMWorkOrders_Current” DataSourceID=”WorkOrderListDataSource” WebMenuName=”WorkOrdersActionPane”></dynamics:AxActionPaneControl>

Properties

The Microsoft Dynamics AX ActionPane component has the below properties:

Subsection Heading

Property Description
AccessKey  Not used for Enterprise Portal.
TabIndex  The tab order of the control.

Appearance

Property Description
BackColor  This property is inherited from a base control. It is not specific to Enterprise Portal.
BorderColor  This property is inherited from a base control. It is not specific to Enterprise Portal.
BorderStyle  This property is inherited from a base control. It is not specific to Enterprise Portal.
BorderWidth  This property is inherited from a base control. It is not specific to Enterprise Portal.
CssClass  This property is inherited from a base control. It is not specific to Enterprise Portal.
Font  This property is inherited from a base control. It is not specific to Enterprise Portal.
ForeColor  This property is inherited from a base control. It is not specific to Enterprise Portal.

Behavior

Property Description
Enabled  Specifies whether the action pane is enabled.
EnableTheming  Indicates whether the control can be themed.
EnableViewState  Mentions whether the control automatically saves its state for use in round-trips.
SkinID  The SkinId of the control skin that gives the skin of the control.
ToolTip  Not used for Enterprise Portal.
Visible  Indicates that the control is visible and rendered.

Data

Property Description
Expressions  The expressions that are bound to properties of the control.
DataMember  The table or view from the information set that is being used for the action pane.
DataSourceID  Mentions the Dynamics AX Data Source component that will be used by the action pane to access data.

Layout

Property Description
Height  The height of the control.
Width  The width of the control.

Microsoft Dynamics AX

Property Description
Web Menu Name   mentions the Web Menu item in the AOT that defines the items displayed in the action pane.

Misc

Property Description
ID  The programmatic name of the control
CausesValidation  Specifies whether the controls in a validation group specified by the ValidationGroup property will be validated when an action pane item is clicked.
EnableMenuItemHelpText  Not applicable for the action pane control.
ValidationGroup  The name of a validation group for which the validation controls will be validated when an action pane item is clicked. Each validation control has the ValidationGroup property that specifies which validation group it is part of.

Events

Events

Events

The Dynamics AX ActionPane component has an event listed in the below table.

Event Description
ActionMenuItemClicked  Occurs after the item in the action pane has been clicked and the action has been performed.
ActionMenuItemClicking  Occurs after the item in the action pane has been clicked, but before the action has been performed.
DataBinding  Occurs when the server control binds to the data source.
DataBound  Occurs after a server control binds to the data source.
Disposed  Occurs when the server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.
Init  Occurs when a server control is initialized, which is the first step in its lifecycle.
Load  Occurs when a server control is loaded into the System.Web.UI.Page object.
PreRender  Occurs after the System.Web.UI.The control object is loaded by prior to rendering.
SetMenuItemProperties  Occurs before an item in the action pane are displayed, allowing the properties to be set.
Unload  Occurs when a server control is unloaded from memory.

Defining Action Pane Content with Code

In most cases, you define the content displayed by the action pane by using Web Menu and Web Menu Item resources in the AOT. If you need the action pane content to be more dynamic, you can define the action pane content with the code you add to the User Control that displays the action pane. You do this by implementing the method that returns an IWebMenuGenerator object for the User Control. This method defines the contents of an action pane. The process to define an action pane content with code is the same as the process used to define toolbar content with code.

Share This Post

Leave a Reply

avatar
  Subscribe  
Notify of
Skip to toolbar