Click or drag to resize

Classe ImportDocument

Associa uno o più documenti ad un'anagrafica. Se i documenti da associare non sono presenti ne viene chiesta la selezione all'utente. Se l'anagrafica alla quale associare il documento non è presente viene chiesta all'utente attraverso la finestra di dialogo ricerca (modale). Se il contesto specificato è Primario ed il file da riconoscere ha una estensione già presente nei primari allora, se questa estensione rientra nella lista delle estensioni disponibili alle nuove rappresentazioni, diventa una nuova rappresentazione altrimenti viene sollevato un errore. Questo comando copia il documento nella posizione di destinazione calcolata in base all'anagrafica. Se il file non è presente nel Database e viene associato come allegato, cerca di copiarlo mantenendo lo stesso nome. Se viene invece associato come primario o pubblicazione calcola il nome corretto di destinazione in base all'anagrafica ed alla sua famiglia di appartenenza. Se esiste già un documento con stesso nome di destinazione, se si tratta di una estensione per la quale si può creare una nuova rappresentazione allora procedere creando una nuova rappresentazione ed aggiunge ^xxxx al nome file. Diversamente interrompe l'esecuzione. Se è attiva l'area locale il file viene copiato nell'area locale e poi riconosciuto come documento associato all'anagrafica. Non viene contestualmente pubblicato nel vault ma rimane in checkout dall'utente corrente. Per ogni documento vengono chieste le dipendenze e, se presenti, anche queste sono inserite nel Database (a meno ché non vi fossero già) ed impostate in checkout (se pws attiva) ed aggiunte come dipendenze del nuovo documento creato. L'elaborazione è racchiusa in una transazione quindi se non ha successo la creazione del documento o di una sua dipendenza oppure l'associazione all'anagrafica, tutte le operazioni vengono annullate. Questo anche se l'errore è avvenuto su di un solo file tra quelli elaborati.
Gerarchia di ereditarietà

Namespace:  DedNet.Commands
Assembly:  DedNet (in DedNet.dll) Versione: 22.4.2.0 (22.4.2.0)
Sintassi
public class ImportDocument : DedCommand

Il tipo ImportDocument espone i seguenti membri.

Proprietà
  NomeDescrizione
