Gestione del progetto tramite REST API

Microsoft Project Professional è il software di project management più popolare al mondo, in quanto aiuta i manager a sviluppare piani, assegnare attività ai membri, monitorare l’avanzamento delle attività, controllare finanze e programmi, comunicare informazioni sul progetto e organizzare lavoro e manodopera in un formato Work Breakdown Structure che spiega chiaramente le attività per un progetto e la loro assegnazione a risorse specifiche nel team. Tuttavia, per creare/aggiornare il programma/piano, è necessario utilizzare il software MS Project Professional, che comporta sforzi di installazione e costi di licenza.

• Alternativa a MS Project Professional
• Formati di file supportati
• Funzionalità avanzate
• Installazione
• Leggi le proprietà di MS Project
• Convertire MS Project in altri formati

Alternativa a MS Project Professional

Aspose.Tasks Cloud è una soluzione incredibile per la creazione, la manipolazione e il rendering di file MS Project in altri formati supportati. La soluzione basata su API REST offre la flessibilità di utilizzare qualsiasi piattaforma e il linguaggio di tua scelta per soddisfare i requisiti desiderati. Consente agli utenti di eseguire la creazione di progetti, la pianificazione, la gestione di risorse, attività e attributi nel cloud. L’API Aspose.Tasks Cloud offre tale flessibilità che puoi lavorare direttamente con assegnazioni di progetti, attività di progetto, risorse di progetto, calendari di progetto, eccezioni di calendario di progetto, attributi estesi di progetto, VBA, dati in scala temporale e varie altre proprietà di progetti cloud.

Formati di file supportati

Aspose.Tasks Cloud per cURL supporta i popolari formati di file Microsoft Project (MPT, MPP, MPX) e Primavera P6 (XER, XML).L’API fornisce anche la funzionalità per convertire i file del tuo progetto cloud in formati di file leader del settore, tra cui HTML, PDF, XPS, XLSX, CSV, TXT e formati di immagine (BMP, PNG, JPEG, TIFF, SVG).

Funzionalità avanzate

Tra le funzionalità specificate sopra, l’API Aspose.Tasks Cloud fornisce anche alcune funzionalità avanzate come elencato di seguito

• Importa progetto da un database, incluso Primavera DB
• Ripianifica tutti gli ID attività del progetto, le date di inizio/fine, calcola i margini di flessibilità
• Ottieni dati su scala temporale o informazioni ricorrenti per un’attività specifica utilizzando UID
• Eseguire l’analisi del rischio utilizzando la simulazione Monte Carlo e creare un report
• Gestire la Work Breakdown Structure (WBS) del progetto
• Ricalcolare il lavoro del progetto per il completamento o l’incompletezza
• Leggi i calendari di Microsoft Project and Calendar Exceptions information.

Installazione

Di seguito sono specificati i passaggi su come installare Aspose.Tasks Cloud SDK per .NET in Visual Studio per Mac.

• Espandere la struttura del progetto nella finestra Esplora soluzioni.
• Fare clic con il pulsante destro del mouse sulla cartella dei pacchetti e fare clic sull’opzione Gestisci pacchetti NuGet…
• Inserisci Aspose.Tasks Cloud nel campo di ricerca e premi il tasto Invio
• Abilita la casella di controllo accanto a Aspose.Tasks Cloud e fai clic sul pulsante Aggiungi pacchetto
• L’SDK viene aggiunto ai pacchetti del progetto

Leggi le proprietà di MS Project

Queste proprietà sono un posto dove archiviare metadati sui tuoi progetti come Titolo, Oggetto, Autore, Responsabile, Azienda, parole chiave e descrizioni del tuo progetto. Queste proprietà possono essere utili quando cerchi il tuo progetto o per scopi di riferimento quando tu o qualcun altro rivisiterà questo file di progetto tra mesi o anni.

Comando cURL

I comandi cURL possono essere utilizzati per leggere le proprietà del progetto su qualsiasi piattaforma tramite una console/prompt dei comandi. Utilizzando gli stessi comandi cURL, puoi leggere le proprietà associate al file di progetto come mostrato di seguito.

curl -v "https://api.aspose.cloud/oauth2/token" \
-X POST \
-d 'grant_type=client_credentials&client_id=xxx-xxx-xxx&client_secret=xxxxx' \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"


curl -X GET "https://api.aspose.cloud/v3.0/tasks/sample.mpp/documentproperties" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

Richiedi URL

https://api.aspose.cloud/v3.0/tasks/sample.mpp/documentproperties

L’API fornisce anche la funzionalità per leggere le singole proprietà associate al file.

curl -X GET "https://api.aspose.cloud/v3.0/tasks/sample.mpp/documentproperties/LastAuthor" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

Richiedi URL

https://api.aspose.cloud/v3.0/tasks/sample.mpp/documentproperties/LastAuthor

Corpo della risposta

