URL: /GanttTask/Insert

Method: POST

Descrizione

Chiamata per l'inserimento di un'attività di Gantt

Formato richieste

Legenda:
Parametro obbligatorio
Parametro opzionale

{
    SessionId: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
    IdGantt: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
    GanttExternalId: "",
    TaskStateId: 3,
    TaskStateExternalId: "Planned"
    Fields: [
        {
            ExternalId: "Name",
            Value: "Nome Attività"
        },
        {
            ExternalId: "Duration",
            Value: "120"
        },
        {
            ExternalId: "StartDate",
            Value: "20/04/2024 14:00",
            ValueFormat: "dd/MM/yyyy HH:mm",
            ValueCultureInfoName: 'it-IT'
        }
    ],
    UpdateResources: null,
    UpdateProgress: true,   
    ManualRecompute: false,
    PlanningCategoryIds: ['xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'],
    PlanningCategoryExternalIds: ["test"],
    ResourceIds: null,
    ResourceExternalIds: ["utente1"],
    ResourcesCanManageTaskDuration: true,
    ResourcesCanManageSubTasks: null,
    ResourcesCanEditCheckList: null,
    ResourceRequirement: {
            RequirementType: "ByPlanner",
            AskBeforeDuration: 120,
            AskUntilDuration: null,
            GroupIds: [100],
            AreaIds: null,
            SkillIds: null,
            GroupExternalIds: null,
            AreaExternalIds: null,
            SkillExternalIds: ["Developer"],
            SkillValueExternalIds: null
        }
}

Note

• SessionId: identificativo della sessione
• IdGantt / GanttExternalId: Indica in quale gantt inserire l'attività. Almeno uno dei due campi è obbligatorio.
• TaskStateId / TaskStateExternalId: Indica con quale stato inserire l'attività. Almeno uno dei due campi è obbligatorio.
• ResourceIds / ResourceExternalIds: Lista delle risorse assegnate a questa attività. Nota: in questo momento il designer di Gantt supporta solo una risorsa per attività
• UpdateResources: Parametro facoltativo, indica se la procedura deve aggiornare le risorse dell'attività (Predefinito falso)
• UpdateProgress: Parametro facoltativo, indica se la procedura deve ricalcolare la % di progresso di un'attività (Predefinito falso)
• ManualRecompute: L'API inserisce l'attività alle date indicate. Se abilitato, questo parametro permette di effettuare una pianificazione parziale per posizionare l'attività rispetto al calendario lavorativo della risorsa.
• PlanningCategoryIds / PlanningCategoryExternalIds: Elenco di categorie di pianificazione
• ResourcesCanManageTaskDuration: Indica che la risorsa assegnata all'attività potrà modificarne la durata
• ResourcesCanManageSubTasks: Indica che la risorsa assegnata all'attività potrà dividerla in sotto-attività
• ResourcesCanEditCheckList: Indica che la risorsa assegnata all'attività potrà modificarne le checklist
• Fields: Elenco dei campi di un'attività che voglio aggiornare
  Occore fornire una lista di oggetti strutturata nel seguente modo:
  
  • ExternalId: Nome del campo
  • Value: Valore in formato stringa
  • ValueFormat: se il tipo di valore è Date o DateTime, definisce il formato utilizzato. Vedere la pagina MSDN per i dettagli
  • ValueCultureInfoName: influisce sul modo in cui i valori numerici vengono parsati
  L'elenco delle proprietà di un'attività è disponibile qui
  
• ResourceRequirement: Permette di configurare i requisiti per l'assegnazione di una risorsa di una attività:
  
  • RequirementType: indica il tipo di requisito, valore accettato: "ByPlanner", "ByService"
  • AskBeforeDuration: indica quanto tempo prima iniziare ad assegnare dinamicamente la risorsa (in minuti)
  • AskUntilDuration: indica fino a quanto tempo assegnare dinamicamente la risorsa (in minuti)
  • GroupIds / GroupExternalIds: indica che l'attività può essere fatta solo da risorse che fanno parte dei seguenti gruppi
  • AreaIds / AreaExternalIds
  • SkillIds / SkillExternalIds / SkillValueExternalIds

Campi dell'attività

• Name - String
  Nome attività
  
• StartDate - DateTime
  Data di inizio dell'attività
  
• Duration - Double
  Durata di un'attività (in minuti)
  Nota: il valore 0 corrisponde alle milestones
• IdGanttTask - Guid
  Identificativo univoco attività
  
• IdGanttTaskParent - Guid
  Identificativo attività padre
  
• Description - String
• ExternalId - string
• Priority - Int
  Priorità dell'attività nel Gantt
  
• IsParentNode - Boolean
  Indica se l'attività è da considerarsi un'attività padre che conterrà altri figli.
  Questo parametro è facoltativo in quanto se il servizio di pianificazione trova attività con dei figli, automaticamente la imposta come attività padre.
  
• MinStartDate - DateTime
  Il servizio di pianificazione non schedulerà l'attività prima della data minima impostata
  
• MaxEndDate - DateTime
  Il servizio di pianificazione cercherà di non schedulerà l'attività dopo la data massima impostata
  Se la data dovesse essere superata, il sistema porterà un avviso.
  Se il parametro MaxEndDateForced sarà attivo, l'attività verrà nascosta dalla pianificazione, altrimenti verrà comunque ripianificata oltre la data stabilita.
• MaxEndDateForced - Boolean
  Se definita una data massima di fine e l'opzione è abilitata, l'attività verrà nascosta dalla pianificazione, altrimenti verrà comunque ripianificata oltre la data stabilita.
  
• MinConsecutiveDuration - Double
  È possibile indicare che un'attività debba essere pianificata considerando una durata (in minuti) consecutiva
  
• MaxDuration - Double
  È possibile indicare una durata massima per l'attività e configurare degli eventi di Gantt per reagire qualora un'attività dovesse richiedere più tempo del previsto
  
• Progress - Decimal
  È possibile indicare la % di progresso di un'attività. Nota: questa percentuale viene ricalcolata automaticamente nel caso di attività padri e attività con checklists.
  
• HiddenInGantt - Boolean
  È possibile indicare debba risultare nascosta nel designer di Gantt.
  
• ObjectId - Guid
  Identificativo del profilo DocsMarshal da legare all'attività
• ExpectedStartDate - DateTime
  Proprietà esclusiva delle milestone
  Permette di indicare una data presunta di inizio lavori per quella milestone. (Utile a fini statistici)
• PillowDate - DateTime
  Proprietà esclusiva delle milestone
  Permette di configurare una data cuscino
  

Formato risposte

{
    Error: false
    ErrorDescription: null,
    LoggedOut: false,
    Data: {
        IdGantt: "111ae83b-0aea-47e9-b63f-f7a32bdb40b7",
        IdGanttTask: "ae6b1111-b8a6-47eb-9a43-1c9d565f2bc3",
        IdGanttTaskParent: null,
        Name: 'Task 1',
        ... (Consulta questa pagina per le proprietà dell'entitità)
    }
}