Frequently Asked Questions: Declarative Outlook Solution

SharePoint 2010

Yes, you can remove them from the BDC model. In addition, you can also make the Microsoft Outlook 2010 folder read-only for a better user experience. The following is an example of the OIR.config file that shows how to make a folder read-only.

<OutlookFolder StoreType="Solution" Name="GetBug" FolderDisplayName="Bugs Under PR" NativeType="FolderTasks"  SubscriptionName="816979bb-32c7-489b-861a-3f4b61ec2c9b" FolderName="816979bb-32c7-489b-861a-3f4b61ec2c9b" CanCreate="false" CanUpdate=" false " CanDelete="false">

See the following code example for information on how to trigger a cache refresh based on a certain subscription: Code Snippet: Programmatically Request a Cache Refresh on the Client.

The requirements for icon file formats and expected sizes are dictated by the Outlook Ribbon extensibility schema.

  • Folder level icon: Can be in .jpg, .bmp, .ico, or .png file format. Must be 16x16 pixels.

  • Item level Icon: Can be in .ico file format only, but be any size.

  • Ribbon button: Can be in .png, .jpg, .bmp, or .ico file format. Can be any size.

Specify the name of your custom view in the OIR.config file. The following example shows how to do this.

<OutlookFolder Name="ContosoCustomers" FolderDisplayName="Contoso Customers" ……….>
      <Views<FolderViewDefinition Name="ContosoCustomerViewName" ViewName="ContosoCustomerView" ViewType="TableView" IsDefault="true" ViewFileName="ContosoCustomerView.ovd" />

Yes, you can define a DeclarativeFormRegion + Layout + Action to use a layout with either a Microsoft InfoPath 2010 form or an external data part to replace the default Outlook form.

Replacing the Default Outlook Form with an InfoPath Form

  1. Define a DeclarativeFormRegion.

    <FormRegions i:type="mx:DeclarativeFormRegions" >
      <mx:DeclarativeFormRegion  Type="Replacement" InternalName="CustomerReplaceFormRegion" ShowInspectorComposeMode="true" Name="CustomReplaceFormRegion" Title="MyCustomReplaceFormRegion"/>
  2. Define an Action.

    <CodeMethodAction MethodType="ShowRegionLayout" Name="ShowRegionLayoutAction">
        <ConstantParameter Name="Param1" ValueType="System.String" Value="IPLayout"/>
        <ConstantParameter Name="Param2" ValueType="System.String" Value=" ArtistReplaceFormRegion" />
  3. Trigger the Action at when the inspector opens.

        <mx:ContextActivated ActionName="ShowRegionLayoutAction"/>
  4. Define a Layout.

      <Layouts xmlns="">
        <Layout Name="IPLayout" LayoutFileName="IPLayout">
  5. Create a Layout file to define what to display within the layout.

Yes. However, by default, in a declarative solution, you can link your code to the OnClick event only, the event that is triggered when you click a ribbon button.

To associate code with the OnClick event

  1. Define the ribbon as shown in the following example Ribbon.xml file.

    <customUI xmlns="" onLoad="OnLoad" loadImage="GetImage">
          <tab id="tabIssueID" label="Team Review" getVisible="GetVisible" tag="Solution">
            <group id="IssueGroupID" label="Issue Actions" getVisible="GetVisible" tag="Context[TeamIssues.IssueGroupID]">
              <button id="AllIssueButton"
                          label="All Issues"
                        getEnabled ="GetEnabled"
                        screentip="Display All Existing Issues in Task Pane"
  2. Define an Action in the Oir.config file.

    <mx:CodeMethodAction MethodType="Custom" Name ="OpenBugRibbonAction" MethodName="OpenBugMethod" QualifiedTypeName="CustomCodeActionNameSpace.CustomCodeActionClassName, CustomCodeActionAssemblyName, Version=, Culture=neutral, PublicKeyToken=3c6b236b1e85d97a">
        <mx:ExpressionParameter Name="p1" EntityViewInstanceReference="PrimaryEntityNameInContext" Expression="BugID"/>
  3. Implement a custom code Action.

    using System;
    using System.Text;
    using Microsoft.Office.BusinessApplications.Runtime.OIM;
    namespace CustomCodeActionNameSpace
       public class CustomCodeActionCalssName
            public void CustomCodeActionMethod(params object[] parameters)
                //BCS Client Runtime passes in the Current Entity Instance as First parameter by default.
                 IEntityInstance iei = parameters[0] as IEntityInstance;
                // Other parameters are passed in based on the configuration within oir.config.
                // Process the Action based on parameters.
Note Note

If you use a custom ribbon manager, your solution will be able to listen to ribbon-related additional events.

The Publisher name comes from your certificate. The solution must be signed with a certificate that is issued by a trusted Certification Authority. Due to the limitation of Office development tools for Visual Studio (see KB970682), the certificate of the Certification Authority must be in the Trusted Root Certification Authority certificate store of the client.

Call this.Parent.Parent to get the layout of the External Data Part and search and compare all the children in that layout to find the one you want. The following code snippet shows how to do this.

WinFormsOBPartBase MyEDP;
ControlCollection allContainersUnderSameLayout = this.Parent.Parent.Controls;
foreach (Control container in allContainersUnderSameLayout)
    ControlCollection allEDPsUnderSameContainer = container.Controls;
    foreach (Control edp in allEDPsUnderSameContainer)
        if (edp.Name == "MyEDPName")
            MyEDP = edt as WinFormsOBPartBase;