Job content grouping

By default, when you or the system creates a job, the job may contain translatable segments coming from any file in the project. This default behavior is just fine in most cases, but not all.

You have two means to separate content across jobs:

• Have Beebox create a separate job per each file (one job = one file). Simply configure your project for single file jobs. No need to read further.
• Group files into jobs by their folder or extension. This is what this page is all about.

Content:

Configuring content grouping

Go to the project settings page and navigate to the job settings:

Select a grouping:

• No grouping: The default. A job can contain any content from any file.
• Group by folder: Files inside the same base folder are added into the same job.
• Group by file extension: Files with the same extension (.docx, .html...) will be added into the same job.

Let's assume our project "in" directory contains these files:

in\
	file1.docx
	file2.docx
	marketing\
		brochure.docx
		sub\
			another.html
	technical\
		documentation.docx
		documentation.html

Group content by root folder

Select the ByFolder option in the screen above and save the settings. When you now create jobs, manually or using Autorun, you will get three jobs:

• A job with segments from "file1.docx" and "file2.docx". The group name is "".
• A job with segments from "brochure.docx" and "another.html". The group name is "marketing" in both cases.
• A job with segments from "documentation.docx" and "documentation.html". The group name is "technical".

Group content by file extension

Select the ByExtension option in the screen above and save the settings. You will obtain two jobs:

• A job with segments from "file1.docx", "file2.docx", "brochure.docx" and "documentation.docx". The group name is "docx" in all cases.

Note: A job has a configurable maximum size limit. With big or many files the system may create multiple jobs per base folder.

Configuring job references

You may now want to include the category with the job reference. Go to the project settings page and edit the job reference format:

The {group} placeholder is replaced by the group name such as the base folder or the file extension. This is what we get from the example further up:

Where can I see the category of my jobs?

The content grouping details are shown in various places:

In the jobs list as shown in the screenshot above.

In the job details page: