Riusare il flusso di controllo dei pacchetti tramite le parti del pacchetto del flusso di controlloReuse Control Flow across Packages by Using Control Flow Package Parts

Salvare un'attività o un contenitore di flusso di controllo di uso comune in un file di parte autonomo (file con estensione dtsxp) e riusarli più volte in uno o più pacchetti usando le parti del flusso di controllo.Save a commonly used control flow task or container to a standalone part file - a “.dtsxp” file - and reuse it multiple times in one or more packages by using control flow package parts. Questa riusabilità semplifica la progettazione e la manutenzione dei pacchetti SSIS.This reusability makes SSIS packages easier to design and maintain.

Creare una nuova parte del pacchetto del flusso di controlloCreate a new control flow package part

Per creare una nuova parte del pacchetto del flusso controllo, in Esplora soluzioni espandere la cartella Parti del pacchetto .To create a new control flow package part, in Solution Explorer, expand the Package Parts folder. Fare clic con il pulsante destro del mouse su Flusso di controllo e selezionare Nuova parte del pacchetto del flusso di controllo.Right-click on Control Flow and select New Control Flow Package Part.

Creare un nuovo modello di flusso di controlloCreate a new control flow template

Viene creato un nuovo file di parte con estensione dtsxp nella cartella Parti del pacchetto | Flusso di controllo .A new part file with the ".dtsxp" extension is created under the Package Parts | Control Flow folder. Allo stesso tempo, viene aggiunto un nuovo elemento con lo stesso nome nella casella degli strumenti SSISAt the same time, a new item with the same name is also added to the SSIS toolbox. (l'elemento della casella degli strumenti è visibile solo quando si dispone di un progetto che contiene la parte sia aperto in Visual Studio).(The toolbox item is only visible while you have a project that contains the part open in Visual Studio.)

Modelli di flusso nella casella degli strumenti di controlloControl flow templates in toolbox

Progettare una parte del pacchetto del flusso di controlloDesign a control flow package part

Per aprire l'editor delle parti del pacchetto, fare doppio clic sul file di parte in Esplora soluzioni.To open the package part editor, double-click on the part file in Solution Explorer. È possibile progettare la parte esattamente come si progetta un pacchetto.You can design the part just like you design a package.

Passaggio 1 della progettazione di modello del flusso di controlloStep 1 of control flow template design

Passaggio 2 della progettazione di modello del flusso di controlloStep 2 of control flow template design

Le parti del pacchetto del flusso di controllo presentano le limitazioni seguenti.Control flow package parts have the following limitations.

  • Una parte può avere solo un contenitore o un'attività di livello principale.A part can have only one top-level task or container. Se si desidera includere più attività o contenitori, inserirli in un unico contenitore di sequenza.If you want to include multiple tasks or containers, put them all in a single sequence container.

  • Non è possibile eseguire o eseguire il debug di una parte direttamente nella finestra di progettazione.You can't run or debug a part directly in the designer.

Aggiungere una parte del pacchetto del flusso di controllo esistente a un pacchettoAdd an existing control flow package part to a package

È possibile riusare le parti che vengono salvate nel progetto di Servizi di integrazione corrente o in un progetto diverso.You can reuse parts that are saved in the current Integration Services project or in a different project.

  • Per riusare una parte del progetto corrente, trascinare e rilasciare la parte dalla casella degli strumenti.To reuse a part that's part of the current project, drag and drop the part from the toolbox.

  • Per riusare una parte di un progetto diverso, usare il comando Aggiungi parte del pacchetto del flusso di controllo esistente .To reuse a part that's part of a different project, use the Add Existing Control Flow Package Part command.

Trascinare e rilasciare una parte del pacchetto del flusso di controlloDrag and drop a control flow package part

Per riusare una parte in un progetto, è sufficiente trascinare e rilasciare l'elemento della parte dalla casella degli strumenti come qualsiasi altra attività o contenitore.To reuse a part in a project, simply drag and drop the part item from the toolbox just like any other task or container. È possibile trascinare e rilasciare più volte la parte in un pacchetto per usare la logica in più posizioni nel pacchetto.You can drag and drop the part into a package multiple times to reuse the logic in multiple locations in the package. Impiegare questo metodo per riusare una parte del progetto corrente.Use this method to reuse a part that is part of the current project.

Aggiungere un modello di flusso di controllo a un pacchettoAdd a control flow template to a package

Pacchetto con diversi modelli di flusso di controlloPackage with multiple control flow templates

Quando si salva il pacchetto, Progettazione SSIS controlla se sono presenti istanze di parte nel pacchetto.When you save the package, SSIS designer checks whether there are any part instances in the package.

  • Se il pacchetto contiene istanze di parte, la finestra di progettazione genera un nuovo file con estensione dtsx che contiene tutte le informazioni relative alla parte.If the package contains part instances, the designer generates a new .dtsx.designer file which contains all part-related information.

  • Se il pacchetto non contiene parti, la finestra di progettazione elimina qualsiasi file con estensione dtsx creato in precedenza per il pacchetto (ovvero, qualsiasi file di progettazione con estensione dtsx con lo stesso nome del pacchetto).If the package does not use parts, the designer deletes any previously created .dtsx.designer file for the package (that is, any .dtsx.designer file that has the same name as the package).

    Esplora soluzioni con modelli di flusso di controlloSolution Explorer with control flow templates

Aggiungere una copia di una parte del pacchetto del flusso di controllo esistente o un riferimento a una parte esistenteAdd a copy of an existing control flow package part or a reference to an existing part

Per aggiungere a un pacchetto una copia di una parte esistente nel file system, in Esplora soluzioni espandere la cartella Parti del pacchetto .To add a copy of an existing part in the file system to a package, in Solution Explorer, expand the Package Parts folder. Fare clic con il pulsante destro del mouse su Flusso di controllo e selezionare Aggiungi parte del pacchetto del flusso di controllo esistente.Right-click on Control Flow and select Add Existing Control Flow Package Part.

Aggiungere un nuovo modello di flusso di controllo dal menuAdd a new control flow templates from the menu

Finestra di dialogo Aggiungi copia di modelli esistentiAdd Copy of Existing Templates dialog box

OpzioniOptions

Percorso della parte del pacchettoPackage Part path
Digitare il percorso del file di parte o fare clic sul pulsante Sfoglia (...) e individuare il file di parte da copiare o a cui fare riferimento.Type the path to the part file, or click the browse button (…) and locate the part file to copy or to reference.

Aggiungi come riferimentoAdd as a reference

  • Se viene selezionata questa opzione, la parte viene aggiunta al progetto di Servizi di integrazione come riferimento.If selected, the part is added to the Integration Services project as a reference. Selezionare questa opzione quando si desidera fare riferimento a una singola copia di un file di parte in più progetti di Servizi di integrazione.Select this option when you when want to reference a single copy of a part file in multiple Integration Services projects.
  • Se deselezionata, una copia del file di parte viene aggiunta al progetto.If cleared, a copy of the part file is added to the project.

Configurare una parte del pacchetto del flusso di controlloConfigure a control flow package part

Per configurare le parti del pacchetto del flusso di controllo dopo averle aggiunte al flusso di controllo di un pacchetto, usare la finestra di dialogo Configurazione della parte del pacchetto .To configure control flow package parts after you've added them to the control flow of a package, use the Package Part Configuration dialog box.

Per aprire la finestra di dialogo Configurazione della parte del pacchettoTo open the Package Part Configuration dialog box

  1. Per configurare un'istanza di parte, fare doppio clic sull'istanza di parte specifica nel flusso di controllo.To configure a part instance, double-click the part instance in the control flow. Oppure fare clic con il pulsante destro del mouse sull'istanza di parte e selezionare Modifica.Or right-click on the part instance and select Edit. Si apre la finestra di dialogo Configurazione della parte del pacchetto .The Package Part Configuration dialog box opens.

  2. Configurare le proprietà e le gestioni connessioni per l'istanza di parte.Configure the properties and connection managers for the part instance.

Scheda ProprietàProperties tab

Usare la scheda Proprietà della finestra di dialogo Configurazione della parte del pacchetto per specificare le proprietà della parte.Use the Properties tab of the Package Part Configuration dialog box to specify the properties of the part.

Scheda proprietà della finestra di dialogo di configurazione del modelloProperties tab of the Template Configuration dialog box

La gerarchia della visualizzazione ad albero nel riquadro sulla sinistra elenca tutte le proprietà configurabili dell'istanza di parte.The tree view hierarchy in the left pane lists all configurable properties of the part instance.

  • Se deselezionata, la proprietà non è configurata nell'istanza di parte.If cleared, the property is not configured in the part instance. L'istanza di parte usa il valore predefinito per la proprietà, definito nella parte del pacchetto del flusso di controllo.The part instance uses the default value for the property, which is defined in the control flow package part.

  • Se selezionata, il valore immesso o selezionato esegue l'override del valore predefinito.If selected, the value that you enter or select overrides the default value.

    La tabella nel riquadro sulla destra elenca le proprietà da configurare.The table in the right pane lists the properties to configure.

  • Percorso proprietà.Property Path. Il percorso della proprietà.The property path of the property.

  • Tipo proprietà.Property Type. Tipo di dati della proprietà.The data type of the property.

  • Valore.Value. Il valore configurato.The configured value. Questo valore esegue l'override del valore predefinito.This value overrides the default value.

Scheda Gestioni connessioniConnection Managers tab

Usare la scheda Gestioni connessioni della finestra di dialogo Configurazione della parte del pacchetto per specificare le proprietà delle gestioni connessioni dell'istanza di parte.Use the Connection Managers tab of the Package Part Configuration dialog box to specify the properties of connection managers for the part instance.

Scheda gestioni connessioni della finestra di dialogo di configurazione del modelloConnection Managers tab of the Template Configuration dialog box

La tabella nel riquadro sulla sinistra elenca tutte le gestioni connessioni definite nella parte del flusso di controllo.The table in the left pane lists all the connection managers defined in the control flow part. Scegliere la gestione connessione che si desidera configurare.Choose the connection manager that you want to configure.

L'elenco nel riquadro sulla destra riporta le proprietà della gestione connessione selezionata.The list in the right pane lists the properties of the selected connection manager.

  • Imposta.Set. Selezionata se la proprietà è configurata per l'istanza di parte.Checked if the property is configured for the part instance.

  • Nome proprietà.Property Name. Nome della proprietà.The name of the property.

  • Valore.Value. Il valore configurato.The configured value. Questo valore esegue l'override del valore predefinito.This value overrides the default value.

Eliminare una parte del flusso di controlloDelete a control flow part

Per eliminare una parte, in Esplora soluzioni fare clic con il pulsante destro del mouse sulla parte, quindi scegliere Elimina.To delete a part, in Solution Explorer, right-click the part, and then select Delete. Selezionare OK per confermare l'eliminazione oppure Annulla per mantenere la parte.Select OK to confirm the deletion or select Cancel to keep the part.

Se si elimina una parte da un progetto, viene eliminata definitivamente dal file system e non può essere ripristinata.If you delete a part from a project, it is deleted permanently from the file system and it cannot be restored.

Nota

Se si vuole rimuovere una parte da un progetto di Servizi di integrazione, ma continuare a usarla in altri progetti, scegliere l'opzione Escludi dal progetto anziché l'opzione Elimina .If you want to remove a part from an Integration Services project, but continue to use it in other projects, use the Exclude from Project option instead of the Delete option.

Le parti del progetto sono disponibili solo in modalità di progettazionePackage parts are a design-time feature only

Le parti del progetto sono proprio una funzionalità della modalità di progettazionePackage parts are purely a design-time feature. Progettazione SSIS crea, apre, salva e aggiorna le parti e aggiunge, configura o elimina le istanze di parte di un pacchetto.SSIS designer creates, opens, saves, and updates parts, and adds, configures, or deletes part instances in a package. Tuttavia, SSIS Runtime non riconosce le parti.However, the SSIS runtime is not aware of the parts. Ecco come la finestra di progettazione ottiene la separazione.Here is how the designer achieves this separation.

  • La finestra di progettazione consente di salvare le istanze delle parti del pacchetto con le proprietà configurate in un file con estensione dtsx.designer.The designer saves package part instances with their configured properties to a “.dtsx.designer” file.

  • Se la finestra di progettazione consente di salvare il file con estensione dtsx.designer, è anche possibile estrarre il contenuto dalle parti a cui il file fa riferimento e sostituire le istanze di parte nel pacchetto con il contenuto delle parti.When the designer saves the “.dtsx.designer” file, it also extracts the content from the parts referenced by this file and replaces the part instances in the package with the content of the parts.

  • Infine tutto il contenuto, che non include più informazioni sulla parte, viene salvato nel file di pacchetto con estensione dtsx.Finally all the content, which no longer includes part information, is saved back to the “.dtsx” package file. Questo è il file che viene eseguito da SSIS Runtime.This is the file that the SSIS runtime runs.

    Il diagramma seguente illustra la relazione tra le parti (file con estensione dtsxp), Progettazione SSIS e SSIS Runtime.The diagram below demonstrates the relationship among parts (“.dtsxp” files), SSIS designer, and the SSIS runtime.

    File dei modelli di flusso e il flusso di controlloControl flow templates files and flow