1.В редакторе решения, модуля, типа сущности или отчета в группе «Структуры и константы» перейдите по ссылке Добавить.

2.В открывшемся редакторе кода доработайте имя структуры, добавьте поля и напишите комментарии, например:

/// <summary>

/// Замещение.
/// </summary>
partial class Substitution
{
  /// Замещающий (кто).
  public IUser User { get; set; }
 
  /// Замещаемый (кого).
  public IUser SubstitutedUser { get; set; }
}

3.Сохраните изменения.

Важно. В перекрытиях и наследниках можно добавлять новые структуры, но нельзя переопределять структуры, которые добавлены в родительском модуле или типе сущности.

Если у структуры нет атрибута Public и она добавлена в редакторе решения, то создавать экземпляры структуры и использовать их:

•можно в коде этого решения и перекрытиях, которые созданы в этом решении. Например, структура создана в решении SolutionDiscipline. Ее можно использовать в этом же решении и его перекрытиях;

•нельзя в коде модулей, типов сущностей и отчетов этого решения и в других решениях.

Если у структуры нет атрибута Public и она добавлена в редакторе модуля, типа сущности или отчета, то создавать экземпляры структуры и использовать их:

•можно в рамках этого модуля. Например, структура добавлена в редакторе типа документа с именем Presentation. Создать экземпляры структуры можно в функции модуля HRPR, в событии отчета ReportAttestation, в действии типа документа Presentation и т.п.

•нельзя в решении, где находится модуль, в перекрытиях, а также в других модулях и решениях.

Например, создан модуль с именем HRPR. В него добавлена структура с данными для расчета исполнительской дисциплины сотрудников подразделений:

/// <summary>

/// Исполнительская дисциплина подразделения.
/// </summary>
partial class DepartmentDiscipline
{
  /// <summary>
  /// Процент исполнительской дисциплины сотрудников.
  /// </summary>
  public int? Discipline { get; set; }
 
  /// <summary>
  /// Подразделение.
  /// </summary>
  public Sungero.Company.IDepartment Department { get; set; }
}

Структура используется в серверной функции этого же модуля:

public List<Structures.Module.DepartmentDiscipline> GetDepartmentsDiscipline()

{
  /// Берутся задания сотрудников и группируются по подразделениям.
  var assignments = Assignments.GetAll().GroupBy(a => a.Performer.Department).ToList();
  /// Возвращается исполнительская дисциплина сотрудников.
  return assignments.Select(assignmentsGroup => Structures.Module.DepartmentDiscipline.Create(this.CalculateDiscipline(assignmentsGroup.ToList()), assignmentsGroup.Key)).OrderBy(s => s.Discipline).ToList();
}

Атрибут Public добавляют, если нужно создавать и использовать экземпляры структуры в других решениях, модулях, типах сущностей и отчетах. Например, в модуле Vacations (Отпуска) добавлена структура:

/// <summary>

/// Отпуск.
/// </summary>
[Public]
partial class Vacation
{
  // Дата начала отпуска.
  public DateTime StartVacation { get; set; }
  
  //Дата завершения отпуска.
  public DateTime EndVacation { get; set; }
  
  /// Отпускник.
  public IUser Vacationer { get; set; }
 
}

Ее можно использовать в рамках этого модуля и в других модулях, решениях и перекрытиях:

Важно. Чтобы обратиться к структуре с атрибутом Public, нужно использовать интерфейс структуры. Например, в модуле HRPR добавлена серверная функция, в которой создается экземпляр структуры из модуля Vacations:

public Vacations.Structures.Module.IVacation CreateVacation()

{
  var StartDate = Calendar.Today.NextWorkingDay();
  var EndDate = StartDate.AddWorkingDays(7);
  var vacation = Vacations.Structures.Module.Vacation.Create(StartDate, EndDate, Users.Current);
  return vacation;
}

Интерфейс структуры используется в типе возвращаемого значения: написано Structures.Module.IVacation, а не Structures.Module.Vacation.

Чтобы создать экземпляр структуры, используйте метод Create() с параметрами или без них. Параметрами являются поля структуры. Формат вызова метода зависит от того, в каком редакторе элемента разработки добавлена структура.

Функции

Константы