Procedura: creare report di distribuzione dalla riga di comando

Articolo
09/12/2008

Aggiornamento: novembre 2007

Mediante l'utilizzo della riga di comando è possibile generare dei report di distribuzione. Tuttavia, è necessario prima suddividere il file del diagramma applicazioni (estensione AD) in file di definizioni di applicazioni (estensione SDM), quindi compilare i documenti SDM (System Definition Model) richiesti per il report di distribuzione. Per ulteriori informazioni, vedere Cenni preliminari su SDM (System Definition Model).

Suggerimento:
È inoltre possibile generare i report di distribuzione anche mediante Progettazione distribuzione oppure in modo automatico tramite Visual Studio. Per ulteriori informazioni, vedere Procedura: generare report di distribuzione e Procedura: utilizzare l'automazione con report distribuzione.

Per compilare i documenti SDM è necessario scaricare un compilatore dalla pagina System Definition Model (SDM) SDK Workshop (informazioni in lingua inglese).

Per suddividere il diagramma applicazioni in file con estensione SDM

Nel file del diagramma applicazioni (estensione AD), individuare i tag <sdmDocument></SdmDocument> e copiare quanto contenuto fra tali tag in un nuovo file.

Nota:
Nel caso di un'applicazione implementata, la sezione <sdmDocument> non è contenuta nel file con estensione AD, ma si trova in un file con estensione SDM esistente contenuto nel progetto corrispondente. Compilare ognuno di questi file con estensione SDM prima di compilare qualsiasi file di diagramma sistema (estensione SD) o file Default.sdm (nel caso di sistemi predefiniti) come descritto più avanti nel presente argomento.

Nel caso di un'applicazione implementata, la sezione <sdmDocument> non è contenuta nel file con estensione AD, ma si trova in un file con estensione SDM esistente contenuto nel progetto corrispondente. Compilare ognuno di questi file con estensione SDM prima di compilare qualsiasi file di diagramma sistema (estensione SD) o file Default.sdm (nel caso di sistemi predefiniti) come descritto più avanti nel presente argomento.

Nel seguente frammento di codice viene mostrato un esempio di dati contenuti nel tag <sdmDocument>:

<SdmDocument><SystemDefinitionModel xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Name="WebApplication1" Version="1.0.0.0" Culture="en-US" DocumentLanguage="en" xmlns="https://schemas.microsoft.com/SystemDefinitionModel/2005/1">
...
</SystemDefinitionModel></SdmDocument>

Denominare ogni file utilizzando il valore dell'attributo Name nel tag <SystemDefinitionModel> e aggiungere l'estensione SDM.

Dopo aver creato questi file SDM, il passaggio successivo consiste nel compilare i file sdSDMm e gli altri documenti SDM richiesti per il report di distribuzione.

Per compilare i documenti SDM per il report di distribuzione

Compilare i nuovi file SDM creati a partire dal file con estensione AD o dai file con estensione SDMDOCUMENT, escluso il file Default.sdm se questo è stato creato. Per compilare tali file, utilizzare la riga di comando nel seguente formato:
```
sdmc <File name> /output <File Name.sdmDocument> /r import1 /r import2… /SearchPath <path to your files> /SearchPath <path to System.Flow.Sdmdocument and other references>
```
Nota:

Nella compilazione dei documenti SDM specificare il nome del file di output utilizzando lo stesso nome del file originale e l'estensione SDMDOCUMENT.

Per la maggior parte dei file è necessario fare riferimento soltanto ai documenti elencati nel documento SDM con i tag <import>. Tuttavia, il file del diagramma distribuzione (estensione DD) richiede alcuni riferimenti non elencati, come ad esempio System.Flow.sdmDocument e System.Constraints.sdmDocument, oltre ai riferimenti ai propri documenti figlio e a tutti i riferimenti richiesti da tali documenti.
Compilare tutti i file di diagramma sistema (SD).
Compilare il file del diagramma datacenter logico (LDD).

Nota:
Nella compilazione dei documenti SDM specificare il nome del file di output utilizzando lo stesso nome del file originale e l'estensione SDMDOCUMENT.

Compilare il file del diagramma distribuzione (DD) e utilizzare l'opzione /ConfigReport per specificare il nome del report di distribuzione. Senza questa opzione, il report di distribuzione non verrà generato.

Nota:
Nella compilazione del diagramma distribuzione, fare riferimento a tutti i documenti elencati con i tag <import>, come ad esempio System.Flow.sdmDocument, System.Constraints.sdmDocument e tutti i riferimenti utilizzati per compilare i succitati documenti con estensione AD, SD e LDD. Se si tenta di eseguire la compilazione senza specificare l'elenco necessario, il compilatore elencherà tutti i riferimenti ai documenti mancanti. Tuttavia, evitare di fare riferimento al documento System.sdmDocument anche se nella maggior parte dei casi tale documento è elencato nel tag <import>. Se si fa riferimento al documento System.sdmDocument, il compilatore restituisce un errore.

Nella compilazione del diagramma distribuzione, fare riferimento a tutti i documenti elencati con i tag <import>, come ad esempio System.Flow.sdmDocument, System.Constraints.sdmDocument e tutti i riferimenti utilizzati per compilare i succitati documenti con estensione AD, SD e LDD. Se si tenta di eseguire la compilazione senza specificare l'elenco necessario, il compilatore elencherà tutti i riferimenti ai documenti mancanti. Tuttavia, evitare di fare riferimento al documento System.sdmDocument anche se nella maggior parte dei casi tale documento è elencato nel tag <import>. Se si fa riferimento al documento System.sdmDocument, il compilatore restituisce un errore.

Sicurezza

Nel report di distribuzione possono essere contenuti dei dati aziendali o istituzionali sensibili o riservati. Di conseguenza, tali report devono essere inviati o eliminati con estrema cautela.

Vedere anche

Altre risorse

Creazione di report di distribuzione

Condividi tramite