Come creare e gestire gruppi in Redmine.

Creazione di gruppi

Per creare un gruppo, seguire le seguenti istruzioni:

1. Clicca su Amministrazione
2. Clicca su Gruppi
3. Clicca su Nuovo gruppo
4. Inserire il nome del gruppo nel campo Nome
5. Clicca su Crea

Aggiunta di individui e progetti partner

Per aggiungere a individui un gruppo, seguire le seguenti istruzioni:

1. In Amministrazione >> Gruppi
2. Fare clic sul nome del gruppo che si desidera modificare.
3. Saranno richieste 3 schede: Generale, Utenti, Progetti

• Generale

❖ Modificare il nome modificando il campo Nome

• Clienti

❖ Aggiungere i clienti selezionando la casella di controllo del nome utente per ogni cliente

❖ Clicca su Aggiungi

• progetti

❖ Selezionare un progetto dal menu a comparsa

❖ Impostare il Ruolo

❖ Clicca su Aggiungi

Figura 1: Esempio scheda Utenti del gruppo

Figura 2: Aggiunta di membri a un gruppo

Figura 3: Esempio scheda Progetti del gruppo

Figura 4: Associazione di un gruppo a un progetto (dalle impostazioni del gruppo)

Creazione di gruppi utente in Redmine

Amministrazione > Gruppi

Qui i responsabili possono gestire un gruppo di utenti Redmine.

Sono predefiniti due gruppi di utenti: Utenti anonimi e Utenti non membri. Questi gruppi hanno autorizzazioni limitate per quanto riguarda i Progetti e le Issue di Redmine.

Gli Utenti non membri sono utenti completamente registrati (loggati in Redmine) che non sono stati aggiunti come Membri al progetto che stanno visualizzando. Gli utenti anonimi sono generalmente utenti non registrati. Questi due gruppi vedranno un progetto solo se non è privato.

Nota: L'aggiunta di utenti ai gruppi semplifica la gestione dei ruoli degli utenti relativamente ai Progetti poiché un intero gruppo può essere aggiunto come Membro del progetto con ruoli simili agli utenti.

Ogni gruppo è mostrato nell'elenco per il suo nome e il numero di utenti. C'è un'opzione di filtraggio per parola chiave (ad esempio, il nome del gruppo).

Per creare un nuovo gruppo, cliccare su Nuovo gruppo, digitare un nome e cliccare su Crea o Crea e Continua (se si desidera creare un nuovo gruppo).

Per modificare un gruppo, selezionarlo dall'elenco. È possibile modificare il nome del gruppo o aggiungere utenti o progetti partner. Ogni operazione può essere eseguita nella scheda corrispondente.

Per aggiungere utenti a un gruppo selezionato, andare alla scheda Utenti del gruppo, cliccare su Nuovo utente e selezionare uno o più utenti da aggiungere:

Quando un utente viene aggiunto a un gruppo, ottiene automaticamente tutti i privilegi del gruppo (ad esempio, i ruoli nei progetti).

Gruppi REST a Redmine

/gruppi.:formato

GET

Restituisce l'elenco dei gruppi.

Questo endpoint richiede i privilegi di amministratore.

Esempio:

GET/gruppi.xml

Risposta:

53

Manager

55

Sviluppatori

POST

Crea un gruppo.

Questo endpoint richiede i privilegi di amministratore.

• Limiti:

❖ Gruppo (obbligatorio): un hash delle proprietà del gruppo, tra cui:

❏ nome (obbligatorio): il nome del gruppo

❏ user_ids: id dei clienti del gruppo (viene creato un gruppo vuoto se non fornito)

• Esempio:

❖ POST/gruppi.xml

Sviluppatori

3

5

❖ POST/gruppi.json

{

"gruppo": {

"nome": "Ingegneri",

"user_ids": [3, 5]

}

}

Risposta:

• 201 Creato: il gruppo è stato creato
• 422 Entità non elaborabile: il gruppo non è stato creato a causa di fallimenti di approvazione (il corpo della risposta contiene i messaggi di errore)

/Gruppi/:id.:formato

GET

Restituisce i dettagli di un gruppo.

Questo endpoint richiede i privilegi di amministratore.

• Parametro:

❖ include (opzionale): una lista separata da virgole di relazioni da includere nella risposta:

❏ utente

❏ membro

Esempio:

GET/gruppo/20.xml?include=utenti

Risposta:

20

Sviluppatori

PUT

Aggiorna un gruppo esistente.

Questo endpoint richiede i privilegi di amministratore.

DELETE

Elimina un gruppo esistente.

Questo endpoint richiede i privilegi di amministratore.

/gruppi/:id/clienti.:formato

POST

Aggiunge un cliente esistente a un gruppo.

Questo endpoint richiede i privilegi di amministratore.

• parametri:

❖ user_id (obbligatorio): id del cliente da aggiungere al gruppo.

Esempio:

POST/gruppi/10/clienti.xml

5

• Risposta:

❖ 200 OK: l'utente è stato aggiunto alla raccolta

/gruppi/:id/clienti/:user_id.:formato

Annulla

Rimuovi un cliente da una raccolta.

Questo endpoint richiede i privilegi di amministratore.

Esempio:

Elimina/gruppi/10/utenti/5.xml

Risposta:

200 OK: l'utente è stato rimosso dal gruppo