在前面的两篇文章中，我分别介绍了如何自定义Ribbon按钮并向其传递参数以及Ribbon按钮与其背后JScript的工作原理。在这篇文章中，我结合前面介绍到的知识，再为大家演示一下如何在表单中传递自定义的参数。
我们还是以扩展Connect按钮为例子，这一节我们安排”To Interest ">Partner”这个子选项多做一些事情。如果你点击”Connect To Another”，CRM会为你打开一个Connection的创建表单，我们也为”Connect To Investment Partner”做同样的事情，也打开一个Connection的表单，但是我们要向Connection表单中传递一个自定义的参数。
也许有人会问，为什么要向表单传递自定义参数。一个简单的例子，比如你向Connection表单传递一个Connection Role的参数，这样在Connection表单的OnLoad事件中，你就可以读取这个参数，并将表单上的Connection Role直接添好，而不需要用户在手动选择。
下面我们还将修改account的Ribbon定义，至于如何修改Ribbon定义，可以参见我前边的文章如何自定义Ribbon按钮并向其传递参数或者SDK。改动后的ribbon定义如下，注意我在command的定义中，增加了两个参数 <StringParameter Value="account" />和<StringParameter Value="Investment Partner" />。它们分别表示account 连接到另一个Entity的类型是account，Connection Role是Investement Partner。
<RibbonDiffXml> <CustomActions> <CustomAction Id="mycompany.account.form.ConnectToInvestmentPartner.CustomAction" Location="Mscrm.Form.account.AddConnection.Controls._children" Sequence="42"> <CommandUIDefinition> <Button Id="mycompany.account.form.ConnectToInvestmentPartner.Button" Command="mycompany.account.form.ConnectToInvestmentPartner.Command" LabelText="$LocLabels:mycompany.account.form.ConnectToInvestmentPartner.LabelText" ToolTipTitle="$LocLabels:mycompany.account.form.ConnectToInvestmentPartner.LabelText" ToolTipDescription="$LocLabels:mycompany.account.form.ConnectToInvestmentPartner.ToolTip" /> </CommandUIDefinition> </CustomAction> <CustomAction Id="mycompany.account.grid.ConnectToInvestmentPartner.CustomAction" Location="Mscrm.HomepageGrid.account.AddConnection.Controls._children" Sequence="46"> <CommandUIDefinition> <Button Id="mycompany.account.homepagegrid.ConnectToInvestmentPartner.Button" Command="mycompany.account.grid.ConnectToInvestmentPartner.Command" LabelText="$LocLabels:mycompany.account.form.ConnectToInvestmentPartner.LabelText" ToolTipTitle="$LocLabels:mycompany.account.form.ConnectToInvestmentPartner.LabelText" ToolTipDescription="$LocLabels:mycompany.account.form.ConnectToInvestmentPartner.ToolTip" /> </CommandUIDefinition> </CustomAction> <CustomAction Id="mycompany.account.subgrid.ConnectToInvestmentPartner.CustomAction" Location="Mscrm.SubGrid.account.AddConnection.Controls._children" Sequence="21"> <CommandUIDefinition> <Button Id="mycompany.account.subgrid.ConnectToInvestmentPartner.Button" Command="mycompany.account.grid.ConnectToInvestmentPartner.Command" LabelText="$LocLabels:mycompany.account.form.ConnectToInvestmentPartner.LabelText" ToolTipTitle="$LocLabels:mycompany.account.form.ConnectToInvestmentPartner.LabelText" ToolTipDescription="$LocLabels:mycompany.account.form.ConnectToInvestmentPartner.ToolTip" /> </CommandUIDefinition> </CustomAction> </CustomActions> <
Templates> <Ribbon
Templates Id="Mscrm.Templates"></RibbonTemplates> </Templates> <CommandDefinitions> <CommandDefinition Id="mycompany.account.form.ConnectToInvestmentPartner.Command"> <EnableRules> <EnableRule Id="Mscrm.Enabled" /> </EnableRules> <DisplayRules /> <Actions> <JavaScriptFunction
Library="$webresource:new_AccountLibrary.js" FunctionName="AccountLibrary.AddConnectionToInvestmentPartner"> <CrmParameter Value="FirstPrimaryItemId" /> <CrmParameter Value="PrimaryEntityTypeCode" /> <CrmParameter Value="PrimaryEntityTypeName" /> <StringParameter Value="account" /> <StringParameter Value="Investment Partner" /> </JavaScriptFunction> </Actions> </CommandDefinition> <CommandDefinition Id="mycompany.account.grid.ConnectToInvestmentPartner.Command"> <EnableRules> <EnableRule Id="Mscrm.Enabled" /> </EnableRules> <DisplayRules /> <Actions> <JavaScriptFunction Library="$webresource:new_AccountLibrary.js" FunctionName="AccountLibrary.AddConnectionToInvestmentPartner"> <CrmParameter Value="FirstSelectedItemId" /> <CrmParameter Value="SelectedEntityTypeCode" /> <CrmParameter Value="SelectedEntityTypeName" /> <StringParameter Value="account" /> <StringParameter Value="Investment Partner" /> </JavaScriptFunction> </Actions> </CommandDefinition> </CommandDefinitions> <RuleDefinitions> <TabDisplayRules /> <DisplayRules /> <EnableRules /> </RuleDefinitions> <LocLabels> <LocLabel Id="mycompany.account.form.ConnectToInvestmentPartner.LabelText"> <Titles> <Title languagecode="1033" description="To Investment Partner" /> <Title languagecode="2052" description="投资伙伴" /> </Titles> </LocLabel> <LocLabel Id="mycompany.account.form.ConnectToInvestmentPartner.ToolTip"> <Titles> <Title languagecode="1033" description="To Investment Partner" /> <Title languagecode="2052" description="投资伙伴" /> </Titles> </LocLabel> </LocLabels> </RibbonDiffXml>
下面我们修改AccountLibrary.js web resource。内容如下。