Организационные диаграммы являются необходимыми для визуализации структуры команд, отделов и отношений подчинения внутри компании. Они помогают руководству и сотрудникам понять иерархию и взаимосвязи между ролями в организации. Автоматизация создания этих диаграмм на C# позволяет разработчикам динамически генерировать визуальные представления из HR‑баз данных, проектных команд или корпоративных каталогов без необходимости ручного проектирования в Visio или других инструментах для создания диаграмм.

Этот учебник объясняет, как создать организационную диаграмму на C# программно, используя библиотеку диаграмм. Вы узнаете, как добавлять иерархические узлы, соединять фигуры с помощью соединителей и автоматически размещать диаграмму, используя алгоритм CompactTree для чистого и профессионального вида.

Почему создавать организационную схему программно?

  • Автоматизировать HR‑процессы для создания и обновления диаграмм при изменениях персонала или структуры.
  • Создавать четкие и стандартизированные диаграммы иерархии без необходимости вручную рисовать их в Visio.
  • Экономить время, интегрируя генерацию диаграмм в существующие системы, такие как управление персоналом или панели отчетности.
  • Обеспечить единообразный дизайн, программно применяя стили фигур, соединители и правила компоновки.
  • Экспортировать диаграммы напрямую в формат Visio (VSDX) для совместного использования и дальнейшего редактирования при необходимости.

Создание организационной диаграммы на C#

  1. Добавьте библиотеку диаграмм в ваш проект C#, чтобы получить доступ к API создания и размещения Visio.
  2. Инициализируйте новый объект Diagram и загрузите базовые фигуры и соединители из файла шаблона Visio.
  3. Определите иерархическую структуру или набор данных, представляющих организационные отношения.
  4. Динамически добавляйте фигуры для каждого узла в иерархии и сохраняйте их идентификаторы для сопоставления соединений.
  5. Используйте соединители, чтобы связать дочерние фигуры с их родительскими узлами, формируя иерархическое дерево.
  6. Примените автоматический алгоритм размещения (например, CompactTree), чтобы аккуратно организовать узлы.
  7. Сохраните полученную диаграмму в формате Visio VSDX.
// Load masters from any existing diagram, stencil or template
string visioStencil = dataDir + "BasicShapes.vss";
const string rectangleMaster = "Rectangle";
const string connectorMaster = "Dynamic connector";
const int pageNumber = 0;
const double width = 1;
const double height = 1;
double pinX = 4.25;
double pinY = 9.5;

// Define values to construct the hierarchy
List<string> listPos = new List<string>(new string[] { 
    "0", "0:0", "0:1", "0:2", "0:3", "0:4", "0:5", "0:6", 
    "0:0:0", "0:0:1", "0:3:0", "0:3:1", "0:3:2", "0:6:0", "0:6:1" 
});

// Define a Hashtable to map the string name to long shape id
System.Collections.Hashtable shapeIdMap = new System.Collections.Hashtable();

// Create a new diagram
Aspose.Diagram.Diagram diagram = new Aspose.Diagram.Diagram(visioStencil);
diagram.Pages[pageNumber].PageSheet.PageProps.PageWidth.Value = 11;

// Add shapes for each hierarchy node
foreach (string orgnode in listPos)
{
    long rectangleId = diagram.AddShape(pinX++, pinY++, width, height, rectangleMaster, pageNumber);
    Aspose.Diagram.Shape shape = diagram.Pages[pageNumber].Shapes.GetShape(rectangleId);
    shape.Text.Value.Add(new Aspose.Diagram.Txt(orgnode));
    shape.Name = orgnode;
    shapeIdMap.Add(orgnode, rectangleId);
}

// Create connections between parent and child nodes
foreach (string orgName in listPos)
{
    int lastColon = orgName.LastIndexOf(':');
    if (lastColon > 0)
    {
        string parendName = orgName.Substring(0, lastColon);
        long shapeId = (long)shapeIdMap[orgName];
        long parentId = (long)shapeIdMap[parendName];
        Aspose.Diagram.Shape connector1 = new Aspose.Diagram.Shape();
        long connecter1Id = diagram.AddShape(connector1, connectorMaster, pageNumber);
        diagram.Pages[pageNumber].ConnectShapesViaConnector(parentId,
            Aspose.Diagram.Manipulation.ConnectionPointPlace.Right,
            shapeId, Aspose.Diagram.Manipulation.ConnectionPointPlace.Left,
            connecter1Id);
    }
}

// Auto layout CompactTree chart
Aspose.Diagram.AutoLayout.LayoutOptions compactTreeOptions = new Aspose.Diagram.AutoLayout.LayoutOptions
{
    LayoutStyle = Aspose.Diagram.AutoLayout.LayoutStyle.CompactTree,
    Direction = Aspose.Diagram.AutoLayout.LayoutDirection.DownThenRight,
    EnlargePage = false
};

diagram.Pages[pageNumber].Layout(compactTreeOptions);

// Save diagram
diagram.Save(dataDir + "ORGChart_out.vsdx", Aspose.Diagram.SaveFileFormat.Vsdx);

Этот пример кода создает организационную иерархию, соединяет родительские и дочерние узлы с помощью динамических соединителей и применяет автоматическую компоновку CompactTree для чистой структуры. Каждая фигура представляет организационный узел, помеченный в соответствии со списком иерархии, а окончательный результат сохраняется в файл Visio VSDX.

Заключение

Создание организационных диаграмм на C# предоставляет динамический способ визуализировать структуры команд, иерархии отчетности и отношения между отделами без необходимости вручную рисовать их в Visio. Благодаря автоматическому размещению и управлению соединениями вы можете генерировать чистые, читаемые диаграммы непосредственно из источников данных. Представленный выше подход упрощает HR‑отчетность, повышает согласованность и позволяет интегрировать её с бизнес‑автоматизационными рабочими процессами.

См. также