Utilizzo di annotazioni nei pacchettiUse Annotations in Packages

In Progettazione SSISSSIS sono disponibili annotazioni che è possibile utilizzare per ottenere pacchetti autodocumentati, più semplici da capire e gestire.The SSISSSIS Designer provides annotations, which you can use to make packages self-documenting and easier to understand and maintain. È possibile aggiungere annotazioni alle aree di progettazione dei flussi di controllo, dei flussi di dati e dei gestori di eventi di Progettazione SSISSSIS .You can add annotations to the control flow, data flow, and event handler design surfaces of SSISSSIS Designer. Nelle annotazioni può essere contenuto qualsiasi tipo di testo e possono essere utilizzate per aggiungere etichette, commenti e altre informazioni descrittive a un pacchetto.The annotations can contain any type of text, and they are useful for adding labels, comments, and other descriptive information to a package. Le annotazioni sono disponibili solo in modalità progettazione.Annotations are a design-time feature only. Non possono essere ad esempio scritte nei log.For example, they are not written to logs.

Quando si preme INVIO, il testo viene riportato nella riga successiva.When you press ENTER, the text wraps to the next line. Le dimensioni della casella delle annotazioni aumentano automaticamente man mano che si aggiungono le righe di testo.The annotation box automatically increases in size as you add additional lines of text. Le annotazioni dei pacchetti vengono rese persistenti come testo non crittografato nella sezione CDATA del file del pacchetto.Package annotations are persisted as clear text in the CDATA section of the package file.

Per altre informazioni sulle modifiche al formato del file del pacchetto, vedere Formato del pacchetto SSIS.For more information about changes to the format of the package file, see SSIS Package Format.

Quando si salva un pacchetto, Progettazione SSISSSIS salva le annotazioni nel pacchetto.When you save the package, SSISSSIS Designer saves the annotations in the package.

Aggiunta di un'annotazione a un pacchettoAdd an annotation to a package

  1. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)aprire il progetto di Integration ServicesIntegration Services contenente il pacchetto a cui si desidera aggiungere un'annotazione.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services project that contains the package to which you want to add an annotation.

  2. In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.In Solution Explorer, double-click the package to open it.

  3. In Progettazione SSISSSIS fare clic con il pulsante destro del mouse in un punto qualsiasi dell'area di progettazione della scheda Flusso di controllo, Flusso di datio Gestore evento , quindi fare clic su Aggiungi annotazione.In SSISSSIS Designer, right-click anywhere on the design surface of the Control Flow, Data Flow, or Event Handler tab, and then click Add Annotation. Nell'area di progettazione della scheda viene visualizzato un blocco di testo.A text block appears on the design surface of the tab.

  4. Aggiungere il testo.Add text.

    Nota

    Se non si aggiunge alcun testo, quando si fa clic all'esterno del blocco di testo quest'ultimo verrà rimosso.If you add no text, the text block is removed when you click outside the block.

  5. Per modificare le dimensioni o il formato del testo nell'annotazione, fare clic con il pulsante destro del mouse sull'annotazione, quindi scegliere Imposta carattere annotazioni testo.To change the size or format of the text in the annotation, right-click the annotation and then click Set Text Annotation Font.

  6. Pre aggiungere una riga di testo aggiuntiva, premere INVIO.To add an additional line of text, press ENTER.

    Le dimensioni della casella delle annotazioni aumentano automaticamente man mano che si aggiungono le righe di testo.The annotation box automatically increases in size as you add additional lines of text.

  7. Per aggiungere un'annotazione a un gruppo, fare clic con il pulsante destro del mouse sull'annotazione, quindi scegliere Gruppo.To add an annotation to a group, right-click the annotation and then click Group.

  8. Per salvare il pacchetto aggiornato, scegliere Salva tutto dal menu File.To save the updated package, on the File menu, click Save All.