Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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. 
fromyearcidCompany 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): 
taskDelimit 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
slocDelimit report to jobs with this source locale.string?, Optional
tlocDelimit report to jobs with this target locale.string?, Optional
managerDelimit report to jobs to projects managed by this user.int?, Optional
clientDelimit report to projects (and their jobs) where the client company is this ID.int?, Optional
   
 Date range filter (optional): 
yearAggregate analytical data starting with this year (2016, 2017....). If not specified then set to the current year.int?, Optional
frommonthmonthAggregate analytical data starting with this month of the year (1, 2...12). If not specified then set to 1.int?, Optional
toyearyeartoAggregate analytical data up to and including this year (2016, 2017....). If not specified then same as "fromyearyear".int?, Optional
tomonthmonthtoAggregate 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:

  • Excludes persons contained in parameter knownpersons.
  • Excludes persons that the user cannot see. There is an access right to prevent a user from viewing user and company names.

 

The object has keys where the key is the person id.

Code Block
"persons": {
    "_7": {
      "id": 7,
      "nm": "Stephan",
      "cid": 1,
      "cnm": "Tradubee"
    },
    "_3": {
      "id": 3,
      "nm": "Thierry",
      "cid": 1,
      "cnm": "Freelancebee"
    }

 

  • nm: Full name of person
  • id: Id of person
  • cnm: Company of person
  • cid: Company 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:

  • canSendEmail: When a user adds/edits a comment, this boolean tells if the user can notify the comment by email or not.
  • canAdd: Tells if the user can add a new comment in one of the locales.

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:

  • companies: Array of object each with company id ("id") and name ("name")
  • persons: Array of object each with company id ("id") and name ("name")
  • tasks: Array of object each with task code ("id") and name ("name")

 

object
volume

Contains work volume information with totals and individually for each type of job and month:

  • totals: An object with grand totals:
    • task: Always null
    • jobs: Total jobs
    • documents: Total documents in jobs
    • segments: Total segments in jobs
    • words: Total words
    • chars: Total characters
    • wdpreident: Total identically pretranslated words
    • wdprefuzzy: Total fuzzy pretranslated words
    • wdfuzzy: Total fuzzy matches or repetitions
  • tasks: An array that shows the above information individually per job task type. For example if the supplier translated and revised, you will see totals for translation jobs and totals for revision jobs.
  • months: Shows totals per each month in the selected date range. Each array element has these properties:
    • title: The year and month as a string
    • jobs: Total jobs in month
    • words: Total words in month
    • chars: Total chars in month

How monthly volume can be rendered:

Image Added

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.

  • cnt: Total jobs with at least one action
  • total: Total actions
  • translation: Total translation actions i.e. editing previously empty segments
  • revision: Total editing actions i.e. editing of previously human translated segments
  • postediting: Total post-editing actions i.e. editing of previously not human translated segments
  • corrected: Total segments edited by the supplier and which were subsequently edited by someone else
  • segments: Total number of segments concerned by the actions (one segment can have more than one action)

 

 
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:

  • responseTime: Histogram for time from start to completion of jobs.
  • deadlineTime: Histogram for time difference between job completion and deadline.
  • assignedTime: Histogram for time from assignment to acceptance/start of jobs.
  • dailyVolumeAssigned: Histogram for time from start to completion of jobs.
  • dailyVolumeWorked: Histogram for time from start to completion of jobs.
  • dailyVolumeActual: Histogram for time from start to completion of jobs.

In addition you find:

  • responseTimeNone: Total jobs without any response time. Not included in histograms.
  • deadlineTimeNone: Total jobs without deadline. Not included in histograms.

Each histogram is an object with these properties:

  • cnt: Total jobs added to the histogram
  • sum: Sum of all values calculated for all jobs. Depending on the histogram the value can be a time difference, the number of words, etc.
  • nocnt: Total jobs not added in histogram. The reason is that the value to add was not available for the job.
  • slots: The slots of the histogram. An array of objects:
    • label: Title of slot
    • min: Slot minimum value (x-axis)
    • max: Slot maximum value (x-axis)
    • cnt: Total jobs counted in slot (y-axis). Total jobs for which the calculate value in slot's min/max range
    • pdf: Cumulative count from first slot up to this slot

 

Example histogram:

Image Added

 

 

 
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:

  • id: If 0 then the record is for jobs not assigned to a specific worker or assigned to a now deleted worker. Otherwise the id of the worker.
  • jobs: Jobs assigned to worker
  • documents
  • words
  • chars
  • jobsintime: Total jobs delivered in time
  • acnt: Total jobs with actions. If different from "jobs", then the worker did not do any changes in some jobs.
  • atot: Total actions.
  • acr: Total corrected actions.

 

 
managers

List of all project managers involved with the jobs. Same structure as workers above.

 
clientsList of all client companies involved with the jobs. Same structure as workers above. 
languages

Volume per language couple. An array with objects:

  • id: Language couple key
  • st: Source locale
  • tt: Target locale
  • jobs: Total jobs
  • words: Total words
  • chars: Total chars

 

 
team

Information on other companies or workers with which the present supplier was involved in workflows. An array with objects:

  • cid: Other company
  • pid: Other worker. 0 if not specific person.
  • task1: Task type of this supplier
  • task2: Task type of suppier cid/pid
  • jobs: Total jobs
  • words: Total words
  • chars: Total chars

 

Image Added

 

 

 
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.

  • manager: An object with ratings given by manager
  • supplier: An object with ratings given by supplier him/herself

Each of these two objects has these properties:

  • rated: Total jobs rated
  • unrated: Total jobs not rated
  • all: A histogram that gives the total ratings (all categories combined) per rating values 1, 2, 3, 4, 5
  • q: An array with the histograms per each rating category.

Each histogram has these properties:

  • q: Rating ategory id.
  • qtitle: Title of rating category.
  • cnt: Total ratings.
  • avg: Average rating value
  • std: Standard deviation.
  • s: An integer array with one element per rating value (1, 2... 6). Each element is the total jobs rated.

 

Example:

Code Block
   "worker": {
      "rated": 0,
      "

...

unrated": 

...

6,
      "

...

all": 

...

{

...


...

 

...

       "

...

q": 

...

-

...

1,
 

...

 

...

      

...

"

...

qtitle": 

...

"All ratings",
        "

...

cnt": 

...

4,
      

...

 

...

 

...

"

...

avg": 

...

4,

...


...

 

...

       "

...

std": 

...

2,
        "

...

s": 

...

[
      

...

 

...

   

...

0,
  

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 0,
          1,
          4,
          1
        ]
      },
  

...

    

...

"

...

q"

...

: [
       

...

 {
      

...

 

...

   

...

"

...

q": 

...

0,
  

...

 

...

       "

...

qtitle": "

...

Overall",
  

...

 

...

       "

...

cnt": 

...

0,

...

...

 

This is how a histogram could be rendered (no ratings done here):

Image Added

 

 

 

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}