Diagramy organizacyjne są niezbędne do wizualizacji struktury zespołów, działów i relacji raportowania w firmie. Pomagają zarządowi i pracownikom zrozumieć hierarchię oraz powiązania między rolami w organizacji. Automatyzacja tworzenia tych diagramów w C# umożliwia programistom dynamiczne generowanie wizualizacji z baz danych HR, zespołów projektowych lub katalogów korporacyjnych bez ręcznego projektowania w Visio lub innych narzędziach do diagramowania.

Ten samouczek wyjaśnia, jak utworzyć wykres organizacyjny w C# programowo przy użyciu biblioteki diagramowej. Nauczysz się dodawać węzły hierarchiczne, łączyć kształty za pomocą łączników oraz automatycznie układać wykres przy użyciu algorytmu CompactTree, aby uzyskać czysty i profesjonalny wygląd.

Dlaczego tworzyć wykres organizacyjny programowo?

  • Automatyzuj przepływy pracy HR, aby generować i aktualizować wykresy, gdy zachodzą zmiany personelu lub struktury.
  • Twórz czytelne i standaryzowane diagramy hierarchii bez konieczności ręcznego rysowania ich w programie Visio.
  • Oszczędzaj czas, integrując generowanie wykresów z istniejącymi systemami, takimi jak zarządzanie pracownikami lub pulpity raportowe.
  • Zapewnij spójny projekt, programowo stosując style kształtów, łączniki i zasady układu.
  • Eksportuj wykresy bezpośrednio do formatu Visio (VSDX) w celu udostępniania i dalszej edycji w razie potrzeby.

Utwórz wykres organizacyjny w C#

  1. Dodaj bibliotekę diagramów do swojego projektu C#, aby uzyskać dostęp do interfejsów API tworzenia i układu Visio.
  2. Zainicjuj nowy obiekt Diagram i załaduj podstawowe kształty oraz łączniki z pliku szablonu Visio.
  3. Zdefiniuj strukturę hierarchiczną lub zestaw danych reprezentujący relacje organizacyjne.
  4. Dodaj kształty dynamicznie dla każdego węzła w hierarchii i przechowaj ich identyfikatory w celu mapowania połączeń.
  5. Użyj łączników, aby połączyć kształty potomne z ich węzłami nadrzędnymi, tworząc drzewo hierarchiczne.
  6. Zastosuj automatyczny algorytm układu (np. CompactTree), aby uporządkować węzły w przejrzysty sposób.
  7. Zapisz powstały diagram w formacie 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);

Ten przykład kodu tworzy hierarchię organizacyjną, łączy węzły nadrzędne i podrzędne przy użyciu dynamicznych łączników oraz stosuje automatyczny układ CompactTree, aby uzyskać przejrzystą strukturę. Każdy kształt reprezentuje węzeł organizacyjny oznaczony zgodnie z listą hierarchii, a końcowy wynik jest zapisywany jako plik Visio VSDX.

Conclusion

Tworzenie wykresów organizacyjnych w C# zapewnia dynamiczny sposób wizualizacji struktur zespołów, hierarchii raportowania i relacji działowych bez ręcznego rysowania w Visio. Dzięki automatycznemu układowi i zarządzaniu połączeniami możesz generować czyste, czytelne wykresy bezpośrednio z źródeł danych. Pokazane powyżej podejście upraszcza raportowanie HR, zwiększa spójność i umożliwia integrację z przepływami automatyzacji biznesowej.

See Also