<< 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. |
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.