Linee guida per la sintassi delle funzioni

Per informazioni sulla sintassi delle singole funzioni, fare riferimento a Descrizione delle funzioni.

  • Per usare una connessione condivisa, è necessario aggiungere alla funzione l'identificativo WSFN che specifica una funzione di Workspace, insieme a una stringa di connessione. Il formato è il seguente:

    "WSFN|ProviderType|Server|Application|Database","POV"

    Ad esempio, nella funzione HsGetValue per una connessione condivisa a un'origine dati Oracle Essbase l'identificativo WSFN e la stringa di connessione vengono aggiunti alla funzione nel modo seguente.

    =HsGetValue("WSFN|Essbase|myserver|Sample|Basic","Market#South")

    Per ProviderType, usare una delle seguenti stringhe con distinzione tra maiuscole e minuscole:

    • Essbase (solo per Essbase in locale; Oracle Essbase cloud richiede la sintassi relativa alla connessione privata)

    • HFM (per Oracle Hyperion Financial Management)

    • HP (per Oracle Hyperion Planning, Planning, Moduli Planning, Financial Consolidation and Close, Tax Reporting)

    Per Financial Management, il parametro Database può essere omesso o può avere lo stesso valore del parametro Application. Per coerenza Oracle consiglia di immettere il nome dell'applicazione per il parametro Database.

  • Per usare una connessione URL, è necessario aggiungere alla funzione l'identificativo URLFN che specifica una funzione URL, insieme a una stringa di connessione. Il formato è il seguente:

    URLFN|URL|Server|Application|Database

    Ad esempio, la sintassi della funzione HsGetValue che usa l'URL per una connessione a un processo aziendale Planning:

    HsGetValue("URLFN|URL|Server|Application|Database","POV")

    Tutte le informazioni necessarie per stabilire una connessione sono incluse nel token, come sopra illustrato. Se il token contiene informazioni non valide, in genere viene visualizzato un errore #NoConnection, con le seguenti eccezioni per il token del server:

    • Per i processi aziendali di Oracle Enterprise Performance Management Cloud, ad esempio Planning, il token del server può essere vuoto (o non valido)
    • Il token del server Essbase può solo essere vuoto
    • Financial Management richiede il parametro del token del server

  • I parametri relativi alla connessione privata possono avere i valori sotto riportati.

    • Vuoto: connessione predefinita

    • HsActive: connessione attiva associata

    • Nome definito dall'utente per una connessione privata

    Se si specifica una connessione privata, questo deve precedere il POV.

  • Il POV è costituito da coppie dimensione#membro, ad esempio:

    Entity#Connecticut

  • Le relazioni padre-figlio sono indicate tramite un punto (.), ad esempio:

    Entity#UnitedStates.Maine

  • La connessione e ciascuna coppia dimensione#membro del POV possono essere suddivise in parametri di funzione distinti, racchiusi singolarmente tra virgolette (") e separati da virgole (,), ad esempio:

    "My_connection","Entity#UnitedStates","Account#Sales"

    In alternativa, è possibile separare la connessione dal POV mediante una virgola (,) con l'intero POV racchiuso tra virgolette (") e ciascuna coppia dimensione#membro separata da un punto e virgola (;), ad esempio:

    "My_connection","Entity#UnitedStates;Account#Sales"

  • Gli alias sono supportati nelle funzioni come indicato di seguito.

    • Non combinare il nome di una dimensione con i relativi alias.
    • Per i membri è possibile utilizzare il nome del membro o il relativo alias dalla tabella alias selezionata.
    • È necessario utilizzare la stessa tabella alias per tutti gli alias.
    • Se si utilizza una connessione privata con nome, assicurarsi che sia impostata la tabella alias corretta per essa.
    • Se un'etichetta di alias ha lo stesso valore di un altro nome di membro, viene visualizzato un messaggio di "membro non valido".