Here is what my bing translator integration looks like.

You can download an unmanaged solution to implement the bing translator for cases, letters, tasks, and emails, you can download it here: Translate_1_0.zip. It will not modify your forms, but if you have unmanaged ribbon buttons on those entities, it will remove them. So to avoid that problem you can install the unmanaged solution with the JScript (that you need to edit to set your bing api key) and the images, and then follow the RibbonDiff guide in the SDK to add the buttons, or install the managed solution to add the button to the ribbons for cases, letters, tasks, and emails.

To start, I created a JScript file to include as a web-resource that I could leverage when a button is clicked on the ribbon. This JScript file utilizes the Bing Translation WebServices to translate text.

YOU WILL NEED TO EDIT THE JSCRIPT FILE AND CHANGE ‘YOUR API KEY GOES HERE’ TO CONTAIN YOUR API KEY.

var bing = {};
bing.popup = {};
bing.language = {};

bing.appId = 'YOUR API KEY GOES HERE';
bing.language.text = '';
bing.language.from = '';
bing.language.to = 'en';

bing.language.detect = function (text,oncomplete)
{
  var src = "https://api.microsofttranslator.com/V2/Ajax.svc/Detect?oncomplete=" +
      oncomplete + "&appId="+ bing.appId + "&text=" + text;
  var s = document.createElement("script");
  s.src = src;
  s.id = "bingdetect";
  document.getElementsByTagName("head")[0].appendChild(s);
}

bing.language.translate = function(from,to,text,oncomplete)
{
  var src = "https://api.microsofttranslator.com/V2/Ajax.svc/Translate?oncomplete=" +
      oncomplete + "&appId=" + bing.appId + "&from=" + from +
      "&to=" + to + "&text=" + text;

  var s = document.createElement("script");
  s.src = src;
  s.id = "bingtranslate";
  document.getElementsByTagName("head")[0].appendChild(s);
}

bing.popup.show = function(text)
{
  var idiv = document.createElement('div');
  idiv.id = "bingtext";
  idiv.style.height = "265px";
  idiv.style.width = "306px";
  idiv.style.align = "left";
  idiv.style.textAlign = "left";
  idiv.style.backgroundColor = "white";
  idiv.style.overflow = "auto";
  idiv.style.padding = "2px";
  idiv.style.margin = "2px";
  idiv.style.border = "1px solid black";
  idiv.innerHTML =  "<p>"+text+"</p>";

  var iurl = Xrm.Page.context.getServerUrl();
  iurl += "WebResources/tran_img/translatelogo.gif";

  var img = document.createElement('img');
  img.src = iurl;

  var div = document.createElement('div');
  div.id = "bingpopup";
  div.appendChild(img);
  div.appendChild(idiv);
  div.innerHTML += "<button style='text-align:center;width:60px;' onclick='bing.popup.copy();'>Copy</button>&nbsp;&nbsp;";
  div.innerHTML += "<button style='text-align:center;width:60px;' onclick='bing.popup.hide();'>Close</button>";
  div.style.position = "absolute";
  div.style.backgroundColor = "#20415F";
  div.style.border="1px solid black";
  div.style.left = "50%";
  div.style.top = "50%";
  div.style.color = "black";
  div.style.padding = "5px";
  div.style.width = "320px";
  div.style.height = "340px";
  div.style.marginLeft = "-160px";
  div.style.marginTop = "-170px";
  div.setAttribute("align","center");
  document.getElementsByTagName("body")[0].appendChild(div);
}

bing.popup.hide = function()
{
  var deleteElement = function(id) {
    var el = document.getElementById(id);
    el.parentNode.removeChild(el);
  }

  deleteElement("bingpopup");
  deleteElement("bingdetect");
  deleteElement("bingtranslate");
}

bing.popup.copy = function()
{
  var el = document.getElementById('bingtext');

  if (window.clipboardData && window.clipboardData.setData)
  {
    window.clipboardData.setData("Text", el.innerText);
  }
}

bing.getSelectedText = function (p)
{
  if (p.getSelection)
  {
    text = p.getSelection();
  }
  else if (p.selection)
  {
    text = p.selection.createRange().text;
  }
  return text;
}

// get current control
bing.language.toolbarClick = function (ctrl)
{
  var text = '';
  if (window.getSelection)
  {
    text = window.getSelection();
  }
  else {
    text = bing.getSelectedText(document);
  }

  if (text==null || text=='') {
    if (ctrl==null) {
      ctrl = Xrm.Page.ui.getCurrentControl();
    }

    var entityName = Xrm.Page.data.entity.getEntityName();
    if (ctrl==null && entityName.match(/letter|email|task/)) {
      ctrl = Xrm.Page.ui.controls.get('description');
    }

    if (ctrl==null) {
      alert('Please highlight the text to translate.');
      return;
    }

    if (ctrl.getControlType()!="standard") {
      return; // only standard
    }

    if (ctrl.getName()=="notescontrol") {
      text = bing.getSelectedText(document.frames['notescontrol'].document);
      if (text==null || text == "") {
        alert('Please highlight the text to translate.');
      }
    }

    if (text == null || text == "") {
      var attr = ctrl.getAttribute();
      if (attr!=null) {
        var t = attr.getAttributeType();
        if (t.match(/string|memo/))
        {
          text = attr.getValue();
        }
      }
    }
  }

  if (text == null || text == "") {
    // Nothing to translate
    return;
  }  

  text = encodeURIComponent(text);
  bing.language.text = text;

  bing.language.from = '';
  bing.language.detect(text,"translate");
}

window.translate = function (response)
{
  bing.language.from = response;
  bing.language.translate(bing.language.from,bing.language.to,bing.language.text,"translated");
}

window.translated = function (response)
{
  bing.popup.show(response);
}

The JScript uses the Bing Translate logo image (WebResources/tran_img/translatelogo.gif – you may need to change the path in the JScript):

I added some images for Microsoft Translate button images:

16×16 image tran_icontranslate_16x16.png

32×32 image tran_icontranslate_32x32.png

Then I added the buttons to the ribbons on the entities I wanted to have bing translation capabilities by following the SDK guidelines to add a button. Here is the RibbonDiffXml for a case. You can follow the guide to change it to be on different entities.

