Attività File systemFile System Task

L'attività File system consente di eseguire operazioni su file e directory nel file system.The File System task performs operations on files and directories in the file system. Tramite l'attività File system un pacchetto può ad esempio creare, spostare o eliminare file e directory.For example, by using the File System task, a package can create, move, or delete directories and files. È inoltre possibile utilizzare l'attività File system per impostare attributi su file e directory,You can also use the File System task to set attributes on files and directories. ad esempio per impostare file come nascosti o in sola lettura.For example, the File System task can make files hidden or read-only.

Tutte le operazioni dell'attività File system utilizzano un'origine, che può essere costituita da un file o una directory.All File System task operations use a source, which can be a file or a directory. Il file copiato o la directory eliminata tramite un'attività è un'origine.For example, the file that the task copies or the directory it deletes is a source. L'origine può essere specificata tramite una gestione connessione file che punta alla directory o al file oppure specificando il nome di una variabile che contiene il percorso dell'origine.The source can be specified by using a File connection manager that points to the directory or file or by providing the name of a variable that contains the source path. Per altre informazioni, vedere Gestione connessione File e Variabili di Integration Services (SSIS).For more information, see File Connection Manager and Integration Services (SSIS) Variables.

Le operazioni che prevedono la copia e lo spostamento di file e directory oppure la ridenominazione di file utilizzano un'origine e una destinazione.The operations that copy and move file and directories and rename files use a destination and a source. La destinazione viene specificata utilizzando una gestione connessione file o una variabile.The destination is specified by using a File connection manager or a variable. Le operazioni dell'attività File system possono essere configurate in modo da consentire la sovrascrittura dei file e delle directory di destinazione.File system task operations can be configured to permit overwriting of destination files and directories. L'operazione con cui viene creata una nuova directory può essere configurata in modo da utilizzare una directory esistente con il nome specificato anziché avere esito negativo se la directory esiste già.The operation that creates a new directory can be configured to use an existing directory that has the specified name instead of failing when the directory already exists.

Operazioni predefinite dell'attività File systemPredefined File System Operations

L'attività File system include un set predefinito di operazioni,The File System task includes a predefined set of operations. descritte nella tabella seguente.The following table describes these operations.

OperazioneOperation DescriptionDescription
Copia directoryCopy directory Copia una cartella da un percorso a un altro.Copies a folder from one location to another.
Copia fileCopy file Copia un file da un percorso a un altro.Copies a file from one location to another.
Crea directoryCreate directory Crea una cartella in un percorso specificato.Creates a folder in a specified location.
Elimina directoryDelete directory Elimina una cartella in un percorso specificato.Deletes a folder in a specified location.
Elimina contenuto directoryDelete directory content Elimina tutti i file e le cartelle contenute in una cartella.Deletes all files and folders in a folder.
Elimina fileDelete file Elimina un file in un percorso specificato.Deletes a file in a specified location.
Sposta directoryMove directory Sposta una cartella da un percorso a un altro.Moves a folder from one location to another.
Sposta fileMove file Sposta un file da un percorso a un altro.Moves a file from one location to another.
Rinomina fileRename file Rinomina un file in un percorso specificato.Renames a file in a specified location.
Imposta attributiSet attributes Imposta attributi su file e cartelle.Sets attributes on files and folders. Tali attributi includono Archive, Hidden, Normal, ReadOnly e System.Attributes include Archive, Hidden, Normal, ReadOnly, and System. Normal indica la mancanza di attributi e non può essere combinato con altri attributi.Normal is the lack of attributes, and it cannot be combined with other attributes. Tutti gli altri attributi possono essere utilizzati in combinazione.All other attributes can be used in combination.

