Start by implementing a function called CreateProject. Create a file-based project object called newProject based on the class FileBasedProject. In our example we provide the project properties as parameter. We recommend that you generate the project properties through a separate helper function called e.g. GetProjectInfo as shown below:

FileBasedProject newProject = new FileBasedProject(info);

In the GetProjectInfo helper function, we first create a ProjectInfo object:

ProjectInfo info = new ProjectInfo();

info.Name = "My First Project";
info.Description = "This is a programmatically created project.";
info.DueDate = DateTime.Now.AddDays(3);

• Project name, which can be any descriptive name
• The (optional) project description
• The (optional) project due date, e.g. 3 days from now

The screenshot below illustrates how this information is entered in the New Project wizard of SDL Trados Studio 2017.

All project files, i.e. translatable and localizable documents, reference files, project TMs, etc. are stored in a specific folder. By default, the main folder used for storing projects is: C:\Documents and Settings\UserName\My Documents\Studio 2017\Projects. Below this main folder SDL Trados Studio 2017 creates sub-folders that carry the name of the respective project. However, you could just as well pick any other folder name, as long as the specified folder is empty so as to avoid collisions with existing files. In the example below we follow the default folder rule of SDL Trados Studio 2017 by selecting the Studio 2017\Projects\ folder below MyDocuments, and by appending the project name sub-folder. We then set the LocalProjectFolder property accordingly as shown in the example below:

string localProjectFolder = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments).ToString() +
    Path.DirectorySeparatorChar + @"Studio 2011\Projects\" + info.Name;

info.LocalProjectFolder = localProjectFolder;

A project must have at least one language pair, i.e. a source language and one target language. Projects can have only one source language, but multiple target languages. The screenshot below illustrates how languages are selected in SDL Trados Studio 2017:

For this example, let us assume that the source language should be English (US), and the target languages German and French. First, we create the source language object through the Language class. The language object takes the CultureInfo as parameter. Then we assign the source language object to the project info by applying the SourceLanguage property:

Language srcLang = new Language(CultureInfo.GetCultureInfo("en-US"));
info.SourceLanguage = srcLang;

Language[] trgLangs = new Language[] { new Language(CultureInfo.GetCultureInfo("de-DE")), new Language(CultureInfo.GetCultureInfo("fr-FR")) };
info.TargetLanguages = trgLangs;

After setting the above project properties, do not forget to return the project info object:

return info;

Furthermore, to persist the project information in the project object, you need to apply the Save method:

newProject.Save();

After running the above code you should already see a result in the projects folder as illustrated in the screenshot below:

Even if you have not added any translatable files yet, you will end up generating the project sub-folder (i.e. Projects\My first project), which contains the *.sdlproj file, and a sub-folder called File Types, which contains the file type definition (*.sdlfiletype) files for all document types that are currently supported by SDL Trados Studio 2017. In the following chapters you will learn how to add documents, TMs, termbases, etc. to turn your sample into a meaningful project. Note that if you run your sample application again while the My first project is still there, an error will be thrown, as the folder is not empty. It is recommended that when you re-run your sample application for testing purposes that you delete the project sub-folder, so that you have a fresh start (see also Deleting Projects).

Also note that the C:\Documents and Settings\Administrator\My Documents\Studio 2017\Projects folder contains a file called projects.xml. This is a meta file that contains references to all the projects that have been created in SDL Trados Studio 2017. The projects that you create programmatically will not be referenced in this file, and thus not be listed in SDL Trados Studio 2017, which is by design. However, you can, of course, open the programmatically created *.sdlproj file in SDL Trados Studio 2017.

The complete function for setting the project properties should look as shown below:

public ProjectInfo GetProjectInfo()
{
    #region "InfoObject"
    ProjectInfo info = new ProjectInfo();
    #endregion

    #region "GeneralInfo"
    info.Name = "My First Project";
    info.Description = "This is a programmatically created project.";
    info.DueDate = DateTime.Now.AddDays(3);
    #endregion

    #region "ProjectFolder"
    string localProjectFolder = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments).ToString() +
        Path.DirectorySeparatorChar + @"Studio 2011\Projects\" + info.Name;

    info.LocalProjectFolder = localProjectFolder;
    #endregion

    #region "SourceLanguage"
    Language srcLang = new Language(CultureInfo.GetCultureInfo("en-US"));
    info.SourceLanguage = srcLang;
    #endregion

    #region "TargetLanguages"
    Language[] trgLangs = new Language[] { new Language(CultureInfo.GetCultureInfo("de-DE")), new Language(CultureInfo.GetCultureInfo("fr-FR")) };
    info.TargetLanguages = trgLangs;
    #endregion

    #region "ReturnInfo"
    return info;
    #endregion
}

Other Resources