Blog posts by Yen Nguyen2019-03-26T03:46:39.0000000Zhttps://world.optimizely.com/blogs/yen-nguyen/Optimizely WorldAuto Translation V2 to V3 migration<h2><br />Api V3 has came out.</h2>
<p>Microsoft has migrated auto translation service api from V2 to V3 in the beginning of this year. <br />Version 2 was deprecated on April 30, 2018 and will be discontinued on April 30, 2019 according to Microsoft announcement <a href="https://docs.microsoft.com/en-us/azure/cognitive-services/translator/migrate-to-v3" title="V2 to V3 Migration" target="_blank" rel="noopener">here</a><br />Episerver's Language Manager add-on was updated in response to that and released in version EPiServer.Labs.LanguageManager 3.3.0. <br />The upgraded auto translation service's name is changed to "Cognitive Service Translation" (was "Bing Translator" before) with new api endpoint: <strong>api.cognitive.microsofttranslator.com</strong>.<br />Microsoft also introduces service improvements in V3:</p>
<ul>
<li>Is generally available and fully supported.</li>
<li>Is GDPR compliant as a processor and satisfies all ISO 20001 and 20018 as well as SOC 3 certification requirements.</li>
<li>Allows you to invoke the neural network translation systems you have customized with Custom Translator (Preview), the new Translator NMT customization feature.</li>
<li>Does not provide access to custom translation systems created using the Microsoft Translator Hub.<br /><br /></li>
</ul>
<h2>Authentication</h2>
<p>The V3 api will accept authentication key of V2, so you don't need to get a new subscription that make it easier for you to migrate to new version without breaking anything.</p>
<h2>How to update Episerver's Language Manager package?</h2>
<p>These updates were released in package EPiServer.Labs.LanguageManager 3.3.0. So, all you need to do is to update this package, then go to Language Manager settings change provider to "Cognitive Service Translation".<br />All behaviors should remain the same.</p>
<p><img src="/link/81aaa3538934467498694335ba22c0d6.aspx" width="500" height="298" alt="" /></p>
<p><br />Hope you guys find this info useful. Thanks!</p>2019-03-26T03:46:39.0000000ZBlog postImplement a custom geolocation provider with Forms<p>I got a support ticket a few days ago in terms of Forms' hidden vistor profiling element. The customer basically wanted to capture user's zip code by using the element with a external geolocation api. He could get ip, location name however zip code always return empty in submission. So, i digged in the form's visitor profiling element and its geolocation provider. It turns out Form is using an api named FreeGeo and fetch geolocation info base on user's ip address and you can replace it by your own api for sure. The thing is, to make it work, we'll need some extra steps to config custom provider and justify the api result to meet our needs. The following implementaion is built with Episerver 11 Alloy site together with Forms 4.20. This is step by step guide to acomplish it. </p>
<h3><strong>1. Change configuration using new provider</strong><strong></strong></h3>
<p>Open Web.config file, add following block of config under <virtualPathProviders> section.</p>
<pre class="language-markup"><code> <geolocation defaultProvider="customGeoProvider">
<providers>
<add name="customGeoProvider" type="AlloySample.Internal.GeoData.CustomGeolocationProvider, AlloySample" geoApiUrl="http://{YOUR_API_URI}/{0}?access_key={YOUR_API_KEY}"/>
</providers>
</geolocation></code></pre>
<p>This config will switch geolocation to your custom one. You can modify type and geoApiUrl to fit your needs and notice that {0} will be filled with user IP when making a request to api.</p>
<h3><strong>2. Create custom provider to fetch api result</strong><strong></strong></h3>
<p>Firstly, we add a new provider class that inherit GeolocationProviderBase class and ICustomGeolocationProvider interface (this is required because Forms will scan all implementation of ICustomGeolocationProvider to process). In this sample, i created a provider class named CustomGeolocaitonProvider</p>
<pre class="language-csharp"><code> public class CustomGeolocationProvider : GeolocationProviderBase, ICustomGeolocationProvider
{
private string _geoApiUrl { get; set; }
private static readonly ILogger _logger = LogManager.GetLogger(typeof(FreeGeolocationProvider));
public override IGeolocationResult Lookup(System.Net.IPAddress address)
{
return GetGeoData(address.ToString()).Result;
}
private async Task<EPiServer.Forms.Internal.GeoData.GeolocationResult> GetGeoData(string clientIp)
{
if (string.IsNullOrEmpty(clientIp))
{
return null;
}
//create request and get reponse in Json from API
var request = (HttpWebRequest)WebRequest.Create(string.Format(_geoApiUrl, clientIp));
request.Method = WebRequestMethods.Http.Get;
request.Accept = "application/json";
var response = await request.GetResponseAsync().ConfigureAwait(false);
string jsonResponse = "";
using (var reader = new StreamReader(response.GetResponseStream()))
{
jsonResponse = reader.ReadToEnd();
}
if (string.IsNullOrEmpty(jsonResponse))
{
return null;
}
EPiServer.Forms.Internal.GeoData.GeolocationResult result;
try
{
//convert json response to GeolocationResult
dynamic geoJsonData = jsonResponse.ToObject();
result = new EPiServer.Forms.Internal.GeoData.GeolocationResult
{
ip = geoJsonData["ip"],
country_code = geoJsonData["country_code"],
country_name = geoJsonData["country_name"],
region_code = geoJsonData["region_code"],
region_name = geoJsonData["region_name"],
city = geoJsonData["city"],
zip_code = geoJsonData["zip"],
time_zone = geoJsonData["time_zone"]?.id,
latitude = geoJsonData["latitude"],
longitude = geoJsonData["longitude"],
CountryCode = geoJsonData["country_code"],
Region = geoJsonData["region_name"],
};
}
//if jsonResponse is not a valid json string:
catch
{
_logger.Error("Free Geo Api does not return a valid json string");
return null;
}
return result;
}
public override IEnumerable<string> GetCountryCodes(string continentCode)
{
throw new NotImplementedException();
}
public override IEnumerable<string> GetRegions(string countryCode)
{
throw new NotImplementedException();
}
public override void Initialize(string name, System.Collections.Specialized.NameValueCollection config)
{
base.Initialize(name, config);
//get geoApiUrl in Provider Config
if (string.IsNullOrEmpty(config["geoApiUrl"]))
{
throw new ConfigurationErrorsException("Invalid configuration. Geo API url is missing");
}
_geoApiUrl = config["geoApiUrl"];
}
public override Capabilities Capabilities => throw new NotImplementedException();
public IGeoDataProcessService GeoDataProcessService
{
get
{
return new CustomGeoDataProcessService();
}
}
}</code></pre>
<p>In this provider class, we care about two methods: GetGeoData - method will handle geolocation data receiving and GeoDataProcessService - method return data processor. In GetGeoData method, just go ahead and write your code to pull api geo location data. I'm assuming your api is returning json data, the code is nothing but a simple api call using WebRequest. </p>
<pre class="language-csharp"><code> var request = (HttpWebRequest)WebRequest.Create(string.Format(_geoApiUrl, clientIp));
request.Method = WebRequestMethods.Http.Get;
request.Accept = "application/json";
var response = await request.GetResponseAsync().ConfigureAwait(false);
string jsonResponse = "";
using (var reader = new StreamReader(response.GetResponseStream()))
{
jsonResponse = reader.ReadToEnd();
}
if (string.IsNullOrEmpty(jsonResponse))
{
return null;
}</code></pre>
<p>After receving json response from api, the remaining task is so simple, you just need to create a new GeoLocationResult instance to store all json data by mapping field by field of json to result model or you can custome result here. The tricky point is that you need to map result property value to the right json object property. For example, my api return json result with "zip": "XXX" but the other api return "zip_code": "XXX".</p>
<pre class="language-csharp"><code> try
{
//convert json response to GeolocationResult
dynamic geoJsonData = jsonResponse.ToObject();
result = new EPiServer.Forms.Internal.GeoData.GeolocationResult
{
ip = geoJsonData["ip"],
country_code = geoJsonData["country_code"],
country_name = geoJsonData["country_name"],
region_code = geoJsonData["region_code"],
region_name = geoJsonData["region_name"],
city = geoJsonData["city"],
zip_code = geoJsonData["zip"],
time_zone = geoJsonData["time_zone"]?.id,
latitude = geoJsonData["latitude"],
longitude = geoJsonData["longitude"],
CountryCode = geoJsonData["country_code"],
Region = geoJsonData["region_name"],
};
}
//if jsonResponse is not a valid json string:
catch
{
_logger.Error("Free Geo Api does not return a valid json string");
return null;
}</code></pre>
<p>After get geo data, we'll need one more step to process the data. Method GeoDataProcessService return a service named GeoDataProcessService that will be created on the next step.</p>
<h3><strong>3. Add a custom geolocation data process service </strong></h3>
<p>Add a new class, name it whatever you want, inherit IGeoDataProcessService with code as below:</p>
<pre class="language-csharp"><code> public class CustomGeoDataProcessService : IGeoDataProcessService
{
EPiServer.Forms.Internal.GeoData.GeolocationResult IGeoDataProcessService.ProcessGeoData(IGeolocationResult geoLocationResult)
{
var result = geoLocationResult as EPiServer.Forms.Internal.GeoData.GeolocationResult;
return result;
}
}</code></pre>
<p>This class has only one method and it gets IGeolocationResult from provider's Lookup method and return strong typed result. This step is mandatory because Forms requires a data processor.</p>
<p>Compile, run and subit forms, im now able to capture geolocation info as exact as api result. </p>
<p><img src="/link/9e29603508f74447acad69fae9ab0631.aspx" width="440" height="177" /></p>
<p>*Note: The form's element will work only if site is online, the local sites won't be able to capture gelocation data.</p>
<p><span>If you have any questions in relation to this post, please comment below. Thanks!</span></p>2019-01-04T05:44:30.0000000ZBlog post