{
  "Property": {
    "Name": "LastAuthor",
    "Value": "Alexey Zhilin",
    "link": {
      "Href": "/documentProperties/LastAuthor",
      "Rel": "self",
      "Type": null,
      "Title": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

C#.NET

// Per esempi completi e file di codice, visitare https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-dotnet/
const string clientID = "xxxx-xxxx-xxxx-xxxxx";
const string clientSecret = "xxxxxxxxx";

// inizializza e oggetto di TasksApi
Aspose.Tasks.Cloud.Sdk.TasksApi tasksApi = new Aspose.Tasks.Cloud.Sdk.TasksApi(clientSecret, clientID);

// recuperare le proprietà associate al documento di progetto
var retrievedProperties = tasksApi.GetDocumentPropertiesAsync(new GetDocumentPropertiesRequest
{
    Name = "sample.mpp",
});

// scorrere l'elenco delle proprietà recuperate sul documento e stamparne il valore
for(int counter= 0; counter< retrievedProperties.Result.Properties.List.Count; counter++)
{ 
    Console.WriteLine("Property name at index " + counter + " = "+retrievedProperties.Result.Properties.List[counter].Name);
    Console.WriteLine("Property value at index " + counter + " = "+retrievedProperties.Result.Properties.List[counter].Value);
}

Nel caso in cui sia necessario ottenere il valore associato a una determinata proprietà, provare a utilizzare il seguente frammento di codice

var response = tasksApi.GetDocumentPropertyAsync(new Aspose.Tasks.Cloud.Sdk.Model.Requests.GetDocumentPropertyRequest
{
    Name = "sample.mpp",
    PropertyName = "LastAuthor"
});
Console.WriteLine(response.Result.Property.Value );

Per vostra informazione, è possibile scaricare una copia di sample.mpp dal link indicato.

Convertire il file MS Project in altri formati

Aspose.Tasks Cloud fornisce un metodo GetTaskDocumentWithFormat(..) che fornisce le capacità per leggere il file MS Project e salvarlo in uno dei seguenti formati supportati

• Gestione del progetto
  • MPP
  • P6XML
  • XER
  • Numero di parte
• Sito web
  • Formato XML
  • Codice HTML
• Immagini raster
  • BMP
  • PNG
  • Formato JPEG
  • TIFF
• Il PDF è in inglese.
• Pagina descrittiva
  • XPS
  • SVG
• Foglio di calcolo
  • Formato CSV
  • TXT
  • Foglio di calcoloML
  • Formato XLSX
• Gdhtml

Renderizza MPP in formato PNG

Il seguente comando cURL fornisce le capacità per leggere un archivio di file MS Project in un archivio cloud e renderizzare l’output in formato PNG. L’output viene quindi salvato nell’archivio locale.

comando cURL

curl -X GET "https://api.aspose.cloud/v3.0/tasks/CalendarWorkWeeks.mpp/format?format=png&returnAsZipArchive=false" \
-H  "accept: multipart/form-data" \
-H  "authorization: Bearer <JWT Token>" \
-o resultant.png

Il file di progetto di esempio utilizzato nell’esempio precedente può essere scaricato da CalendarWeek.mpp.

C#.NET

L’Aspose.Tasks Cloud SDK per .NET può essere utilizzato esclusivamente nei progetti .NET per l’elaborazione dei file MS Project. Utilizzando lo stesso SDK, puoi soddisfare i requisiti di rendering dei file .mpp in .png o altri formati supportati (come menzionato sopra).

• Innanzitutto, dobbiamo creare un’istanza di un oggetto TasksApi passando ClientSecret e ClientID come argomenti di input
• In secondo luogo, chiamare il metodo GetTaskDocumentWithFormat (…) di TasksApi durante il passaggio dell’oggetto GetTaskDocumentWithFormatRequest
• Le informazioni sul formato di esportazione vengono specificate tramite l’oggetto GetTaskDocumentWithFormatRequest. Il valore è accessibile dall’enumerazione ProjectFileFormat

// Per esempi completi e file di dati, visitare https://github.com/aspose-tasks-cloud/aspose-tasks-cloud-dotnet/
// inizializza e oggetto di TasksApi
Aspose.Tasks.Cloud.Sdk.TasksApi tasksApi = new Aspose.Tasks.Cloud.Sdk.TasksApi(clientSecret, clientID);

// chiamare il metodo per eseguire la conversione
var resultantOutput = tasksApi.GetTaskDocumentWithFormat(new Aspose.Tasks.Cloud.Sdk.Model.Requests.GetTaskDocumentWithFormatRequest
{
    Format = Aspose.Tasks.Cloud.Sdk.Model.ProjectFileFormat.Png,
    Name = "Home move plan.mpp",
});

// chiama il metodo per salvare il file risultante
saveToDisk(resultantOutput, "Converted.png");

public static void saveToDisk(Stream responseStream, String resultantFile)
{
    var fileStream = File.Create(resultantFile);
    responseStream.Seek(0,SeekOrigin.Begin);
    responseStream.CopyTo(fileStream);
    fileStream.Close();
}

Per riferimento, il file MPP sorgente utilizzato nell’esempio precedente può essere scaricato da Home move plan.mpp.