AgileApps Support Wiki Pre Release

Difference between revisions of "REST API:translationWorkbench Resource"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 10: Line 10:
   
   
;URI:
;URI:
:<tt><nowiki>https://{domain}/networking/rest/translationWorkBench/{elem}/{id}</nowiki></tt>
:<tt><nowiki>https://{domain}/networking/rest/translationWorkBench/{elem}/{key}</nowiki></tt>
:<tt><nowiki>https://{domain}/networking/rest/translationWorkBench/{elem}/{id}?args=param1,...</nowiki></tt>  
:<tt><nowiki>https://{domain}/networking/rest/translationWorkBench/{elem}/{key}?args=param1,...</nowiki></tt>  
where:
where:
::* '''{elem}''' - Is the internal name for one of the [[Translation Workbench]] elements:  
::* '''{elem}''' - Is the internal name for one of the [[Translation Workbench]] elements:  
Line 37: Line 37:
|}
|}


::* '''id''' - Is the identifier for a translated string.<br>(For the Custom Label category, that ID takes the form <tt>{category}.{token_id}</tt>.)
::* '''key''' - Is the index value used to look up a translated string.<br>(For the Custom Label category, that ID takes the form <tt>{category}.{token_id}</tt>.)


{{Query Parameters|
{{Query Parameters|

Revision as of 00:34, 16 June 2011

Get translated strings using the REST API.

Learn more: REST API Conventions and Considerations.

Requirements

Get a Translation

Method
GET
URI
https://{domain}/networking/rest/translationWorkBench/{elem}/{key}
https://{domain}/networking/rest/translationWorkBench/{elem}/{key}?args=param1,...

where:

action
application
customlabel
enumeratedfield

field
form
globalpicklist
homepage

object
reportfolder
report
sidebar

validation
view
webtab
workflow

  • key - Is the index value used to look up a translated string.
    (For the Custom Label category, that ID takes the form {category}.{token_id}.)
Query Parameters
  • args - A list of one or more arguments that will be interpolated into the string at the locations assigned to them when the base string was created.
For more information, see: Specifying Query Parameters in REST APIs
Response
This sample response comes in reply to the request, http://localhost/networking/rest/translationWorkBench/customlabel/validation.record_deleted?args=5, when the user's language is Spanish.
<syntaxhighlight lang="xml" enclose="div">

<platform>

   <translationWorkBench>
       <key>validation.record_deleted</key>
       <translatedText>5 registros eliminados con éxito</translatedText>
   </translationWorkBench>
   <message>
       0
       <description>Success</description>
   </message>

</platform> </syntaxhighlight>

See also: REST API:Error Codes

Fields

Name Type Description
key String The ID of the translated element, in the form {category}.{token_id}. For example: validation.record_deleted
translatedText String The translation for the key, in the current user's language, with any arguments in the request interpolated into the string.