L'attività File system opera su un singolo file o directory.The File System task operates on a single file or directory. Pertanto, questa attività non supporta l'utilizzo di caratteri jolly per eseguire la stessa operazione su più file.Therefore, this task does not support the use of wildcard characters to perform the same operation on multiple files. Affinché l'attività File system ripeta un'operazione su più file o directory, inserire l'attività File system in un contenitore Ciclo Foreach, come descritto nella procedura seguente:To have the File System task repeat an operation on multiple files or directories, put the File System task in a Foreach Loop container, as described in the following steps:

  • Configurare il contenitore Ciclo Foreach Nella pagina Raccolta dell'Editor ciclo Foreach, impostare l'enumeratore su Enumeratore Foreach File e immettere l'espressione con caratteri jolly come configurazione dell'enumeratore per File.Configure the Foreach Loop container On the Collection page of the Foreach Loop Editor, set the enumerator to Foreach File Enumerator and enter the wildcard expression as the enumerator configuration for Files. Nella pagina Mapping variabili dell'Editor ciclo Foreach, eseguire il mapping di una variabile che si desidera usare per passare uno alla volta i nomi dei file all'attività File System.On the Variable Mappings page of the Foreach Loop Editor, map a variable that you want to use to pass the file names one at a time to the File System task.

  • Aggiungere e configurare un'attività File System Aggiungere un'attività File System al contenitore Ciclo Foreach.Add and configure a File System task Add a File System task to the Foreach Loop container. Nella pagina Generale dell'Editor attività File system, impostare la proprietà SourceVariable o DestinationVariable sulla variabile definita nel contenitore Ciclo Foreach.On the General page of the File System Task Editor, set the SourceVariable or DestinationVariable property to the variable that you defined in the Foreach Loop container.

Voci di log personalizzate disponibili nell'attività File SystemCustom Log Entries Available on the File System Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività File system.The following table describes the custom log entry for the File System task. Per altre informazioni, vedere registrazione di Integration Services (SSIS).For more information, see Integration Services (SSIS) Logging.

Voce di logLog entry DescriptionDescription
FileSystemOperationFileSystemOperation Indica l'operazione eseguita dall'attività.Reports the operation that the task performs. Questa voce di log viene scritta all'inizio dell'operazione sul file system e include informazioni sull'origine e sulla destinazione.The log entry is written when the file system operation starts and includes information about the source and destination.

Configurazione dell'attività File systemConfiguring the File System Task

È possibile impostare le proprietà tramite Progettazione SSISSSIS o a livello di codice.You can set properties through SSISSSIS Designer or programmatically.

Per ulteriori informazioni sulle proprietà che è possibile impostare in Progettazione SSISSSIS , vedere gli argomenti seguenti:For more information about the properties that you can set in SSISSSIS Designer, see the following topics:

Integration ServicesIntegration Services include un'attività che consente di eseguire il download e il caricamento di file di dati, nonché di gestire directory sui server. includes a task that downloads and uploads data files and manages directories on servers. Per altre informazioni, vedere Attività FTP.For more information, see FTP Task.

Editor attività File system (pagina Generale)File System Task Editor (General Page)

Usare la pagina Generale della finestra di dialogo Editor attività File system per configurare l'operazione di file system eseguita dall'attività.Use the General page of the File System Task Editor dialog to configure the file system operation that the task performs.

È necessario specificare una gestione connessione di origine e di destinazione impostando le proprietà SourceConnection e DestinationConnection.You must specify a source and destination connection manager by setting the SourceConnection and DestinationConnection properties. È possibile specificare i nomi delle gestioni connessione file che puntano ai file utilizzati dall'attività come origine o come destinazione oppure, se i percorsi dei file sono archiviati in variabili, è possibile specificare i nomi delle variabili.You can either provide the names of File connection managers that point to the files that the task uses as a source or destination, or if the paths of the files are stored in variables, you can provide the names of the variables. Per usare variabili per l'archiviazione dei percorsi dei file, è innanzitutto necessario impostare su Truel'opzione IsSourcePathVariable per la connessione di origine e l'opzione IsDestinationPathVariable per la connessione di destinazione.To use variables to store the file paths, you must set first set the IsSourcePathVariable option for the source connection and the IsDestinationPatheVariable option for the destination connection to True. È quindi possibile scegliere quali variabili utilizzare tra le variabili di sistema o definite dall'utente esistenti, oppure creare nuove variabili.You can then choose the existing system or user-defined variables to use, or you can create new variables. Nella finestra di dialogo Aggiungi variabile è possibile configurare e specificare l'ambito delle variabili.In the Add Variable dialog box, you can configure and specify the scope of the variables. L'ambito deve essere l'attività File system o un contenitore padre.The scope must be the File System task or a parent container. Per altre informazioni, vedere Variabili di Integration Services (SSIS) e Utilizzo di variabili nei pacchetti.For more information see, Integration Services (SSIS) Variables and Use Variables in Packages.

Nota