<RibbonDiffXml>
  <CustomActions>
    <CustomAction Id="bing.incident.form.Bing.CustomAction"
                  Location="Mscrm.Form.incident.MainTab.Groups._children"
                  Sequence="110">
    <CommandUIDefinition>
      <Group Id="bing.incident.form.Bing.Group"
             Command="bing.incident.form.Bing.Command"
             Title="$LocLabels:bing.incident.Bing.Title"
             Sequence="39"
             Template="Mscrm.Templates.Flexible2"
             Image32by32Popup="$webresource:tran_icon/translate_32x32.png">
      <Controls Id="bing.incident.form.Bing.Controls">
        <Button Id="bing.incident.form.Bing.Button.BingTranslator"
                Command="bing.incident.Bing.Button.BingTranslator.Command"
                Sequence="10"
                LabelText="$LocLabels:bing.incident.Bing.Button.BingTranslator.LabelText"
                ToolTipTitle="$LocLabels:bing.incident.Bing.Button.BingTranslator.LabelText"
                ToolTipDescription="$LocLabels:bing.incident.Bing.Button.BingTranslator.Description"
                TemplateAlias="isv"
                Image16by16="$webresource:tran_icon/translate_16x16.png"
                Image32by32="$webresource:tran_icon/translate_32x32.png" />
      </Controls>
      </Group>
    </CommandUIDefinition>
    </CustomAction>
    <CustomAction Id="bing.incident.form.Bing.Popup.CustomAction"
                  Location="Mscrm.Form.incident.MainTab.Scaling._children"
                  Sequence="140">
    <CommandUIDefinition>
      <Scale Id="bing.incident.form.Bing.Popup.1"
             GroupId="bing.incident.form.Bing.Group"
             Sequence="85"
             Size="Popup" />
    </CommandUIDefinition>
    </CustomAction>
    <CustomAction Id="bing.incident.form.Bing.MaxSize.CustomAction"
                  Location="Mscrm.Form.incident.MainTab.Scaling._children"
                  Sequence="120">
    <CommandUIDefinition>
      <MaxSize Id="bing.incident.form.Bing.MaxSize"
               GroupId="bing.incident.form.Bing.Group"
               Sequence="21"
               Size="LargeLarge" />
    </CommandUIDefinition>
    </CustomAction>
  </CustomActions>
  <Templates>
    <RibbonTemplates Id="Mscrm.Templates"></RibbonTemplates>
  </Templates>
  <CommandDefinitions>
    <CommandDefinition Id="bing.incident.Bing.Button.BingTranslator.Command">
    <EnableRules />
    <DisplayRules />
    <Actions>
      <JavaScriptFunction Library="$webresource:tran_js/bing.translate.js"
                          FunctionName="bing.language.toolbarClick">
      <CrmParameter Value="SelectedControl" />
      </JavaScriptFunction>
    </Actions>
    </CommandDefinition>
    <CommandDefinition Id="bing.incident.form.Bing.Command">
    <EnableRules></EnableRules>
    <DisplayRules />
    <Actions />
    </CommandDefinition>
  </CommandDefinitions>
  <RuleDefinitions>
    <TabDisplayRules />
    <DisplayRules />
    <EnableRules />
  </RuleDefinitions>
  <LocLabels>
    <LocLabel Id="bing.incident.Bing.Title">
    <Titles>
      <Title languagecode="1033"
             description="Bing" />
    </Titles>
    </LocLabel>
    <LocLabel Id="bing.incident.Bing.Button.BingTranslator.LabelText">
    <Titles>
      <Title languagecode="1033"
             description="Translate" />
    </Titles>
    </LocLabel>
    <LocLabel Id="bing.incident.Bing.Button.BingTranslator.Description">
    <Titles>
      <Title languagecode="1033"
             description="Translate text area with bing!" />
    </Titles>
    </LocLabel>
  </LocLabels>
</RibbonDiffXml>

Here are the files to download if you want to use it:

• Option A
  • Complete unmanaged solution: Translate_1_0.zip
• Option B
  • Unmanaged Image and JScript solution: Translate_1_0-ImageJS.zip
    • You will need to edit the JScript to set your Bing API key.
  • Managed Solution for the Ribbons on cases, letters, tasks, and emails: Translate_1_0-Ribbon-Managed.zip

The thing that makes this great is it is workflow. It is not tied down to an entity. You can use it on your custom entities, you can geocode your addresses, and correct them. You can do address verification and geocoding. You can control what you do using workflow.

Ok, while this isn’t anything complicated, I thought it was a good example of a custom workflow that used an external webservice. Please don’t forget to create a signed key for your project.

Workflow Class:

using System;
using System.ServiceModel;
using System.Text;
using System.Workflow.Activities;
using System.Workflow.ComponentModel;
using BingWorkflow.BingMapsGeo;
using Microsoft.Crm.Sdk;
using Microsoft.Crm.Workflow;
using Microsoft.Win32;

