Domanda:
Come è possibile ritagliare documenti utilizzando l'SDK .NET o l'API REST?
Risposta:
Il ritaglio dei documenti utilizzando l'API può essere effettuato in vari scenari, che saranno illustrati nei seguenti esempi.
Utilizzo dell'SDK .NET
I seguenti esempi di codice possono essere utilizzati e modificati a seconda della situazione.
Nota: tenere presente le implicazioni di unisci dei documenti quando si sceglie di rimuovere un documento dalla posizione di origine. Se l'opzione per rimuovere il documento di origine è impostata su true, il documento verrà completamente rimosso dalla posizione di origine. Si consiglia di testare questa funzionalità in un ambiente di prova prima di passare a un sistema di produzione.
Aggiungere un documento alla fine
Stiamo passando l'oggetto File Cabinet, che contiene i documenti che vogliamo unire al primario, che è anche il secondo parametro che stiamo passando.
public static Document AppendDocuments(FileCabinet cabinet, Documento doc)
{
Documento DocumentAfterAppend = doc.GetDocumentFromSelfRelation().PutToProcessDocumentActionRelationForDocument(nuovo DocumentActionInfo()
{
DocumentAction = DocumentAction.Append,
DocumentActionParameters = new AppendActionParameters()
{
// Rimuovere i documenti dopo il ritaglio?
RemoveSourceDocuments = true,
DocumentiInDietro = nuovo elenco<AppendActionDocuments>()
{
nuovo AppendActionDocuments()
{
Documenti = nuovo Elenco<int>()
{
// ID documento dall'archivio file di origine
34, 35
},
IDCabinetFonte = cabinet.Id
}
}
}
});
return DocumentAfterAppend;
}
Aggiungi un documento all'inizio
Passiamo l'oggetto File Cabinet, che contiene i documenti che vogliamo unire al principale, che è anche il secondo parametro che passiamo.
public static Document AppendDocuments(FileCabinet cabinet, Documento doc)
{
Document DocumentAfterAppend = doc.GetDocumentFromSelfRelation().PutToProcessDocumentActionRelationForDocument(nuovo DocumentActionInfo()
{
DocumentAction = DocumentAction.Append,
DocumentActionParameters = new AppendActionParameters()
{
// Rimuovere i documenti dopo il ritaglio?
RemoveSourceDocuments = true,
DocumentiInPrimoPiano = nuovo elenco<AppendActionDocuments>()
{
nuovo AppendActionDocuments()
{
Documenti = nuovo Elenco<int>()
{
// ID documento dall'archivio file di origine
34, 35
},
IDCabinetFonte = cabinet.Id
}
}
}
});
return DocumentAfterAppend;
}
Unisci dal vassoio dei documenti all'archivio
Per unisci un documento dal vassoio documenti a uno nell'archivio, è necessario passare il guid del vassoio documenti alla funzione.
Ritaglio da archivio cartaceo ad archivio cartaceo
Per unire un documento dall'archivio cartaceo a un altro archivio cartaceo, è necessario passare il GUID dell'archivio cartaceo alla funzione.
Spostamento all'interno dello stesso archivio
Per unisci un documento che si trova nello stesso archivio, è necessario passare il GUID dell'archivio alla funzione.
Utilizzo dell'API REST
Verrà utilizzato il seguente endpoint, che può essere modificato per tenere conto delle seguenti situazioni.
Endpoint:{{ServerUrl}}/{{Platform}}/FileCabinets/{{File CabinetGuid}}/Operations/ProcessDocumentAction?docId={{DocId}}
Nota: il trasferimento di documenti da un archivio a un vassoio documenti o il trasferimento di documenti dallo stesso vassoio documenti non è un metodo supportato. Se provato, verrà visualizzato il seguente errore:
"Operazione non supportata per i vassoi documenti! Il metodo specificato non è supportato."
Per ritagliare documenti nella parte anteriore
Richiesta corpo:
Per ritagliare i documenti sul retro
Richiesta corpo:
Unisci da vassoio documenti a schedario
Per unisci un documento da un vassoio documenti a uno che si trova in un archivio, è necessario fare riferimento al GUID dell'archivio nell'URL dell'endpoint, quindi fare riferimento al GUID del vassoio documenti nella richiesta del corpo per "SourceCabinetId".
Unisci da archivio cartaceo ad archivio cartaceo
Per unire un documento da un archivio a un altro archivio, è necessario fare riferimento al GUID dell'archivio di destinazione nell'URL dell'endpoint, quindi fare riferimento al GUID dell'archivio di origine nella richiesta del corpo per "SourceCabinetId".
Ritaglio all'interno dello stesso archivio
Per unisci documenti all'interno dello stesso archivio, è necessario fare riferimento al GUID dell'archivio sia nell'URL dell'endpoint che nella richiesta del corpo per "SourceCabinetId".
Si prega di notare: Questo articolo è una traduzione dalla lingua inglese. Le informazioni contenute in questo articolo si basano sulla/le versione/i originale/i del/i prodotto/i in inglese. Potrebbero esserci errori minori, come nella grammatica utilizzata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa accuratezza della traduzione, nella maggior parte dei casi troverai che è sufficientemente informativa. In caso di dubbio, fai riferimento alla versione inglese di questo articolo.
KBA applicabile sia alle organizzazioni cloud che a quelle on-premise