CopyDistributionList

<< Fare clic per visualizzazione il sommario >>

Percorso:  API di piattaforma > Servizi Core > Jamio ACL >

CopyDistributionList

Sostituisce la lista di distribuzione di una lista di risorse con quella della risorsa sorgente.

 

Metodo

JamioACL/CopyDistributionList

 

Input

Nome

Descrizione

Tipo

Opzionale

serverAddress

Indirizzo del server per domini esterni (o ' ' per il dominio corrente).

String

Y

token

Token di sessione (per la sessione corrente nel dominio corrente potrebbe essere null o vuoto).

String

Y

source

Collegamento alla risorsa la cui lista di distribuzione deve essere presa come riferimento.

Reference

 

destinationList

Lista di collegamenti delle risorse di cui si deve impostare la lista di distribuzione.

La lista di collegamenti deve essere omogenea rispetto alla tipologia di risorsa, ma può afferire a modelli diversi.

Reference List

Extended Reference List

CatalogItem List

 

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Lista dati strutturati relativa ai soli elementi a cui non è stato possibile applicare la lista di distribuzione.

Ciascun dato strutturato contiene:

Destination, dello stesso tipo dell'oggetto i-esimo della lista destinationList a cui non è possibile applicare la lista di distribuzione (collegamento, collegamento esteso o catalog item);

ReasonCode, di tipo numerico intero, che assume i valori:

o1 se non si possiedono i permessi di condivisione o la risorsa non esiste;

o2 se non si dispone di uno o più permessi sulla risorsa destinazione da inserire in lista di distribuzione (non è possibile distribuire permessi di cui non si dispone);

Detail, di tipo lista, che riporta l'elenco dei tipi dei permessi che non è possibile applicare. E' valorizzato solo se ReasonCode è pari a 2.

Dataset List

 

 

Commenti

I tipi di risorse a cui può essere applicato il metodo sono i seguenti:

Dati

Identità

Documento

Fascicolo

 

La risorsa sorgente può essere di una tipologia diversa da quella della risorsa di destinazione: in tal caso, vengono applicati solo i permessi compatibili con la tipologia di risorsa destinazione.

Il metodo applica una sostituzione della lista di distribuzione, per cui se la risorsa sorgente non ha una lista di distribuzione definita, quelle delle risorse destinazione, se presenti, vengono svuotate.

 

Il metodo restituisce errore se:

la lista di destinazione non è omogenea per tipologia;

la tipologia delle risorse di destinazione è del tipo a cui non è possibile applicare una lista di distribuzione;

la lista risorse di destinazione non appartengono stesso Tenant.