Provides ratings given to the person in the current year or a specific date range.
All ratings will be aggregated and the average values will be returned.
Note: This method works with inhouse suppliers only. For external suppliers use this method: This method returns a business analytics report for a supplier company or person.
The report is calculated from the jobs that were assigned to the supplier and includes:
- Total job volume and monthly volume
- Total editing actions (translated or revised segments, post edits etc.)
- Statistics on response time, delivery in time, ratings and metrics etc.
- Clients, managers and other suppliers for or with which the supplier worked (team setups)
This information is identical to what you can see in Wordbee Translator: Navigate to a supplier's company page or an inhouse worker's page and click the "Statistics" tab.
Note: For this method to work you need to have a subscription for the Business Analytics component.
URL
(GET) /ba/suppliers/{cid}/{uid}
PARAMETERS
The URL parameters are:
uid | The person ID | int, Mandatory |
Optional range of data to aggregate. | ||
fromyearcid | Company for which to return data. This parameter is mandatory. The ID can be the platform company (My Company). | int, Mandatory |
uid | Optionally restricts data to a specific user within the company. | int?, Optional |
Jobs filter (optional): | ||
task | Delimit report to jobs of this specific task type. For example: "TR", "RV"... If not set then data for jobs of any kind are loaded. | string?, Optional |
sloc | Delimit report to jobs with this source locale. | string?, Optional |
tloc | Delimit report to jobs with this target locale. | string?, Optional |
manager | Delimit report to jobs to projects managed by this user. | int?, Optional |
client | Delimit report to projects (and their jobs) where the client company is this ID. | int?, Optional |
Date range filter (optional): | ||
year | Aggregate analytical data starting with this year (2016, 2017....). If not specified then set to the current year. | int?, Optional |
frommonthmonth | Aggregate analytical data starting with this month of the year (1, 2...12). If not specified then set to 1. | int?, Optional |
toyearyearto | Aggregate analytical data up to and including this year (2016, 2017....). If not specified then same as "fromyearyear". | int?, Optional |
tomonthmonthto | Aggregate analytical data up to and including this month of the year (1, 2...12). If not specified then set to 12same as "month". | int?, Optional |
Examples:
Get analytical data for the current year (January to current month) and company 12344:
/personsba/{uid}/ba/ratingssuppliers/12344
Get analytical data for March to April 2017 and person 223 of company 12344:
/personsba/{uid}suppliers/ba12344/ratings223?fromyearyear=2017&frommonthmonth=3&tomonthmonthto=124
RESULTS
A JSON with these properties:
comments | An array of all comments of the segment, sorted by descending date. It includes comments in all the scope languages to which the user has access. See Comment (Object) for details. | object[] | ||
history | An array of all text and flag changes of the segment, sorted by descending date. These are notably changes of the texts by different workers over time. See Segment Change (Object) for details. | object[] | ||
persons | An object containing the persons referred to by comments or revisions. Note:
The object has keys where the key is the person id.
| object | ||
locales | A list of all locales available for this segment and which are within the scope. You can use these in a comments/revisions language filter. | string[] | ||
rights | A few access rights that are specifically useful when working with the results:
Note: When using the APIs to add/edit/delete comments, you may obtain a not authorized information even when the edit, canAdd or canSendEmail properties are true. The reason for this is that further detailed access rights check are done upon those advanced operations. | object |
ACCESS RIGHTS
When working with the timeline of a segment, you should always read out these properties:
- comments.[].edit: Tells if a comment can be edited or deleted.
- rights.canAdd: Tells if a new comment can be added to the segment.
- rights.canSendEmail: Tells if a newly added comment can be notified by email to people involved with this segment.
EXAMPLE
Here we get details for a target document with
...
strings | Object that contains names of companies, persons and task codes that are referenced by this report. We include this purely for convenience so that you do not need to issue more calls to get the names. Properties:
| object | |
volume | Contains work volume information with totals and individually for each type of job and month:
How monthly volume can be rendered: | object | |
actions | Provides information on the total changes done in segments. Example: If user A edits a segment, which is then edited by B and again edited by A. We count 3 actions for supplier: 1 translation action, 1 corrected, 1 revision. We count 2 actions for A: 1 revision, 1 corrected.
| ||
histo | Provides histograms for detailed analysis of supplier response times (time from reception of job to acceptance of job), respect of deadlines: Histograms are stored in these properties:
In addition you find:
Each histogram is an object with these properties:
Example histogram:
| ||
workers | If the BA report is generated for "My company" you will find the list of all inhouse workers. Each array element has these properties:
| ||
managers | List of all project managers involved with the jobs. Same structure as workers above. | ||
clients | List of all client companies involved with the jobs. Same structure as workers above. | ||
languages | Volume per language couple. An array with objects:
| ||
team | Information on other companies or workers with which the present supplier was involved in workflows. An array with objects:
| ||
ratings | Ratings given to the jobs of the supplier, either by the supplier himself or his manager. A rating is a value between 1 (worst) and 5 (best). There are zero, one or more categories that can be rated. The categories are configured in the Wordbee Translator platform.
Each of these two objects has these properties:
Each histogram has these properties:
Example:
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
This is how a histogram could be rendered (no ratings done here):
|
SCOPE OF DATA
Supplier data in this report is provided by the Wordbee Translator BA component:
- Live data is aggregated per calendar day with a lag of 3 to 4 days. Thus you will not see any data later than 3 to 4 days ago.
- The report comprises completed jobs only.
EXAMPLE
Sample results for an external supplier company:
Example - ba/suppliers/{cid}/{uid}