API di piattaforma > Servizi Core > Jamio Resource

Restituisce una lista di collegamenti agli allegati di una risorsa che verificano una specifica espressione di selezione.

Metodo

JamioResource/ListResourceAttachments

Input
Nome	Descrizione	Tipo	Opzionale
serverAddress	Indirizzo server da un Dominio esterno (per il Dominio della sessione corrente, utilizzare nullo o vuoto).	String	Y
token	Token di sessione (per la sessione corrente, nel Dominio corrente, potrebbe essere nullo o vuoto).	String	Y
resource	Riferimento della risorsa.	Reference
attachmentInfoSelection	Espressione di selezione, che lavora sull'oggetto AttachmentInfo, utile a specificare un filtro sugli AttachmentInfo degli allegati alla risorsa, riportati nel risultato (per ulteriori dettagli consultare la sezione e le espressioni di selezione). L'espressione non può contenere riferimenti a variabili del contesto di processo o del contesto utente.	String	Y
includeTags	Lista di testi che indicano i tag degli allegati alla risorsa da includere nel risultato. La lista interroga la proprietà Tags di AttachmentInfo di un allegato.	List of String	Y
excludeTags	Lista di testi che indicano i tag degli allegati alla risorsa da escludere dal risultato. La lista interroga la proprietà Tags di AttachmentInfo di un allegato.	List of String	Y
Output
Nome	Descrizione	Tipo	Opzionale
returnValue	Lista di collegamenti agli allegati che verificano i criteri di selezione. I collegamenti restituiti sono valorizzati come segue: •Name: nome dell'allegato •Type: Types.Attachment •Url: URL dell'allegato	List of Reference

Commenti

Il metodo restituisce:

Restituisce	Condizione
La lista dei collegamenti a tutti gli allegati della risorsa	Se i valori delle proprietà attachmentInfoSelection, includeTags ed excludeTags sono nulli.
La lista dei collegamenti a tutti gli allegati della risorsa con o senza tag filtrati per attachmentInfoSelection	Se i valori delle proprietà includeTags ed excludeTags non sono specificati.
La lista dei collegamenti a tutti gli allegati della risorsa eventualmente filtrati per attachmentInfoSelection ed excludeTags	Se il valore della proprietà includeTags è nullo (ovvero non specificato nei valori di input o List()).
La lista dei collegamenti a tutti gli allegati della risorsa eventualmente filtrati per attachmentInfoSelection ed includeTags	Se il valore della proprietà excludeTags è nullo (ovvero non specificato nei valori di input o List()).
Una lista vuota	Se resource non possiede allegati.
Errore	Se la lista includeTags e la lista excludeTags sono valorizzati allo stesso modo.
Errore	Se il valore della lista includeTags è uguale al valore della lista excludeTags.

Al parametro attachmentInfoSelection è possibile assegnare espressioni che contengono solo riferimenti a valori costanti. Qualora sia necessario utilizzare variabili del contesto di processo o del contesto utente, è possibile definire una variabile di processo di tipo testo breve, contenente l'espressione di selezione, in cui tali variabili sono sostituite da placeholder. Successivamente questa variabile di processo dovrà essere rielaborata mediante le funzioni di sostituzione dei placeholder, in maniera tale da comporre l'espressione di selezione desiderata.

Esempio

Si desidera la lista degli allegati ad una risorsa Jamio che hanno nome file uguale al valore contenuto in una variabile di processo denominata nomeFile.

L'espressione di selezione da passare al parametro attachmentInfoSelection dovrebbe essere:

#oel.StringContains(FileName,#processVariables.Fields['nomeFile'])

Per quanto detto precedentemente, si definisce una variabile di processo di tipo testo breve denominata selectionExpression, contente la sopraelencata espressione, in cui un placeholder ##PLACEHOLDER## sostituisce la variabile nomeFile:

'#oel.StringContains(FileName,''##PLACEHOLDER##'')'

Successivamente si assegna al parametro attachmentInfoSelection l'espressione:

ReplaceString(#processVariables.Fields['selectionExpression'],'##PLACEHOLDER##',#processVariables.Fields['nomeFile'])

in cui col metodo ReplaceString si sostituisce il placeholder in maniera tale da ottenere l'espressione definitiva desiderata.

Espressioni di selezione

L'espressione di selezione attachmentInfoSelection ha come contesto un oggetto di tipo AttachmentInfo.

Per utilizzare le funzioni del OEL è necessario utilizzare il contesto #oel all'interno dell'espressione. Per riferirsi alla proprietà di AttachmentInfo va usata la notazione .nomeproprietà ad esempio:

Proprietà di AttachmentInfo	Espressione inserita
FileExtension	'FileExtension==''.eml'''
FileName	'#oel.StringContains(FileName,''pecemail'')'
FileName e Created.Date	'FileName== ''pecemail.eml'' and #oel.GreaterThan(Created.Date,DateTime.Today)'
FileExtension e OwnerType	'FileExtension==''.docx'' and OwnerType==Types.Data'
Created.Date	'#oel.LessThan(Created.Date,#oel.StringToDateTime(''04/02/2021 09:00:00'’,null,null))'

Autorizzazioni

Per eseguire il metodo è necessario possedere il permesso di lettura sulla risorsa che contiene gli allegati.