Skip to main content
Version: 8.1

Debug C# code

Level: advanced

1. Export the C# code schemas to the local directory files

  1. Modify the Creatio configuration files to debug C# code.

    1. Set the debug attribute of the <compilation> element to true in the Web.config configuration file located in the Creatio root directory.

      <compilation debug="true" targetFramework="4.5" />

      Save the file.

    2. Set the following values in the Web.config configuration file located in the ...\Terrasoft.WebApp directory:

      • Set IncludeDebugInformation to "true."
      • Set ExtractAllCompilerSources to "true" (if you need to export all schemas while executing the Compile action in the Configuration section) or "false" (if you need to export only modified schemas, the default value).
      <add key="IncludeDebugInformation" value="true" />
      <add key="ExtractAllCompilerSources" value="false" />

      Save the file.

  2. Execute the Compile all action in the Configuration section.

As a result of compilation, Creatio will export the files that contain the source code of configuration schemas to the ../Terrasoft.WebApp/Terrasoft.Configuration/Autogenerated/Src directory. For example, configuration libraries, their modules, and files that contain debugging information (*.pdb files). Creatio exports the source code of schemasupon each compilation.

The file names of exported schemas follow this pattern: SchemaNameInConfiguration.PackageName_SchemaType.cs, for example, Contact.Base_Entity.cs, ContractReport.Base_Report.cs.

2. Create a Visual Studio Code project for debugging


You do not have to create a Visual Studio project to debug the source code. You can simply open the needed files in Visual Studio. If you debug files often or need to manage a large number of files at the same time, create a project streamline the workflow.

To create a Visual Studio Code project for debugging:

  1. Click FileNewProject on the Visual Studio toolbar.

  2. Fill out the project properties:

    • Select the "Class Library (.NET Framework)" project type.
    • Enter the project name.
    • Enter the project location.
  3. Delete the Class1.cs file from the project after creating it and save the project.

3. Add the exported files to the Visual Studio Code project

  1. Click AddExisting Item in the context menu of the project in the solution explorer.

  2. Select all files in the exported files directory.


    You can only add files needed to debug to the Visual Studio project. In this case, the transition among methods while debugging is limited to the class methods implemented in the added project files.

  3. Save the project.

4. Connect the project to the IIS server workflow and debug code

  1. Click DebugAttach to process on the Visual Studio toolbar.

  2. Select the IIS workflow where the Creatio instance pool runs from the process list.


    The workflow name depends on the current IIS server configuration and might differ. The process name for the regular IIS Web Server is w3wp.exe and iisexpress.exe for IIS Express.

    By default, IIS runs the working process as the account whose name matches the name of the application pool. To display processes from all users, select the Show processes from all users checkbox.

  3. Open the source code file and set a breakpoint.

    As soon Visual Studio Code runs the method that has a breakpoint set, the program execution is stopped. You can check the current state of the variables and trace the code after stopping.