<< Fare clic per visualizzazione il sommario >> Percorso: API di piattaforma > Servizi Core > Jamio Document > CreateDocumentWithFileComponents |
Crea un documento con componenti di tipo file, individuati tramite collegamenti ad allegati di risorsa o di processo.
Metodo
Jamio Document/CreateDocumentWithFileComponents
Input |
|||
Name |
Description |
Type |
Optional |
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 |
tenantId |
Tenant id (se nullo o vuoto, viene utilizzato quello della sessione corrente). |
String |
Y |
primaryComponent |
Dato strutturato contenente le informazioni del componente principale. Deve essere costruito con la seguente struttura: •chiave Component, il cui valore è un collegamento ad un Attachment, un FileComponent, un allegato di processo, un Document o un'altra risorsa contenente attachments. Se la risorsa è di tipo Document e contiene più componenti file viene utilizzato: ▪il componente principale se è di tipo File; ▪in assenza di componente principale, deve esserci un solo Componente File. Se la risorsa contiene una lista di attachments, deve esserci un solo file; •chiave ModelReference, il cui valore è il collegamento al modello del componente di tipo file. Se non presente nel dato strutturato, viene utilizzato il componente di tipo file built-in; •chiave Metadata, il cui valore è un dato strutturato che contiene i metadati da associare al componente. Viene ignorata se non è indicato il campo ModelReference. Se vi sono campi del dato strutturato non utilizzati, vengono ignorati. |
Dataset |
Y |
otherComponents |
Lista di dati strutturati costruiti con la stessa struttura del parametro primaryComponent. |
List of Dataset |
Y |
parentAggregationReference |
Collegamento al fascicolo in cui deve essere pubblicato il documento creato. |
Reference |
|
freeze |
Impostazione che indica se disabilitare il documento dopo la pubblicazione. Il valore di default è false. |
Boolean |
Y |
name |
Testo che valorizza la proprietà Name del documento. Se non specificato, il nome sarà "Doc__data e orario_". |
String |
Y |
description |
Testo che valorizza la proprietà Description del documento. Non è previsto un valore di default. |
String |
Y |
modelReference |
Collegamento al modello di documento da creare, se non valorizzato, viene creato un documento con il modello built-in. |
Reference |
Y |
metadata |
Dato strutturato con i metadati da associare al documento, la chiave indica il nome del campo presente nel modello specificato dal parametro modelReference. |
Dataset |
Y |
majorVersion |
Rappresenta il numero della versione principale del documento come specificato. Il valore di default è zero. Se si vuole impostare un numero di versione personalizzato da assegnare alla prima versione del documento, deve essere maggiore o uguale a 1. |
Integer |
Y |
minorVersion |
Rappresenta il numero della versione minore del documento. Il valore di default è zero. |
Integer |
Y |
versionLabel |
Testo che specifica il nome da assegnare alla versione del documento. |
String |
Y |
versionDescription |
Testo che specifica la descrizione da assegnare alla versione del documento. |
String |
Y |
Output |
|||
Name |
Description |
Type |
Optional |
returnValue |
Collegamento alla versione corrente del documento creato. |
Reference |
|
Commenti
I parametri PrimaryComponent e OtherComponents non sono obbligatori, ma almeno uno di essi deve essere presente. Se non è valorizzato il parametro PrimaryComponent, ma si utilizza la lista degli OtherComponents viene impostato come componente principale il primo della lista.
Il metodo si comporta come segue:
Restituisce |
Condizione |
Errore |
Se uno dei passaggi di creazione del documento non si completa. La creazione del documento viene abortita e il sistema tenta un annullamento della transazione. |
Errore |
Se primaryComponent o otherComponents contengono un dato strutturato che nel campo Component riporta un collegamento con URL vuota o un collegamento pari a null. |
Errore |
Se primaryComponent o otherComponents contengono un dato strutturato che nel campo Component riporta un collegamento ad una risorsa che contiene più di un file utilizzabile come componente. |
Esempio1
Si vuole creare una nuova risorsa di tipo documento, DocumentoC, a partire da due risorse di tipo documento esistenti: DocumentoA e DocumentoB.
Documento A contiene un solo componente file, impostato come componente principale.
Documento B contiene tre componenti file, di cui uno è impostato come componente principale.
Utilizzando il metodo CreateDocumentWithFileComponents riportando in input:
- il campo Component del dato strutturato primaryComponent valorizzato con il collegamento a DocumentoA;
- il campo Component del dato strutturato otherComponents valorizzato con il collegamento a DocumentoB.
Si ottiene il DocumentoC che ha i seguenti due componenti:
- componente principale: una copia del componente principale di DocumentoA;
- componente file: una copia del componente principale di DocumentoB.
Esempio2
Si vuole creare una nuova risorsa di tipo documento, DocumentoC, a partire da due risorse di tipo documento esistenti: DocumentoA e DocumentoB.
Documento A contiene un solo componente file, impostato come componente principale.
Documento B contiene tre componenti file, di cui nessuno è impostato come componente principale.
Utilizzando il metodo CreateDocumentWithFileComponents riportando in input:
- il campo Component del dato strutturato primaryComponent valorizzato con il collegamento a DocumentoA;
- il campo Component del dato strutturato otherComponents valorizzato con il collegamento a DocumentoB.
Si ottiene errore, poiché il DocumentoB contiene più componenti file utilizzabili come componente.