Comandi di distribuzione delle definizioni BAM (modello di osservazione)
I comandi di distribuzione dell'utilità di gestione BAM consentono di applicare, modificare e rimuovere definizioni.
deploy-all: distribuisce una definizione BAM.
update-all: Aggiornamenti una definizione BAM.
remove-all: rimuove una definizione BAM.
update-livedataworkbook: Aggiornamenti le informazioni di connessione del database in una cartella di lavoro dei dati in tempo reale.
rigenerare-livedataworkbook: rigenera la cartella di lavoro dei dati in tempo reale nel server.
Nota
È possibile abilitare la traccia in qualsiasi comando di utilità BM includendo l'opzione -Trace:on|off . Tramite l'opzione Trace viene eseguito l'override delle impostazioni di traccia nel file di configurazione. Questa opzione può essere utilizzata in combinazione con qualsiasi comando BM comune.
Nota
In un sistema che supporta il controllo dell'account utente, potrebbe essere necessario eseguire lo strumento con i privilegi amministrativi.
Comando deploy-all
Utilizzo
bm.exe deploy-all -DefinitionFile:<def file>[ -Server:server> ][ -Database:<database<> ]
Parametri
| Parametro | Descrizione |
|---|---|
| File DefinitionFile:<def> | Percorso e nome del file che contiene le definizioni da distribuire. |
| Server:<server> | Facoltativo: nome del server in cui distribuire le definizioni. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database a cui distribuire le definizioni. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di distribuire tutti gli elementi dal file XML della definizione BAM specificata nei server e database specificati. Il file può essere un file di testo che contiene il codice XML della definizione BAM o una cartella di lavoro Excel BAM. Il file di definizione deve contenere solo nuovi elementi. Se il file contiene elementi che sono già stati distribuiti, la distribuzione avrà esito negativo e verrà segnalato un errore.
Considerazioni per la distribuzione di definizioni BAM
Per distribuire le sottoscrizioni per gli avvisi, è necessario specificare gli ID dei sottoscrittori nel formato dominio\utente.
Il servizio DTC (Distributed Transaction Coordinator) deve essere in esecuzione nel computer in cui viene rilasciato il comando deploy-all .
Quando si distribuisce una definizione, l'utilità di gestione BAM supporta solo 14 livelli della dimensione nella visualizzazione Aggregazione in tempo reale. La distribuzione di ulteriori livelli restituisce un errore di distribuzione non riuscita.
Se si definiscono più visualizzazioni che utilizzano impostazioni di lingua diverse e si distribuisce la soluzione in un server in cui viene utilizzata una sola lingua, non sarà possibile distribuire le visualizzazioni. Questo scenario è supportato solo nel caso in cui non siano state pianificate aggregazioni che richiedono OLAP nella definizione BAM.
Se sono attivati gli avvisi BAM, l'utilità di gestione BAM consente al massimo 49 visualizzazioni di attività distribuite. Il numero di visualizzazioni di attività viene calcolato come la somma di 1..N visualizzazione/i per il numero di attività padre. Se, ad esempio, si distribuisce una visualizzazione basata su due attività, si ottengono due visualizzazioni di attività. Se si distribuiscono due visualizzazioni, una delle quali è basata su due attività e l'altra su una sola attività, si hanno 3 visualizzazioni di attività.
L'utilità di gestione BAM blocca la distribuzione delle definizioni BAM con più report di tabella pivot definiti nella stessa combinazione di RTA e nome del cubo. Bm.exe interromperà la distribuzione e restituirà il seguente errore:
Distribuzione della visualizzazione... ERRORE: la distribuzione BAM non è riuscita.
In una data combinazione RTA e cubo è possibile definire una sola visualizzazione tabella pivot.
I nomi riportati di seguito sono riservati e non possono essere utilizzati nella distribuzione della definizione:
RecordID
ActivityID
IsVisible
IsComplete
LastModified
Nota
Se bm.exe incontra un errore durante la distribuzione, la distribuzione viene interrotta e viene eseguito il roll-back delle modifiche apportate alle visualizzazioni e alle attività. Non viene eseguito il roll-back delle modifiche apportate ai cubi OLAP, perché OLAP non supporta la distribuzione transazionale.
Nota
Le definizioni BAM create in un computer con un'impostazione internazionale non possono essere distribuite in un computer configurato con un'impostazione internazionale diversa. Ad esempio, una definizione BAM generata utilizzando una versione in lingua inglese di Microsoft Excel in un computer configurato con l'impostazione internazionale EN non può essere distribuita in un computer configurato per il giapponese con l'impostazione internazionale JA.
esempi
bm.exe deploy-all -DefinitionFile:MyDef.xml
bm.exe deploy-all -DefinitionFile:MyWorkbook.xls -Server:machine1
Comando update-all
Utilizzo
bm.exe update-all -DefinitionFile:<def file>[ -Server:server> ][ -Database:<database<> ]
Parametri
| Parametro | Descrizione |
|---|---|
| File DefinitionFile:<def> | Percorso e nome del file che contiene le definizioni in base alle quali eseguire l'aggiornamento. |
| Server:<server> | Facoltativo: nome del server a cui distribuire gli aggiornamenti delle definizioni. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database in cui distribuire gli aggiornamenti delle definizioni. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di aggiornare alcuni elementi in base al codice XML della definizione BAM. Il file può essere un file di testo che contiene il codice XML della definizione BAM o una cartella di lavoro Excel BAM. Durante l'aggiornamento non vengono eliminati gli elementi che non sono descritti nel file di definizione corrente. È possibile aggiungere nuovi punti di arresto alle attività, ma non è possibile rimuovere punti di arresto dalle attività distribuite. Durante l'aggiornamento non è possibile rinominare punti di arresto, né modificare proprietà dei punti di arresto.
Dopo la distribuzione di un'attività, le azioni che è possibile eseguire su di sono limitate. In particolare non è possibile eliminare elementi da un'attività a meno che l'amministratore non sia pronto ad annullare la distribuzione dell'intera attività BAM e dei set di visualizzazioni e quindi a ridistribuirli. Tale operazione può provocare un'interruzione della visibilità e la perdita di dati a meno che l'amministratore non esegua il backup e il ripristino dei dati.
Nota
Non è possibile utilizzare questo comando per aggiungere nuove attività a una visualizzazione esistente. Per aggiungere una visualizzazione a un'attività, è necessario creare una nuova visualizzazione contenente la nuova attività. A questo punto sarà possibile annullare la distribuzione della vecchia visualizzazione, ma è importante tenere presente che la cronologia dei dati OLAP andrà persa.
esempi
bm.exe update-all -DefinitionFile:MyDef.xml
bm.exe update-all -DefinitionFile:MyWorkbook.xls -Server:machine1
Comando remove-all
Utilizzo
bm.exe remove-all DefinitionFile:<def file> [ -Server:server> ][ -Database:<database<> ]
Parametri
| Parametro | Descrizione |
|---|---|
| File DefinitionFile:<def> | Percorso e nome del file che contiene le definizioni da rimuovere. |
| Server:<server> | Facoltativo: nome del server da cui verranno rimosse le definizioni. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database da cui verranno rimosse le definizioni. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di rimuovere tutti gli elementi specificati nel file XML della definizione BAM. Il file può essere un file di testo che contiene il codice XML della definizione BAM o una cartella di lavoro Excel BAM. La definizione di ogni elemento deve corrispondere esattamente alla definizione originale utilizzata per la distribuzione.
esempi
bm.exe remove-all -DefinitionFile:MyDef.xml
bm.exe remove-all -DefinitionFile:MyWorkbook.xls -Server:machine1
Comando update-livedataworkbook
Utilizzo
bm.exe update-livedataworkbook -Name:<livedata workbook file name>[ -Server:<server> ][ -Database:<database> ]
Parametri
| Parametro | Descrizione |
|---|---|
| Nome:<cartella di lavoro livedata> | Nome della cartella di lavoro dati attivati da aggiornare. |
| Server:<server> | Facoltativo: nome del server in cui risiede la cartella di lavoro. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database in cui risiede la cartella di lavoro. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di aggiornare le informazioni di connessione al database di importazione primaria BAM nella cartella di lavoro dati attivati BAM specificata.
Nota
Quando si configura una nuova stringa di connessione, è necessario riavviare il servizio TDDS per garantire che riconosca la modifica. Per altre informazioni sul servizio TDDS, vedere Stored procedure del servizio bus di eventi BAM.
esempi
bm.exe update-livedataworkbook -Name:SalesManager_Live.xls
bm.exe update-livedataworkbook -Name:SalesManager_Live.xls -Server:SalesSrv
Comando regenerate-livedataworkbook
Utilizzo
bm.exe rigenerare-livedataworkbook -WorkbookName:<livedata workbook file name>[ -Server:<server> ][ -Database:<database> ]
Parametri
| Parametro | Descrizione |
|---|---|
| <Nomecartella di lavoro:nome file della cartella di lavoro livedata> | Nome della cartella di lavoro da aggiornare. |
| Server:<server> | Facoltativo: nome del server in cui risiede la cartella di lavoro. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database in cui risiede la cartella di lavoro. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di generare una cartella di lavoro dati attivati BAM, ma non consente di distribuire la cartella di lavoro.
Esempi
bm.exe regenerate-livedataworkbook -WorkbookName:SalesManager_Live.xls
bm.exe regenerate-livedataworkbook -WorkbookName:SM_Live.xls -Server:S1