Afficher plusieurs colonnes dans l'image du graphique Gantt rendu

Aperçu

Dans Microsoft Project, les données du projet sont non seulement disponibles dans le formulaire textuel, mais peuvent également être affichées graphiquement en tant que graphique. Les types de graphiques les plus populaires sont le graphique Gantt, l’utilisation des tâches et l’utilisation des ressources. Aspose.Tasks pour .NET prend en charge le rendu des données de projet à un graphique.

Cet article décrit deux approches qui permet de personnaliser les colonnes de projet à inclure dans un graphique Gantt et montre comment rendre le graphique à une image.

Gantt Chart

Un graphique Gantt est une représentation graphique des tâches du projet décomposées par des jours, des semaines ou des mois. Un projet est composé de tâches affectées à différentes ressources. Une tâche individuelle peut être divisée en sous-tâches dans le cadre de la gestion des tâches. Chaque tâche a une date de début et une date de fin qui détermine sa durée. Un graphique Gantt dans le projet Microsoft donne une vue rapide de ces données de projet. Cette capture d’écran montre un graphique Gantt typique dans le projet Microsoft:

Image du graphique Gantt dans Aspose.Tasks pour .net

Dans Aspose.Tasks pour .NET, la classe de projet est la classe principale pour gérer les fichiers de projet. La classe de projet expose différentes surcharges si “Enregistrer” la méthode d’exportation de données de projet vers différents formats de fichiers. Les utilisateurs peuvent configurer cette méthode pour exporter des données de projet vers n’importe quel format pris en charge en passant par des paramètres.

Par exemple, envisagez de surcharger enregistrer (chaîne, sauvegarde).

• Le premier paramètre est le nom du fichier de destination.
• Le deuxième et le plus important paramètre accepte l’un des héritiers de la classe SaveOptions. Par exemple, pour le format PDF, on peut passer PDFSaveOptions.

Type de sauvegarde

Le comportement de rendu peut être personnalisé à l’aide de propriétés de la classe SaveOptions (ou l’un de ses héritiers). Par exemple, la taille de la page du document de sortie peut être définie à l’aide de la propriété SaveOptions.CustomPageSize ou SaveOptions.legendonEachPage peut être définie pour définir si une légende doit être affichée sur chaque page.

PDFSAVEOPTIONS SAVEOPTIONS = NOUVEAU PDFSaveOptions ()
{
   CustomPageSize = new sizef (800, 600),
   LegendonEachPage = False
};

Il y a au moins deux approches pour personnaliser l’apparence du graphique rendu.

Personnaliser les colonnes Gantt Chart à l’aide de ProjectView Type

Veuillez noter que c’est un moyen obsolète de personnaliser l’apparence et il est moins probable qu’il soit étendu ou amélioré à l’avenir. La classe ProjectView a une fonctionnalité limitée et peut être utilisée pour afficher des colonnes spécifiques dans l’image de sortie. Un constructeur de cette classe prend une liste de tableaux de la classe GanttchartColumn comme argument. L’instance ProjectView résultante doit être définie comme une valeur de la propriété SaveOptions.View. L’exemple de code montre comment il fonctionne:

// Créer les colonnes de vue
var colonnes = new list <GanttChartColumn> ();
colonnes.add (new GantTChartColumn ("Name", 100, new TaskToColumnTextConverter (TaskName)));
colonnes.add (new GantTchartColumn ("Notes", 100, new TaskToColumnTextConverter (taskNotes)));
colonnes.add (new GantTchartColumn ("Resources", 200, new TaskToColumnTextConverter (TaskResources)));
// Créez la vue
ProjectView projectView = new ProjectView (colonnes);

// Créer des sauvegardes
PDFSAVEOPTIONS SAVEOPTIONS = NOUVEAU PDFSaveOptions ()
{
   CustomPageSize = new sizef (800, 600),
   View = ProjectView
};

// Enregistrez le projet sur PDF.
project.save ("output.pdf", sauvegarde);

