resources/segments/finder/properties

resources/segments/finder/properties

Returns the translation finder details for a scope. The scope defines which resources are accessible and can be searched.

URL

(POST) /resources/segments/finder/properties

PARAMETERS

The message body contains a JSON object:

scope

The scope object. It delimits the total range of segments and related resources that can be operated on.

 

RESULTS

The message body contains a JSON object:

resources

An array of resource. The searchable translation memories, project memories and term bases linked to the scope.

If your scope is for a project or job, then this is the list of resources attached to the project by the project manager.

If the scope is a memory, then this will contain the memory only.

token

A newly created finder token. You can use this for subsequent searches if you did not yet obtain a token earlier in a session.

 

Each resource has these properties:

 

Properties of a resource

 

Properties of a resource

dsid

The document set id.

ctype

Content type of resource: 0 = Documents, 1 = Translation memory, 2 = Terminology database

name

Name of resource.

workedon

Boolean. True if the scope is part of the resource. For example if you are editing a document of a project, the list of resources will contain the corresponding project memory with workedon equals true.

rating

A user given rating for the resource. Value between 0 (no rating), 1 (lowest)... 5 (highest)

scopeDocumentSet

A scope to access the resource in a view. Null if you have no access right to viewing the complete resource.

scopeProject

If the ctype is Documents then it is a document of a project. This is the scope to view the segments in the scope of a project.

A scope  to access the project in a view. Null if you have no access right to viewing the complete resource.

segments

Total number of segments.

canEdit

Null/True/False. Tells if you have the right to edit segments of the resource. Null if you need to first create a scope to see if you have this right or not.

canAdd

Null/True/False. Tells if you have the right to add new segments to the resource. Null if you need to first create a scope to see if you have this right or not.

canDelete

Null/True/False. Tells if you have the right to remove segments from the resource. Null if you need to first create a scope to see if you have this right or not.

localesSource

The source locales of the resource that you can search. Depending on your access rights you may not have access to all locales.

locales

The list of all locales of the resource to which you have access.

lbls

Array of all labels of the resource (and which you are allowed to view). The array may be empty. Each array element is an object with label id and label value. Example:

"lbls": [ { "id": 38, "v": 1 }, { "id": 63, "v": 1 }

cfs

Array of all custom fields of the resource (and which you are allowed to view). The array may be empty. Each array element is an object with custom field id and value. Example:

"cfs": [ { "id": 1, "v": "Mechanics" }, { "id": 3, "v": "http://www.wordbee.com" }



params

 Advanced search parameters that can be configured individually per resource:

 params.strict

Boolean. True if resource is configured for strict language mode. I.e. if you search in "en-UK" and the resource uses "en-US" then it will consider the language variants as distinct languages.

params.pretrans

Boolean. True if you can use this resource for automated pre-translation purposes. If false, then the PM probably considers the contents not reliable enough.

params.skipprob

Boolean. True if segments with red status shall never be searched.

params.skipsame

Boolean. True if segments where the source text equals the target text shall never be searched.

params.pen

Number. Absolute downgrade of match percentage. 0, 1, ... 100  (0 = no downgrade)

params.penum

Number. Absolute downgrade of unreliable exact matches. 0, 1, ... 100  (0 = no downgrade)

params.penformat

String. Penalty mode applied to format differences: None, Lowest, Low, Average, High, Highest

params.penfuzzy

String. Penalty mode applied to fuzzy matches: None, Lowest, Low, Average, High, Highest

params.penplace

String. Penalty mode applied to placeables: Default, None, Maximum

params.white

String. Whitespace handling mode: Default, IgnoreType, IgnoreTypeAndLength, SpecialCYK1

 

EXAMPLES

See this example:

{{ "resources": [ { "dsid": 4507, "ctype": 1, "name": "test notif", "rating": 3, "scopeDocumentSet": { "type": "DocumentSet", "dsid": 4507 }, "scopeProject": { "type": "Project", "projectid": 2863 }, "workedon": true, "segments": 33, "canEdit": null, "canAdd": null, "canDelete": null, "localesSource": [ "en" ], "locales": [ "en", "en-US", "fr" ], "lbls": [], "cfs": [], "params": { "strict": false, "pretrans": true, "skipprob": false, "skipsame": true, "pen": 0, "penum": 99, "penformat": "None", "penfuzzy": "Lowest", "penplace": "Default", "white": "Default" } }, { "dsid": 4210, "ctype": 1, "name": "Test minimum charge codyt", "rating": 3, "scopeDocumentSet": { "type": "DocumentSet", "dsid": 4210 }, "scopeProject": { "type": "Project", "projectid": 2590 }, "workedon": true, "segments": 65, "canEdit": null, "canAdd": null, "canDelete": null, "localesSource": [ "en" ], "locales": [ "en", "fr" ], "lbls": [ { "id": 38, "v": 1 }, { "id": 63, "v": 1 }, { "id": 98, "v": 0 } ], "cfs": [ { "id": 1, "v": "asdasd" }, { "id": 3, "v": "sdfsdfsdf" }, { "id": 5, "v": "Option 3" }, { "id": 6, "v": "Do not translate data in brackets [] or carats <>, unless highlighted in yellow or explicitly specified." } ], "params": { "strict": false, "pretrans": true, "skipprob": true, "skipsame": false, "pen": 0, "penum": 99, "penformat": "None", "penfuzzy": "Lowest", "penplace": "Default", "white": "Default" } }, { "dsid": 840, "ctype": 2, "name": "Glossy_Expressions", "rating": 3, "scopeDocumentSet": { "type": "DocumentSet", "dsid": 840 }, "scopeProject": null, "workedon": true, "segments": 1062, "canEdit": true, "canAdd": true, "canDelete": true, "localesSource": [ "en" ], "locales": [ "en", "en-GB", "fr" ], "lbls": [], "cfs": [], "params": { "strict": false, "pretrans": true, "skipprob": true, "skipsame": false, "pen": 0, "penum": 99, "penformat": "None", "penfuzzy": "Lowest", "penplace": "Default", "white": "Default" } } ], "token": "616b6435-f579-4dd6-8fca-8bdedb72551d" }}

 

 

 

 

 

 

Copyright Wordbee - Buzzin' Outside the Box since 2008