ReplaceDistributionList

<< Fare clic per visualizzazione il sommario >>

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

ReplaceDistributionList

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

 

Metodo

JamioACL/ReplaceDistributionList

 

Input

Nome

Descrizione

Tipo

Opzionale

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 risorse, anche se afferenti a modelli diversi, e non può contenere più di 2000 elementi..

Reference List

Extended Reference List

CatalogItem List

 

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Dato strutturato che contiene i seguenti campi:

TotalItems: numero totale di elementi da processare;

ProcessedItems: numero di elementi processati correttamente;

ScrappedItems: numero di elementi processati con errore e/o non processati per interruzione del Job;

ScrapList: lista di dati strutturati relativa agli elementi a cui non è stato possibile applicare la lista di distribuzione per errore o per interruzione del job. Ciascun dato strutturato contiene:

oDestination, dello stesso tipo dell'oggetto i-esimo della lista destinationList a cui non è possibile applicare la lista di distribuzione (Collegamento, Collegamento Esteso o CatalogItem);

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

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

- 2 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);

- 3 se il collegamento non è valido, punta a risorse che non appartengono allo stesso Tenant della risorsa indicata in source o a risorse esterne a Jamio;

- 4 in caso di errore generico;

- 5 se si è verificata un'interruzione del job (JobStatus Canceled);

oDetail, del tipo:

- lista, se ReasonCode è pari a 2, che riporta l'elenco dei tipi dei permessi che non è possibile applicare.

- testo, se ReasonCode è pari a 4, che riporta il dettaglio dell'errore.

JobStatus: enumerativo che indica lo stato finale del job (Completed o Canceled).

Dataset

 

 

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 tipologia delle risorse di destinazione è del tipo a cui non è possibile applicare una lista di distribuzione;

le risorse di destinazione non appartengono allo stesso Tenant;

il job è in stato faulted.