Le constructeur de la classe GanttchartColumn prend trois arguments - le nom de la colonne, la largeur et un délégué taskToColumnTextConverter - pour convertir les données de la tâche en texte de colonne. Dans l’exemple de code ci-dessus, le délégué TaskToColumnTextConverter appelle trois méthodes cibles, TaskName, TaskNotes et TaskResources, pour convertir les données dans ces colonnes en texte. Les trois méthodes sont implémentées dans l’exemple de code suivant.

/// <résumé>
/// convertit les données de nom d'une tâche en texte de colonne.
/// </summary>
/// <param name = "tâche"> tâche actuelle. </param>
/// <retourne> Texte de la colonne. </ retourne>
Nom de tâche de chaîne privée (tâche de tâche)
{
    StringBuilder res = new StringBuilder ();
    pour (int i = 1; i <task.outlinelevel; i ++)
    {
        res.append ("");
    }

    res.AppendFormat("{0}. {1}", task.Id, task.Name);
    return res.ToString();
}

/// <résumé>
/// convertit les données de nom d'une tâche en texte de colonne.
/// </summary>
/// <param name = "tâche"> tâche actuelle. </param>
/// <retourne> Texte de la colonne. </ retourne>
TaskNameHTML de chaîne privée (tâche)
{
    StringBuilder res = new StringBuilder ();
    pour (int i = 1; i <task.outlinelevel; i ++)
    {
        res.append ("");
    }

    res.AppendFormat("{0}. {1}", task.Id, task.Name);
    return res.ToString();
}

/// <résumé>
/// convertit les données des notes d'une tâche en texte de colonne.
/// </summary>
/// <param name = "tâche"> tâche actuelle. </param>
/// <retourne> Texte de la colonne. </ retourne>
Tâches de chaîne privée (tâche de tâche)
{
    if (task.noteStExt! = null)
        retour tâche.noteStExt;
    autre
        return String.Empty;
}

/// <résumé>
/// convertit les données de ressources d'une tâche en texte de colonne.
/// </summary>
/// <param name = "tâche"> tâche actuelle. </param>
/// <retourne> Texte de la colonne. </ retourne>
TaskResources de tâche privée (tâche)
{
    StringBuilder res = new StringBuilder ();
    Project Project = Task.ParentProject;
    bool bFirst = true;
    foreach (Affectation de l'insignment de ressources dans project.getResourceSignmentsByTask (tâche))
    {
        if (affectation.resource! = null)
        {
            si (! bfirst)
            {
                res.append (",");
            }
 
            res.Append(assignment.Resource.Name);
            bFirst = false;
        }
    }

    return res.ToString();
}

Ce qui suit est l’image et l’image HTML produite avec l’exemple de code:

Personnaliser les colonnes Gantt Chart à l’aide de la vue de vue

La classe de vue d’utilisation et ses héritiers est un moyen recommandé de personnaliser les graphiques lors de la création de données de projet. La classe de vue correspond aux paramètres de vue utilisés dans MS Project (qui sont stockés dans le fichier MPP) et ont fourni une API plus riche par rapport à l’API de ProjectView. Les propriétés disponibles de la classe de vue peuvent être trouvées dans référence de l’API. La vue existante peut être prise (pour les projets chargés à partir du fichier MPP avec des vues enregistrées par Microsoft Project), personnalisées et transmises à Project.Save Méthode comme démontré dans l’extrait de code suivant:

Project Project = nouveau projet ("input.mp"));

// Obtenez la vue existante.
var View = (GanttchartView) project.views.getByName ("& Gantt Chart");

// Définissez et insérez une nouvelle colonne à la vue.
TableField Field = New TableField ()
{
    AlignData = stringalignment.far,
    Largeur = 50,
    Field = field.taskname,
    Title = "Nom de la tâche"
};

View.Table.TableFields.insert (1, champ);
PDFSAVEOPTIONS SAVEOPTIONS = NOUVEAU PDFSaveOptions ()
{
    ViewSettings = View
};

project.save ("output.pdf", sauvegarde);