Per eseguire l'override delle variabili selezionate per le proprietà SourceConnection e DestinationConnection, immettere un'espressione per le proprietà Source e Destination.To override the variables you selected for the SourceConnection and DestinationConnection properties, enter an expression for the Source and Destination properties. Le espressioni devono essere immesse nella pagina Espressioni di Editor attività File system.You enter expressions on the Expressions page of the File System Task Editor. Ad esempio, per impostare il percorso dei file utilizzati dall'attività come destinazione, potrebbe essere necessario utilizzare la variabile A in determinate condizione e la variabile B in altre.For example, to set the path of the files that the task uses as a destination, you may want to use variable A under certain conditions and use variable B under other conditions.

Nota

L'attività File system opera su un singolo file o directory.The File System task operates on a single file or directory. Pertanto, questa attività non supporta l'utilizzo di caratteri jolly per eseguire la stessa operazione su più file o directory.Therefore, this task does not support the use of wildcard characters to perform the same operation on multiple files or directories. Affinché l'attività File system ripeta un'operazione su più file o directory, inserirla in un contenitore Ciclo Foreach.To have the File System task repeat an operation on multiple files or directories, put the File System task in a Foreach Loop container. Per altre informazioni, vedere Attività File system.For more information, see File System Task.

Con le espressioni è possibile utilizzare variabili differenti perYou can use expressions to use different variables for the

OpzioniOptions

IsDestinationPathVariableIsDestinationPathVariable
Consente di specificare se il percorso di destinazione è archiviato in una variabile.Indicate whether the destination path is stored in a variable. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.This property has the options listed in the following table.

ValoreValue DescriptionDescription
TrueTrue Il percorso di destinazione è archiviato in una variabile.The destination path is stored in a variable. Se si seleziona questo valore, viene visualizzata l'opzione dinamica DestinationVariable.Selecting this value displays the dynamic option, DestinationVariable.
FalseFalse Il percorso di destinazione è specificato in una gestione connessione file.The destination path is specified in a File connection manager. Se si seleziona questo valore, viene visualizzata l'opzione dinamica DestinationConnection.Selecting this value displays the dynamic option, DestinationConnection.

OverwriteDestinationOverwriteDestination
Consente di specificare se l'operazione può sovrascrivere i file nella directory di destinazione.Specify whether the operation can overwrite files in the destination directory.

NomeName
Consente di specificare un nome univoco per l'attività File system.Provide a unique name for the File System task. Tale nome viene utilizzato come etichetta nell'icona dell'attività.This name is used as the label in the task icon.

Nota

I nomi delle attività devono essere univoci all'interno di un pacchetto.Task names must be unique within a package.

DescriptionDescription
Consente di digitare una descrizione dell'attività File system.Type a description of the File System task.

OperazioneOperation
Consente di selezionare l'operazione di file system da eseguire.Select the file-system operation to perform. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.This property has the options listed in the following table.

ValoreValue DescriptionDescription
Copia directoryCopy directory Consente di copiare una directory.Copy a directory. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche per l'origine e la destinazione.Selecting this value displays the dynamic options for a source and destination.
Copia fileCopy file Consente di copiare un file.Copy a file. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche per l'origine e la destinazione.Selecting this value displays the dynamic options for a source and destination.
Crea directoryCreate directory Consente di creare una directory.Create a directory. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche per una directory di origine e di destinazione.Selecting this value displays the dynamic options for a source and a destination directory.
Elimina directoryDelete directory Consente di eliminare una directory.Delete a directory. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche per l'origine.Selecting this value displays the dynamic options for a source.
Elimina contenuto directoryDelete directory content Consente di eliminare il contenuto di una directory.Delete the content of a directory. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche per l'origine.Selecting this value displays the dynamic options for a source.
Elimina fileDelete file Consente di eliminare un file.Delete a file. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche per l'origine.Selecting this value displays the dynamic options for a source.
Sposta directoryMove directory Consente di spostare una directory.Move a directory. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche per l'origine e la destinazione.Selecting this value displays the dynamic options for a source and destination.
Sposta fileMove file Consente di spostare un file.Move a file. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche per l'origine e la destinazione.Selecting this value displays the dynamic options for a source and destination. Quando si sposta un file, non includere un nome file nel percorso della directory che si fornisce come destinazione.When moving a file, do not include a file name in the directory path that you provide as the destination.
Rinomina fileRename file Consente di rinominare un file.Rename a file. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche per l'origine e la destinazione.Selecting this value displays the dynamic options for a source and destination. Quando si rinomina un file, includere il nuovo nome file nel percorso della directory che si fornisce come destinazione.When renaming a file, include the new file name in the directory path that you provide for the destination.
Imposta attributiSet attributes Consente di impostare gli attributi di un file o di una directory.Set the attributes of a file or directory. Quando si seleziona questo valore vengono visualizzate le opzioni dinamiche per l'origine e l'operazione.Selecting this value displays the dynamic options for a source and operation.

