Richtlijnen voor functiesyntaxis

Zie Functieomschrijvingen voor de syntaxis van afzonderlijke functies.

  • Als u met een gedeelde verbinding wilt werken, moet u de WSFN-ID (die een Workspace-functie aanduidt) en een verbindingsstring aan de functie toevoegen. De opmaak is:

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

    Bijvoorbeeld: in de functie HsGetValue voor een gedeelde verbinding met een Oracle Essbase-gegevensbron, worden de WSFN-ID en verbindingsstring als volgt aan de functie toegevoegd:

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

    Voor ProviderType gebruikt u een van de volgende hoofdlettergevoelige strings:

    • Essbase (alleen als Essbase lokale versie is geïnstalleerd. Voor Oracle Essbase is de syntaxis voor een privéverbinding vereist)

    • HFM (voor Oracle Hyperion Financial Management)

    • HP (voor Oracle Hyperion Planning, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting)

    Voor Financial Management kan de Database-parameter worden weggelaten, of hetzelfde zijn als de Applicatie-parameter. Het is raadzaam om voor de consistentie de applicatienaam voor de Database-parameter in te voeren.

  • Als u met een URL-verbinding wilt werken, moet u de URLFN-ID (die een URL-functie aanduidt) en een verbindingsstring aan de functie toevoegen. De opmaak is:

    URLFN|URL|Server|Applicatie|Database

    Een voorbeeld van de syntaxis van de functie 'HsGetValue' met behulp van de URL voor een verbinding met een Planning-bedrijfsproces:

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

    Zoals hierboven is getoond, bevat de token alle informatie die nodig is om een verbinding te maken. Als de token ongeldige informatie bevat, wordt de fout #NoConnection weergegeven met de volgende uitzonderingen voor de servertoken:

    • Voor bedrijfsprocessen van Oracle Enterprise Performance Management Cloud, zoals Planning, kan de servertoken leeg (of ongeldig) zijn.
    • De Essbase servertoken mag alleen leeg zijn.
    • Voor Financial Management is de servertokenparameter vereist.
  • Privéverbindingsparameters kunnen de volgende waarden bevatten:

    • Leeg: de standaardverbinding

    • HsActive: de actieve gekoppelde verbinding

    • De gebruikergedefinieerde naam voor een privéverbinding

    Als u een privéverbinding opgeeft, moet deze voorafgaan aan de POV.

  • De POV bestaat uit paren van een dimensie en een onderdeel in de vorm dimensie#onderdeel, bijvoorbeeld:

    Entity#Connecticut
  • De relaties tussen bovenliggende en onderliggende entiteiten worden aangegeven met een punt, (.). Bijvoorbeeld:

    Entity#UnitedStates.Maine
  • De verbinding en elk paar dimensie#onderdeel voor een POV kunnen worden opgesplitst in afzonderlijke functieparameters, waarbij elke parameter tussen dubbele aanhalingstekens, ("), wordt geplaatst en de parameters van elkaar worden gescheiden met een komma, (,). Bijvoorbeeld:

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

    Het is ook mogelijk om de verbinding te scheiden van de POV met een komma, (,), waarbij de hele POV tussen dubbele aanhalingstekens, ("), wordt geplaatst en elk paar dimensie#onderdeel wordt gescheiden met een puntkomma, (;). Bijvoorbeeld:

    "My_connection","Entity#UnitedStates;Account#Sales"
  • Aliassen worden als volgt in functie ondersteund:

    • Gebruik een dimensienaam en de aliassen ervan niet door elkaar.
    • Voor onderdelen kunt u zowel de onderdeelnaam als de alias ervan uit de geselecteerde aliastabel gebruiken.
    • Dezelfde aliastabel moet voor alle aliassen worden gebruikt.
    • Als u een privéverbinding met een naam gebruikt, zorg er dan voor dat de juiste aliastabel is ingesteld voor de verbinding.
    • Als een aliastabel dezelfde waarde heeft als de naam van een ander onderdeel, wordt er een bericht over een ongeldig onderdeel weergegeven.