Contratti di raccolta — Asana
01Come leggere questa pagina #sec_bba4e109
Ogni risorsa che REVIEWIT può raccogliere per Asana ha un contratto pubblicato. Si legge come una riferimento API: ciò che REVIEWIT chiama sul servizio raccolto e attraverso quale mezzo, ciò che il contratto richiede affinché la raccolta si esegua e i dati che REVIEWIT conserva. REVIEWIT esegue solo letture.
- Chiamate: le richieste che REVIEWIT invia al servizio raccolto, tutte in lettura.
- Requisiti: ciascuno deve essere soddisfatto. La sua natura indica cosa richiede: un diritto da concedere all'identificativo, una condizione di amministrazione (un'impostazione o un'assegnazione presso il fornitore che il token non porta, verificata da una chiamata reale in lettura) o l'appartenenza dell'identificativo all'organizzazione Asana della connessione. La regola indica quante opzioni sono necessarie: « richiesta » per l'unica opzione, « una a scelta » quando una sola è sufficiente (sono ordinate dalla più ristretta alla più ampia: preferire la prima), « tutte » o « N a scelta tra M ».
- Condizioni di funzionamento: ciò che REVIEWIT verifica prima di ogni raccolta, oltre ai requisiti.
- Freschezza: l'età massima delle verifiche su cui si basa il verdetto, fissata da ogni contratto (qui: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale). REVIEWIT esegue automaticamente entro questo termine le verifiche che sa eseguire (token ottenuto, servizio che risponde); « Verifica i diritti », nel menu della connessione, li esegue su richiesta. Finché la chiamata reale non è stata effettuata, i diritti rimangono non verificati.
- Dati conservati: i campi che REVIEWIT conserva di ogni oggetto; il ruolo indica cosa ne fa la revisione.
Il verdetto di ogni risorsa, per la tua connessione, si legge sulla sua scheda. Una risorsa che la connessione non raccoglie può comunque essere alimentata dall'import di un rapporto (« Importa un rapporto »).
02Come REVIEWIT verifica i requisiti #sec_4b0123b7
Il token Asana non porta i suoi diritti: il contratto richiede che siano verificati da una chiamata reale, in lettura. REVIEWIT non esegue ancora questa chiamata per Asana: verifica che il token sia ottenuto e che il servizio risponda, ma non i diritti elencati qui. Le risorse vengono visualizzate come « Non verificato »; possono comunque essere alimentate dall'import di un rapporto (« Importa un rapporto »).
03I mezzi di chiamata #sec_cf8230c1
Un mezzo indica quale token REVIEWIT ottiene per l'identificativo: chi lo rilascia e per quale audience. Gli indirizzi chiamati sono indicati nelle chiamate di ogni risorsa; un percorso che inizia con « / » viene chiamato sull'audience del token del suo mezzo.
| Mezzo | Token rilasciato da | Audience del token | Autenticazione dell'identificativo |
|---|---|---|---|
| asana.api.reviewit.service-account | https://app.asana.com | https://app.asana.com/api/1.0 | conto di servizio |
04Directory · Ospiti #sec_b8689674
asana.directory.guests:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · mezzo asana.api.reviewit.service-account
Collaboratori esterni ammessi nell'organizzazione
Chiamate
- GET /workspaces/{gid}/workspace_memberships (is_guest)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Condizione di amministrazione | richiesta | il conto di servizio Asana è creato da un super-amministratore dell'organizzazione (Asana Enterprise); il suo token concede accesso completo in lettura, verificato da chiamata |
| Appartenenza | richiesta | l'identificativo appartiene all'organizzazione Asana della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://app.asana.com/api/1.0 risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| Gid | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | no | |
| IsActive | contesto, senza effetto sulla revisione | booleano | no |
| Teams | contesto, senza effetto sulla revisione | testo | no |
| Projects | contesto, senza effetto sulla revisione | testo | no |
05Directory · Utenti #sec_1061454b
asana.directory.users:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via asana.api.reviewit.service-account
Account dell'organizzazione e loro stato di attività
Chiamate
- GET /workspaces/{gid}/users
- GET /workspaces/{gid}/workspace_memberships
- GET /users/{user_gid}/teams?organization={gid} (campo Teams)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Condizione di amministrazione | richiesto | l'account di servizio Asana è creato da un super-amministratore dell'organizzazione (Asana Enterprise) ; il suo token garantisce accesso completo in lettura, verificato tramite chiamata |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Asana della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://app.asana.com/api/1.0 risponde
Freschezza : verifiche inferiori a 24 ore ; i diritti devono essere verificati tramite una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| Gid | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | no | |
| IsActive | contesto, senza effetto sulla revisione | booleano | no |
| IsAdmin | contesto, senza effetto sulla revisione | booleano | no |
| IsGuest | contesto, senza effetto sulla revisione | booleano | no |
| Teams | contesto, senza effetto sulla revisione | testo | no |
06Portfolios · Membri del portfolio #sec_bdfc2222
asana.portfolios.memberships:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via asana.api.reviewit.service-account
Membri di un portfolio e loro livello di accesso. Chiave di riga : PortfolioGid | UserGid.
Chiamate
- GET /portfolios/{gid}/portfolio_memberships
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Condizione di amministrazione | richiesto | l'account di servizio Asana è creato da un super-amministratore dell'organizzazione (Asana Enterprise) ; il suo token garantisce accesso completo in lettura, verificato tramite chiamata |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Asana della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://app.asana.com/api/1.0 risponde
Freschezza : verifiche inferiori a 24 ore ; i diritti devono essere verificati tramite una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| MembershipKey | chiave dell'oggetto | testo | sì |
| PortfolioGid | contesto, senza effetto sulla revisione | testo | sì |
| PortfolioName | contesto, senza effetto sulla revisione | testo | no |
| UserGid | contesto, senza effetto sulla revisione | testo | sì |
| UserName | contesto, senza effetto sulla revisione | testo | no |
| visualizzato per riconoscere l'oggetto | testo | sì | |
| AccessLevel | contesto, senza effetto sulla revisione | testo | no |
07Portfolios #sec_c80b6d56
asana.portfolios.portfolios:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via asana.api.reviewit.service-account
Portfolio, il loro proprietario, i loro membri e il numero di progetti che raggruppano
Chiamate
- GET /portfolios?workspace={gid}
- GET /portfolios/{gid}/items
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Condizione di amministrazione | richiesto | l'account di servizio Asana è creato da un super-amministratore dell'organizzazione (Asana Enterprise) ; il suo token garantisce accesso completo in lettura, verificato tramite chiamata |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Asana della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://app.asana.com/api/1.0 risponde
Freschezza : verifiche inferiori a 24 ore ; i diritti devono essere verificati tramite una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| Gid | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| Owner | accesso soggetto alla revisione | lista di identità | no |
| Public | valutato dalle politiche REVIEWIT (visibilità) | booleano | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| Members | accesso soggetto alla revisione | lista di identità | no |
| ProjectCount | contesto, senza effetto sulla revisione | intero | no |
08Ruoli privilegiati · Amministratori #sec_901c7249
asana.privileged-roles.admins:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via asana.api.reviewit.service-account
Amministratori dell'organizzazione
Chiamate
- GET /workspaces/{gid}/workspace_memberships (is_admin)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Condizione di amministrazione | richiesto | l'account di servizio Asana è creato da un super-amministratore dell'organizzazione (Asana Enterprise) ; il suo token garantisce accesso completo in lettura, verificato tramite chiamata |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Asana della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://app.asana.com/api/1.0 risponde
Freschezza : verifiche inferiori a 24 ore ; i diritti devono essere verificati tramite una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| Gid | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | no | |
| AdminScope | contesto, senza effetto sulla revisione | testo | no |
| IsActive | contesto, senza effetto sulla revisione | booleano | no |
09Progetti · Membri del progetto #sec_f9f5d31c
asana.projects.memberships:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via asana.api.reviewit.service-account
Membri di un progetto e il loro livello di accesso. Chiave di riga: ProjectGid | UserGid.
Chiamate
- GET /projects/{gid}/project_memberships
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Condizione di amministrazione | richiesto | l'account di servizio Asana è creato da un super-amministratore dell'organizzazione (Asana Enterprise); il suo token concede accesso completo in lettura, verificato da una chiamata |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Asana della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://app.asana.com/api/1.0 risponde
Aggiornamento: verifiche inferiori a 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| MembershipKey | chiave dell'oggetto | testo | sì |
| ProjectGid | contesto, senza effetto sulla revisione | testo | sì |
| ProjectName | contesto, senza effetto sulla revisione | testo | no |
| UserGid | contesto, senza effetto sulla revisione | testo | sì |
| UserName | contesto, senza effetto sulla revisione | testo | no |
| visualizzato per riconoscere l'oggetto | testo | sì | |
| AccessLevel | contesto, senza effetto sulla revisione | testo | no |
| IsGuest | contesto, senza effetto sulla revisione | booleano | no |
10Progetti #sec_82d9dfcf
asana.projects.projects:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via asana.api.reviewit.service-account
Progetti dell'organizzazione, il loro proprietario e la loro visibilità
Chiamate
- GET /workspaces/{gid}/projects
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Condizione di amministrazione | richiesto | l'account di servizio Asana è creato da un super-amministratore dell'organizzazione (Asana Enterprise); il suo token concede accesso completo in lettura, verificato da una chiamata |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Asana della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://app.asana.com/api/1.0 risponde
Aggiornamento: verifiche inferiori a 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| Gid | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| Team | contesto, senza effetto sulla revisione | testo | no |
| Owner | accesso soggetto alla revisione | lista di identità | no |
| Privacy | valutato dalle politiche REVIEWIT (visibilità) | testo | no |
| Archived | contesto, senza effetto sulla revisione | booleano | no |
| Created | contesto, senza effetto sulla revisione | data e ora | no |
| Modified | valutato dalle politiche REVIEWIT (data dell'ultima attività) | data e ora | no |
| Members | accesso soggetto alla revisione | lista di identità | no |
| Followers | accesso soggetto alla revisione | lista di identità | no |
11Squadre · Membri della squadra #sec_3fa08c09
asana.teams.memberships:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via asana.api.reviewit.service-account
Appartenenze di squadra, invitati e accesso limitato incluso. Chiave di riga: TeamGid | UserGid.
Chiamate
- GET /teams/{gid}/team_memberships
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Condizione di amministrazione | richiesto | l'account di servizio Asana è creato da un super-amministratore dell'organizzazione (Asana Enterprise); il suo token concede accesso completo in lettura, verificato da una chiamata |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Asana della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://app.asana.com/api/1.0 risponde
Aggiornamento: verifiche inferiori a 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| MembershipKey | chiave dell'oggetto | testo | sì |
| TeamGid | contesto, senza effetto sulla revisione | testo | sì |
| TeamName | contesto, senza effetto sulla revisione | testo | no |
| UserGid | contesto, senza effetto sulla revisione | testo | sì |
| UserName | contesto, senza effetto sulla revisione | testo | no |
| visualizzato per riconoscere l'oggetto | testo | sì | |
| IsAdmin | contesto, senza effetto sulla revisione | booleano | no |
| IsGuest | contesto, senza effetto sulla revisione | booleano | no |
| IsLimitedAccess | contesto, senza effetto sulla revisione | booleano | no |
12Squadre #sec_29bcc8ef
asana.teams.teams:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via asana.api.reviewit.service-account
Squadre dell'organizzazione e la loro visibilità
Chiamate
- GET /workspaces/{gid}/teams
- GET /teams/{gid}/team_memberships
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Condizione di amministrazione | richiesto | l'account di servizio Asana è creato da un super-amministratore dell'organizzazione (Asana Enterprise); il suo token concede accesso completo in lettura, verificato da una chiamata |
| Appartenenza | richiesto | l'identificativo appartiene all'organizzazione Asana della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://app.asana.com/api/1.0 risponde
Aggiornamento: verifiche inferiori a 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| Gid | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| Description | contesto, senza effetto sulla revisione | testo | no |
| Visibility | valutato dalle politiche REVIEWIT (visibilità) | testo | no |
| Organization | contesto, senza effetto sulla revisione | testo | no |
| MemberCount | contesto, senza effetto sulla revisione | intero | no |
13Per andare oltre #sec_b2bf5f50
- Comprendere una connessione di raccolta
- Riferimento dei diritti per risorsa
- Leggere un verdetto