IsSourcePathVariableIsSourcePathVariable
Consente di specificare se il percorso di destinazione è archiviato in una variabile.Indicate whether the destination path is stored in a variable. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.This property has the options listed in the following table.

ValoreValue
TrueTrue Il percorso di destinazione è archiviato in una variabile.The destination path is stored in a variable. Se si seleziona questo valore, viene visualizzata l'opzione dinamica SourceVariable.Selecting this value displays the dynamic option, SourceVariable.
FalseFalse Il percorso di destinazione è specificato in una gestione connessione file.The destination path is specified in a File connection manager. Se si seleziona questo valore, viene visualizzata l'opzione dinamica DestinationVariable.Selecting this value displays the dynamic option, DestinationVariable.

Opzioni dinamiche di IsDestinationPathVariableIsDestinationPathVariable Dynamic Options

IsDestinationPathVariable = TrueIsDestinationPathVariable = True

DestinationVariableDestinationVariable
Selezionare il nome della variabile nell'elenco oppure fare clic su < nuova variabile... > per creare una nuova variabile.Select the variable name in the list, or click <New variable...> to create a new variable.

Argomenti correlati: Variabili di Integration Services (SSIS), Aggiungi variabileRelated Topics: Integration Services (SSIS) Variables, Add Variable

IsDestinationPathVariable = FalseIsDestinationPathVariable = False

DestinationConnectionDestinationConnection
Selezionare una gestione connessione File nell'elenco oppure fare clic su < nuova connessione... > per creare una nuova gestione connessione.Select a File connection manager in the list, or click <New connection...> to create a new connection manager.

Argomenti correlati: File Connection Manager, File Connection Manager EditorRelated Topics: File Connection Manager, File Connection Manager Editor

Opzioni dinamiche di IsSourcePathVariableIsSourcePathVariable Dynamic Options

IsSourcePathVariable = TrueIsSourcePathVariable = True

SourceVariableSourceVariable
Selezionare il nome della variabile nell'elenco oppure fare clic su < nuova variabile... > per creare una nuova variabile.Select the variable name in the list, or click <New variable...> to create a new variable.

Argomenti correlati: Variabili di Integration Services (SSIS), Aggiungi variabileRelated Topics: Integration Services (SSIS) Variables, Add Variable

IsSourcePathVariable = FalseIsSourcePathVariable = False

SourceConnectionSourceConnection
Selezionare una gestione connessione File nell'elenco oppure fare clic su < nuova connessione... > per creare una nuova gestione connessione.Select a File connection manager in the list, or click <New connection...> to create a new connection manager.

Argomenti correlati: Gestione connessione fileRelated Topics: File Connection Manager

Opzioni dinamiche di OperationOperation Dynamic Options

Operation = Imposta attributiOperation = Set Attributes

HiddenHidden
Consente di specificare se il file o la directory è visibile.Indicate whether the file or directory is visible.

ReadOnlyReadOnly
Consente di specificare se il file è di sola lettura.Indicate whether the file is read-only.

ArchiveArchive
Consente di specificare se il file o la directory è pronta per l'archiviazione.Indicate whether the file or directory is ready for archiving.

Di sistemaSystem
Consente di specificare se il file è un file di sistema.Indicate whether the file is an operating system file.

Operation = Crea directoryOperation = Create directory

UseDirectoryIfExistsUseDirectoryIfExists
Indica se l'operazione Crea directory usa una directory esistente con il nome specificato anziché creare una nuova directory.Indicates whether the Create directory operation uses an existing directory with the specified name instead of creating a new directory.

Vedere ancheSee Also

Attività di Integration Services Integration Services Tasks
Flusso di controlloControl Flow