Manuale dell`utente della console di SAP

Manuale dell'utente della console di SAP BusinessObjects Profitability and
Cost Management
■ SAP BusinessObjects Profitability and Cost Management 10.0
2012-09-26
Copyright
© 2012 SAP AG. Tutti i diritti riservati.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign,
SAP BusinessObjects Explorer, StreamWork, SAP HANA e gli altri prodotti e servizi SAP qui
menzionati, nonché i relativi loghi, sono marchi registrati di SAP AG in Germania e in altri Paesi.
Business Objects e il logo Business Objects, BusinessObjects, Crystal Reports, Crystal Decisions,
Web Intelligence, Xcelsius e gli altri prodotti e servizi Business Objects qui menzionati, nonché i
rispettivi loghi, sono marchi o marchi registrati di Business Objects Software Ltd. Business Objects
è una società SAP. Sybase e Adaptive Server, iAnywhere, Sybase 365, SQL Anywhere e gli altri
prodotti e servizi Sybase qui menzionati, nonché i rispettivi loghi, sono marchi o marchi registrati di
Sybase, Inc. Sybase è una società SAP.Crossgate, m@gic EDDY, B2B 360°, B2B 360° Services
sono marchi registrati di Crossgate AG in Germania e in altri Paesi. Crossgate è una società SAP.
Tutti gli altri nomi di prodotti e servizi qui menzionati sono marchi che appartengono alle rispettive
società. Quanto riportato nel presente documento ha finalità esclusivamente informative. Le specifiche
nazionali dei prodotti possono variare. SAP si riserva il diritto di modificare tutti i materiali senza
preavviso. I materiali sono forniti da SAP AG e dalle sue affiliate (“Gruppo SAP”) solo a scopo
informativo, senza alcun fine illustrativo o di garanzia di qualsiasi natura; il Gruppo SAP non si assume
alcuna responsabilità per eventuali errori od omissioni presenti nei materiali. Le uniche garanzie
applicabili ai prodotti e ai servizi del Gruppo SAP sono quelle espressamente menzionate nelle apposite
clausole contrattuali eventualmente previste per i singoli prodotti o servizi. Nessuna parte del presente
documento è da interpretarsi come garanzia accessoria.
2012-09-26
Sommario
3
Capitolo 1
Cronologia delle modifiche.....................................................................................................7
Capitolo 2
Introduzione all'applicazione Console....................................................................................9
2.1
Esecuzione della Console.........................................................................................................9
Capitolo 3
Utilizzo della Console e dei relativi comandi........................................................................11
3.1
3.2
3.3
Creazione di istruzioni della riga di comando della Console....................................................11
Capitolo 4
Uso di Impostazione guidata console...................................................................................15
4.1
4.2
4.2.1
4.2.2
4.3
4.3.1
Creazione di un nuovo file di comandi.....................................................................................16
Capitolo 5
Comandi della Console disponibili.......................................................................................19
5.1
5.2
5.3
5.4
5.5
5.6
5.7
5.8
5.9
5.10
5.11
5.12
Controllo attivato (auditenabled).............................................................................................25
File di comandi.......................................................................................................................12
Comandi di Work Manager.....................................................................................................13
Definizione dei parametri per la console ................................................................................16
Per aggiungere un parametro a un file di comandi...................................................................16
Per visualizzare in anteprima il file dei comandi.......................................................................17
Verifica del file di comandi......................................................................................................17
Per verificare il file di comandi................................................................................................17
Calcolo automatico (automaticcalculation)..............................................................................26
Calcola modello (calculate).....................................................................................................27
Calcola costi transazionali (calculatetransactionalcosts).........................................................27
Cancella risultati bloccati (clearlockedresults)........................................................................28
Cancella elenco calcoli periodo versione (clearvpcalculationlist).............................................29
Chiudi modello (closemodel)..................................................................................................30
File di comando (cmdfile)........................................................................................................30
Commento (;).........................................................................................................................31
Connetti a Work Manager (wmconnect).................................................................................32
Copia modello (copymodel)....................................................................................................32
Crea nuovo modello (newmodel)............................................................................................33
2012-09-26
Sommario
5.13
5.14
5.15
5.16
5.17
5.18
5.19
5.20
5.21
5.22
5.23
5.24
5.25
5.26
5.27
5.28
5.29
5.30
5.31
5.32
5.33
5.34
5.35
5.36
5.37
5.38
5.39
5.40
5.41
5.42
5.43
5.44
5.45
5.46
5.47
5.48
5.49
5.50
5.51
5.52
5.53
4
Crea ID esportazione condiviso (createsharedexportid)..........................................................35
Crea nome esportazione condiviso (createsharedexportname)...............................................35
Crea connessione di sistema (createsystemconnection)........................................................36
Elimina modello (delete).........................................................................................................37
Password crittografata (encryptedpassword).........................................................................38
Esegui routine di caricamento dati (executedlroutines)...........................................................39
Esporta modello nel file export...............................................................................................41
Esporta risultati (exportresults)...............................................................................................44
Esporta nel database (exporttodb)..........................................................................................45
Esporta vista (exportview)......................................................................................................46
Importa file XML nel modello (import).....................................................................................48
Informazioni (information).......................................................................................................49
Carica modello (loadmodel)....................................................................................................50
Carica valori memorizzati (loadstoredvalues)..........................................................................51
Carica solo calcoli TC (loadtccalconly)...................................................................................52
Carica dati dei volumi (loadvolumedata)..................................................................................52
Blocca risultati (lockresults)....................................................................................................53
Registra tutti gli eventi in un file di testo (log).........................................................................54
Server di accesso (loginserver)..............................................................................................55
Disconnetti (logoff)................................................................................................................55
Descrizione modello (modeldescription).................................................................................57
Modello attivato (modelenabled)............................................................................................57
Opzione modello (modeloption)..............................................................................................58
Server modelli (modelserver).................................................................................................62
Apri modello (open)................................................................................................................62
Arresta l'elaborazione per un certo periodo (pause)................................................................63
Anteponi data e ora (prefixdate).............................................................................................64
Rimuovi tutti i risultati degli utenti (removeuserresults)...........................................................64
Rimuovi risultati per ID esportazione (removeresultsbyexportid).............................................65
Rimuovi risultati in base a nome di esportazione (removeresultsbyexportname).....................66
Rimuovi risultati per ID esportazione corrente (removeresultsbycurrentexportid)....................67
Rinomina per ID esportazione (renameexportid).....................................................................68
Rinomina per nome esportazione (renameexport)...................................................................69
Rinomina modello (renamemodel)..........................................................................................70
Esegui importazione Data Bridge (databridgeimport)..............................................................71
Invia evento di Work Manager (wmsendevent).......................................................................72
Imposta password (password)................................................................................................72
Imposta nome utente (username)...........................................................................................73
Ordina dimensione (sortdimension)........................................................................................74
Cambia connessione al sistema (switchsystemconnection)....................................................75
Modello di trasporto da un sistema all'altro (transportmodel)..................................................76
2012-09-26
Sommario
5.54
5.55
5.56
5.57
5.58
5.59
5.60
5.61
5.62
ID modello univoco (uniquemodelid).......................................................................................78
Capitolo 6
Messaggi di errore della Console.........................................................................................87
Appendice A
Ulteriori informazioni.............................................................................................................91
Indice
5
Scarica modello (unloadmodel)...............................................................................................79
Sblocca risultati (unlockresults)..............................................................................................79
Aggiorna elenco calcoli periodo versione (updatevpcalculationlist).........................................80
Utilizza ID esportazione (useexportid).....................................................................................81
Utilizza tipo di ID esportazione (useexportidtype)...................................................................82
Utilizza nome esportazione (useexportname)..........................................................................83
Attendere. Lasciare il processo in esecuzione per un certo periodo (wait)..............................84
Scrivi un messaggio (msg).....................................................................................................85
93
2012-09-26
Sommario
6
2012-09-26
Cronologia delle modifiche
Cronologia delle modifiche
Il Manuale dell'utente della console SAP BusinessObjects Profitability and Cost Management viene
regolarmente aggiornato sul SAP Help Portal (vedere “Ulteriori informazioni”). Assicurarsi di disporre
della versione più recente di questo documento consultando il SAP Help Portal.
La versione 1.1 è la versione corrente di questo documento. La tabella seguente contiene un riepilogo
delle modifiche più importanti alle versioni precedenti e correnti del documento:
Versione
Data
Versione 1.0
10 maggio
2011
Modifiche importanti
Versione iniziale del documento Manuale dell'utente della console
di SAP BusinessObjects Profitability and Cost Management per
SAP BusinessObjects Profitability and Cost Management 10.0.
Include tutti i comandi e i parametri nuovi di questa versione.
Versione 1.1
7
7 agosto 2012
L'argomento “Esporta vista” è stato aggiornato con la funzionalità
che consente di effettuare l'esportazione in un nome file null.
2012-09-26
Cronologia delle modifiche
8
2012-09-26
Introduzione all'applicazione Console
Introduzione all'applicazione Console
L'utilità Console consente di ampliare le possibilità d'uso delle applicazioni di SAP BusinessObjects
Profitability and Cost Management. È un'applicazione client che consente l'esecuzione di attività da
una console, senza richiedere l'intervento dell'utente.
Mediante le istruzioni della riga di comando, è possibile creare quando desiderato “processi” (o attività
pianificate) per l'esecuzione di comandi nelle varie applicazioni.
È possibile creare manualmente i comandi necessari o, in alternativa, utilizzare l'utilità Impostazione
guidata console che semplifica il processo di creazione e formattazione adeguata dei comandi e dei
file di comandi della Console.
2.1 Esecuzione della Console
L'utilità Console viene avviata eseguendo il file di programma PCMConsole al prompt dei comandi
(anche prompt di sistema o del DOS nei sistemi Windows).
Il programma Console viene installato per impostazione predefinita nel percorso C:\Programmi\SAP
BusinessObjects\PCM. Questo percorso può essere modificato in fase di installazione, se necessario.
Il programma viene eseguito insieme a una serie di comandi e parametri eseguiti nel server dei modelli
di Profitability and Cost Management. È possibile eseguire i comandi:
• dalla riga di comando
• da un file batch.
9
2012-09-26
Introduzione all'applicazione Console
10
2012-09-26
Utilizzo della Console e dei relativi comandi
Utilizzo della Console e dei relativi comandi
Le varie funzioni della Console vengono chiamate mediante istruzioni della riga di comando che vengono
passate al programma quando è in esecuzione. Le istruzioni della riga di comando contengono comandi
e parametri correlati che possono assegnare valori alle variabili del modello e passare valori alle funzioni
del modello.
I comandi dispongono delle seguenti proprietà:
• Salvo diversa indicazione, ogni comando può essere utilizzato più volte in un unico processo della
Console.
• I comandi vengono eseguiti in sequenza, quindi il loro ordine è significativo.
• È possibile specificare i comandi con lettere maiuscole o minuscole, oppure entrambe.
• Tutti i comandi inclusi in un eseguibile vengono controllati per verificarne la validità all'avvio, prima
di eseguire qualsiasi comando.
Un modello viene automaticamente chiuso alla fine di un processo di Console completato correttamente,
purché non vi siano altri utenti connessi.
Se durante l'esecuzione di un comando la console rileva un errore, viene generato un messaggio di
errore in cui è indicato un numero specifico che corrisponde al tipo di comando. Il numero di ogni tipo
di comando è elencato in “Messaggi di errore della console”.
Per i dettagli di tutti i comandi e i parametri disponibili nella Console, consultare il capitolo “Comandi
della Console disponibili”.
Suggerimento:
per visualizzare al prompt dei comandi un elenco di comandi e parametri della Console:
• Passare alla directory in cui è installato il programma Console e digitare PCMCONSOLE /?.
• Per evitare che l'output superi il buffer del prompt dei comandi, aggiungere |more dopo il comando,
in modo da poter controllare la visualizzazione dell'output.
Argomenti correlati
• Comandi della Console disponibili
• Messaggi di errore della Console
3.1 Creazione di istruzioni della riga di comando della Console
11
2012-09-26
Utilizzo della Console e dei relativi comandi
Per formattare le istruzioni dei comandi, questi ultimi e i relativi parametri sono separati da un segno
uguale (=). Ad esempio, il comando username viene mostrato con il valore del parametro User1 come
segue: username=User1.
Un'istruzione della riga di comando può contenere un numero indefinito di comandi e parametri, che
vengono eseguiti in sequenza. Ad esempio, per aprire e calcolare un modello denominato BIKES, è
possibile creare un'istruzione da riga di comando per eseguire PCMConsole con i comandi username,
password, open e calculate come segue:
PCMCONSOLE username=User1 password=pass open=BIKES calculate
Comandi e parametri contenenti spazi o nomi di file lunghi devono essere racchiusi tra virgolette, ad
esempio:
PCMCONSOLE username=User1 password=pass “open=My Bikes Model” calculate
Nota:
l'utilità Impostazione guidata console semplifica il processo di creazione di istruzioni della riga di
comando. Per ulteriori informazioni, consultare il capitolo relativo all'“utilizzo dell'Impostazione guidata
console”.
Argomenti correlati
• Uso di Impostazione guidata console
3.2 File di comandi
Anziché passare più comandi come una singola riga continua, è possibile creare un file di comandi.
Questo file di testo contiene un elenco di comandi o un unico comando. In caso di più comandi, ognuno
deve essere in una riga separata. È consigliabile utilizzare un file di comandi per emettere una sequenza
complicata di comandi e soprattutto quelli da eseguire più volte, ad esempio nell'ambito di un normale
processo pianificato.
Per richiamare un file di comandi, passare il nome del file come parametro a Console con il comando
cmdfile. Per ulteriori informazioni, consultare l'argomento “File di comandi”.
L'utilità Impostazione guidata console semplifica il processo di creazione dei file di comandi. Per ulteriori
informazioni, consultare il capitolo relativo all'“utilizzo dell'Impostazione guidata console”.
Nota:
Se l'ambiente richiede una password crittografata in un file di comandi, utilizzare la funzione Password
crittografata in Impostazione guidata console.
Esempio: CMDFILE
PCMCONSOLE "CMDFILE=C:\consolefile.ini"
12
2012-09-26
Utilizzo della Console e dei relativi comandi
Risultato: Console esegue il comando contenuto nel file consolefile.ini, presente alla radice
dell'unità C.
Di conseguenza, se il file consolefile.ini contiene:
username=user
password=pass
open=Bikes
calculate
export=c:\BikesExport.xml,Overwrite,Results
il modello Bikes viene aperto, calcolato ed esportato nel file xml BikesExport.xml.
Argomenti correlati
• File di comando (cmdfile)
• Password crittografata (encryptedpassword)
• Uso di Impostazione guidata console
3.3 Comandi di Work Manager
È possibile creare un file di comandi della console che venga utilizzato come modello in Work Manager
al fine di consentire ai flussi di lavoro utente di eseguire i processi. Work Manager genera un file di
comandi temporaneo a partire dal modello ed esegue il processo della console. Il processo del server
Work Manager deve disporre di accesso in scrittura alla directory in cui è memorizzato il file modello
.ini della console.
Per comunicare con Work Manager vengono utilizzati i comandi seguenti:
•
wmconnect
Descrizione: connette la console a Work Manager. Prima di tale operazione sono necessari nome
utente e password (o password crittografata), che devono essere credenziali di accesso valide.
Nota:
Questo comando non è obbligatorio ma è utile nei casi in cui è importante avere la certezza che la
connessione sia stata stabilita, ad esempio prima di creare un modello.
•
wmsendevent=<WorkManagerEvent>
Descrizione: invia il nome dell'evento all'istanza del processo di Work Manager per poterne seguire
l'avanzamento.
Argomenti correlati
• File di comandi
• Connetti a Work Manager (wmconnect)
• Invia evento di Work Manager (wmsendevent)
13
2012-09-26
Utilizzo della Console e dei relativi comandi
14
2012-09-26
Uso di Impostazione guidata console
Uso di Impostazione guidata console
La Procedura guidata console è un modo semplice e rapido per creare la console. Utilizzare il menu
Start per avviare l'applicazione Impostazione guidata console:
Start > Programmi > SAP BusinessObjects > Profitability and cost management > Strumenti >
Console Wizard.
All'avvio, viene visualizzata la schermata principale raffigurata sotto:
Al primo avvio della Procedura guidata console, nella scheda "Elenco parametri", viene visualizzato
un nuovo file di inizializzazione (*.ini) vuoto da definire. Se la procedura guidata è già stata avviata in
precedenza, sarà visualizzata la definizione del file utilizzato prima.
La Procedura guidata console consente di creare file dei comandi, definire, modificare e rivedere i
parametri di un file dei comandi e di eseguire un file dei comandi per testarlo.
Argomenti correlati
• File di comandi
15
2012-09-26
Uso di Impostazione guidata console
4.1 Creazione di un nuovo file di comandi
In Impostazione guidata console è possibile creare un nuovo file di comandi per i parametri dei comandi
della console.
Fare clic sull'icona Crea un nuovo file di script o scegliere Nuovo > dal menu File.
Se vi sono parametri esistenti visualizzati, vengono rimossi dalle schede "Elenco parametri" e "Anteprima
file dei comandi".
4.2 Definizione dei parametri per la console
Un file di console è una serie di comandi di Profitability and cost management in forma di parametri
per l'applicazione della consoleda eseguire.
Nella scheda "Elenco parametri" è possibile aggiungere, modificare o eliminare comandi utilizzando
i pulsanti appropriati o il menu di scelta rapida. Quando si ha più di un comando, è possibile modificarne
l'ordine di esecuzione spostandoli verso l'alto o verso il basso utilizzando i pulsanti Sposta su o Sposta
giù o il menu di scelta rapida.
4.2.1 Per aggiungere un parametro a un file di comandi
Nota:
Se si crea un processo di console per l'esportazione, è consigliabile definire in precedenza un file di
specifiche di esportazione, altrimenti Impostazione guidata console inserisce il valore predefinito di
TUTTE le tabelle, operazione che può comportare un tempo di esecuzione eccezionalmente lungo.
1. Nella scheda Elenco parametri, fare clic su Aggiungi.
Viene visualizzata la finestra di dialogo "Proprietà comando" che consente di scegliere un tipo di
comando e aggiungerlo all'elenco di parametri.
2. Selezionare un tipo di comando dall'elenco.
Vengono visualizzati i campi di parametri relativi. Per ogni tipo di comando, è possibile che sia
necessario specificare informazioni dettagliate o informazioni relative al sistema di Profitability and
Cost Management, ad esempio il nome del modello o i dati di accesso. Per ulteriori informazioni,
consultare l'argomento relativo al comando desiderato nella sezione “Comandi della Console
disponibili”.
3. Immettere le altre informazioni necessarie nei campi visualizzati.
16
2012-09-26
Uso di Impostazione guidata console
Queste informazioni vengono aggiunte al comando come parametri.
4. Fare clic su OK per aggiungere il comando all'elenco dei parametri.
Il comando viene visualizzato nell'elenco, insieme ai parametri specificati.
Argomenti correlati
• Comandi della Console disponibili
4.2.2 Per visualizzare in anteprima il file dei comandi
•
Fare clic sulla scheda Anteprima file dei comandi per visualizzare il file dei comandi Procedura
guidata console. Utilizzare questa schermata per verificare il corretto ordine di precedenza e il
corretto contenuto del file dei comandi prima di utilizzare il file.
4.3 Verifica del file di comandi
L'esecuzione del file di comandi deve essere verificata prima dell'effettivo utilizzo del file.
È possibile eseguire questa operazione nella scheda "Verifica" diImpostazione guidata console.
Assicurarsi che il percorso al file PCMConsole.exe (l'applicazione Impostazione guidata console)
venga visualizzato nella casella Percorso console. Per determinare la posizione dell'Impostazione
guidata console, cercare il file. La posizione predefinita è C:\Programmi\SAP
BusinessObjects\PCM, ma questo percorso può essere cambiato, come è effettivamente avvenuto
tra le varie versioni del software.
4.3.1 Per verificare il file di comandi
1. Il campo Argomenti della riga di comando visualizza un riferimento al file di comandi che si crea.
Per impostazione predefinita questo file è denominato Untitled.ini, ma è consigliabile salvarlo
con un nome più significativo selezionando Salva dal menu File.
2. Verificare la funzionalità del file dei comandi facendo clic su Verifica ora. L'output può essere
visualizzato nella schermata corrente selezionando l'opzione Indirizza l'output della console
nell'elenco riportato di seguito. In caso contrario, viene aperta una finestra di comando che
visualizza i messaggi di stato del processo della console.
3. Dopo aver verificato che non vi sono errori e che lo script di comandi esegue quanto previsto, è
possibile salvare il processo scegliendo Salva dal menu File.
17
2012-09-26
Uso di Impostazione guidata console
4. Creare un collegamento allo script di comandi utilizzando il pulsante Crea collegamento.
5. Questo pulsanteconsente di salvare un collegamento al processo della console per un più agevole
avvio in seguito. È anche possibile inserire questo collegamento in applicazioni come l'Utilità di
pianificazione di Windows ( Start > Impostazioni > Pannello di controllo > Operazioni pianificate)
per essere eseguito quando necessario.
18
2012-09-26
Comandi della Console disponibili
Comandi della Console disponibili
Sono disponibili comandi della Console per diverse categorie funzionali, come illustrato nelle seguenti
tabelle riepilogative. Per ulteriori dettagli sulle opzioni e il funzionamento di ciascun comando specifico,
consultare l'argomento correlato. In ogni argomento viene descritta la modalità di utilizzo del comando
sia nell'Impostazione guidata console che come parametro della riga di comando.
Tabella 5 - 1: Accesso utente e connessione al sistema
Nome del comando
Comando
Scopo
username
Consente di impostare l'account
utente di Profitability and Cost
management le cui credenziali
verranno utilizzate per eseguire
azioni. Questo comando è necessario, generalmente, per tutti
gli eseguibili della Console.
password
Consente di specificare la password dell'account utente. Quando si utilizza questo comando,
è necessario impostare anche
un nome utente.
encryptedpassword
Consente di specificare la password dell'account utente in formato crittografato. Quando si
utilizza questo comando, è necessario impostare anche un nome
utente.
Chiusura sessione
logoff
Consente di interrompere totalmente eventuali connessioni
client degli utenti attualmente
connessi al sistema in esecuzione e ne causa la disconnessione.
Server di accesso
loginserver
Specifica quale server utilizzare
per l'accesso.
Imposta nome utente
Imposta password
Password crittografata
19
2012-09-26
Comandi della Console disponibili
Nome del comando
Comando
Scopo
Crea connessione di sistema
createsystemconnection
Crea una connessione a un sistema e passa il controllo a tale
connessione.
Cambia connessione al sistema
switchsystemconnection
Passa il controllo a un sistema.
Passport
passport
Specifica il SAP passport da
utilizzare per la registrazione
delle metriche. Generato dal
Programma di avvio traccia endto-end.
Non specificato dall'utente.
Tabella 5 - 2: Connessione modello
Nome del comando
Comando
Scopo
Apri modello
open
Consente di aprire un modello
esistente utilizzando l'account
utente specificato.
Chiudi modello
closemodel
Consente di chiudere il modello
attualmente aperto.
Comando Carica modello
loadmodel
Crea una connessione a un modello esistente e la mantiene
aperta indipendentemente dal
fatto che vengano connessi altri
modelli durante l'esecuzione
della Console.
Scarica modello
unloadmodel
Chiude una connessione con un
modello specificato, aperto mediante il comando loadmodel.
Tabella 5 - 3: Amministrazione modelli
20
Nome del comando
Comando
Scopo
Crea nuovo modello
newmodel
Consente di creare un nuovo
modello.
Elimina modello
delete
Consente di eliminare un modello.
Copia modello
copymodel
Copia un modello.
2012-09-26
Comandi della Console disponibili
Nome del comando
Comando
Scopo
Rinomina modello
renamemodel
Consente di rinominare un modello.
Descrizione modello
modeldescription
Consente di modificare la descrizione del modello.
Server modelli
modelserver
Consente di modificare il server
dei modelli.
Modello attivato
modelenabled
Consente di impostare lo stato
del modello.
Controllo attivato
auditenabled
Consente di attivare o disattivare
il controllo per il modello.
ID modello univoco
uniquemodelid
Consente di modificare la proprietà del modello ID modello univoco (UMID).
Modello di trasporto da un sistema all'altro
transportmodel
Automatizza la procedura di
spostamento di un modello in un
altro sistema.
Nome del comando
Comando
Scopo
Importa file XML nel modello
import
Consente di importare un file
XML nel modello specificato.
Esegui importazione Data
Bridge
databridgeimport
Consente di eseguire un file di
controllo Data Bridge (*.CTF)
per importare dati nel modello
specificato.
Ordina dimensione
sortdimension
Dispone gli elementi dimensione
di una gerarchia in ordine crescente o decrescente.
executedlroutines
Avvia una procedura per Microsoft SQL Server o Oracle (a seconda dell'installazione) che
esegue automaticamente le
routine di caricamento dati
nell'ordine corretto.
Tabella 5 - 4: Importazione
Esegui routine di caricamento
dati
21
2012-09-26
Comandi della Console disponibili
Nome del comando
Comando
Scopo
loadvolumedata
Consente di caricare volumi di
dati transazionali per fattore di
sviluppo attività in un modello
Transactional Costing, nonché
generare valori fattore di sviluppo attività.
Comando
Scopo
Esporta modello nel file
export
Consente di esportare tutte le
tabelle del modello in un file di
testo XML o CSV (valori separati
da virgola).
Esporta nel database
exporttodb
Consente di esportare i risultati
di un modello in una tabella di
database.
Esporta risultati
exportresults
Consente di esportare i risultati
di un modello nelle tabelle Universo di “SAP BusinessObjects”.
Esporta vista
exportview
Esegue una definizione di un
processo di esportazione vista.
Utilizza tipo di ID esportazione
useexportidtype
Specifica se utilizzare l'ID
esportazione predefinito oppure
creare un nuovo ID esportazione
personale.
Utilizza ID esportazione
useexportid
Specifica un ID esportazione
esistente da utilizzare.
Utilizza nome esportazione
useexportname
Specifica il nome di un ID
esportazione personale o condiviso esistente da utilizzare.
Crea ID esportazione condiviso
createsharedexportid
Crea un nuovo ID esportazione
condiviso con un nome e un ID
esportazione specificati.
Crea nome esportazione condiviso
createsharedexportname
Crea un ID esportazione condiviso selezionato dal sistema con
un nome specificato.
Carica dati dei volumi
Tabella 5 - 5: Esporta
Nome del comando
22
2012-09-26
Comandi della Console disponibili
Nome del comando
Comando
Scopo
Rimuovi tutti i risultati degli utenti
removeuserresults
Rimuove i risultati di tutti gli ID
esportazione personali dell'utente corrente.
Rimuovi risultati per ID esportazione
removeresultsbyexportid
Rimuove i risultati di un ID
esportazione specificato.
Rimuovi risultati in base a nome
di esportazione
removeresultsbyexport
name
Rimuove i risultati di un ID
esportazione personale o condiviso specificato in base al nome.
Rimuovi risultati per ID esportazione corrente
removeresultsbycurrentex
portid
Rimuove i risultati dell'ID esportazione corrente.
Rinomina per ID esportazione
renameexportid
Modifica il nome di un ID esportazione specificato.
Rinomina per nome esportazione
renameexport
Modifica il nome di un ID esportazione personale o condiviso
specificato in base al nome.
Nome del comando
Comando
Scopo
Calcola modello
calcolo
Consente di eseguire un calcolo
del modello attualmente aperto.
Calcolo automatico
automaticcalculation
Attiva o disattiva il calcolo automatico per un modello.
Opzione modello
modeloption
Imposta le opzioni di calcolo del
modello.
Carica valori memorizzati
loadstoredvalues
Cancella i risultati esistenti e
carica valori di regola di modelli
associati.
Blocca risultati
lockresults
Blocca la combinazione di versione e periodo specificata.
Sblocca risultati
unlockresults
Sblocca la combinazione di versione e periodo specificata.
Cancella risultati bloccati
clearlockedresults
Elimina i risultati per la combinazione di versione e periodo
specificata.
Tabella 5 - 6: Calcolo
23
2012-09-26
Comandi della Console disponibili
Nome del comando
Comando
Scopo
Calcola costi transazionali
calculatetransationalco
sts
Calcola i costi unitari finali e li
aggiunge alla tabella
PPHV_UNITRATE. Inoltre, popola tabelle di risultati specifiche.
updatevpcalculationlist
Aggiunge o contrassegna per
l'eliminazione una combinazione
di versioni/periodi nella tabella
PP_HVVERSIONPERIODCALCLI
ST, che contiene un elenco di
combinazioni di versioni/periodi
per cui eseguire i calcoli dei costi transazionali.
clearvpcalculationlist
Contrassegna per l'eliminazione
tutte le combinazioni di versioni/periodi nella tabella PP_HV
VERSIONPERIODCALCLIST,
che contiene un elenco di combinazioni di versioni/periodi per
cui eseguire i calcoli dei costi
transazionali.
loadtccalconly
Esegue le mappature dei costi
transazionali e ricalcola i valori
del fattore di sviluppo attività dai
volumi dei fattori di sviluppo attività senza caricare dati dalla tabella PPLOAD_HVACTIVITYDRI
VER.
Nome del comando
Comando
Scopo
Connetti a Work Manager
wmconnect
Connette la console a Work
Manager.
Invia evento di Work Manager
wmsendevent
Invia l'evento all'istanza del processo di Work Manager per poterne seguire l'avanzamento.
Imposta Id di Work Manager
wfid
Non specificato dall'utente.
Elimina file di comandi dopo
l'utilizzo
deletecmdfile
Non specificato dall'utente.
Aggiorna elenco calcoli periodo
versione
Cancella elenco calcoli periodo
versione
Carica solo calcoli TC
Tabella 5 - 7: Work Manager
24
2012-09-26
Comandi della Console disponibili
Tabella 5 - 8: Controllo della console
Nome del comando
Comando
Scopo
File di comando
cmdfile
Consente di creare un segnaposto per il contenuto del file di
comando specificato.
Commento
;
Consente di inserire un commento in un file di comandi.
Informazioni
information
Fornisce informazioni sullo stato
delle connessioni e delle impostazioni correnti.
Registra tutti gli eventi in un file
di testo
log
Specifica un nome e una posizione per il file di registro relativo ai parametri di comando elaborati mediante l'Impostazione
guidata console.
Sospendi temporaneamente
elaborazione
pause
Arresta l'esecuzione dei parametri del file di comandi per il numero di minuti specificato.
Anteponi data e ora
prefixdate
Inserisce un'indicazione di data
e ora prima di ogni comando
eseguito come parte del file di
comandi.
Attendere. Lasciare il processo
in esecuzione per un certo periodo.
wait
Mantiene aperto un modello per
il numero di minuti specificato.
Scrivi un messaggio
msg
Visualizza il messaggio nella finestra DOS in cui viene eseguito il comando.
Argomenti correlati
• Utilizzo della Console e dei relativi comandi
• Uso di Impostazione guidata console
5.1 Controllo attivato (auditenabled)
25
2012-09-26
Comandi della Console disponibili
Descrizione
• Consente di specificare se un controllo è attivato per il modello. Ciò è possibile solo se si è attivato
il controllo globale mediante Configurazione guidata di Profitability and Cost Management.
Uso:
• auditenabled=<nomemodello>,<nuovostato>
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<nomemodello> Obbligatorio
Il nome del modello esistente
<nuovostato>
Il valore YES attiva il controllo per il modello. Il valore NO lo
disattiva.
Obbligatorio
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Controllo attivato.
2. Immettere il nome del modello.
3. Selezionare la casella di controllo Controllo attivato per attivare il controllo. Se la casella è
deselezionata, il controllo verrà disattivato.
5.2 Calcolo automatico (automaticcalculation)
Descrizione
• Consente di attivare o disattivare il calcolo automatico nel modello attualmente aperto.
Uso:
• automaticcalculation=[nuovovalore]
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
[nuovovalore]
Facoltativo
Consente di stabilire se il calcolo automatico è attivato o disattivato
per il modello. Il valore ON attiva il calcolo automatico. Il valore
predefinito è OFF.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
26
2012-09-26
Comandi della Console disponibili
1. Nell'elenco Tipo di comando selezionare Calcolo automatico.
2. Selezionare la casella di controllo Calcolo automatico attivato per attivare il calcolo automatico
per il modello.
5.3 Calcola modello (calculate)
Descrizione
• Consente di eseguire un calcolo del modello attualmente aperto. Calcola tutti i valori di regola
necessari per produrre costi di oggetto costo o costi di attività a livello foglia per un modello.
Uso:
• calcolo
Non sono associati parametri a questo comando.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Calcola modello.
Esempio: Istruzione da riga di comando per calcolare un modello
PCMCONSOLE username=user password=pass
open=Model1 calculate
Risultato il modello viene aperto e ne viene eseguito il calcolo.
5.4 Calcola costi transazionali (calculatetransactionalcosts)
Descrizione
• È necessario che il modello Transactional Costing sia aperto.
• Calcola i costi unitari finali e li esporta nelle tabelle PPR_HVUNITRATE e PPR_HVLIUNITRATE.
Inoltre, popola le tabelle dei risultati, a seconda del parametro ID caricamento.
• Se l'ID di caricamento contiene un valore negativo, ad esempio -1, l'ID di caricamento massimo per
il modello attivo viene estratto dalla tabella PP_FASTLOAD, quindi viene utilizzato il caricamento più
recente. In alternativa, viene utilizzato l'ID di caricamento fornito. Se l'ID caricamento contiene il
valore specifico di -1000, i risultati del valore di costo dettagliato riepilogati saranno inseriti nella
tabella PPR_HVDETAILCOST. Per qualsiasi altro valore di ID caricamento, i risultati del valore di
costo dettagliato riepilogati saranno inseriti nelle tabelle PPR_HVBREAKDOWN e PPR_HVBREAKDOW
NDETAILCOST. Per ulteriori informazioni, consultare il Manuale dell'utente dei modelli di Profitability
and Cost Management.
27
2012-09-26
Comandi della Console disponibili
•
È necessario un ID esportazione valido per calculatetransactionalcosts, che può essere
specificato in un comando della console aggiuntivo. Se non si specifica un ID di esportazione, viene
utilizzato automaticamente l'ID esportazione 1 del sistema condiviso denominato Default.
Uso:
• calculatetransactionalcosts=<Idcaricamento>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
<Idcaricamen- Obbligatorio
to>
L'ID di caricamento è -1000 per generare un output con i risultati
riepilogativi, oppure un qualsiasi altro valore per un output di risultati dettagliati. Altri ID di caricamento efficaci sono l'ID utilizzato
per caricare dati di costi transazionali o, in alternativa, qualsiasi
numero negativo per utilizzare l'ultimo caricamento per il modello
attivo.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Calcola costi transazionali.
2. Immettere l'ID di caricamento.
Esempio: ID di caricamento contenente il valore specifico pari a -1000
PCMCONSOLE username=user password=pass
open=TC_model calculatetransactionalcosts=-1000
Risultato: calcola i costi unitari finali in un modello Transactional Costing, utilizzando l'ID caricamento
più recente disponibile nella tabella PP_FASTLOAD, esporta i costi nelle tabelle PPR_HVUNITRATE e
PPR_HVLIUNITRATE e restituisce i risultati del valori dei costi dettagliati nella tabella PPR_HVDETAIL
COST.
Esempio: ID di caricamento contenente un valore non specifico negativo
PCMCONSOLE username=user password=pass
open=TC_model calculatetransactionalcosts=-1
Risultato: calcola i costi unitari finali in un modello Transactional Costing, utilizzando l'ID caricamento
più recente disponibile nella tabella PP_FASTLOAD, esporta i costi nelle tabelle PPR_HVUNITRATE e
PPR_HVLIUNITRATE e restituisce i risultati relativi ai valori riepilogativi dei costi nelle tabelle
PPR_HVBREAKDOWN e PPR_HVBREAKDOWNDETAILCOST.
5.5 Cancella risultati bloccati (clearlockedresults)
28
2012-09-26
Comandi della Console disponibili
Descrizione
• Consente di rimuovere la combinazione di Versione e Periodo bloccata specificata.
Uso:
• clearlockedresults=<versione>,<periodo>
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<versione>
Obbligatorio
Nome della versione.
<periodo>
Obbligatorio
Nome del periodo.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Cancella risultati bloccati.
2. Immettere la versione richiesta.
3. Immettere il periodo richiesto.
5.6 Cancella elenco calcoli periodo versione (clearvpcalculationlist)
Descrizione
• Comando facoltativo.
• È necessario che il modello Transactional Costing sia aperto.
• Consente di contrassegnare per l'eliminazione tutte le combinazioni di Versioni/Periodi della tabella
PP_HVVERSIONPERIODCALCLIST, cancellando l'elenco di combinazioni di Versioni/Periodi per cui
devono essere eseguiti i calcoli dei costi transazionali. Benché cancelli l'elenco di combinazioni, il
comando non elimina i risultati esistenti. Per ulteriori informazioni, consultare il Manuale dell'utente
dei modelli di Profitability and Cost Management.
Uso:
• clearvpcalculationlist
Non sono associati parametri a questo comando.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Cancella elenco calcoli periodo versione.
29
2012-09-26
Comandi della Console disponibili
Esempio:
username=administrator
password=administrator
open=TC Model
clearvpcalculationlist
5.7 Chiudi modello (closemodel)
Descrizione
• Consente di rimuovere la connessione al modello attualmente aperto. Il modello potrebbe rimanere
aperto se altri utenti vi sono attualmente connessi; in caso contrario, verrà chiuso.
Uso:
• closemodel
Non sono associati parametri a questo comando.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Chiudi modello.
5.8 File di comando (cmdfile)
Descrizione
• Consente di creare un segnaposto per i contenuti del file di comando specificato. Per ulteriori
informazioni, consultare l'argomento “File di comandi”.
• I comandi in un file di comando vengono eseguiti in ordine di apparizione, tranne il comando cmdfile
che è la prima operazione ad essere eseguita. La sua azione consiste nell'immettere i comandi
contenuti nel file di comando specificato in un elenco ordinato all'interno dell'elenco di comandi
ordinato da eseguire in modo sequenziale.
Uso:
• cmdfile=<nomefile>
Con questo comando è possibile utilizzare i seguenti parametri:
30
2012-09-26
Comandi della Console disponibili
Parametro
Obbligatorio/facoltativo
Descrizione
<nomefile>
Obbligatorio
Percorso di un file di comando esistente
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare File di comando.
2. Immettere il percorso di un file di comando esistente.
Esempio:
Contenuto del file command file1.ini:
username=User1
password=password
open=Model1
Contenuto del file command file2.ini:
cmdfile=C:\command file1.ini
export=export Model1.csv,Replace,C:\my export.esp,ExcludeRulesValues,COMMA,DEFAULT ALIAS,2,ANSI
Quando la Console esegue lo script in un file di comando, la prima azione consiste nel preparare il
file eseguibile. Per eseguire il file di comando command file2.ini, viene prima inserito il contenuto
del file command file1.ini specificato nel comando cmdfile, come segue:
PCMCONSOLE username=User1 password=password open=Model1
“export=export Model1.csv,Replace,C:\my export.esp,ExcludeRulesValues,COMMA,DEFAULT ALIAS,2,ANSI”
A questo punto l'eseguibile è pronto, quindi la Console esegue ognuno dei comandi in sequenza per
completare le operazioni seguenti:
• Viene eseguito l'accesso di Utente1 mediante la password fornita.
• Modello1 viene aperto.
• Modello1 viene esportato in base al file delle specifiche di esportazione.
Argomenti correlati
• File di comandi
5.9 Commento (;)
Descrizione
• Consente di inserire un commento a riga singola.
Uso:
31
2012-09-26
Comandi della Console disponibili
•
Nella riga di comando, i commenti vengono preceduti da un punto e virgola (;).
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Commento.
2. Immettere i commenti necessari.
5.10 Connetti a Work Manager (wmconnect)
Descrizione
• Connette la console a Work Manager. Prima di tale operazione sono necessari nome utente e
password (o password crittografata), che devono essere credenziali di accesso valide.
Suggerimento:
ciò è utile nei casi in cui è importante avere la certezza che la connessione sia stata stabilita, ad esempio
prima di creare un modello.
Uso:
• wmconnect
Non sono associati parametri a questo comando.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Connetti a Work Manager.
Argomenti correlati
• Comandi di Work Manager
5.11 Copia modello (copymodel)
Descrizione
• Descrizione: consente di creare una copia del modello specificato. Tutti gli elementi, i valori e le
“cartelle di lavoro” create nel modello esistente vengono riprodotte nel duplicato.
Nota:
il nuovo nome modello deve essere univoco e non contenere caratteri non consentiti.
Uso:
32
2012-09-26
Comandi della Console disponibili
•
copymodel=<modelloOrigine>, <modelloDest>
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<modelloOrigine>
Obbligatorio
Il nome del modello esistente
<modelloDest>
Obbligatorio
Il nuovo nome modello
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Copia modello.
2. Immettere il nome del modello di origine.
3. Immettere il nome del modello di destinazione.
5.12 Crea nuovo modello (newmodel)
Descrizione
• Crea un nuovo modello del tipo indicato con il nome specificato.
Uso:
• newmodel=<nomemodello>,[turnOnAudit],[modelType],[modelServer]
I seguenti parametri possono essere utilizzati con questo comando:
33
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<nomemodello>
Obbligatorio
Il nome del modello da creare.
[turnOnAudit]
Facoltativo
Il valore YES attiva il controllo per il nuovo modello quando viene
creato. L'impostazione predefinita è NO.
[modelType]
Facoltativo
I valori del tipo di modello sono:
• Redditività e costi = PCMMODEL (predefinito)
• Obiettivi e metriche = OMMODEL
• Transactional Costing = TCMODEL
• Bill of Materials = BOMMODEL
[modelServer]
Facoltativo
Parametro del nome del server in cui creare il modello, ad esempio
se è necessario il server dei modelli secondario.
Nota:
se non viene specificato alcun nome di server, oppure il nome non
è valido o raggiungibile, viene impostato automaticamente il server
dei modelli predefinito.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Crea nuovo modello.
2. Immettere il nome del nuovo modello.
3. Selezionare la casella di controllo Controlla modello per attivare il controllo. Ciò è possibile solo
se si è attivato il controllo globale mediante Configurazione guidata di Profitability and Cost
Management.
4. Nell'elenco Tipo di modello selezionare l'opzione Profitability and Costing, Objectives and Metrics,
Transactional Costing o Bill of Materials. Se non si specifica il tipo di modello, per impostazione
predefinita viene creato un modello di Profitability and Costing.
5. Immettere il Server modelli, se necessario. In questo modo è possibile specificare il server in cui
creare il modello, ad esempio il server modelli secondario. se non viene specificato alcun nome di
server, oppure il nome non è valido o raggiungibile, viene impostato automaticamente il server dei
modelli predefinito.
Esempio:
PCMCONSOLE username=user password=pass
newModel=Model open=Model import=c:\exports\MyExport.xml calculate
Risultato: crea un nuovo modello, quindi ne esegue l'importazione e il calcolo.
34
2012-09-26
Comandi della Console disponibili
5.13 Crea ID esportazione condiviso (createsharedexportid)
Descrizione
• Consente di specificare l'ID esportazione e il nome durante la creazione di un nuovo ID esportazione
condiviso. L'ID esportazione può essere incluso nell'intervallo da 2 a 4.000.
• Per poter eseguire questo comando, è necessario aprire prima un modello nel file di comando della
console per convalidare l'utente.
Uso:
• createsharedexportid=<exportId>,<name>
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<exportId>
Obbligatorio
L'ID esportazione da creare.
<name>
Obbligatorio
Il nome del nuovo ID esportazione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Crea ID esportazione condiviso.
2. Nella casella di selezione ID esportazione immettere o selezionare l'ID esportazione.
3. Immettere il nome del nuovo ID esportazione in Nome esportazione.
Esempio:
PCMCONSOLE username=administrator password=administrator open=Model createsharedexportid=536,SharedExportName
exporttodb=D:\Data\ActCostObjectValue.esp
Risultato: viene aperto un modello e creato un nuovo ID esportazione 536 denominato SharedExport
Name, che viene utilizzato per esportare i risultati nel database.
5.14 Crea nome esportazione condiviso (createsharedexportname)
Descrizione
• Crea un nuovo ID esportazione condiviso che viene impostato automaticamente su un valore
maggiore di 10.000, con il nome fornito.
• Per poter eseguire questo comando, è necessario aprire prima un modello nel file di comando della
console per convalidare l'utente.
35
2012-09-26
Comandi della Console disponibili
Uso:
• createsharedexportname=<name>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametri
Obbligatorio/facoltativo
Descrizione
<name>
Obbligatorio
Il nome del nuovo ID esportazione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Crea nome esportazione condiviso.
2. Immettere il nome del nuovo ID esportazione in Nome esportazione.
Esempio:
PCMCONSOLE username=administrator password=administrator open=Model createsharedexportname=SharedExportName
exporttodb=D:\Data\ActCostObjectValue.esp
Risultato: viene aperto un modello e specificato un nuovo ID esportazione condiviso denominato
SharedExportName, che viene utilizzato per esportare i risultati nel database.
5.15 Crea connessione di sistema (createsystemconnection)
Descrizione
• Crea una connessione a un sistema utilizzando il nome specificato e passa il controllo a tale
connessione. La connessione rimane valida solo per l'esecuzione del file di comando della console.
• È possibile creare più di una connessione di sistema durante l'esecuzione. Il controllo corrente della
console corrisponde sempre all'ultima connessione attivata, a meno che non si utilizza il comando
switchsystemconnection per passare a un'altra connessione di sistema.
• È possibile specificare un server per la connessione di sistema utilizzando il comando loginserver,
altrimenti verrà utilizzato il server su cui è attualmente in esecuzione la console client.
Uso:
• createsystemconnection=<systemConnectionName>
Con questo comando è possibile utilizzare i seguenti parametri:
36
2012-09-26
Comandi della Console disponibili
Parametro
<systemConnectionName>
Obbligatorio/facoltativo
Descrizione
Obbligatorio
Il nome del sistema con cui viene stabilita la connessione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Crea connessione di sistema.
2. Immettere il Nuovo nome connessione al sistema.
Esempio:
PCMCONSOLE createSystemConnection=localserver username=user password=pass
Risultato: crea una connessione di sistema denominata “localserver” ed esegue l'accesso con il nome
utente “user”. Non viene specificato alcun server, pertanto viene utilizzato quello su cui è attualmente
in esecuzione la console.
Argomenti correlati
• Server di accesso (loginserver)
• Cambia connessione al sistema (switchsystemconnection)
5.16 Elimina modello (delete)
Descrizione
• Consente di eliminare il modello specificato, se esiste e non è attualmente in uso. Se necessario,
specifica se eliminare i file e i layout di controllo.
• Se l'eliminazione non è possibile, ad esempio se il modello è ancora aperto, la Console continua a
tentare di eliminare il modello per il numero di minuti di timeout specificato prima di notificare che
l'eliminazione non è riuscita. Se durante il periodo di attesa il modello viene chiuso, allora viene
eliminato e il file di comando prosegue normalmente.
• Ogni volta che la console rileva un errore (ad esempio, il modello da eliminare non esiste),interrompe
l'esecuzione della parte restante del file di comandi. È possibile impostare un'opzione per delete
in modo che la console ignori questo errore e continui l'esecuzione.
Uso:
• delete=<modelName>,[removeAudit],[removeViews],[timeoutValue],[ignoreModelDoesNotExistError]
I seguenti parametri possono essere utilizzati con questo comando:
37
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<nomemodello>
Obbligatorio
Il nome del modello da eliminare.
[removeAudit]
Facoltativo
Il valore YES elimina tutti i record di controllo quando si elimina
il modello. Il valore predefinito è NO.
[removeViews]
Facoltativo
Il valore YES elimina tutti i layout associati quando si elimina il
modello. Il valore predefinito è NO.
[timeoutValue]
Facoltativo
Parametro corrispondente al numero di minuti durante i quali
la Console dovrebbe continuare a tentare di eliminare il modello.
Il valore predefinito è 0.
[ignoreModelDoe- Facoltativo
sNotExistError]
Il valore YES consente alla console di continuare l'esecuzione
della parte restante dello script nel file dei comandi, anche se
il comando delete restituisce un errore. Il valore predefinito è
NO.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Elimina modello.
2. Immettere il nome del modello da eliminare.
3. Per specificare il numero di minuti durante i quali la Console dovrebbe continuare a tentare di
eliminare il modello, selezionare un numero Timeout (minuti).
4. Selezionare la casella di controllo Elimina controlloper rimuovere i file di controllo associati.
5. Selezionare la casella di controllo Elimina visualizzazioniper rimuovere le visualizzazioni associate.
6. Selezionare la casella di controllo Ignora l'errore se il modello non esiste se si desidera che il
file dei comandi non si interrompa qualora il modello non esista.
Esempio:
PCMCONSOLE username=user password=pass
delete=Model1
Risultato: il modello denominato Model1 viene eliminato.
5.17 Password crittografata (encryptedpassword)
Descrizione
• Consente di impostare la password per l'account utente di Profitability and Cost Management
specificato in un formato crittografato. Questo comando può essere utilizzato in alternativa a Imposta
password in un'ambiente dove è preferibile non archiviare le password utente come testo normale.
Quando si utilizza questo parametro, è necessario impostare anche un nome utente (Vedere “Imposta
nome utente”).
38
2012-09-26
Comandi della Console disponibili
•
Per l'utilizzo nella riga di comando, è necessario prima generare la password in un formato
crittografato, utilizzando la funzione Impostazione guidata console.
Uso:
• encryptedpassword =<password>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
<password>
Obbligatorio
La versione crittografata della password.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Password crittografata.
2. Immettere la password in testo normale. Impostazione guidata console crittografa la password
immessa e la visualizza nell'Elenco parametri.
Argomenti correlati
• Imposta nome utente (username)
5.18 Esegui routine di caricamento dati (executedlroutines)
Descrizione
• È necessario che il modello sia aperto.
• Per gli utenti che hanno intenzione di configurare un modello di grandi dimensioni, questo comando
avvia la procedura di “esecuzione delle routine di Data Loader” per Microsoft SQL Server o Oracle,
a seconda dell'installazione. Questa procedura consente di eseguire i pacchetti e le procedure
relative al caricamento di valori, alias e strutture nell'ordine corretto, senza doverle eseguire
singolarmente. Per ulteriori informazioni, consultare il manuale SAP BusinessObjects Profitability
and Cost Management Database Administrator's Guide.
Uso:
• executedlroutines=<Idcaricamento>,<sostituiscidati>,<delta>,<destinazione>,[erase],[sum]
I seguenti parametri possono essere utilizzati con questo comando:
39
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<Idcaricamen- Obbligatorio
to>
L'identificativo di caricamento (ID caricamento) del singolo caricamento di dati da PP_FASTLOAD.
<sostituiscida- Obbligatorio
ti>
Specifica se sostituire le impostazioni relative alla gerarchia attributo. Il valore YES rimuove tutti i mappaggi degli attributi esistenti
e sostituisce i nuovi dati. Il valore NO viene aggiunto ai nuovi
mappaggi delle gerarchie attributo senza apportare modifiche ai
dati esistenti.
<delta>
Obbligatorio
I valori consentiti sono YES o NO. Il valore YES specifica che
devono essere caricati i dati delta.
<destinazione> Obbligatorio
I valori consentiti sono YES o NO. Il valore YES specifica che
devono essere caricati i dati di destinazione.
[erase]
Facoltativo
Il valore specificato indica se sostituire i valori dati per Versione
e Periodo:
• 0 = aggiunge i nuovi elementi dati e sovrascrive eventuali dati
esistenti nel modello con i valori della tabella di caricamento.
I dati non corrispondenti rimangono invariati.
• 1 = se nel modello sono già presenti dati per una Versione e
un Periodo identici a quelli della tabella di caricamento, i valori
dati nel modello per questa combinazione Versione / Periodo
vengono rimossi e sostituiti con i dati della tabella di caricamento.
• 2 = se nel modello sono già presenti dati per questa tabella di
caricamento, i valori dati vengono rimossi per tutte le Versioni
e i Periodi, prima dell'inserimento dei valori della tabella di
caricamento.
Il valore predefinito è 0.
[sum]
Facoltativo
Questo parametro somma i dati per i valori corrispondenti.
• YES = se la tabella di caricamento contiene record duplicati
per un valore dati, i valori vengono sommati insieme a qualsiasi
altro valore presente nel modello e il nuovo valore totale viene
caricato nel modello.
• NO = la procedura aggiunge i nuovi elementi dati e sovrascrive
eventuali dati esistenti nel modello con i valori della tabella di
caricamento. I dati non corrispondenti rimangono invariati. Gli
elementi Key duplicati vengono contrassegnati come duplicati
e non sono caricati.
Il valore predefinito è NO.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Esegui routine di caricamento dati.
40
2012-09-26
Comandi della Console disponibili
2. Immettere l'ID di caricamento di un singolo caricamento dati.
3. Selezionare la casella di controllo Sostituisci dati per rimuovere tutti i mappaggi degli attributi
esistenti e sostituirli con nuovi dati. Se non è selezionato, i nuovi mappaggi delle gerarchie attributo
vengono aggiunti senza apportare modifiche ai dati esistenti.
4. Selezionare la casella di controllo Dati delta per caricare i dati delta.
5. Selezionare la casella di controllo Dati destinazione per caricare i dati di destinazione.
6. Cancella dati specifica se sostituire i valori dati per Versione e Periodo. Selezionare un'opzione
nell'elenco (se non vengono effettuate selezioni, viene impostato il valore predefinito 0):
• 0 - Aggiungi nuovi valori dati: aggiunge nuovi elementi dati e sovrascrive eventuali dati esistenti
nel modello con i valori provenienti dalla tabella di caricamento. I dati non corrispondenti rimangono
invariati.
• 1 - Cancella prima dati per versione/periodo identico: se nel modello sono già presenti dati
per una Versione e un Periodo identici a quelli della tabella di caricamento, i valori dati nel modello
per questa combinazione Versione / Periodo vengono rimossi e sostituiti con i dati della tabella
di caricamento.
• 2 - Cancella prima dati per tutte le versioni e i periodi: se nel modello sono già presenti dati
per questa tabella di caricamento, i valori dati vengono rimossi per tutte le Versioni e per tutti i
Periodi, prima dell'inserimento dei valori della tabella di caricamento.
7. Selezionare la casella di controllo Somma destinazione per sommare i dati dei valori corrispondenti.
•
•
Se la casella è selezionata e la tabella di caricamento contiene record duplicati per un valore
dati, i valori vengono sommati insieme a qualsiasi altro valore presente nel modello e il nuovo
valore totale viene caricato nel modello.
Se non è selezionata, la procedura aggiunge i nuovi elementi dati e sovrascrive eventuali dati
esistenti nel modello con i valori della tabella di caricamento. I dati non corrispondenti rimangono
invariati. Gli elementi Key duplicati vengono contrassegnati come duplicati e non sono caricati.
Esempio:
PCMCONSOLE username=user password=pass
open=PCMmodel executedlroutines=1000,YES,NO,NO
Risultato: esegue la procedura di “esecuzione delle routine di Data Loader” per l'ID caricamento 10001.
Rimuove tutti i mappaggi attributo esistenti e carica tutti i nuovi dati. I dati delta o di destinazione non
vengono caricati.
5.19 Esporta modello nel file export
Descrizione
• Consente di esportare il modello attualmente aperto in un file XML o CSV (valori separati da virgola
come specificato.
41
2012-09-26
Comandi della Console disponibili
Nota:
si consiglia di definire un file di specifiche per l'esportazione (utilizzando la funzione Esporta nel
generatore modelli, in quanto l'opzione predefinita Tutto può richiedere un tempo eccezionalmente
lungo.
Uso:
• export=<fileName>,[appendData],[exportSpec],
[includeRules],[delimiter],[aliasName],[precision],[unicode],[decimalsep]
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<nomefile>
Obbligatorio
[appendData]
Facoltativo
Un nome file valido o un percorso per il file da esportare (tipo di file
.xml o .csv).
Scegliere se sostituire i file con lo stesso nome di file dell'esportazione corrente oppure se aggiungere l'esportazione corrente al file
esistente. I valori consentiti sono AGGIUNGI, SOSTITUISCI o
OVERWRITE (default).
Il file può essere aggiunto mediante AGGIUNGI o utilizzando un file
di specifiche *.ESP predefinito (una specifica di esportazione è
definita nelle schermate Modello > Importa/Esporta dell'applicazione Generatore modelli).
[exportSpec]
Facoltativo
Utilizzare le impostazioni di un file di specifiche di esportazione
(.ESP) predefinito per determinare gli elementi da esportare, oppure esportare tutto, ovvero struttura, dati, protezione e risultati. Se
non viene specificato un file (.ESP), l'impostazione predefinita è
ALL_TABLES, ovvero vengono esportate tutte le tabelle.
Nota:
l'esportazione di tutte le tabelle dei risultati per i modelli di grandi
dimensioni potrebbe richiedere molto tempo.
[includeRules]
Facoltativo
Specificare se includere i valori risultato generati da regole. I valori
consentiti sono EXCLUDERULESVALUES (predefinito) o INCLUDERULESVALUES.
Nota:
Se è già stato selezionato un file ESP specifico, è possibile selezionare i valori basati su regole che contiene. Questa opzione è appropriata solo quando non è stato selezionato un file ESP specifico.
[delimiter]
42
Facoltativo
Specificare un particolare delimitatore per il file di esportazione da
utilizzare. Se non si specifica un delimitatore, viene utilizzato quello
predefinito ovvero una VIRGOLA.
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
[aliasName]
Facoltativo
Deve trattarsi di un nome alias esistente di Profitability and Cost
Management disponibile nel modello che viene esportato. L'impostazione predefinita è DEFAULT ALIAS, ovvero viene selezionato il
valore DEFAULT ALIAS.
[precision]
Facoltativo
Specificare il numero di posizioni decimali per i valori esportati. Il
valore predefinito è 12.
[unicode]
Facoltativo
Scegliere il formato di esportazione dei dati nel file CSV: ANSI o
Unicode. I valori consentiti sono ANSI (predefinito) o UNICODE. Se
selezionata, questa opzione consente di esportare i dati del modello
che contengono caratteri Unicode, ad esempio i simboli asiatici.
[decimalsep]
Facoltativo
Specificare un separatore dei decimali per i numeri a virgola mobile.
L'impostazione predefinita è il valore di parametro DEFAULT, che
utilizza il separatore dei decimali specificato nelle impostazioni internazionali correnti del sistema operativo Windows Per specificare
un valore fisso per il separatore dei decimali, sono consentiti i valori
COMMA e PERIOD.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Esporta modello nel file.
2. In Esporta in file specificare il nome file in cui eseguire l'esportazione e indicare se si tratta di un
file XML. Se si aggiunge il tipo di file .xml, verrà generato un file XML, altrimenti verrà generato un
file CSV.
3. Selezionare la casella di controllo Aggiungi dati a questo file per aggiungere i dati esportati a
qualsiasi file esistente. L'impostazione predefinita comporta la sovrascrittura dei file esistenti dello
stesso nome.
4. Se la casella di controllo Includi valori regola è selezionata, vengono esportati anche i valori
calcolati con regole, altrimenti verranno esportati solo i dati di input, costi di attività e costi di oggetto
costo.
5. In File delle specifiche di esportazione è possibile selezionare la posizione di un file di specifiche
di esportazione (*.esp) che definisce i parametri di esportazione.
Nota:
si consiglia di definire un file di specifiche di esportazione specifico, in quanto l'impostazione
predefinita ALL_TABLES esporta EVERYTHING.
6. Per impostazione predefinita, una virgola viene utilizzata per delimitare i campi esportati. È possibile
utilizzare Delimitatore per specificare un delimitatore specifico per il file di esportazione da utilizzare.
Questa opzione è pertinente solo per le esportazioni di file .csv. Per specificare TAB come
delimitazione, immettere la parola TAB (verrà automaticamente convertita dall'applicazione nella
rappresentazione ASCII di TAB come #9).
7. In Nome alias è possibile specificare il nome di un alias dati se i dati esportati devono apparire con
nomi di alias dati alternativi.
43
2012-09-26
Comandi della Console disponibili
8. È possibile specificare il numero di posizioni decimali per i valori esportati in un file .csv, in
Precisione decimale. Il valore predefinito è 2.
9. Come valore di Separatore decimale in un file .csv viene utilizzato qualsiasi valore predefinito
specificato nelle impostazioni internazionali correnti del sistema operativo Windows.
• Per specificare un valore fisso per il separatore dei decimali, selezionare uno dei valori , (virgola)
o . (punto) in base alle esigenze: il parametro viene quindi compilato con COMMA o PERIOD.
• Per mantenere l'impostazione predefinita, selezionare DEFAULT e il parametro rimane vuoto.
10. È possibile scegliere di esportare i dati in un file .csv in formato ANSI o Unicode. Se la casella di
controllo File Unicode è selezionata, questa opzione consente di esportare i dati modello contenenti
i caratteri Unicode, ad esempio i simboli asiatici.
Esempio:
PCMCONSOLE username=user password=pass
open=Model "export=c:\MyExport.xml,Overwrite,All"
Risultato: esporta tutto il contenuto di un modello, sovrascrivendo tutti i file.
Esempio:
PCMCONSOLE username=user password=pass
open=Model
"export=c:\AnExport.csv,Append,C:\ExportSpec.esp,ExcludeRulesValues,TAB,EPO
CODE",2,ANSI,COMMA
Risultato: esporta solo gli elementi inclusi in un file di specifiche. Il file di esportazione è in formato
.csv con testo delimitato da tabulazioni, escluse le regole, utilizza l'alias dati EPO CODE, una
precisione decimale pari a 2, l'esportazione come ANSI, un separatore decimale fissato come virgola.
5.20 Esporta risultati (exportresults)
Descrizione
• Esporta i risultati dal modello aperto nelle tabelle SAP BusinessObjects“Universo”. Se si desidera,
è possibile selezionare la posizione di un file di specifiche di esportazione (*.ESP) che definisce le
tabelle di risultati da esportare. Se un file di specifiche di esportazione non è elencato, tutte le tabelle
di risultati del modello vengono esportate nelle tabelle “Universo”.
• È necessario un ID esportazione valido per exportresults, che può essere specificato in un
comando della console aggiuntivo. Se non si specifica un ID, verrà automaticamente selezionato
l'ID esportazione 1 del sistema condiviso (Default).
Avvertenza:
deve essere sempre utilizzato l'ID esportazione 1 del sistema condiviso (Default).
Nota:
•
44
si consiglia di definire un file di specifiche di esportazione specifico, in quanto l'impostazione
predefinita ALL_TABLES esporta EVERYTHING.
2012-09-26
Comandi della Console disponibili
•
exportresults non può essere utilizzato con i tipi di modello Objectives and Metrics.
Uso:
• exportresults=<specificheEsportazione>,[NomeAlias]
I seguenti parametri possono essere utilizzati con questo comando:
Parametro
Obbligatorio/facoltativo
Descrizione
<specificheEspor- Obbligatorio
tazione>
Il nome del file di specifiche di esportazione (*.ESP) è facoltativo. Se non viene indicato un file di specifiche di esportazione
specifico, l'impostazione predefinita è ALL_TABLES, ovvero
tutte le tabelle dei risultati del modello vengono esportate nelle
tabelle “Universo”.
[aliasName]
Deve trattarsi di un nome alias esistente di Profitability and
Cost Management disponibile nel modello che viene esportato.
L'impostazione predefinita è DEFAULT ALIAS, ovvero viene
selezionato il valore DEFAULT ALIAS.
Facoltativo
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Esporta risultati.
2. Immettere la posizione di un file di specifiche di esportazione (*.ESP) che definisce le tabelle di
risultati da esportare
Nota:
si consiglia di definire un file di specifiche di esportazione specifico, in quanto l'impostazione
predefinita ALL_TABLES esporta TUTTO.
3. In Alias dati è possibile specificare il nome di un alias dati se i dati esportati devono apparire con
nomi di alias dati alternativi.
5.21 Esporta nel database (exporttodb)
Descrizione
• Consente di esportare i dati dei risultati dal modello attualmente aperto a una tabella di database.
Il file di specifiche di esportazione (*.ESP) è facoltativo. Se un file di specifiche di esportazione non
è elencato, tutte le tabelle di risultati del modello vengono esportate nel database.
• È necessario un ID esportazione valido per exporttodb, che può essere specificato in un comando
della console aggiuntivo. Se non si specifica un ID di esportazione, viene utilizzato automaticamente
l'ID esportazione 1 del sistema condiviso denominato Default.
45
2012-09-26
Comandi della Console disponibili
Avvertenza:
La funzionalità “Esporta in universo” (exportresults) può essere utilizzata solo con l'ID
esportazione 1 del sistema condiviso (Default). Se questa funzionalità viene utilizzata anche
nell'organizzazione, dovrà essere utilizzato solo l'ID esportazione 1 del sistema condiviso (Default)
per tutte le esportazioni di database.
Nota:
vedere la schermata "Statistiche modello" in Generatore modelli per indicazioni sul numero di calcoli
possibili (e quindi sulla dimensione dei dati) esportabili durante tale processo.
Uso:
• exporttodb=[nomefile]
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
[nomefile]
Facoltativo
Se si desidera, è possibile indicare la posizione di un file di specifiche di esportazione (*.ESP) che definisce le tabelle e le dimensioni
da esportare.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Esporta nel database.
2. Se si desidera, è possibile selezionare la posizione di un file di specifiche di esportazione (*.ESP)
che definisce le tabelle e le dimensioni da esportare.
5.22 Esporta vista (exportview)
Descrizione
• È necessario che il modello sia aperto.
• Esegue una definizione di processo di esportazione vista precedentemente creata nel generatore
modelli, utilizzando la funzionalità Esporta vista dati (per ulteriori informazioni, consultare il Manuale
dell'utente di SAP BusinessObjects Profitability and Cost Management).
• A seconda dei parametri forniti, il comando effettua le operazioni indicate di seguito.
• Se viene fornito un nome file: i dati risultanti vengono esportati in un file .csv creato
dall'esportazione (se non esiste già nel percorso specificato).
• Se viene fornito un nome file “null”: il modello esegue tutti i calcoli e memorizza i risultati nella
cache ma non li scrive in un file.
46
2012-09-26
Comandi della Console disponibili
Suggerimento:
Questa operazione richiede una quantità di tempo notevolmente inferiore rispetto all'esportazione
in un file. Risulta ad esempio utile per eseguire un'esportazione in un nome file “null” durante le
ore notturne. In questo modo il calcolo un modello di grandi dimensioni viene completato al
mattino e l'apertura richiede meno tempo.
Uso:
• exportview=<JobName>,<FileName>
I seguenti parametri possono essere utilizzati con questo comando:
Parametro
Obbligatorio/facoltativo
Descrizione
<JobName>
Obbligatorio
Il nome del processo di esportazione vista.
<FileName>
Obbligatorio
•
•
Per eseguire l'esportazione in un file: il nome del file .csv in
cui esportare i risultati.
Per eseguire l'esportazione in un nome file “null”: una coppia
di virgolette doppie ("") o una coppia di virgolette singole ('').
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Esporta vista.
2. Immettere il nome del processo di esportazione vista.
3. Eseguire una delle operazioni seguenti:
• Immettere la posizione del file .csv in cui esportare i risultati.
• Immettere una coppia di virgolette doppie ("") o una coppia di virgolette singole ('') per specificare
un nome file null.
Esempio: esportazione in un file
PCMCONSOLE username=user password=pass
open=PCMmodel exportview=exportjob1,c:\results.csv
Risultato: apre il modello denominato PCMmodel ed esegue il processo di esportazione vista
denominato exportjob1. I dati vengono esportati nel file results.csv. Se il file non esiste, viene
creato dall'esportazione.
Esempio: esportazione in un nome file null
PCMCONSOLE username=user password=pass
login server=pcmserver open=PCMmodel exportview=exportjob2,'' logoff=ALLUSERS
Risultati: apre il modello denominato PCMmodel ed esegue il processo di esportazione vista denominato
exportjob2. Vengono eseguiti tutti i calcoli del modello e i risultati vengono memorizzati nella cache
ma non scritti in un file, quindi tutti gli utenti vengono disconnessi.
47
2012-09-26
Comandi della Console disponibili
5.23 Importa file XML nel modello (import)
Descrizione
• Seleziona un file di modello XML esistente da importare nel modello attualmente aperto. I file XML
importati in un modello con struttura e dati esistenti aggiungono soltanto ulteriori informazioni. Se
necessario, specifica se consentire la creazione di una nuova struttura che non esiste nel modello.
• Consente di specificare un file ISF (Import Specification File) con i dettagli relativi a quali tabelle
selezionare per l'importazione dal file XML. Il file ISF viene creato nel generatore modelli, salvando
le selezioni nella finestra di dialogo "Importa file XML". Per ulteriori informazioni, consultare il Manuale
dell'utente di SAP BusinessObjects Profitability and Cost Management Modeling.
Uso:
• import=<fileName>,[createStructure],[isfFile]
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<nomefile>
Obbligatorio
Il nome di un file di modello XML esistente
[createStructure]
Facoltativo
Il valore YES consente di creare una nuova struttura che non è già
esistente nel modello (impostazione predefinita). Il valore NO non
consente la creazione della nuova struttura.
[isfFile]
Facoltativo
Nome di un file ISF (Import Specification File) esistente.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Importa file XML nel modello.
2. Immettere il nome di un file di modello XML esistente.
3. Selezionare la casella di controllo Consenti creazione struttura per consentire la creazione della
nuova struttura non ancora esistente nel modello.
4. Immettere il nome di un file Import Specification File esistente, con un tipo di file ISF.
Esempio:
PCMCONSOLE username=user password=pass
delete=Model1 newModel=Model2 import=c:\exports\MyExport.xml
Risultato: un modello viene eliminato, il nuovo modello viene creato e vengono importati i dati e la
struttura.
48
2012-09-26
Comandi della Console disponibili
5.24 Informazioni (information)
Descrizione
• Fornisce informazioni per l'esecuzione di questo file dei comandi della console sullo stato del modello
e delle connessioni di sistema correnti e sulle impostazioni passport applicazione. Specificare un
singolo parametro per scegliere il tipo di informazioni visualizzate. È possibile ripetere il comando
information tutte le volte che è necessario con un parametro diverso o mantenendo lo stesso,
nel punto appropriato per ogni opzione di informazione necessaria.
Uso:
• information=<infoOnWhat>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
<infoOnWhat>
Obbligatorio
È possibile utilizzare le seguenti opzioni:
• PASSPORT_ACTIVE: mostra se il passport applicazione è attivo
o meno.
• PASSPORT_VALUE: mostra il valore del passport applicazione
attivo.
• MODEL_LIST: mostra un elenco di modelli per la connessione
di sistema corrente attiva.
• SYSTEM_CONNECTION_NAME: mostra il nome della connessione di sistema corrente attiva.
• SYSTEM_CONNECTIONS: mostra un elenco di tutte le connessioni di sistema stabilite durante l'esecuzione del file dei comandi
della console.
• EXPORT_ID_TYPE: mostra l'impostazione che indica se
l'esportazione dei valori basata sui risultati utilizzerà l'ID esportazione predefinito o richiederà un nuovo ID esportazione.
• EXPORT_ID: mostra l'ID esportazione da utilizzare in un'esportazione dei valori basata sui risultati. Se un ID esportazione non
è stato precedentemente specificato nel file dei comandi, la console lo recupera.
• USER_EXPORT_DETAILS: mostra tutti gli ID esportazione per
l'utente corrente, con i nomi e l'indicazione se si tratta di ID personali o condivisi.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Informazioni.
49
2012-09-26
Comandi della Console disponibili
2. Nella casella Informazioni immettere il tipo di informazioni richiesto per le opzioni seguenti:
•
•
•
•
•
.
PASSPORT_ACTIVE
PASSPORT_VALUE
MODEL_LIST
SYSTEM_CONNECTION_NAME
SYSTEM_CONNECTIONS
Esempio:
Un file INI di esempio della console:
createSystemConnection=devserver username=user password=pass loginserver=devserv1
;
createSystemConnection=testserver username=user password=pass loginserver=testserv2
;
switchSystemConnection=devserver
;
information=model_list
Risultato:
1. Crea una connessione di sistema denominata devserver.
2. Crea una seconda connessione di sistema denominata testserver.
3. Passa di nuovo il controllo al sistema devserver.
4. Mostra un elenco di tutti i modelli nel sistema devserver.
5.25 Carica modello (loadmodel)
Descrizione
• Consente di stabilire una connessione con un modello esistente, utilizzando l'account specificato,
per la durata dell'esecuzione della Console.
• Consente l'esecuzione dell'eseguibile della Console con connessioni a più modelli, a differenza del
comando open, poiché loadmodel rende possibile stabilire connessioni tra Console e più modelli
contemporaneamente. Ciò è utile quando la Console deve gestire più di un modello, per garantire
che ogni modello sia tenuto aperto.
Uso:
• loadmodel=<nomemodello>
Con questo comando è possibile utilizzare i seguenti parametri:
50
2012-09-26
Comandi della Console disponibili
Parametro
Obbligatorio/facoltativo
Descrizione
<nomemodello>
Obbligatorio
Il nome del modello esistente
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Carica modello.
2. Immettere il nome del modello al quale ci si vuole connettere.
5.26 Carica valori memorizzati (loadstoredvalues)
Descrizione
• Cancella i risultati esistenti e carica valori di regola di modelli associati.
Esistono due tipi di valori di modello incrociato:
• I modelli contenenti valori dinamici - Questo tipo di modello rileva e ricarica automaticamente i
valori modificati nei modelli dipendenti.
• I modelli contenenti valori modello memorizzati (non dinamici) - Questo tipo di modello contiene
un insieme di dati statici derivanti dai modelli dipendenti, in modo che i valori modificati non siano
rilevati o riflettano il modello principale.
In caso di aggiornamento dei valori di modello memorizzati in un modello principale, è possibile
eseguire il comando loadstoredvalues per rimuovere i risultati calcolati ed ottenere quindi
un aggiornamento di tutti i valori nei modelli dipendenti desiderati.
Nota:
Poiché Carica valori memorizzati cancella eventuali risultati (non bloccati) esistenti in un
modello, è consigliabile eseguire il comando loadstoredvalues PRIMA del comando calculate.
Ciò si applica soprattutto ai modelli che contengono regole che utilizzano Carica valori memorizzati.
Uso:
• loadstoredvalues
Non sono associati parametri a questo comando.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Carica valori memorizzati.
Esempio:
PCMCONSOLE USERNAME=<utente> PASSWORD=<password> OPEN =<nome modello> LOADSTOREDVALUES
51
2012-09-26
Comandi della Console disponibili
5.27 Carica solo calcoli TC (loadtccalconly)
Descrizione
• È necessario che il modello Transactional Costing sia aperto.
• Esegue le mappature dei costi transazionali e ricalcola i valori del fattore di sviluppo attività dai
volumi dei fattori di sviluppo attività senza caricare dati dalla tabella PPLOAD_HVACTIVITYDRIVER.
Per ulteriori informazioni, consultare il Manuale dell'utente dei modelli di Profitability and Cost
Management.
• Il parametro ID caricamento rappresenta l'ID di caricamento del singolo caricamento dati. Se si
immette un valore negativo, ad esempio -1, l'ID di caricamento massimo per il modello attivo viene
estratto dalla tabella PP_FASTLOAD, quindi viene utilizzato il caricamento più recente. Se si immette
uno specifico ID di caricamento, i dati vengono elaborati solo quando l'ID di caricamento corrisponde.
Uso:
• loadtccalconly =<Idcaricamento>
I seguenti parametri possono essere utilizzati con questo comando:
Parametro
Obbligatorio/facoltativo
Descrizione
<Idcaricamento>
Obbligatorio
L'ID di caricamento del singolo caricamento dati
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Carica solo valori TC.
2. Immettere l'ID di caricamento del singolo caricamento dati.
5.28 Carica dati dei volumi (loadvolumedata)
Descrizione
• Consente di caricare volumi di dati transazionali per fattore di sviluppo attività in un modello
Transactional Costing attualmente aperto. Utilizza l'ID di caricamento fornito e genera valori di fattori
di sviluppo attività. Per ulteriori informazioni, consultare il Manuale dell'utente dei modelli di Profitability
and Cost Management.
• Il parametro ID caricamento rappresenta l'ID di caricamento del singolo caricamento dati. Se si
immette un valore negativo, ad esempio -1, l'ID di caricamento massimo per il modello attivo viene
estratto dalla tabella PP_FASTLOAD, quindi viene utilizzato il caricamento più recente. Se si immette
uno specifico ID di caricamento, i dati vengono elaborati solo quando l'ID di caricamento corrisponde.
52
2012-09-26
Comandi della Console disponibili
Uso:
• loadvolumedata=<Idcaricamento>
I seguenti parametri possono essere utilizzati con questo comando:
Parametro
<Idcaricamento>
Obbligatorio/facoltativo
Descrizione
Obbligatorio
L'identificatore (ID caricamento) fornito per il singolo caricamento
di dati correlato all'ID di caricamento nella tabella di gestione temporanea PPLOAD_HVACTIVITYDRIVERVOLUME.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Carica dati dei volumi.
2. Immettere l'identificatore (ID caricamento) fornito per il singolo caricamento di dati correlato all'ID
di caricamento nella tabella di gestione temporanea PPLOAD_HVACTIVITYDRIVERVOLUME.
Esempio:
PCMCONSOLE username=user password=pass
open=TC_model loadvolumedata=-1
Risultato: i dati Transactional Costing vengono importati in un modello, utilizzando l'ID di caricamento
più recente disponibile nella tabella PP_FASTLOAD e vengono generati valori del fattore di sviluppo
attività a partire dai volumi transazionali corrispondenti.
5.29 Blocca risultati (lockresults)
Descrizione
• Consente di bloccare la combinazione di Versione e Periodo specificata.
Uso:
• lockresults=<versione>,<periodo>
I seguenti parametri possono essere utilizzati con questo comando:
53
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<versione>
Obbligatorio
Nome della versione.
<periodo>
Obbligatorio
Nome del periodo.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Blocca risultati.
2. Immettere la versione richiesta.
3. Immettere il periodo richiesto.
5.30 Registra tutti gli eventi in un file di testo (log)
Descrizione
• Questo comando genera un file di testo delle azioni registrate verificatesi durante l'ultima serie di
comandi emessi (file o riga di comandi). Il nome file e il percorso devono essere specificati e
disponibili, ovvero l'utente deve disporre di diritti di “scrittura” nella posizione specificata. Questo
comando può essere specificato ovunque nel file o nella riga di comandi e viene applicato a tutte
le azioni. Anche gli eventuali errori rilevati durante l'elaborazione del file di comandi vengono registrati
in tale file.
Uso:
• log=<nomefile>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
<nomefile>
Obbligatorio
Specifica un nome e una posizione per il file di registro relativo ai
parametri di comando elaborati mediante Impostazione guidata
console.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Registra tutti gli eventi in un file di testo.
2. Immettere un nome file e un percorso in cui scrivere il file di registro.
Esempio:
PCMCONSOLE username=user password=pass
open=Model databridgeimport=c:\ADBImportspec.ctf prefixdate
log=c:\MyLog.txt
54
2012-09-26
Comandi della Console disponibili
Risultato: importa dati in un modello esistente utilizzando un file di controllo Data Bridge e registra
l'intervallo di tempo necessario per l'operazione.
5.31 Server di accesso (loginserver)
Descrizione
• Specifica quale server utilizzare per l'accesso. Questo comando può essere utilizzato per accedere
a un altro sistema che non è attualmente configurato come predefinito, ma è un'opzione disponibile
quando durante l'accesso non è necessario specificare il server.
• Deve essere preceduto dai comandi username e password, nonché facoltativamente da create
systemconnection.
Uso:
• loginserver=<ConnectionName>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
<ConnectionName>
Obbligatorio
Il nome del server a cui connettersi durante l'accesso.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Server di accesso.
2. Immettere il nome del server nella casella Server di accesso.
Esempio:
PCMCONSOLE createSystemConnection=devserver username=user password=pass loginserver=devserv1 open=Model1
Risultato: crea una connessione di sistema denominata devserver al server devserv1 ed esegue
l'accesso con il nome utente “user” e la password “pass”; quindi apre un modello.
5.32 Disconnetti (logoff)
Descrizione
55
2012-09-26
Comandi della Console disponibili
•
Consente di interrompere totalmente le connessioni client degli utenti attualmente connessi al sistema
in esecuzione e ne causa la disconnessione. Il messaggio seguente viene visualizzato nell'istanza
client: La sessione è stata interrotta manualmente da un utente autorizzato.
La funzionalità fornita da questo comando corrisponde a quella di Disconnetti nell'utilità Controllo
utenti. Per ulteriori informazioni, vedere l'argomento “User Monitor” nel manuale SAP BusinessObjects
Profitability and Cost Management Administrator's Guide.
Nota:
per eseguire ulteriori comandi successivi a Disconnetti, verificare che un altro utente sia connesso
all'eseguibile della Console e non che siano disconnessi tutti gli utenti.
Uso:
• logoff=<comandosecondario>,[subcommandParam]
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<comandoseco- Obbligatorio
ndario>
Disconnette gli utenti in base ai parametri forniti:
• ALLUSERS - disconnette tutti gli utenti connessi al sistema
• USER - disconnette l'utente specificato
• GROUP - disconnette tutti gli utenti del gruppo specificato attualmente connessi
• MODEL - disconnette tutti gli utenti attualmente connessi al
modello specificato
[subcommand- Facoltativo
Param]
Specificare un nome utente o un nome gruppo o un nome modello,
in base al comando secondario selezionato. Questo parametro non
è richiesto per ALLUSERS.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Disconnetti.
2. Nell'elenco Tipo di disconnessione:
•
•
•
•
56
Per disconnettere tutti gli utenti attualmente connessi al sistema, selezionare Tutti gli utenti.
Per disconnettere un utente specifico, selezionare Utente specifico, quindi immettere il Nome
utente.
Per disconnettere tutti gli utenti di un gruppo specifico, selezionare Gruppo specifico di utenti,
quindi immettere il Nome gruppo.
Per disconnettere tutti gli utenti attualmente connessi a un modello specifico, selezionare Tutti
gli utenti di un modello specifico, quindi immettere il Nome modello.
2012-09-26
Comandi della Console disponibili
5.33 Descrizione modello (modeldescription)
Descrizione
• Consente di specificare o correggere la descrizione esistente che viene visualizzata per il modello
in Generatore modelli.
Uso:
• modeldescription=<nomemodello>,<descrizione>
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<nomemodello>
Obbligatorio
Il nome del modello
<descrizione>
Obbligatorio
Nuova descrizione del modello.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Descrizione modello.
2. Immettere il nome del modello.
3. Immettere la descrizione del modello.
5.34 Modello attivato (modelenabled)
Descrizione
• Consente di specificare se il modello è attivato o disattivato. Non è possibile aprire un modello
disattivato.
Uso:
• modelenabled=<nomemodello>,<nuovostato>
I seguenti parametri possono essere utilizzati con questo comando:
57
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<nomemodello>
Obbligatorio
Il nome del modello
<nuovostato>
Obbligatorio
Il valore YES attiva il modello. Il valore NO lo disattiva.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Modello attivato.
2. Immettere il nome del modello.
3. Selezionare la casella di controllo Modello attivato per attivare il modello. Se la casella è
deselezionata, il modello verrà disattivato.
5.35 Opzione modello (modeloption)
Descrizione
• Modifica le impostazioni delle opzioni calcolo modello esistenti nel modello attualmente aperto.
Specificare un singolo parametro per l'opzione calcolo modello e un altro per l'impostazione. È
possibile ripetere il comando modeloption tutte le volte che è necessario con un parametro diverso
per ogni opzione calcolo modello.
• Per ulteriori informazioni sull'utilizzo delle opzioni calcolo modello e le relative impostazioni, consultare
la sezione “Opzioni calcolo modello” del Manuale dell'utente di SAP BusinessObjects Profitability
and Cost Management Modeling.
Uso:
• modeloption=<modeloption>,<setting>
I seguenti parametri possono essere utilizzati con questo comando:
58
2012-09-26
Comandi della Console disponibili
Parametro
Obbligatorio/facoltativo
Descrizione
<modeloption> Obbligatorio
<setting>
59
L'opzione calcolo modello da impostare. Le opzioni disponibili
sono:
• LI_DETAIL_VALUES
• ACTIVITY_DRIVER_VALUES
• WORK_SHEET_VALUES
• REVENUE_VALUES
• EMPLOYEE_RESOURCE_DRIVER_SPLIT_VALUES
• SUMMARY_MOVEMENT_VALUES
• REASSIGNMENT_DRIVERS
• SUMMARY_COST_OBJECT_VALUES
• LI_COST_OBJECT_VALUES
• ACTIVITY_COST_OBJECT_VALUES
• TOTAL_COST_OBJECT_VALUES
• COST_OBJECT_RESPONSIBILITY_CENTERS
• COST_OBJECT_ACTIVITY_TYPE_LINE_ITEMS
• RULES_ENGINE
• RULE_DEPENDENCY_ANALYZER
• BACKGROUND_CALC
• AWE_MEMORY_USAGE
• DETAIL_COST_OBJECT_1_MAIN_HIERARCHY
• DETAIL_COST_OBJECT_2_MAIN_HIERARCHY
• DETAIL_COST_OBJECT_3_MAIN_HIERARCHY
• DETAIL_COST_OBJECT_4_MAIN_HIERARCHY
• DETAIL_COST_OBJECT_5_MAIN_HIERARCHY
• COST_OBJECT_ACTIVITY_LI_UNIT_RATE
• MAXIMUM_CPU_USAGE
• FIRST_CPU_USAGE
• PRODUCTION_UNIT_SOLD_RECONCILIATION
• RESOURCEDRIVERASSIGNMENT
• DEFAULTVOLUMERESPONSIBILITYCENTER
• DATALOADERALIASRESOLUTION
Obbligatorio
2012-09-26
Comandi della Console disponibili
Parametro
Obbligatorio/facoltativo
Descrizione
La nuova impostazione per l'opzione calcolo modello specificata.
Le impostazioni disponibili sono:
• CALC_IF_REQUIRED
• CALC_ALL_LEAVES
• CALC_RESULTS
• NO_CALC_RESULTS
• SUMMARIZE
• NO_SUMMARIZE
• LINKED_TO_LI_VALUES
• NOT_LINKED_TO_LI_VALUES
• COMPILED
• COMPILED_WITH_VBSCRIPT
• VBSCRIPT
• FULL_ANALYSIS
• PARTIAL_ANALYSIS
• SMART_DELETE_DISABLED
• 1_CPU
• 2_CPU
• 3_CPU
• 4_CPU
• 5_CPU
• 6_CPU
• 7_CPU
• 8_CPU
• 9_CPU
• 10_CPU
• 11_CPU
• 12_CPU
• 13_CPU
• 14_CPU
• 15_CPU
• 16_CPU
• 20_CPU
• 24_CPU
• 28_CPU
• 32_CPU
• NO_CPU_RESTRICTION
• NOT_ALLOWED
• MAX_1GB
• MAX_2GB
• MAX_3GB
60
2012-09-26
Comandi della Console disponibili
Parametro
Obbligatorio/facoltativo
Descrizione
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
MAX_4GB
MAX_5GB
MAX_6GB
MAX_7GB
MAX_8GB
MAX_9GB
MAX_10GB
MAX_11GB
MAX_12GB
MAX_13GB
MAX_14GB
MAX_15GB
MAX_16GB
MAX_20GB
MAX_24GB
MAX_28GB
MAX_32GB
UNLIMITED
AUTOMATIC
HIDE
DISPLAY
BY_COSTTYPE
BY_RESPCENTER
ALL
PARENT
CURRENT
RCUNASSIGNED
DEFAULT_ALIAS
ALL_ALIASES
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Opzione modello.
2. Selezionare l'opzione modello.
3. Selezionare il Valore opzione.
Esempio:
PCMCONSOLE username=administrator password=administrator open=Model1
modeloption=LI_DETAIL_VALUES,CALC_IF_REQUIRED modeloption=MAXIMUM_CPU_USAGE,5_CPU
61
2012-09-26
Comandi della Console disponibili
Risultato: apre un modello e imposta due opzioni calcolo modello. L'opzione Valori di dettagli partita
singola è impostato su Calcola solo se necessario e l'opzione Massimo utilizzo CPU è impostata
su 5 CPU.
5.36 Server modelli (modelserver)
Descrizione
• Consente di modificare il server dei modelli in cui viene eseguito il modello.
Uso:
• modelserver=<nomemodello>,<server>
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<nomemodello>
Obbligatorio
Il nome del modello
<server>
Obbligatorio
Il nome del server modelli
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Server modelli.
2. Immettere il nome del modello.
3. In Nome server modelli immettere il nome del server modelli in cui modificare il modello.
5.37 Apri modello (open)
Descrizione
• Consente di aprire un modello esistente, tranne nel caso in cui sia già aperto da un altro utente) e
creare una connessione a tale modello utilizzando l'account specificato.
• È possibile stabilire una connessione a un eseguibile della Console per un solo modello alla volta
utilizzando il comando open. Se si utilizza un secondo comando open nello stesso eseguibile, il
primo modello verrà automaticamente chiuso prima di aprire il secondo.
Uso:
• open=<nomemodello>
Con questo comando è possibile utilizzare i seguenti parametri:
62
2012-09-26
Comandi della Console disponibili
Parametro
Obbligatorio/facoltativo
Descrizione
<nomemodello>
Obbligatorio
Il nome del modello da aprire.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Apri modello.
2. Immettere il nome del modello.
Esempio:
PCMCONSOLE username=user password=pass
open=Model1 calculate
Risultato: viene aperto il modello denominato Model1.
5.38 Arresta l'elaborazione per un certo periodo (pause)
Descrizione
• Arresta l'esecuzione dei parametri del file di comandi per il numero di minuti specificato. L'esecuzione
del comando può essere ritardata inserendo un comando di pausa nello script della console.
• La pausa viene eseguita immediatamente, ovvero l'esecuzione dello script viene interrotta nel
momento in cui il comando pause viene inviato.
Uso:
• pause=[minuti]
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
[minuti]
Facoltativo
Il numero di minuti di pausa prima dell'esecuzione del comando successivo
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Arresta l'elaborazione per un certo periodo.
2. Immettere il numero di minuti di pausa prima dell'esecuzione del comando successivo.
63
2012-09-26
Comandi della Console disponibili
5.39 Anteponi data e ora (prefixdate)
Descrizione
• Inserisce un'indicazione di data e ora prima di ogni comando eseguito come parte del file di comandi.
Tale indicazione viene visualizzata nella schermata della console (prompt DOS o riquadro comandi)
oppure registrata nel file di registro eventualmente specificato (vedere il comando “Registra tutti gli
eventi in un file di testo”).
• È possibile emettere questo comando in qualsiasi posizione nel file di comandi o nella riga di comandi,
ma viene applicato a tutte le azioni, ovvero a tutte le azioni viene aggiunto un prefisso).
Uso:
• prefixdate
Non sono associati parametri a questo comando.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Anteponi data e ora.
Esempio:
PCMCONSOLE username=user password=pass
open=Model databridgeimport=c:\ADBImportspec.ctf prefixdate
log=c:\MyLog.txt
Risultato: importa dati in un modello esistente utilizzando un file di controllo Data Bridge e registra
l'intervallo di tempo necessario per l'operazione.
Argomenti correlati
• Registra tutti gli eventi in un file di testo (log)
5.40 Rimuovi tutti i risultati degli utenti (removeuserresults)
Descrizione
• Per tutti gli ID esportazione personali dell'utente corrente, consente di rimuovere risultati in tutti i
modelli ed eventualmente di eliminare anche gli ID esportazione.
• Per poter eseguire questo comando, è necessario aprire prima un modello nel file di comando della
console per convalidare l'utente. In ogni caso, i risultati vengono rimossi tra tutti i modelli,
indipendentemente dal modello aperto.
64
2012-09-26
Comandi della Console disponibili
Uso:
• removeuserresults=<removeWhat>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametri
Obbligatorio/facoltativo
Descrizione
<removeWhat> Obbligatorio
I valori consentiti sono:
• RESULTS: per rimuovere solo i risultati.
• RESULTS_AND_MAPPING: per rimuovere i risultati ed eliminare gli ID esportazione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Rimuovi tutti i risultati degli utenti.
2. Nell'elenco Tipo di comando selezionare Solo risultati o Risultati e ID esportazione.
Esempio:
PCMCONSOLE username=administrator password=administrator open=Model removeuserresults=RESULTS_AND_MAPPING
Risultato: l'utente amministratore apre un modello, elimina tutti gli ID esportazione personali e rimuove
eventuali risultati associati in tutti i modelli.
5.41 Rimuovi risultati per ID esportazione (removeresultsbyexportid)
Descrizione
• Per uno specifico ID esportazione, consente di rimuovere risultati in tutti i modelli ed eventualmente
di eliminare anche l'ID esportazione.
Nota:
non è possibile eliminare l'ID esportazione condiviso predefinito 1, sebbene sia possibile rimuoverne
i risultati.
•
Per poter eseguire questo comando, è necessario aprire prima un modello nel file di comando della
console per convalidare l'utente. In ogni caso, i risultati per l'ID esportazione vengono rimossi tra
tutti i modelli, indipendentemente dal modello aperto.
Uso:
• removeresultsbyexportid=<exportId>,<removeWhat>
I seguenti parametri possono essere utilizzati con questo comando:
65
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<exportId>
Obbligatorio
<removeWhat> Obbligatorio
L'ID esportazione da utilizzare.
I valori consentiti sono:
• RESULTS: per rimuovere solo i risultati.
• RESULTS_AND_MAPPING: per rimuovere i risultati ed eliminare l'ID esportazione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Rimuovi risultati per ID esportazione.
2. Nella casella di selezione ID esportazione immettere o selezionare l'ID esportazione.
3. Nell'elenco Tipo di comando selezionare Solo risultati o Risultati e ID esportazione.
Esempio:
PCMCONSOLE username=user password=pass open=Model removeresultsbyexportid=13456,RESULTS
Risultato: apre un modello e rimuove i risultati in tutti i modelli per l'ID esportazione 13456. L'ID
esportazione resta disponibile per poter essere utilizzato in altre esportazioni.
5.42 Rimuovi risultati in base a nome di esportazione (removeresultsbyexportname)
Descrizione
• Consente di fornire il nome di un ID esportazione allo scopo di rimuoverne i risultati in tutti i modelli
ed eventualmente di eliminare anche l'ID esportazione. È anche possibile specificare se si tratta di
un ID esportazione personale o condiviso.
Nota:
non è possibile eliminare l'ID esportazione condiviso predefinito 1, denominato Default sebbene sia
possibile rimuoverne i risultati.
•
Per poter eseguire questo comando, è necessario aprire prima un modello nel file di comando della
console per convalidare l'utente. In ogni caso, i risultati per l'ID esportazione vengono rimossi tra
tutti i modelli, indipendentemente dal modello aperto.
Uso:
• removeresultsbyexportname=<exportName>,<whatGroup>,<removeWhat>
I seguenti parametri possono essere utilizzati con questo comando:
66
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<exportName> Obbligatorio
Il nome dell'ID esportazione.
<whatGroup>
I valori consentiti sono:
• SHARED: per un ID esportazione condiviso.
• USER: per un ID esportazione personale.
Obbligatorio
<removeWhat> Obbligatorio
I valori consentiti sono:
• RESULTS: per rimuovere solo i risultati.
• RESULTS_AND_MAPPING: per rimuovere i risultati ed eliminare l'ID esportazione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Rimuovi risultati in base a nome di esportazione.
2. Immettere il nome dell'ID esportazione in Nome esportazione.
3. Nell'elenco Esporta gruppo selezionare Condiviso o Utente.
4. Nell'elenco Tipo di comando selezionare Solo risultati o Risultati e ID esportazione.
Esempio:
PCMCONSOLE username=administrator password=administrator open=Model removeresultsbyexportname=UserEx
port,USER,RESULTS
Risultato: l'utente amministratore apre un modello e rimuove i risultati in tutti i modelli per l'ID
esportazione personale denominato UserExport. L'ID esportazione resta disponibile per poter essere
utilizzato in altre esportazioni.
5.43 Rimuovi risultati per ID esportazione corrente (removeresultsbycurrentexportid)
Descrizione
• Per l'ID esportazione corrente, consente di rimuovere risultati in tutti i modelli ed eventualmente di
eliminare anche l'ID esportazione.
Nota:
non è possibile eliminare l'ID esportazione condiviso predefinito 1, sebbene sia possibile rimuoverne
i risultati.
•
Per poter eseguire questo comando, è necessario aprire prima un modello nel file di comando della
console per convalidare l'utente. In ogni caso, i risultati per l'ID esportazione vengono rimossi tra
tutti i modelli, indipendentemente dal modello aperto.
Uso:
67
2012-09-26
Comandi della Console disponibili
•
removeresultsbycurrentexportid=<removeWhat>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametri
Obbligatorio/facoltativo
Descrizione
<removeWhat> Obbligatorio
I valori consentiti sono:
• RESULTS: per rimuovere solo i risultati.
• RESULTS_AND_MAPPING: per rimuovere i risultati ed eliminare l'ID esportazione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Rimuovi risultati per ID esportazione corrente.
2. Nell'elenco Tipo di comando selezionare Solo risultati o Risultati e ID esportazione.
Esempio:
PCMCONSOLE username=user password=pass open=Model useexportid=1 removeresultsbycurrentexportid=RESULTS
Risultato: apre un modello e specifica l'ID esportazione 1 corrente per rimuovere i risultati in tutti i
modelli.
5.44 Rinomina per ID esportazione (renameexportid)
Descrizione
• Consente di modificare il nome di un ID esportazione specificato.
• Per poter eseguire questo comando, è necessario aprire prima un modello nel file di comando della
console per convalidare l'utente.
Uso:
• renameexportid=<exportId>,<newName>
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<exportId>
Obbligatorio
L'ID esportazione da rinominare.
<newName>
Obbligatorio
Il nuovo nome.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
68
2012-09-26
Comandi della Console disponibili
1. Nell'elenco Tipo di comando selezionare Rinomina per ID esportazione.
2. Nella casella di selezione ID esportazione immettere o selezionare l'ID esportazione.
3. Immettere il nuovo nome dell'ID esportazione in Nuovo nome esportazione.
Esempio:
PCMCONSOLE username=user password=pass open=Model renameexportid=10,SharedExportID
Risultato: apre un modello e modifica il nome dell'ID esportazione 10 in SharedExportID.
5.45 Rinomina per nome esportazione (renameexport)
Descrizione
• Consente di modificare il nome di un ID esportazione specificandolo e indicando se si tratta di un
ID esportazione personale o condiviso.
• Per poter eseguire questo comando, è necessario aprire prima un modello nel file di comando della
console per convalidare l'utente.
Uso:
• renameexport=<exportName>,<whatGroup>,<newName>
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<exportName> Obbligatorio
Il nome dell'ID esportazione da modificare.
<whatGroup>
Obbligatorio
I valori consentiti sono:
• SHARED: per un ID esportazione condiviso.
• USER: per un ID esportazione personale.
<newName>
Obbligatorio
Il nuovo nome.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Rinomina per nome esportazione.
2. Immettere il nome dell'ID esportazione in Nome esportazione.
3. Nell'elenco Esporta gruppo selezionare Condiviso o Utente.
4. Immettere il nuovo nome dell'ID esportazione in Nuovo nome esportazione.
Esempio:
PCMCONSOLE username=user password=pass open=Model renameexport=SharedExportID,SHARED,SharedExportID_Renamed
69
2012-09-26
Comandi della Console disponibili
Risultato: apre un modello e modifica il nome dell'ID esportazione condiviso SharedExportID in Sha
redExportID_Renamed.
5.46 Rinomina modello (renamemodel)
Descrizione:
• Consente di rinominare il modello specificato.
Nota:
il nuovo nome modello deve essere univoco e non contenere caratteri non consentiti.
•
Se la ridenominazione non è possibile, ad esempio se il modello è ancora aperto, la Console continua
a tentare di rinominare il modello per il numero di minuti di timeout specificato prima di notificare
che la ridenominazione non è riuscita. Se durante il periodo di attesa il modello viene chiuso, allora
viene rinominato e il file di comando prosegue normalmente.
Uso:
• renamemodel=<modelloOrigine>,<modelloDest>,[timeoutValue]
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
<modelloOrigine>
Obbligatorio/facoltativo
Descrizione
Obbligatorio
Il nome attuale del modello da rinominare
<modelloDest> Obbligatorio
Il nuovo nome per il modello.
[timeoutValue] Facoltativo
Il numero di minuti durante i quali la Console dovrebbe continuare
a tentare di rinominare il modello Il valore predefinito è 0.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Rinomina modello.
2. Nel Nome del modello di origine immettere il nome esistente del modello.
3. Nel Nome del modello di destinazione immettere il nuovo nome del modello.
4. In Timeout (minuti) selezionare il numero di minuti durante i quali la Console dovrebbe continuare
a tentare di rinominare il modello.
70
2012-09-26
Comandi della Console disponibili
5.47 Esegui importazione Data Bridge (databridgeimport)
Descrizione
• Questo comando esegue un file di controllo di Data Bridge (*.CTF) per importare dati nel modello
attualmente aperto. È necessario specificare il percorso completo al file a meno che quest'ultimo
non si trovi nella directory di lavoro corrente.
• Se necessario, specifica se consentire la creazione di una nuova struttura che non esiste nel modello.
Nota:
Se è necessario un maggiore controllo dell'importazione dei dati, fare riferimento a Data Bridge User
Guide per informazioni sull'utility di automazione DBCONS di Data Bridge.
Uso:
• databridgeimport=<nomefile>,[allowCreate]
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<nomefile>
Obbligatorio
Nome del file (*.CTF) da importare.
[allowCreate]
Facoltativo
Il valore YES consente di creare una nuova struttura che non è
già esistente nel modello (impostazione predefinita). Il valore NO
non consente la creazione della nuova struttura.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Esegui importazione Data Bridge.
2. Immettere il nome del file (*.CTF) da importare.
3. Selezionare la casella di controllo Consenti creazione struttura per consentire la creazione della
nuova struttura non ancora esistente nel modello.
Esempio:
PCMCONSOLE username=user password=pass
open=Model databridgeimport=c:\ADBImportspec.ctf prefixdate
log=c:\MyLog.txt
Risultato: importa dati in un modello esistente utilizzando un file di controllo Data Bridge e registra
l'intervallo di tempo necessario per l'operazione.
71
2012-09-26
Comandi della Console disponibili
5.48 Invia evento di Work Manager (wmsendevent)
Descrizione
• Consente di inviare il nome dell'evento all'istanza del processo di Work Manager in modo da poter
monitorare l'avanzamento.
Uso:
• wmsendevent=<nomeEvento>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
<nomeEvento>
Obbligatorio
Nome evento
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Invia evento di Work Manager.
2. Immettere il nome dell'evento di Work Manager.
Argomenti correlati
• Comandi di Work Manager
5.49 Imposta password (password)
Descrizione
• Consente di impostare la password per l'account utente di Profitability and Cost Management
specificato. Quando si utilizza questo parametro, è necessario impostare anche un nome utente
(Vedere “Imposta nome utente”). Per l'utilizzo in un ambiente protetto, vedere “Password crittografata”.
Uso:
• password=<password>
Con questo comando è possibile utilizzare i seguenti parametri:
72
2012-09-26
Comandi della Console disponibili
Parametro
Obbligatorio/facoltativo
Descrizione
<password>
Obbligatorio
Password
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Imposta password.
2. Immettere la Password.
Argomenti correlati
• Password crittografata (encryptedpassword)
• Imposta nome utente (username)
5.50 Imposta nome utente (username)
Descrizione
• Imposta l'account utente di Profitability and cost management le cui credenziali verranno utilizzate
per eseguire azioni (come aprire un modello). Una password deve essere definita per questo utente.
Nota:
Single Sign On non è disponibile per la console. Se si opera in un ambiente BusinessObjects
Enterprise, non è consentito l'utilizzo delle credenziali di accesso di un utente BusinessObjects
Enterprise importato ed è necessario creare un utente Profitability and Cost Management valido. In
alternativa, è possibile convertire un utente BusinessObjects Enterprise importato scegliendo
Reimposta password in Generatore modelli (selezionando Strumenti > Protezione > Utenti e
gruppi). In questo modo si imposta una password Profitability and Cost Management, che consente
l'utilizzo del nome utente anche nella console.
Uso:
•
username=<nomeutente>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
<nomeutente>
Obbligatorio
Il nome dell'utente
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Imposta nome utente.
2. Immettere il nome utente.
73
2012-09-26
Comandi della Console disponibili
Esempio:
PCMCONSOLE username=User1 password=pass open=BIKES
Risultato: consente di aprire un modello con utente denominato User1.
5.51 Ordina dimensione (sortdimension)
Descrizione
• Dispone gli elementi dimensione di una gerarchia di modelli in ordine alfabetico crescente o
decrescente nel modello attualmente aperto. Questo comando può essere utilizzato insieme al
comando databridgeimport quando è possibile produrre un elevato numero di elementi secondario
eseguendo un importazione Data Bridge.
Avvertenza:
l'ordinamento è permanente e, una volta applicato, NON è più possibile ripristinare quello precedente.
Uso:
• sortdimension=<Dimensione>,<AliasDati>,<DirezioneOrdinamento>
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo
Descrizione
<Dimensione>
Obbligatorio
La dimensione da ordinare per questo comando
<AliasDati>
Obbligatorio
L'alias dati in base al quale ordinare la dimensione
Nota:
non è possibile ordinare in base all'alias EPO CODE
<DirezioneOrdi- Obbligatorio
namento>
La direzione di ordinamento delle dimensioni, ad esempio crescente.
I valori consentiti sono ASC e DESC.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Selezionare Ordina dimensione nell'elenco Tipo di comando.
2. Immettere la dimensione che si desidera ordinare nella casella Dimensione.
3. Immettere l'alias dati in base al quale effettuare l'ordinamento nella casella Alias dati.
4. Selezionare Ordinamento crescente oppure Ordinamento decrescente per specificare il tipo di
ordinamento.
74
2012-09-26
Comandi della Console disponibili
Argomenti correlati
• Esegui importazione Data Bridge (databridgeimport)
5.52 Cambia connessione al sistema (switchsystemconnection)
Descrizione
• Passa il controllo a un sistema utilizzando il nome specificato. La connessione a questo sistema è
già stata creata durante l'esecuzione del file di comando della console corrente.
Uso:
• switchsystemconnection=<systemConnectionName>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
<systemConnectionName>
Obbligatorio/facoltativo
Descrizione
Obbligatorio
Il nome del sistema a cui viene passata la connessione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Cambia connessione al sistema.
2. Immettere il Nome connessione al sistema.
Esempio:
Un file INI di esempio della console:
createSystemConnection=devserver username=user password=pass loginserver=devserv1
;
createSystemConnection=testserver username=user password=pass loginserver=testserv2
;
switchSystemConnection=devserver
Risultato:
1. Risultato: crea una connessione di sistema denominata devserver ed esegue l'accesso con il nome
utente “user” e la password “pass” al server devserv1.
2. Crea una seconda connessione di sistema denominata testserver e accede al server testserv2.
3. Passa di nuovo il controllo al sistema devserver.
75
2012-09-26
Comandi della Console disponibili
5.53 Modello di trasporto da un sistema all'altro (transportmodel)
Descrizione
• Quando si sposta un modello da un sistema all'altro (ad esempio da un sistema di sviluppo a uno
di test oppure da un sistema di test a uno di produzione), è necessario eseguire una serie di passaggi
nei due sistemi coinvolti. Questo comando automatizza la procedura eseguendo alcuni di questi
passaggi e consentendo di eseguire l'intero processo tramite un file dei comandi della Console.
• Prima di eseguire il comando transportmodel in un file dei comandi, è necessario includere i
passaggi nel flusso di lavoro per creare le connessioni e accedere ai sistemi di origine e di
destinazione. Per questo scopo è necessario utilizzare i comandi createSystemConnection e
loginserver (vedere l'esempio).
• Il comando transportmodel esegue le azioni seguenti:
1. Passa il controllo al sistema di origine.
2. Apre il modello specificato nel sistema di origine.
3. Esporta il modello di origine nel file di esportazione temporaneo specificato. Il file di esportazione
è di tipo XML e si trova nel computer in cui è in esecuzione il client della Console. Il processo
può anche utilizzare un file di specifiche di esportazione (ESP) che definisce quali elementi del
modello esportare.
Nota:
si consiglia di definire un file di specifiche per l'esportazione (utilizzando la funzione Esporta nel
generatore modelli), in quanto l'opzione predefinita ALL_TABLES esporta tutto. Le tabelle dei
risultati non devono essere esportate poiché non vengono importate e questa operazione
risulterebbe estremamente lunga per i modelli di grandi dimensioni.
4. Passa il controllo al sistema di destinazione.
5. Crea e apre il modello specificato nel sistema di destinazione.
6. Importa il contenuto del file di esportazione nel modello specificato nel sistema di destinazione.
Se si verifica un errore in qualsiasi passo dell'esecuzione del comando, la Console si interrompe in
tale punto. Viene generato un errore se il nuovo modello esiste già, tuttavia è possibile impostare
un'opzione per ignorare questo errore e proseguire l'esecuzione.
Nota:
il modello di origine non viene modificato dal comando transportmodel. Dopo l'esecuzione del
comando transportmodel, è possibile trovare il file di esportazione temporaneo nel server in cui è
in esecuzione il client della Console.
Suggerimento:
può essere utile includere il comando Information nel file dei comando per semplificare l'individuazione
dello stato del modello e delle connessioni di sistema.
Uso:
• transportmodel=<srcSystemConnectionName>,<srcModelName>,<destSystemConne
ctionName>,<destModelName>,[specificationFile],<temporaryExportFile
name>,[ignoreModelDoesExistError]
76
2012-09-26
Comandi della Console disponibili
I seguenti parametri possono essere utilizzati con questo comando:
Parametri
Obbligatorio/facoltativo Descrizione
<srcSystemConnec- Obbligatorio
tionName>
Il nome del sistema di origine.
<srcModelName>
Il nome del modello esistente da trasportare dal sistema di origine.
Obbligatorio
<destSystemConne- Obbligatorio
ctionName>
Il nome del sistema di destinazione.
<destModelName> Obbligatorio
Il nome del nuovo modello da creare nel sistema di destinazione.
[specificationFile]
Un file di specifiche di esportazione (*.ESP) predefinito che
determina quali elementi esportare. Se non viene specificato un
file, l'impostazione predefinita è ALL_TABLES, ovvero vengono
esportate tutte le tabelle.
Facoltativo
Nota:
l'esportazione di tutte le tabelle dei risultati per i modelli di grandi
dimensioni potrebbe richiedere molto tempo.
<temporaryExportFi- Obbligatorio
lename>
Un nome di file e un percorso validi per il file di esportazione
temporaneo.
[ignoreModelDoesExistError]
Il valore YES consente al comando di proseguire l'esecuzione
anche se si genera un errore poiché il modello esiste già. Il valore
predefinito è NO.
Facoltativo
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Modello di trasporto da un sistema all'altro.
2. Immettere il Nome connessione al sistema di origine.
3. Immettere il nome del modello di origine.
4. Immettere il Nome connessione al sistema di destinazione.
5. Immettere il nome del modello di destinazione.
6. In Nome file delle specifiche è possibile selezionare la posizione di un file di specifiche di
esportazione (ESP) che definisce i parametri di esportazione.
Nota:
si consiglia di definire un file di specifiche di esportazione specifico, in quanto l'impostazione
predefinita ALL_TABLES esporta tutto.
7. In Nome file esportazione temporaneo specificare il nome del file in cui eseguire l'esportazione.
Il tipo di file XML viene aggiunto al nome del file.
8. Selezionare la casella di controllo Ignora errore Il modello esiste già se si desidera che il comando
ignori l'errore se il modello esiste già.
77
2012-09-26
Comandi della Console disponibili
Esempio:
Un file INI di esempio della console:
createSystemConnection=devserver username=user password=pass loginserver=devserv1
;
createSystemConnection=testserver username=user password=pass loginserver=testserv2
;
transportmodel=devserver,source_model,testserver,new_model,c:\ExportSpec.esp,c:\temp\transport.export.xml,YES
Risultato:
1. Risultato: crea una connessione di sistema denominata devserver ed esegue l'accesso con il nome
utente “user” e la password “pass” al server devserv1.
2. Crea una seconda connessione di sistema denominata testserver e accede al server testserv2.
3. Trasporta il modello denominato source_model nel sistema devserver in un modello denominato
new_model nel sistema testserver. Utilizza il file di specifiche di esportazione c:\ExportSpec.esp
per determinare quali elementi esportare e la posizione c:\temp\transport.export.xml per
il file di esportazione temporaneo. Ignora qualsiasi errore se il modello new_model esiste già.
Argomenti correlati
• Crea connessione di sistema (createsystemconnection)
• Server di accesso (loginserver)
5.54 ID modello univoco (uniquemodelid)
Descrizione
• Consente di modificare la proprietà del modello ID modello univoco (UMID). Questo comando
consente agli utenti di monitorare e individuare i dati originati dall'applicazione Financial Information
Management, anche dopo che un modello è stato rinominato, copiato, importato o esportato.
Uso:
• uniquemodelid=<id>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
<id>
Obbligatorio
L' ID del modello univoco
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare ID modello univoco.
2. Immettere l'ID modello univoco (UMID).
78
2012-09-26
Comandi della Console disponibili
5.55 Scarica modello (unloadmodel)
Descrizione
• Consente di rimuovere la connessione al modello specificato. Il modello potrebbe rimanere aperto
se altri utenti vi sono attualmente connessi; in caso contrario, verrà chiuso.
• Utilizzare il comando unloadmodel per rimuovere una connessione creata con il comando load
model.
Uso:
• unloadmodel=<nomemodello>
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
<nomemodello>
Obbligatorio
Nome del modello con cui si desidera interrompere la
connessione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Scarica modello.
2. Immettere il nome del modello.
Argomenti correlati
• Carica modello (loadmodel)
5.56 Sblocca risultati (unlockresults)
Descrizione
• Consente di sbloccare la combinazione di Versione e Periodo specificata.
Uso:
• unlockresults=<versione>,<periodo>
I seguenti parametri possono essere utilizzati con questo comando:
79
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<versione>
Obbligatorio
Nome della versione.
<periodo>
Obbligatorio
Nome del periodo.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Sblocca risultati.
2. Immettere la versione richiesta.
3. Immettere il periodo richiesto.
5.57 Aggiorna elenco calcoli periodo versione (updatevpcalculationlist)
Descrizione
• È necessario che il modello Transactional Costing sia aperto.
• Aggiorna la tabella PP_HVVERSIONPERIODCALCLIST, che contiene un elenco di combinazioni di
versioni/periodi per le quali occorre eseguire i calcoli dei costi transazionali. L'aggiornamento può
essere effettuato in uno di questi modi:
• Aggiungere una combinazione di versioni/periodi: la tabella PP_HVVERSIONPERIODCALCLIST
viene aggiornata in base alla combinazione selezionata. Quando successivamente si esegue
un calcolo transazionale, i risultati vengno generati per tale combinazione.
• Contrassegnare per l'eliminazione una combinazione di versioni/periodi: la combinazione
selezionata viene contrassegnata per l'eliminazione nella tabella PP_HVVERSIONPERIODCAL
CLIST. Quando successivamente si esegue il calcolo di un costo transazionale, i risultati non
vengono generati per tale combinazione e gli eventuali risultati esistenti per la combinazione
vengono eliminati.
Per ulteriori informazioni, consultare il Manuale dell'utente dei modelli di Profitability and Cost
Management.
Uso:
• updatevpcalculationlist=<versione>, <periodo>,<aggiungiA>
I seguenti parametri possono essere utilizzati con questo comando:
80
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<versione>
Obbligatorio
Nome della versione.
<periodo>
Obbligatorio
Nome del periodo.
<aggiungiA>
Obbligatorio
I valori consentiti sono ADD o DELETE, per specificare se aggiungere o contrassegnare per l'eliminazione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Aggiorna elenco calcoli periodo versione.
2. Immettere la versione richiesta.
3. Immettere il periodo richiesto.
4. Selezionare il pulsante di opzione Aggiungi o Elimina per indicare se aggiungere o rimuovere la
combinazione di versioni/periodi.
Esempio: Aggiungere una combinazione di versioni/periodi
username=administrator
password=administrator
open=TC Model
updatevpcalculationlist=actual,january,ADD
Esempio: Rimuovere una combinazione di versioni/periodi
username=administrator
password=administrator
open=TC Model
updatevpcalculationlist=actual,march,DELETE
5.58 Utilizza ID esportazione (useexportid)
Descrizione
• Specifica un ID esportazione esistente da utilizzare per un'esportazione di valori basati sui risultati.
• Per poter eseguire questo comando, è necessario aprire prima un modello nel file di comando della
console per convalidare l'utente.
Uso:
• useexportid=<exportId>
Con questo comando è possibile utilizzare i seguenti parametri:
81
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<exportId>
Obbligatorio
L'ID esportazione da utilizzare.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Utilizza ID esportazione.
2. Nella casella di selezione ID esportazione immettere o selezionare l'ID esportazione.
Esempio:
PCMCONSOLE username=user password=pass open=Model useexportid=100 exporttodb=D:\Data\ActCostObjectValue.esp
Risultato: apre un modello ed esporta i risultati nel database utilizzando l'ID esportazione esistente
100.
5.59 Utilizza tipo di ID esportazione (useexportidtype)
Descrizione
• Specifica per un'esportazione di valori basati sui risultati se utilizzare l'ID esportazione condiviso
predefinito 1 o se creare un nuovo ID esportazione personale per l'utente corrente. Nell'ultimo caso
l'ID esportazione viene impostato automaticamente su un valore maggiore di 10.000 ed è possibile
fornire un nome.
Nota:
Nel caso di un nuovo ID esportazione, le informazioni vengono memorizzate fino all'esecuzione di
un altro comando che le richieda. A quel punto viene creato l'ID esportazione.
Uso:
• useexportidtype=<whatType>,[name]
I seguenti parametri possono essere utilizzati con questo comando:
82
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<whatType>
Obbligatorio
I valori consentiti sono:
• USE_DEFAULT: per utilizzare l'ID esportazione condiviso
predefinito.
• USE_NEW: per creare e utilizzare un nuovo ID esportazione
personale.
[name]
Facoltativo
Il nome da utilizzare se si crea un nuovo ID esportazione.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Utilizza tipo di ID esportazione.
2. Nell'elenco Tipo di ID esportazione:
•
•
Per utilizzare l'ID esportazione condiviso predefinito 1, selezionare Predefinito.
Per creare e utilizzare un nuovo ID esportazione personale, selezionare Nuovo.
3. Se si crea un nuovo ID esportazione, immetterne il nome in Nome esportazione.
Esempio:
PCMCONSOLE username=user password=pass open=Model useexportidtype=USE_NEW,ExportName exporttodb=D:\Data\Act
CostObjectValue.esp
Risultato: viene aperto un modello e specificato un ID esportazione personale che deve essere creato
automaticamente dal sistema denominato ExportName. Viene quindi eseguito Esporta nel database,
che crea l'ID esportazione e lo utilizza per i risultati esportati.
5.60 Utilizza nome esportazione (useexportname)
Descrizione
• Specifica il nome di un ID esportazione esistente da utilizzare per un'esportazione di valori basati
sui risultati. È anche possibile specificare se si tratta di un ID esportazione personale o condiviso.
Se queste informazioni non vengono fornite e si utilizza lo stesso nome per l'ID esportazione
personale e quello condiviso, viene selezionato l'ID esportazione personale.
• Per poter eseguire questo comando, è necessario aprire prima un modello nel file di comando della
console per convalidare l'utente.
Uso:
• useexportname=<exportName>,[whatGroup]
I seguenti parametri possono essere utilizzati con questo comando:
83
2012-09-26
Comandi della Console disponibili
Parametri
Obbligatorio/facoltativo
Descrizione
<exportName> Obbligatorio
Il nome dell'ID esportazione.
[whatGroup]
I valori consentiti sono:
• SHARED: per utilizzare un ID esportazione condiviso.
• USER: per utilizzare un ID esportazione personale (predefinito).
Facoltativo
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Utilizza nome esportazione.
2. Immettere il nome dell'ID esportazione in Nome esportazione.
3. In Esporta gruppo selezionare Condiviso per utilizzare un ID esportazione condiviso oppure Utente
per utilizzare un ID esportazione personale.
Esempio:
PCMCONSOLE username=administrator password=administrator open=Model useexportname=UserExport,USER export
todb=D:\Data\ActCostObjectValue.esp
Risultato: l'utente amministratore apre un modello ed esporta i risultati nel database utilizzando un ID
esportazione personale esistente denominato UserExport.
5.61 Attendere. Lasciare il processo in esecuzione per un certo periodo (wait)
Descrizione
• Mantiene aperto un modello per il numero di minuti specificato. Se lo script termina senza questo
comando, il modello viene chiuso. Consente di impostare il tempo di attesa prima che venga eseguita
la procedura di arresto. È utile per mantenere aperto un modello per un determinato periodo di
tempo (fino a 24 ore).
• Il tempo di attesa non inizia dal momento in cui il comando wait viene inviato ma alla fine
dell'esecuzione di un comando della console. Ad esempio, se un comando calculate viene inviato
dopo il comando wait e l'operazione di calcolo dura un'ora, il comando wait inizia l'attesa dopo il
completamento del calcolo, ovvero un'ora dopo.
Uso:
• wait=<minuti>
Con questo comando è possibile utilizzare i seguenti parametri:
84
2012-09-26
Comandi della Console disponibili
Parametro
Obbligatorio/facoltativo
Descrizione
<minuti>
Obbligatorio
Il numero di minuti in cui Console rimane in esecuzione prima
dell'arresto.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Attendere. Lasciare il processo in esecuzione per un
certo periodo.
2. Immettere il numero di minuti in cui la Console rimane in esecuzione prima dell'arresto.
Esempio:
PCMCONSOLE username=user password=pass
open=Model calculate wait=240
Risultato: apre un modello, lo calcola e lo mantiene aperto per 4 ore.
5.62 Scrivi un messaggio (msg)
Descrizione
• Consente di visualizzare un messaggio di testo nella finestra DOS in cui viene eseguito il comando.
• Il messaggio appare come una riga di testo tra le informazioni visualizzate automaticamente dalla
Console.
Uso:
• msg=[messaggio]
Con questo comando è possibile utilizzare i seguenti parametri:
Parametro
Obbligatorio/facoltativo
Descrizione
[messaggio]
Facoltativo
Il messaggio di testo deve essere una stringa racchiusa tra virgolette, ma non deve includerne. Utilizzare solo virgolette singole.
In Impostazione guidata console, nella finestra di dialogo "Proprietà comando", procedere come descritto
di seguito:
1. Nell'elenco Tipo di comando selezionare Scrivi un messaggio.
2. Immettere il messaggio da visualizzare.
85
2012-09-26
Comandi della Console disponibili
86
2012-09-26
Messaggi di errore della Console
Messaggi di errore della Console
I messaggi di testo di errore della console sono generati nel formato ERRORE - n, dove il numero n
indica il tipo di comando dell'istruzione non riuscita, come indicato nella tabella seguente.
87
Numero
Nome del comando
0
Nessuno
1
Imposta nome utente
2
Imposta password
3
Password crittografata
4
Elimina modello
5
Apri modello
6
Crea nuovo modello
7
Crea nuovo modello
8
Imposta Id di Work Manager
9
Invia evento di Work Manager
10
Importa file XML nel modello
11
Calcola modello
12
Esporta modello nel file
13
Registra tutti gli eventi in un file di testo
14
Opzione Esporta nel database
15
File di comando
16
Attendere. Lasciare il processo in esecuzione per un certo periodo.
17
Scrivi un messaggio
18
Arresta l'elaborazione per un certo periodo
19
Carica valori memorizzati
20
Anteponi data e ora
21
Esegui importazione Data Bridge
22
Calcolo automatico
2012-09-26
Messaggi di errore della Console
88
Numero
Nome del comando
23
Esporta risultati
24
Blocca risultati
25
Sblocca risultati
26
Cancella risultati bloccati
27
Carica dati dei volumi
28
Calcola costi transazionali
29
Aggiorna elenco calcoli periodo versione
30
Cancella elenco calcoli periodo versione
31
Carica solo calcoli TC
32
Esegui routine di caricamento dati
33
Connetti a Work Manager
34
Elimina file di comandi dopo l'utilizzo
35
Copia modello
36
Descrizione modello
37
Server modelli
38
Rinomina modello
39
Chiudi modello
40
Comando Carica modello
41
Scarica modello
42
Controllo attivato
43
Modello attivato
44
ID modello univoco
45
Chiusura sessione
46
Esporta vista
47
Ordina dimensione
48
Server di accesso
49
Passport
50
Opzione modello
51
Informazioni
52
Crea connessione di sistema
53
Cambia connessione al sistema
2012-09-26
Messaggi di errore della Console
89
Numero
Nome del comando
54
Modello di trasporto da un sistema all'altro
55
Utilizza tipo di ID esportazione
56
Crea ID esportazione condiviso
57
Crea nome esportazione condiviso
58
Utilizza ID esportazione
59
Utilizza nome esportazione
60
Rimuovi risultati per ID esportazione
61
Rimuovi risultati per ID esportazione corrente
62
Rimuovi risultati in base a nome di esportazione
63
Rimuovi tutti i risultati degli utenti
64
Rinomina per ID esportazione
65
Rinomina per nome esportazione
2012-09-26
Messaggi di errore della Console
90
2012-09-26
Ulteriori informazioni
Ulteriori informazioni
Informazioni
Posizione
Informazioni sul prodotto SAP BusinessObjects
http://www.sap.com
Passare a http://help.sap.com/businessobjects/ e nel pannello laterale
"SAP BusinessObjects Overview" fare clic su All Products.
SAP Help Portal
Nel portale della Guida in linea SAP è possibile accedere alla documentazione più aggiornata riguardante tutti i prodotti SAP BusinessObjects
e la relativa distribuzione. È possibile scaricare le versioni PDF o le librerie
HTML installabili.
Alcuni manuali sono memorizzati nel SAP Service Marketplace e non
sono disponibili nel SAP Help Portal. Questi manuali sono elencati
nell'Help Portal accompagnati da un collegamento al SAP Service Marketplace. I clienti con contratto di manutenzione dispongono di un ID
utente autorizzato per l'accesso a questo sito. Per ottenere un ID, contattare il rappresentante del supporto tecnico.
http://service.sap.com/bosap-support > Documentazione
•
•
SAP Service Marketplace
Guide all'installazione: https://service.sap.com/bosap-instguides
Note sulla versione: http://service.sap.com/releasenotes
Nel SAP Service Marketplace sono memorizzati alcuni documenti dei
seguenti tipi: guide all'installazione, manuali di aggiornamento e migrazione, manuali della distribuzione in rete, note sulla versione e documenti relativi alle piattaforme supportate. I clienti con contratto di manutenzione dispongono di un ID utente autorizzato per l'accesso a questo sito.
Per ottenere un ID, contattare il rappresentante del supporto tecnico. Se
si viene reindirizzati al SAP Service Marketplace dal SAP Help Portal,
utilizzare il menu nel riquadro di spostamento sulla sinistra per individuare
la categoria contenente la documentazione a cui si desidera accedere.
https://cw.sdn.sap.com/cw/community/docupedia
Docupedia
91
Docupedia fornisce ulteriori risorse di documentazione, un ambiente di
creazione collaborativo e un canale di feedback interattivo.
2012-09-26
Ulteriori informazioni
Informazioni
Posizione
https://boc.sdn.sap.com/
Risorse per lo sviluppatore
https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary
Articoli su SAP BusinessObjects
relativi a SAP Community Network
https://www.sdn.sap.com/irj/boc/businessobjects-articles
Questi articoli erano conosciuti in precedenza come schede tecniche.
https://service.sap.com/notes
Note
Queste note erano conosciute in precedenza come articoli di knowledge
base.
Forum su SAP Community Network
https://www.sdn.sap.com/irj/scn/forums
http://www.sap.com/services/education
Formazione
I pacchetti di formazione disponibili variano dal tradizionale apprendimento in classe ai seminari di e-learning mirati e sono in grado di soddisfare
qualsiasi esigenza e stile di apprendimento.
http://service.sap.com/bosap-support
Supporto tecnico in linea
SAP Support Portal contiene informazioni sui programmi e i servizi del
supporto tecnico. Inoltre, contiene collegamenti a una vasta gamma di
informazioni tecniche e download. I clienti con contratto di manutenzione
dispongono di un ID utente autorizzato per l'accesso a questo sito. Per
ottenere un ID, contattare il rappresentante del supporto tecnico.
http://www.sap.com/services/bysubject/businessobjectsconsulting
Consulenza
92
I consulenti sono a disposizione dei clienti dalla fase di analisi iniziale fino
alla consegna del progetto di distribuzione. Possono essere fornite co
nsulenze su argomenti quali i database relazionali e multidimensionali,
la connettività, gli strumenti di progettazione del database e la tecnologia
di incorporamento personalizzata.
2012-09-26
Indice
A
Aggiorna elenco calcoli periodo
versione 80
Anteponi data e ora 64
Apri 62
Apri modello 62
arresta 63
Arresta l'elaborazione per un certo
periodo 63
Attendere. Lasciare il processo in
esecuzione per un certo periodo
84
auditenabled 26
automaticcalculation 26
B
Blocca risultati 53
C
Calcola costi transazionali 27
Calcola Modello 27
Calcolo automatico 26
calculate 27
calculatetransactionalcosts 27
Cambia connessione al sistema 75
Cancella elenco calcoli periodo
versione 29
Cancella risultati bloccati 29
Carica dati dei volumi 52
Carica modello 50
Carica solo calcoli TC 52
Carica valori memorizzati 51
Chiudi modello 30
clearlockedresults 29
clearvpcalculationlist 29
closemodel 30
cmdfile 30
comandi
da aggiungere 16
file di comando 12
WMCONNECT 13
WMSENDEVENT 13
Commento 31
Connetti a Work Manager 32
console 9
Esecuzione 9
Controllo attivato 26
Copia modello 32
93
copymodel 32
Crea connessione di sistema 36
Crea ID esportazione condiviso 35
Crea nome esportazione condiviso 35
Crea nuovo modello 33
createsharedexportid 35
createsharedexportname 35
createsystemconnection 36
L
loadmodel 50
loadstoredvalues 51
loadtccalconly 52
loadvolumedata 52
lockresults 53
loginserver 55
D
databridgeimport 71
Descrizione modello 57
disconnessione 55
E
Elimina modello 37
eliminazione 37
errori 11
Esegui importazione Data Bridge 71
Esegui routine di caricamento dati 39
Esporta modello nel file 41
Esporta nel database 45
Esporta risultati 44
Esporta vista 46
esportazione 41
executedlroutines 39
exportresults 44
exporttodb 45
exportview 46
F
file di comando 30
anteprima 17
creazione 16
test 17
formattazione comandi 12
I
ID modello univoco 78
importa 48
Importa file XML nel modello 48
Imposta nome utente 73
Imposta password 72
information 49
Informazioni 49
Invia evento di Work Manager 72
M
messaggi di testo di errore 87
modeldescription 57
modelenabled 57
Modello attivato 57
Modello di trasporto da un sistema
all'altro 76
modeloption 58
modelserver 62
msg 85
N
newmodel 33
nome utente 73
O
Opzione modello 58
Ordina dimensione 74
P
parametri dei comandi, definizione
nella procedura guidata console 16
parametri di comando 19
password 72
password crittografata 38
prefixdate 64
procedura guidata console 15
Proprietà 11
R
Registra tutti gli eventi in un file di testo
54
registro 54
removeresultsbycurrentexportid 67
2012-09-26
Indice
removeresultsbyexportid 65
removeresultsbyexportname 66
removeuserresults 64
renameexport 69
renameexportid 68
renamemodel 70
Rimuovi risultati in base a nome di
esportazione 66
Rimuovi risultati per ID esportazione
65
Rimuovi risultati per ID esportazione
corrente 67
Rimuovi tutti i risultati degli utenti 64
rinomina modello 70
Rinomina per ID esportazione 68
Rinomina per nome esportazione 69
Sblocca risultati 79
Scarica modello 79
Scrivi un messaggio 85
Server di accesso 55
Server modelli 62
sortdimension 74
switchsystemconnection 75
unloadmodel 79
unlockresults 79
updatevpcalculationlist 80
useexportid 81
useexportidtype 82
useexportname 83
Utilizza ID esportazione 81
Utilizza nome esportazione 83
Utilizza tipo di ID esportazione 82
T
W
transportmodel 76
wait 84
wmconnect 32
wmsendevent 72
S
U
uniquemodelid 78
94
2012-09-26