Per automatizzare la versione cloud o on-premise di IBM TM1® come parte di una catena, aggiungere una fase che includa un comando di connessione a IBM® Planning Analytics. Ad esempio:
- Automatizzare le operazioni e i processi di TM1
- Interrogare i file di log di TM1
- Scambio bidirezionale di dati con una serie di applicazioni, tra cui database relazionali, Workday®, NetSuite®, Namely® e Salesforce®
Per abilitare questi comandi, un amministratore IT deve innanzitutto creare un connettore IBM Planning Analytics TM1.
Attivare un compito
Per attivare un lavoro di routine, utilizzare il comando Attivare un lavoro di routine.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del compito | Inserire il nome del ciclo da attivare. |
Uscite
Nessuno
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Disattivare un compito
Per disattivare un lavoro di routine, utilizzare il comando Disattivare un lavoro di routine.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del compito | Immettere il nome dell'attività da disattivare. |
Uscite
Nessuno
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Cancellare un compito
Per eliminare un lavoro di routine, utilizzare il comando Eliminare un lavoro di routine.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del compito | Immettere il nome del core da eliminare. |
Uscite
Nessuno
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Cancellare un cubo
Per eliminare un cubo, utilizzare il comando Elimina un cubo.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del cubo | Inserire il nome del cubo da eliminare. |
Uscite
Nessuno
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Cancellare una vista cubo
Per eliminare una vista cubo, utilizzare il comando Elimina una vista cubo.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del cubo | Inserire il nome del cubo da cui cancellare. |
| Visualizza il nome | Inserire il nome della vista da eliminare. |
Uscite
Nessuno
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Eliminare un processo
Per eliminare un processo in TM1, utilizzare il comando Elimina un processo.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del processo | Inserire il nome del processo. |
Uscite
Nessuno
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Eseguire un compito
Per eseguire un lavoro in TM1, utilizzare il comando Execute a chore.
Nota: Per eseguire un lavoro manuale, non attivarlo.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del compito | Inserire il nome dell'operazione da eseguire. |
Uscite
Nessuno
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Eseguire un processo
Per eseguire un processo in TM1, utilizzare il comando Esegui un processo.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del processo | Inserite il nome del processo da eseguire. |
| Parametri del processo | Immettere i parametri con cui eseguire il processo. |
Uscite
Nessuno
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
| 10 | Errore | Parametro non valido |
| 53 | Errore | Il processo non è stato eseguito |
| 55 | Errore | Il processo non è stato eseguito |
Eseguire MDX
Per eseguire una funzione di espressione multidimensionale (MDX) ed esportarla in un CSV, utilizzare il comando Execute MDX.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Funzione MDX | Inserire la funzione MDX da eseguire. |
| Tipo di uscita | Selezionare il formato del file CSV generato. |
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Dati delle cellule | File |
| ID del gruppo di celle | Stringa |
| Totale cellule trattate | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Filtrare i log dei messaggi
Per elencare i registri dei messaggi del server, utilizzare il comando Filter message logs.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Data di inizio | Inserire il filtro della data di inizio dei registri. |
| Data di fine | Inserire il filtro della data di fine dei registri. |
| Risultati massimi | Inserire il numero massimo di voci di registro da recuperare. |
Uscite
| Uscita | Tipo di uscita |
|---|---|
| File di registro | File |
| Conteggio delle voci del registro | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Filtrare i registri delle transazioni
Per elencare i registri delle transazioni del server, utilizzare il comando Filter transaction logs.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Data di inizio | Inserire il filtro della data di inizio dei registri. |
| Data di fine | Inserire il filtro della data di fine dei registri. |
| Risultati massimi | Inserire il numero massimo di voci di registro da recuperare. |
| Filtro a cubo | Immettere i criteri di filtro per il cubo per il quale recuperare i registri delle transazioni. |
| Filtro utente | Immettere i criteri di filtro per l'utente per cui recuperare i registri delle transazioni. |
Uscite
| Uscita | Tipo di uscita |
|---|---|
| File di registro | File |
| Conteggio delle voci del registro | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Ottenere i log degli errori di processo
Per recuperare un file ZIP dei registri degli errori di processo, utilizzare il comando Get process error logs.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Data di inizio | Inserire il filtro della data di inizio dei registri. |
| Data di fine | Inserire il filtro della data di fine dei registri. |
| Nome del processo | Inserire il nome del processo. |
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Registri zippati | File |
| Conteggio dei file di registro | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Elencare i compiti delle faccende domestiche
Per elencare i compiti disponibili in un core, utilizzare il comando List chore tasks.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del compito | Inserire il nome dell'attività da elencare. |
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Fasi dell'attività di routine | Array |
| Conteggio delle attività di routine | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Elenco delle faccende domestiche
Per elencare i lavori di pulizia disponibili, utilizzare il comando List chores.
Proprietà
Nessuno
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Nomi dei compiti | Array |
| Impostazioni attive del core | Array |
| Conteggio dei compiti | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Elenco delle dimensioni del cubo
Per elencare le dimensioni di un cubo, utilizzare il comando List cube dimensions.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del cubo | Inserire il nome del cubo di cui elencare le dimensioni. |
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Nomi delle dimensioni | Array |
| Dimensione nomi unici | Array |
| Conteggio delle dimensioni | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Elenco delle viste del cubo
Per elencare le viste di un cubo, utilizzare il comando List cube views.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del cubo | Inserire il nome del cubo di cui elencare le viste. |
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Visualizza i nomi | Array |
| Visualizza il conteggio | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Elenco cubi
Per elencare i cubi, utilizzare il comando List cubes.
Proprietà
Nessuno
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Nomi dei cubi | Array |
| Conteggio dei cubi | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Elenco dei processi
Per elencare i processi disponibili, utilizzare il comando List processes.
Proprietà
Nessuno
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Nomi dei processi | Array |
| Conteggio del processo | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Elenco utenti
Per elencare gli utenti del server TM1, utilizzare il comando List users.
Proprietà
Nessuno
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Nomi univoci degli utenti | Array |
| Nomi utente | Array |
| Tipi di utenti | Array |
| Utente abilitato | Array |
| Utenti attivi | Array |
| Conteggio degli utenti | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Leggi le celle di visualizzazione
Per generare un CSV con le gerarchie come intestazioni di tutti i valori delle celle di una vista, utilizzare il comando Read view cells.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del cubo | Inserire il nome del cubo. |
| Visualizza il nome | Inserire il nome della vista. |
| Tipo di uscita | Selezionare il formato del file CSV generato. |
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Visualizza i dati | File |
| ID del chiamante | Stringa |
| Totale cellule trattate | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
Aggiornare i parametri dell'attività core
Per modificare i parametri impostati per una determinata attività, utilizzare il comando Update chore task parameters.
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del compito | Inserire il nome del lavoro di routine. |
| Numero del compito | Immettere il numero dell'attività per cui aggiornare i parametri. |
| Parametri | Inserire i nuovi valori dei parametri per il task. |
Uscite
Nessuno
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
| 10 | Errore | Parametro dell'attività core non valido |
| 13 | Errore | L'attività di core specificata non ha parametri |
| 17 | Errore | Il core ha un programma attivo |
Scrivere le celle del cubo
Per scrivere i valori in un cubo, utilizzare il comando Write cube cells. Questo comando richiede un file CSV (comma-separated values) con:
- Nomi univoci della gerarchia come intestazioni
- Un'intestazione di colonna Valore, con i valori da scrivere nel cubo
Proprietà
| Proprietà | Dettaglio |
|---|---|
| Nome del cubo | Inserire il nome del cubo. |
| Formato del file | Selezionare il formato del file CSV. |
| File CSV | Inserire il file sorgente CSV. |
Uscite
| Uscita | Tipo di uscita |
|---|---|
| Conteggio aggiornato delle cellule | Intero |
| Scritture di cella non riuscite | Intero |
Codici di uscita
| Codice | Tipo | Dettaglio |
|---|---|---|
| 0 | Il successo | Il successo |
| 1 | Errore | Argomenti non validi |
| 2 | Errore | Impossibile comunicare con TM1 |
| 3 | Errore | L'esecuzione del comando non è riuscita |
| 16 | Errore | Alcune celle non sono riuscite a scrivere sul cubo |