How can we change the locale(display language) programmatically?

Answered Question
Dec 3rd, 2008

Hi, all. I have a question about the AXL,

I want to change the locale from English United State to Thai Thailand but, I have no any idea which funcion. I found the updatePhone, but it seem to many parameter. Please kindly advice me.

I have this problem too.
0 votes
Correct Answer by stephan.steiner about 7 years 11 months ago

This means that it worked out. If you look at the spec (e.g. http://developer.cisco.com/c/document_library/get_file?folderId=192390&name=DLFE-11111.zip&redirect=http%3A%2F%2Fdeveloper.cisco.com%2Fweb%2Faxl%2Fdocs%3Fp_p_id%3Ddoc_library_summary_portlet_WAR_doclibrarysummaryportlet_INSTANCE_DXka%26p_p_lifecycle%3D0%26p_p_state%3Dnormal%26p_p_mode%3Dview%26p_p_col_id%3Dcolumn-1%26p_p_col_count%3D3) you'll see that upon successful execution of updatePhone, you get the uuid of the device back. You'd get something that includes the string error if it fails.

Oh, one thing though: just as with ccmadmin, changing the locale won't change anything on the phone just now.. you have to reset the device to make the change sticky. To do that, you need to execute a doDeviceReset operation and set the isHardReset parameter to true.. that will perform a hard reset of the phone and when it comes back up, it'll load the new locale.

If you're using extension mobility, you need to log out the currently logged in user and then log him back in.. more info about that in the extension mobility api section:http://developer.cisco.com/web/emapi/home. With EM you'll need to give your axl user em proxy rights so that it can log in/out everybody so you don't need to know the user's password.

  • 1
  • 2
  • 3
  • 4
  • 5
Overall Rating: 5 (1 ratings)
Loading.
stephan.steiner Thu, 12/04/2008 - 00:05

updatePhone is the correct method... and the parameter you're looking for is userLocale. By default, it is empty which means the default English US locale, but you can set it to any other locale you have installed on your CCM (e.g. German Germany for German, or French France for French).

And, if you look at the axl documentation again, you'll see that very few parameters are actually mandatory.. something as simple as

SEP1234German Germany is all it takes to change the user locale on phone SEP1234.

Correct Answer
stephan.steiner Thu, 12/18/2008 - 04:57

This means that it worked out. If you look at the spec (e.g. http://developer.cisco.com/c/document_library/get_file?folderId=192390&name=DLFE-11111.zip&redirect=http%3A%2F%2Fdeveloper.cisco.com%2Fweb%2Faxl%2Fdocs%3Fp_p_id%3Ddoc_library_summary_portlet_WAR_doclibrarysummaryportlet_INSTANCE_DXka%26p_p_lifecycle%3D0%26p_p_state%3Dnormal%26p_p_mode%3Dview%26p_p_col_id%3Dcolumn-1%26p_p_col_count%3D3) you'll see that upon successful execution of updatePhone, you get the uuid of the device back. You'd get something that includes the string error if it fails.

Oh, one thing though: just as with ccmadmin, changing the locale won't change anything on the phone just now.. you have to reset the device to make the change sticky. To do that, you need to execute a doDeviceReset operation and set the isHardReset parameter to true.. that will perform a hard reset of the phone and when it comes back up, it'll load the new locale.

If you're using extension mobility, you need to log out the currently logged in user and then log him back in.. more info about that in the extension mobility api section:http://developer.cisco.com/web/emapi/home. With EM you'll need to give your axl user em proxy rights so that it can log in/out everybody so you don't need to know the user's password.

ray_skynet Fri, 12/19/2008 - 00:53

it's work, thank you very much.

More question, if i just change the locale and reset the phone (ignored the other parameters such as username, line, display) the phone still save the original?

Actions

This Discussion