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: 23.3.0.0 (23.3.0.0)

Sintassi

C++

Copy

public class ImportDocument : DedCommand

Public Class ImportDocument
	Inherits DedCommand

public ref class ImportDocument : public DedCommand

type ImportDocument =  
    class
        inherit DedCommand
    end

Il tipo ImportDocument espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Application	Restituisce l'applicazione alla quale questo oggetto appartiene. (Ereditato da DedCommand.)
	Client	Restituisce o imposta le applicazioni client per le quali questo comando è disponibile. (Ereditato da DedCommand.)
	CommandContext	Restituisce o imposta il Contesto nel quale questo comando è disponibile. (Ereditato da DedCommand.)
	Data	Restituisce o imposta l'anagrafica nella quale importare i documenti.
	DelegateFileCopy	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.
	DelegateNewAttachFileName	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.
	DestFileName	Permette di fare un import senza anagrafica(effettua un copia o un move).
	EnforceOverWriteMode	Indica se è nel caso sovrascrivere o creare una rappresentazione.
	EnforceRepresentation	Indica se è nel caso sovrascrivere o creare una rappresentazione.
	FileList	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.
	Folder	Cartella di destinazione
	GlobalName	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.)
	GlobalOrder	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.)
	IgnoreUserPerm	Indica di ignorare i permessi utente. (Ereditato da DedCommand.)
	Img16	Restituisce o imposta l'immagine 16x16 abbinata al comando. (Ereditato da DedCommand.)
	Img32	Restituisce o imposta l'immagine 32x32 abbinata al comando. (Ereditato da DedCommand.)
	InternalName	Restituisce il nome interno del comando che non varia in base alla lingua locale. (Ereditato da DedCommand.)
	IsCreateNewRep	Indica se è un importazione chiamata dal comando crea nuova rappresentazione.
	IsCreateRevision	Indica se è una importazione chiamata dal comando salva revisione
	IsDocSelection	Restituisce o imposta se si tratta di una selezione di documenti o file ( default = file ).
	IsImportingOperation	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.)
	LastException	Restituisce l'ultima eccezione che si è verificata durante l'esecuzione. Restituisce null se non sono avvenuti errori. (Ereditato da DedCommand.)
	MinimumPerm	Restituisce o imposta il permesso minimo necessario per eseguire il comando. (Ereditato da DedCommand.)
	Name	Restituisce il nome visualizzato del comando. (Ereditato da DedCommand.)
	NeedDocument	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.)
	NeedParameters	Restituisce true se non è impostata l'anagrafica nella quale importare il documento. (Sovrascrive DedCommandNeedParameters.)
	NeedRefresh	Restituisce se il comando ha modificato l'oggetto sul quale agisce e può esserci necessità di refresh. (Ereditato da DedCommand.)
	NoOwnerForm	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.)
	OwnerForm	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.)
	PrimaryContext	Restituisce o imposta il contesto con il quale importare i documenti. Di default è true ed i documenti vengono importati come primari.
	Result	Restituisce il risultato dell'ultima esecuzione. (Ereditato da DedCommand.)
	Silent	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.)
	SparePartsContext	Indica se importare il documento associandolo all'anagrafica con contesto 'PubblicazioneRicambio' o 'TavolaRicambio'.
	SubMenuName	Restituisce o imposta il nome del Sottomenu nel quale inserire questo comando. (Ereditato da DedCommand.)
	SubMenuText	Restituisce o imposta il testo del Sottomenu nel quale inserire questo comando. (Ereditato da DedCommand.)
	ToBeCheckIn	Indica se effettuare il checkin o meno alla fine del comando (default True).
	Tooltip	Restituisce o imposta il Tooltip descrittivo del comando. (Ereditato da DedCommand.)
	UseOriginalSparePartsFileName	Indica se, in caso di importazione file ricambio, utilizzare il nome originale o calcolarne uno valido. Di default è False.
	UseUI	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

	Nome	Descrizione
	ClearCommand	Azzera il Comando. (Sovrascrive DedCommandClearCommand.)
	Enabled	Restituisce se il comando è abilitato in base alla selezione contestuale. Si accontenta di avere l'anagrafica alla quale associare il file. (Sovrascrive DedCommandEnabled(DedCommandContext).)
	Equals	(Ereditato da DedCommand.)
	ExecuteCommand	Esegue il comando vero e proprio. (Sovrascrive DedCommandExecuteCommand.)
	GetHashCode	(Ereditato da DedCommand.)
	InitSubCommand	Inizializza un sotto-comando con le impostazioni generali presenti in questo. (Ereditato da DedCommand.)
	Run	Esegue il comando. (Ereditato da DedCommand.)
	RunSubCommand	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.)
	SetContext	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).)
	ToString	(Ereditato da DedCommand.)

Torna su

Vedi anche

Documentazione

Namespace DedNet.Commands