AgileApps Support Wiki Pre Release

Difference between revisions of "REST API:translationWorkbench Resource"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
 
(9 intermediate revisions by the same user not shown)
Line 6: Line 6:
:* Translations have been created in the [[Translation Workbench]]
:* Translations have been created in the [[Translation Workbench]]


===Get a Translation===
===Get a Translation for a Custom Label===
;Method:GET
;Method:GET
 
;URI:
;URI:
:<tt><nowiki>https://{domain}/networking/rest/translationWorkBench/{elem}/{key}</nowiki></tt>
:<tt>{{platformURL}}/rest/translationWorkBench/customlabel/{key}</tt>
:<tt><nowiki>https://{domain}/networking/rest/translationWorkBench/{elem}/{key}?args=param1,...</nowiki></tt>  
:<tt>{{platformURL}}/rest/translationWorkBench/customlabel/{key}?args=param1,...</tt>  
:where:
:where:
::* '''{elem}''' - Is the internal name for one of the [[Translation Workbench]] elements
::* '''{key}''' - The index value used to look up a translated string, in the form  <tt>{category}.{token_id}</tt>
::* '''key''' - Is the index value used to look up a translated string
 
:The possible values are shown in this table:
 
::{| border="1" cellpadding="5" cellspacing="1"
! Element !! Key Format
|-
| action || <tt>{object_name}.{action_name}</tt>
|-
| application || <tt>{application_name}.{sub_type}</tt>, where <tt>{sub_type}</tt> is either <tt>label</tt> or <tt>widgetTitle</tt>.
|-
| customlabel || <tt>{category}.{token_id}</tt>
|-
| enumeratedfield || <tt>{object_name}.{enumerated_field_name}</tt>
|-
| field || <tt>{object_name}.{field_name}</tt>
|-
| form || <tt>{object_name}.{sub_type}.{layout_name}</tt>. For example, Customers.RelatedInformationSection.DefaultLayout.
|-
| globalpicklist || {{TBD|TBD: The "name" column in the GUI shows the picklist name, rather than display label names. Should it be showing the latter? Should the format be <tt>{picklist_name}.{label_name}</tt>? For example: <tt>accountRating.active</tt> -- or <tt>AccountRating.active</tt>?}}
|-
| homepage || <tt>{application_name}.{sub_type}</tt>, where <tt>{sub_type}</tt> is either <tt>label</tt> or <tt>widgetTitle</tt>.
|-
| object || <tt>{object_name}</tt>
|-
| reportfolder || <tt>report_name</tt>
|-
| report || <tt>report_name</tt>
|-
| sidebar || <tt>{sub_type}.{name}</tt>, where <tt>{sub_type}</tt> is either <tt>label</tt> or <tt>widgetTitle</tt>.
|-
| validation || <tt>{object_name}.{validation_message_name}</tt>
|-
| view || <tt>{view_type}.{object_name}.{label_name}</tt>, where <tt>{view_type}</tt> is one of <tt>objectRelatedViews</tt> or <tt>otherViews</tt>.
|-
| webtab || <tt>{sub_type}.{name}</tt>, where <tt>{sub_type}</tt> is either <tt>label</tt> or <tt>widgetTitle</tt>.
|-
| workflow || <tt>{object_name}.{workflow_name}.{label_name}</tt>
|}


{{Query Parameters|
{{Query Parameters|
Line 58: Line 19:


;Response:
;Response:
:This sample response comes in reply to the request, <tt><nowiki>http://localhost/networking/rest/translationWorkBench/customlabel/validation.record_deleted?args=5</nowiki></tt>, when the user's language is Spanish.
:When the user's language is Spanish, this sample response comes in reply to the request:
::<tt>{{platformURL}}/rest/translationWorkBench/customlabel/validation.record_deleted?args=5</tt>
:<syntaxhighlight lang="xml" enclose="div">
:<syntaxhighlight lang="xml" enclose="div">
<platform>
<platform>

Latest revision as of 21:47, 30 March 2012

Get translated strings using the REST API.

Learn more: REST API Conventions and Considerations.

Requirements

Get a Translation for a Custom Label

Method
GET
URI
https://{yourDomain}/networking/rest/translationWorkBench/customlabel/{key}
https://{yourDomain}/networking/rest/translationWorkBench/customlabel/{key}?args=param1,...
where:
  • {key} - The index value used to look up a translated string, in 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
When the user's language is Spanish, this sample response comes in reply to the request:
https://{yourDomain}/networking/rest/translationWorkBench/customlabel/validation.record_deleted?args=5
<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.
Retrieved from "https://agileappscloud.info/aadev-src/index.php?title=REST_API:translationWorkbench_Resource&oldid=13856"