ReplaceDistributionListByCatalog

<< Fare clic per visualizzazione il sommario >>

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

ReplaceDistributionListByCatalog

Sostituisce la lista di distribuzione delle risorse contenute in un catalogo con quella della risorsa sorgente.

 

Metodo

JamioACL/ReplaceDistributionListByCatalog

 

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

 

catalogReference

Collegamento al catalogo che contiene le risorse di cui si deve aggiornare la lista di distribuzione. Può essere valorizzato con l'url di un catalogo installato (runtime) o di un modello di catalogo.

Reference

 

parameters

Parametri di filtro da applicare al catalogo, eventuali valori impostati per la paginazione e l'ordinamento vengono ignorati.

SearchParameters

Y

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Dato strutturato che contiene i seguenti campi:

TotalItems: numero totale di CatalogItem da processare;

ProcessedItems: numero di CatalogItem processati correttamente;

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

ScrapList: lista di dati strutturati relativa ai soli elementi a cui non è stato possibile applicare la lista di distribuzione in seguito ad errore. Non sono inclusi gli elementi non processati per interruzione del Job. Ciascun dato strutturato contiene:

oDestination, di tipo collegamento, riporta per l'i-esima riga del catalogo il riferimento alla risorsa;

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;

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.

Se non è definita una lista di distribuzione sulla risorsa sorgente, il metodo restituisce una lista di dati strutturati vuota e lascia inalterate le liste di distribuzione delle risorse destinazione.

 

Il metodo restituisce errore se:

se il parametro catalogReference non è valorizzato con un collegamento ad un catalogo;

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.