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à
SystemObject
  DedNet.CommandsDedCommand
    DedNet.CommandsImportDocument

Namespace: DedNet.Commands
Assembly: DedNet (in DedNet.dll) Versione: 26.4.0.0 (26.4.0.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à pubblicaExtFilter Filtro estensioni da utilizzare in caso di selezione file. Formato richiesto (Tutti i file (*.*)|*.*)
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à pubblicaHasTopic Restituisce o imposta il Topic per individuare il comando nell'Help.
(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à pubblicaMdres 
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à pubblicaRunningContext Indica di ignorare i permessi utente.
(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à pubblicaTopicHelp Restituisce o imposta il Topic per individuare il comando nell'Help.
(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