namespace BingWorkflow
{
    [CrmWorkflowActivity("Bing Maps", "Geocode")]
    public class VerifyAddressUsingBingMapsActivity :
        SequenceActivity
    {
        // Activity code goes here. 

        public static DependencyProperty AddressCityProperty = DependencyProperty.Register(
            "AddressCity", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty AddressCountryProperty = DependencyProperty.Register(
            "AddressCountry", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty AddressLine1Property = DependencyProperty.Register(
            "AddressLine1", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty AddressPostalCodeProperty = DependencyProperty.Register(
            "AddressPostalCode", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty AddressStateProperty = DependencyProperty.Register(
            "AddressState", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty BingKeyProperty = DependencyProperty.Register(
            "BingKey", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty OutputCityProperty = DependencyProperty.Register(
            "OutputCity", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty OutputCountryProperty = DependencyProperty.Register(
            "OutputCountry", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty OutputLatitudeProperty = DependencyProperty.Register(
            "OutputLatitude", typeof (CrmFloat), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty OutputLine1Property = DependencyProperty.Register(
            "OutputLine1", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty OutputLongitudeProperty = DependencyProperty.Register(
            "OutputLongitude", typeof (CrmFloat), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty OutputMultipleFoundProperty = DependencyProperty.Register(
            "OutputMultipleFound", typeof (CrmBoolean), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty OutputPostalCodeProperty = DependencyProperty.Register(
            "OutputPostalCode", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        public static DependencyProperty OutputStateProperty = DependencyProperty.Register(
            "OutputState", typeof (string), typeof (VerifyAddressUsingBingMapsActivity));

        [CrmInput("Address City")]
        public string AddressCity
        {
            get { return (string)GetValue(AddressCityProperty); }
            set { SetValue(AddressCityProperty, value); }
        }

        [CrmInput("Address Country")]
        public string AddressCountry
        {
            get { return (string)GetValue(AddressCountryProperty); }
            set { SetValue(AddressCountryProperty, value); }
        }

        [CrmInput("Address Line 1")]
        public string AddressLine1
        {
            get { return (string)GetValue(AddressLine1Property); }
            set { SetValue(AddressLine1Property, value); }
        }

        [CrmInput("Address Postal Code")]
        public string AddressPostalCode
        {
            get { return (string)GetValue(AddressPostalCodeProperty); }
            set { SetValue(AddressPostalCodeProperty, value); }
        }

        [CrmInput("Address State Or Province")]
        public string AddressState
        {
            get { return (string)GetValue(AddressStateProperty); }
            set { SetValue(AddressStateProperty, value); }
        }

        [CrmInput("Bing API Key")]
        public string BingKey
        {
            get { return (string)GetValue(BingKeyProperty); }
            set { SetValue(BingKeyProperty, value); }
        }

        [CrmOutput("City")]
        public string OutputCity
        {
            get { return (string)GetValue(OutputCityProperty); }
            set { SetValue(OutputCityProperty, value); }
        }

        [CrmOutput("Country Or Region")]
        public string OutputCountry
        {
            get { return (string)GetValue(OutputCountryProperty); }
            set { SetValue(OutputCountryProperty, value); }
        }

        [CrmOutput("Latitude")]
        public CrmFloat OutputLatitude
        {
            get { return (CrmFloat)GetValue(OutputLatitudeProperty); }
            set { SetValue(OutputLatitudeProperty, value); }
        }

        [CrmOutput("Line 1")]
        public string OutputLine1
        {
            get { return (string)GetValue(OutputLine1Property); }
            set { SetValue(OutputLine1Property, value); }
        }

        [CrmOutput("Longitude")]
        public CrmFloat OutputLongitude
        {
            get { return (CrmFloat)GetValue(OutputLongitudeProperty); }
            set { SetValue(OutputLongitudeProperty, value); }
        }

        [CrmOutput("Multiple Address Found")]
        public CrmBoolean OutputMultipleFound
        {
            get { return (CrmBoolean)GetValue(OutputMultipleFoundProperty); }
            set { SetValue(OutputMultipleFoundProperty, value); }
        }

        [CrmOutput("Postal Code")]
        public string OutputPostalCode
        {
            get { return (string)GetValue(OutputPostalCodeProperty); }
            set { SetValue(OutputPostalCodeProperty, value); }
        }

        [CrmOutput("State Or Province")]
        public string OutputState
        {
            get { return (string)GetValue(OutputStateProperty); }
            set { SetValue(OutputStateProperty, value); }
        }

        protected override ActivityExecutionStatus Execute(ActivityExecutionContext executionContext)
        {
            // Reset Outputs
            OutputLatitude = new CrmFloat();
            OutputLongitude = new CrmFloat();
            OutputLine1 = String.Empty;
            OutputCity = String.Empty;
            OutputState = String.Empty;
            OutputPostalCode = String.Empty;
            OutputMultipleFound = new CrmBoolean {Value = false};

            var key = BingKey;
            if (String.IsNullOrEmpty(key) || key.ToLower() == "registry")
            {
                key = GetAPIKeyFromRegistry();
            }

            // Create Bing Maps Request
            var bingRequest = new GeocodeRequest
                              {
                                  Credentials = new Credentials {ApplicationId = key},
                                  Query = AddressLine1 + ", " +
                                          AddressCity + ", " +
                                          AddressState + ", " +
                                          AddressPostalCode + ", " +
                                          AddressCountry
                              };

            // Filter for High Confidence
            var filters = new ConfidenceFilter[1];
            filters[0] = new ConfidenceFilter {MinimumConfidence = Confidence.High};
            bingRequest.Options = new GeocodeOptions {Filters = filters};

            // Create Client
            GeocodeServiceClient bingClient = null;
            try
            {
                var geoBinding = new BasicHttpBinding(BasicHttpSecurityMode.None)
                                 {
                                     Name = "BasicHttpBinding_IGeocodeService",
                                     CloseTimeout = new TimeSpan(0, 1, 0),
                                     OpenTimeout = new TimeSpan(0, 1, 0),
                                     ReceiveTimeout = new TimeSpan(0, 10, 0),
                                     SendTimeout = new TimeSpan(0, 1, 0),
                                     AllowCookies = false,
                                     BypassProxyOnLocal = false,
                                     HostNameComparisonMode = HostNameComparisonMode.StrongWildcard,
                                     MaxBufferSize = 65536,
                                     MaxBufferPoolSize = 524288,
                                     MaxReceivedMessageSize = 65536,
                                     MessageEncoding = WSMessageEncoding.Text,
                                     TextEncoding = Encoding.UTF8,
                                     TransferMode = TransferMode.Buffered,
                                     UseDefaultWebProxy = true
                                 };

                var geoEA =
                    new EndpointAddress("http://dev.virtualearth.net/webservices/v1/geocodeservice/GeocodeService.svc");

                bingClient = new GeocodeServiceClient(geoBinding, geoEA);

                var bingResponse = bingClient.Geocode(bingRequest);

                if (bingResponse.Results != null && bingResponse.Results.Length > 0)
                {
                    if (bingResponse.Results.Length > 1)
                    {
                        OutputMultipleFound.Value = true;
                    }

                    var bingResult = bingResponse.Results[0];

                    if (bingResult.Locations != null && bingResult.Locations.Length > 0)
                    {
                        var bingLocation = bingResult.Locations[0];
                        OutputLatitude.Value = bingLocation.Latitude;
                        OutputLongitude.Value = bingLocation.Longitude;
                    }

                    var bingAddress = bingResult.Address;

                    OutputLine1 = bingAddress.AddressLine;
                    OutputPostalCode = bingAddress.PostalCode;
                    OutputCountry = bingAddress.CountryRegion;

                    OutputCity = String.IsNullOrEmpty(bingAddress.PostalTown)
                                     ? bingAddress.Locality
                                     : bingAddress.PostalTown;
                    OutputState = String.IsNullOrEmpty(bingAddress.AdminDistrict)
                                      ? bingAddress.District
                                      : bingAddress.AdminDistrict;
                }
            }
            catch (Exception ex)
            {
                throw new WorkflowTerminatedException(
                    "There was an error openning the connection to Bing Maps.", ex);
            }
            finally
            {
                // Close the client
                if (bingClient != null)
                {
                    bingClient.Close();
                }
            }

            return base.Execute(executionContext);
        }

        private static string GetAPIKeyFromRegistry()
        {
            // Opening the registry key
            var key = Registry.LocalMachine;
            if (key != null)
            {
                key = key.OpenSubKey("Software\\Microsoft Geocoder");
            }

            return key != null ? key.GetValue("APIKey").ToString() : null;
        }
    }
}

The steps are:

1. Run an advanced find in CRM
2. Export it to Excel as a Dynamic Worksheet
3. Open it, save it as an excel file.
4. In Excel 2007, Click on Data in the ribbon, then Connections.
5. Click Properties
6. Click on Definition tab, edit the query
7. Click ok, then click close