Proprietà pubblicaApplication
Restituisce l'applicazione alla quale questo oggetto appartiene.
(Ereditato da DedCommand.)
Proprietà pubblicaClient
Restituisce o imposta le applicazioni client per le quali questo comando è disponibile.
(Ereditato da DedCommand.)
Proprietà pubblicaCommandContext
Restituisce o imposta il Contesto nel quale questo comando è disponibile.
(Ereditato da DedCommand.)
Proprietà pubblicaData
Restituisce o imposta l'anagrafica nella quale importare i documenti.
Proprietà pubblicaDelegateFileCopy
Restituisce o imposta il delegate che, dopo la creazione dei record, viene chiamato dal comando per la copia effettiva dei file. Se viene lasciato vuoto la copia viene effettuatata dal comando. Chi implementa il delegate dovrebbe sollevare eccezioni in caso di errore per interrompere ed annullare tutta la procedura di importazione documenti.
Proprietà pubblicaDelegateNewAttachFileName
Restitusice o imposta il delegate che viene chiamato per reperire il nome file nel caso di importazione di un nuovo documento come allegato. Il valore restituito deve essere il nome file compreso di estensione ma senza percorso: viene calcolato dal comando. Chi implementa il delegate dovrebbe sollevare eccezioni in caso di errore per interrompere ed annullare tutta la procedura di importazione documenti.
Proprietà pubblicaDestFileName
Permette di fare un import senza anagrafica(effettua un copia o un move).
Proprietà pubblicaEnforceOverWriteMode
Indica se è nel caso sovrascrivere o creare una rappresentazione.
Proprietà pubblicaEnforceRepresentation
Indica se è nel caso sovrascrivere o creare una rappresentazione.
Proprietà pubblicaFileList
Restituisce la lista dei file da importare come documenti e da associare all'anagrafica. Inserire in questa lista solo i file che si desidera importare e non le dipendenze, a meno ché non siano a loro volta da importare.
Proprietà pubblicaFolder
Cartella di destinazione
Proprietà pubblicaGlobalName
Restituisce o imposta il nome globale da utilizzare per il comando quando utilizzato come comando globale (es.: DedWin, DedWiew, ecc.). Di default è null, in questo caso viene utilizzato il valore di Name.
(Ereditato da DedCommand.)
Proprietà pubblicaGlobalOrder
Restituisce o imposta l'indice di ordinamento di questo comando, quando utilizzato come comando globale (es.: DedWin, DedWiew, ecc.). Di default è inizializzato a 1000.
(Ereditato da DedCommand.)
Proprietà pubblicaIgnoreUserPerm
Indica di ignorare i permessi utente.
(Ereditato da DedCommand.)
Proprietà pubblicaImg16
Restituisce o imposta l'immagine 16x16 abbinata al comando.
(Ereditato da DedCommand.)
Proprietà pubblicaImg32
Restituisce o imposta l'immagine 32x32 abbinata al comando.
(Ereditato da DedCommand.)
Proprietà pubblicaInternalName
Restituisce il nome interno del comando che non varia in base alla lingua locale.
(Ereditato da DedCommand.)
Proprietà pubblicaIsCreateNewRep
Indica se è un importazione chiamata dal comando crea nuova rappresentazione.
Proprietà pubblicaIsCreateRevision
Indica se è una importazione chiamata dal comando salva revisione
Proprietà pubblicaIsDocSelection
Restituisce o imposta se si tratta di una selezione di documenti o file ( default = file ).
Proprietà pubblicaIsImportingOperation
Restituisce o imposta se si tratti di una operazione di importazione (eseguita per esempio dal programma Importer.exe). In tal caso il comando si comporta in modo da non effettuare i controlli in modo stretto.
(Ereditato da DedCommand.)
Proprietà pubblicaLastException
Restituisce l'ultima eccezione che si è verificata durante l'esecuzione. Restituisce null se non sono avvenuti errori.
(Ereditato da DedCommand.)
Proprietà pubblicaMinimumPerm
Restituisce o imposta il permesso minimo necessario per eseguire il comando.
(Ereditato da DedCommand.)
Proprietà pubblicaName
Restituisce il nome visualizzato del comando.
(Ereditato da DedCommand.)
Proprietà pubblicaNeedDocument
Restituisce se questo comando è un comando che lavora sul documento. Questa propritetà viene interrogata nella finestra di dialogo di ricerca codice per sapere se deve espandersi e far selezionare all'utente anche un documento.
(Ereditato da DedCommand.)
Proprietà pubblicaNeedParameters
Restituisce true se non è impostata l'anagrafica nella quale importare il documento.
(Sovrascrive DedCommandNeedParameters.)
Proprietà pubblicaNeedRefresh
Restituisce se il comando ha modificato l'oggetto sul quale agisce e può esserci necessità di refresh.
(Ereditato da DedCommand.)
Proprietà pubblicaNoOwnerForm
Restituisce o imposta se ignorare il parent form, per questo comando, nel visualizzare qualsiasi finestra. Viene utilizzato per forzare la non parentela.
(Ereditato da DedCommand.)
Proprietà pubblicaOwnerForm
Restituisce o imposta l'handle del form principale dal quale è stato lanciato il comando. Viene utilizzato come parent delle finestre secondarie e di errore eventualmente visualizzate.
(Ereditato da DedCommand.)
Proprietà pubblicaPrimaryContext
Restituisce o imposta il contesto con il quale importare i documenti. Di default è true ed i documenti vengono importati come primari.
Proprietà pubblicaResult
Restituisce il risultato dell'ultima esecuzione.
(Ereditato da DedCommand.)
Proprietà pubblicaSilent
Restituisce o imposta se il comando debba visualizzare o meno i messaggi di conferma o di errore all'utente. Di default è false.
(Ereditato da DedCommand.)
Proprietà pubblicaSparePartsContext
Indica se importare il documento associandolo all'anagrafica con contesto 'PubblicazioneRicambio' o 'TavolaRicambio'.
Proprietà pubblicaSubMenuName
Restituisce o imposta il nome del Sottomenu nel quale inserire questo comando.
(Ereditato da DedCommand.)
Proprietà pubblicaSubMenuText
Restituisce o imposta il testo del Sottomenu nel quale inserire questo comando.
(Ereditato da DedCommand.)
Proprietà pubblicaToBeCheckIn
Indica se effettuare il checkin o meno alla fine del comando (default True).
Proprietà pubblicaTooltip
Restituisce o imposta il Tooltip descrittivo del comando.
(Ereditato da DedCommand.)
Proprietà pubblicaUseOriginalSparePartsFileName
Indica se, in caso di importazione file ricambio, utilizzare il nome originale o calcolarne uno valido. Di default è False.
Proprietà pubblicaUseUI
Restituisce o imposta se, in mancanza di informazioni per l'esecuzione del comando, si debba chiedere all'utente attraverso le apposite finestre di dialogo. Di default è true.
(Ereditato da DedCommand.)
Torna su
Metodi
  NomeDescrizione
Metodo pubblicoClearCommand
Azzera il Comando.
(Sovrascrive DedCommandClearCommand.)
Metodo pubblicoEnabled
Restituisce se il comando è abilitato in base alla selezione contestuale. Si accontenta di avere l'anagrafica alla quale associare il file.
(Sovrascrive DedCommandEnabled(DedCommandContext).)
Metodo pubblicoEquals (Ereditato da DedCommand.)
Metodo protettoExecuteCommand
Esegue il comando vero e proprio.
(Sovrascrive DedCommandExecuteCommand.)
Metodo pubblicoGetHashCode (Ereditato da DedCommand.)
Metodo protettoInitSubCommand
Inizializza un sotto-comando con le impostazioni generali presenti in questo.
(Ereditato da DedCommand.)
Metodo pubblicoRun
Esegue il comando.
(Ereditato da DedCommand.)
Metodo pubblicoRunSubCommand
Esegue il comando come sotto-comando ovvero non gestisce la visualizzazione degli errori ma "fa passare" le eccezioni in modo che siano gestite dal chiamante cioè il comando principale. ///
(Ereditato da DedCommand.)
Metodo pubblicoSetContext
Permette al comando di auto-impostare le proprietà leggendo le informazioni dal contesto. Si accontenta di avere l'anagrafica alla quale associare il file.
(Sovrascrive DedCommandSetContext(DedCommandContext).)
Metodo pubblicoToString (Ereditato da DedCommand.)
Torna su
Vedi anche