IBM Planning Analytics Sidst opdateret: 23. maj TM1 TurboIntegrator

Transkript

1 IBM Planning Analytics Sidst opdateret: 23. maj 2017 TM1 TurboIntegrator

2 Note Før du bruger disse oplysninger og det produkt, de understøtter, skal du læse oplysningerne i Bemærkninger på side 105. Produktoplysninger Dette dokument omhandler IBM Planning Analytics Version og kan også gælde for efterfølgende releases. Licensed Materials - Property of IBM Copyright IBM Corporation 2007, 2017.

3 Indholdsfortegnelse Introduktion ii Kapitel 1. TurboIntegrator - grundlæggende oplysninger Tilgængelige datakilder med TurboIntegrator Grænse for strenglængde i TurboIntegrator Indstillinger for import TurboIntegrator-funktioner Processer og job Rækkefølge af funktioner i en TurboIntegrator-proces Bemærkninger til TurboIntegrator-processer Samtidige forbindelser til den samme TM1 -serer Aliasser i TurboIntegrator-funktioner Brug af personlige arbejdsområder med TurboIntegrator-processer Udfør en TurboIntegrator-proces manuelt med et personligt arbejdsområde eller en sandkasse Brug af TurboIntegrator-funktioner med sandkasser Kapitel 2. Importér tekstfil Opret en dimension fra en tekstfil Definér en datakilde Identificér ariabler i datakilden Map ariabler Gem og udfør TurboIntegrator-processen Opret en kun fra en tekstfil Definér kubedatakilden Definér kubeariabler Map kubeariabler Map kubeelementariabler til dimensioner Map kubedataariabler Map konsolideringsariabler Gem og udfør kubeprocessen Kapitel 3. Importér fra en ODBC-kilde Unicode og DNS Definér en ODBC-datakilde Generér en TurboIntegrator-proces fra en MDX-sætning Byg MDX TurboIntegrator-processen Kapitel 4. Importér fra en TM1 -oersigt eller et udsnit Brug en TM1 -kubeoersigt som en datakilde Opret en kubeproces Brug af TM1 -udsnit som datakilde Definér dimensionsudsnit som datakilde Definér dimensionsariabler Map dimensionsariabler Gem og udfør dimensionen Kapitel 5. Importér fra MSAS OLE DB til OLAP-datakilder ODBO-udbydernan ODBO-placering ODBO-datakilde ODBC-katalog Forbindelsesstreng: MSAS s. TM Opret forbindelse til en OLE DB til OLAP-datakilde ed brug af CAM-alidering Copyright IBM Corp. 2007, 2017 iii

4 Importér en MAS-kube Opret forbindelse til Analysis Serices med TurboIntegrator Angi kuben med skillebladet Indlæs ODBC-kube Brug af skillebladet Kubedimensioner Gem og udfør MAS-processen Importér en MAS-dimension Definér MAS-forbindelsesparametre Brug af skillebladet Indlæs ODBO-dimension Gem og udfør dimensions-mas-processen TM1 - Meddelelseslog Kapitel 6. Importér data med IBM Cognos TM1 Package Connector Opret forbindelse til en Cognos BI Serer Opret forbindelse til publicerede pakker - Pakke- og dimensionsindstilling Importér en enkelt dimension Opret forbindelse til publicerede pakker - Indstillingen Tilpasset forespørgsel Gem, udfør og reidér TurboIntegrator-processen med TM1 Package Connector som datakilde Vis resultater Kapitel 7. Redigér udidede procedurer Brug bulk load-tilstand Bemærkninger til brug af bulk load-tilstand TurboIntegrator-proceskommandoer til bulk load-tilstand TM1 C API-funktioner til bulk load-tilstand Redigeringsprocedurer Udfør en proces efter beho Brug af TM1RunTI TM1RunTI-syntaks TM1RunTI-konfigurationsfil TM1RuntTI-returkoder og -fejlmeddelelser Andre oerejelser edrørende TM1RunTI Serialisér TurboIntegrator-processer ed hjælp af synchronized() synchronized() TurboIntegrator-sikkerhed tildeles af administrator Kapitel 8. Planlæg en proces til automatisk udførelse med job Redigér et job Aktiér et job Deaktiér et job Slet et job Udfør et job on demand Brug af ChoreCommit Udfør et job ed sererstart Kapitel 9. Understøttelse af Jaa-udidelser i TurboIntegrator Aktiering og konfiguration af Jaa-udidelser Konfigurér TM1-sereren, så den understøtter Jaa Opret Jaa-udidelsesbiblioteker Opret filen jaaextensions.policy Konfigurér Eclipse Jaa EE IDE Jaa-udidelsesfunktioner i TurboIntegrator ExecuteJaaN ExecuteJaaS Understøttelse af arrays i funktioner, som accepterer et ariabelt antal parametre TurboIntegrator-funktioner, som ikke understøttes i Jaa-udidelser Fejlsøgning i Jaa-udidelser Fejlsøgning i Jaa-kode med Eclipse Skrining af fejl og andre oplysninger til TM1-sererlogfilen Integrér TM1 og Cognos Command Center ed brug af JaaTI i TM1 TurboIntegrator

5 Tillæg A. TurboIntegrator - øeprogram Definér biblioteket til øeprogramdata TurboIntegrator - Oersigt Opret en TurboIntegrator-proces Opret dimensioner ed hjælp af TurboIntegrator Opret en kube, og behandl data Udidet script-brug Redigér prolog-, metadata-, data- og epilogprocedurer Opret udsnit Opret attributter Tillæg B. TurboIntegrator - resererede ord Regelfunktionsnane Procesfunktionsnane Implicitte ariabelnane TurboIntegrator-nøgleord Bemærkninger Stikordsregister Indholdsfortegnelse

6 i TM1 TurboIntegrator

7 Introduktion Dette dokument er beregnet til brug i forbindelse med IBM Cognos TM1. Denne manual beskrier, hordan IBM Cognos TM1 TurboIntegrator kan importere data og metadata fra forskellige Business Analytics-kilder. Business Analytics omfatter softwareløsninger, der sørger for den løbende styring og oerågning af den finansielle, driftsmæssige, kundeorienterede og organisatoriske ydeene i hele irksomheden. Søg efter oplysninger His du il søge efter dokumentation på internettet, herunder al oersat dokumentation, skal du anende IBM Knowledge Center ( knowledgecenter). Ansarsfraskrielse edrørende eksempler Firmaet Sample Outdoors, Great Outdoors, GO Sales, alle arianter af nanene Sample Outdoors og Great Outdoors og planlægningseksempel skildrer fiktie irksomheder med eksempeldata, der bruges til at udikle eksempelapplikationer til IBM og IBM-kunder. Disse fiktie oplysninger omfatter eksempeldata til salgstransaktioner, produktdistribution, økonomi og personale. Enher lighed med faktiske nane, adresser, kontaktnumre eller transaktionsærdier er tilfældig. Andre eksempelfiler kan indeholde fiktie data, der er manuelt eller maskinelt oprettet, faktuelle data, der er kompileret fra akademiske eller offentlige kilder, eller data, der anendes med tilladelse fra copyrightindehaeren, til brug som eksempeldata med henblik på at udikle eksempelapplikationer. Produktnane, der henises til, kan ære aremærker, der tilhører de respektie ejere. Uautoriseret kopiering er ikke tilladt. Bemærk: En del billedeksempler og andre eksempler optræder uoersatte. Der kan i den forbindelse forekomme teksthenisninger (enkeltord) på dansk, da isse af eksemplerne er oersat i applikationen. Disse ord il normalt ære letgenkendelige og oersættelige, his brugeren anender ikke-oersatte eksempler. Hjælp til handicappede Hjælp til handicappede er funktioner, som kan ære en hjælp til brugere med en fysisk defekt, f.eks. begrænset mobilitet eller syn, til at anende IT-produkter. Dette produkt støtter ikke i øjeblikket funktioner til handicappede, som kan ære en hjælp til brugere med en fysisk defekt, f.eks. begrænset mobilitet eller syn. Fremadrettede erklæringer Denne dokumentation beskrier de aktuelle funktioner i produktet. Referencer til funktioner, der ikke er tilgængelige i øjeblikket, kan blie inkluderet på et senere tidspunkt. Heraf kan ikke udledes, at sådanne funktioner blier tilgængelige i fremtiden. Denne type referencer medfører herken en binding, et løfte eller en juridisk forpligtelse til at leere materiale, kode eller funktionalitet. Udikling, frigi- Copyright IBM Corp. 2007, 2017 ii

8 else og alg af tidspunkt for funktioner eller funktionalitet sker alene ud fra IBM's skøn. Bemærkninger om sikkerhed Der er bemærkninger om sikkerhed for IBM Planning Analytics i Planning Analytics Installation and Configuration. Information om administration af bruger- og gruppealidering findes i kapitlet Administrér brugere og grupper i TM1 Driftsejledning. iii TM1 TurboIntegrator

9 Kapitel 1. TurboIntegrator - grundlæggende oplysninger I dette afsnit beskries, hordan du importerer data til en IBM Cognos TM1 -kube ed hjælp af TurboIntegrator. Med TurboIntegrator kan du designe en proces, der genkender datastrukturen på kilden og omformer den til den releante struktur, som TM1 skal bruge. Når TIprocessen er designet, kan du udføre den igen eller planlægge, at den skal bruges, når der importeres data fra en dynamisk kilde. De efterfølgende afsnit beskrie de trin, der skal udføres for at importere data fra bestemte kildetyper. Før du begynder at bruge TurboIntegrator, skal du ære sikker på, at du forstår de oplysninger, der gælder for de forskellige kildetyper. Tilgængelige datakilder med TurboIntegrator Med TM1 TurboIntegrator kan du importere data fra disse datakilder: Kommaseparerede tekstfiler, herunder ASCII-filer. Relationelle databasetabeller, der kan anendes ia en ODBC-datakilde. Andre kuber og oersigter. Microsoft Analysis Serices. SAP ia RFC. IBM Cognos-pakker I andre afsnit i denne ejledning er der specifikke oplysninger om disse kildetyper. Grænse for strenglængde i TurboIntegrator Indstillinger for import TurboIntegrator kan håndtere strengdata i størrelser på op til 8000 enkeltbytetegn ad gangen. Denne grænse gælder, når TI-processen udfører funktioner som f.eks. at tilføje en ærdi til en ariabel eller importere indiiduelle datarecords. En ærdi eller en record, der er større end 8000 enkeltbytetegn, afkortes. Denne grænse gælder, når TI-processen udfører funktioner som f.eks. at tilføje en ærdi til en ariabel eller importere indiiduelle datarecords. En ærdi eller en record, der er større end 8000 enkeltbytetegn, afkortes. His du f.eks. importerer datalinjer fra en tekstfil, kan her tekstlinje højst ære på 8000 tegn. His du importerer data fra en kommasepareret fil, kan her record i filen højst ære på 8000 tegn. Når du importerer data med TurboIntegrator, har du følgende muligheder: Opret en kube, og udfyld den med data, der er importeret fra kilden. Opret en kube igen. Dermed ødelægges en allerede eksisterende kube, horefter den blier oprettet igen, så du både kan ændre data og metadata under importen. Opdatér en eksisterende kube, og bear kubens struktur. På den måde kan du importere data til en eksisterende kubestruktur. Copyright IBM Corp. 2007,

10 Opret en dimension fra data, der er importeret fra en kilde. Opdatér en dimension fra importerede data. TurboIntegrator-funktioner Processer og job Du kan bruge TurboIntegrator til at udføre en ilkårlig kombination af disse handlinger. TurboIntegrator inkluderer en række funktioner, så du kan behandle kuber, oersigter, dimensioner, elementer og andre TM1 -objekter, mens du importerer data. Ud oer disse TurboIntegrator-funktioner kan du også indsætte alle TM1 -regelfunktioner i en TurboIntegrator-proces med undtagelse af funktionen STET. TurboIntegrator-funktioner beskries i "TM1 TurboIntegrator-funktioner" i IBM Cognos TM1 Reference. Du importerer data med TurboIntegrator ed at definere en proces. En proces er TM1 -objektet, som består af: En beskrielse af en datakilde. Et sæt ariabler, der hører til de enkelte kolonner i datakilden. Et sæt mapninger, der definerer relationerne mellem ariabler og datastrukturer i TM1 -databasen. En prologprocedure, der består af en række handlinger, der skal udføres, før datakilden behandles. En metadataprocedure, der består af en række handlinger, der opdaterer eller opretter kube-, dimensions- og andre metadatastrukturer. En dataprocedure, der består af en række handlinger, der opdaterer eller transformerer data i TM1 -databasen. En epilogprocedure, der skal udføres, når datakilden er behandlet. Et sæt parametre, der kan anendes til at generalisere en proces, så den kan bruges i flere situationer. Job er opbearingsstedobjekt for en gruppe af TM1 -processer. Ved hjælp af job kan du udføre processer i en bestemt rækkefølge og planlægge, at processer skal udføres på et bestemt tidspunkt. Der er flere oplysninger i Kapitel 8, Planlæg en proces til automatisk udførelse med job, på side 57. Rækkefølge af funktioner i en TurboIntegrator-proces En TurboIntegrator-proces indeholder adskillige procedurer: Prolog, Metadata, Data og Epilog. Disse procedurer kan ises som underordnede skilleblade til skillebladet Udidet i TurboIntegrator-editoren. Når du definerer en datakilde, angier ariabler og datahandlinger til en proces, genererer TM1 scripts, der udføres, når du udfører TurboIntegrator-processen. Disse scripts placeres på det releante underordnede procedureskilleblad til proceduren i TurboIntegrator-editoren. Du kan også oprette egne scripts på et af de underordnede procedureskillebladet ed hjælp af TurboIntegrator- og regel-funktioner. 2 TM1 TurboIntegrator

11 Når du udfører en TurboIntegrator-proces, udføres procedurerne i følgende rækkefølge: 1. Prologproceduren udføres, før datakilden til TurboIntegrator-processen åbnes. 2. His datakilden til processen er Ingen, udfører TurboIntegrator straks proceduren Epilog, når Prolog har afsluttet behandlingen. Bemærk: Når datakilden til en proces er Ingen, ignoreres procedurerne Data og Metadata. I dette tilfælde skal alle scripts til processen oprettes i proceduren Prolog eller Epilog. 3. His datakilden til processen er andet end Ingen, åbner TurboIntegrator datakilden til processen. 4. Alle linjer i proceduren Metadata udføres i rækkefølge mod den første record i datakilden. Alle linjer udføres derefter i rækkefølge mod den anden record i datakilden os., indtil alle records er behandlet. 5. Alle linjer i proceduren Data udføres i rækkefølge mod den første record i datakilden. Alle linjer udføres derefter i rækkefølge mod den anden record i datakilden os., indtil alle records er behandlet. 6. TurboIntegrator lukker datakilden, når proceduren Data er udført. 7. Proceduren Epilog udføres. 8. TM1 lukker TurboIntegrator-processen. Bemærkninger til TurboIntegrator-processer Husk følgende, når du opretter og redigerer TurboIntegrator-processer. TurboIntegrator kompilerer kun en ny og ændret dimension i slutningen af den procedure, som dimensionen oprettes eller ændres i. His der er tale om en ny dimension, betyder det, at du ikke har adgang til den nye dimension (ia TurboIntegrator eller andet), før proceduren, som dimensionen er oprettet i, har færdigbehandlet alle records i datakilden. His det er en ændret dimension, betyder det, at du ikke har adgang til nye elementer i dimensionen, før proceduren, som dimensionen er ændret i, er færdig med behandlingen. TurboIntegrator- og regelfunktioner (med undtagelse af STET) kan anendes i en ilkårlig procedure i processen. Der er heller ingen begrænsninger med hensyn til, om funktioner kan anendes i en gien procedure. Alle funktioner kan anendes i en hilken som helst TurboIntegrator-procedure. Under "Formulas" i kapitlet Introduction to Rules i IBM Cognos TM1 Rules-dokumentationen er der oplysninger om brug af forskellige typer operatorer, f.eks. logiske og matematiske operatorer i TI-processer og -regler. I TurboIntegrator-processen konerteres NULL-ærdier til nuller for numeriske ærdier, og NULL-ærdier konerteres til tomme strenge for strengærdier. His du forsøger at placeret et konsolideret element under et eksisterende n-nieau-element, ændres n-nieau-elementet til konsolideret element, og alle data i det oprindelige n-nieau-element går tabt. Du skal oprette en logisk rækkefølge af funktioner for at sikre, at en proces når målet. His f.eks. du il bygge en proces, der tilføjer nye elementer til en dimension og opdaterer dataærdier til nye elementer, skal du ære sikker på, at processen tilføjer de nye elementer og kompilerer dimensionen, før du forsøger at opdatere dataærdier til de nye elementer. I de fleste tilfælde tilføjer du nye elementer til metadataprocedure ed hjælp af funktionen DimensionElementInsert, og derefter opdaterer du ærdier i proceduren Data med funktionen CellPutN. Kapitel 1. TurboIntegrator - grundlæggende oplysninger 3

12 His du anender oenstående eksempel, og du forsøger at bygge en proces, hor begge nye elementer er tilføjet, og tilhørende dataærdier opdateres i proceduren Data, blier processen ikke udført. Fejlen skyldes, som nænt oenfor, at ændrede dimensioner kun kompileres i slutningen af en procedure. Indtil dimensionen er kompileret, findes de nye elementer ikke. TurboIntegrator kan ikke opdatere dataærdier for elementer, der ikke findes, så processen blier ikke udført. Samtidige forbindelser til den samme TM1 -serer Udfør ikke en funktion i TurboIntegrator-processen, som opretter en ny forbindelse (logger på) til den samme TM1 -serer, hor processen allerede er i gang. Denne type scenarie medfører en baglåssituation mellem de to logoner, eller programdele, der medfører, at sereren hænger eller går ned. Undgå f.eks. følgende scenarier: Brug ikke en TI-proces til at starte en ODBO MDX-forespørgsel (ia TM1 OLE DB MD-leerandøren) ind i den samme serer. Dette scenarie kan medføre, at både processen og forespørgslen enter på hinanden for at afslutte. Brug ikke TI-funktionen ExecuteCommand til at tinge en TI-proces til at udføre og ente på (Wait-argument angiet til 1) et eksternt program, der logger tilbage til den samme serer. Dette inkluderer en et. tilpasset applikation eller en IBM Cognos-applikation, f.eks. TM1 ETLDAP-funktionen, der kan oprette forbindelse tilbage til den samme serer. Vær opmærksom på, at brug af funktionen ExecuteCommand med dens Wait-argument angiet til 1, kan medføre, at sereren hænger, sel om det eksterne program ikke logger tilbage til samme serer. His det eksterne program opdager dets eget problem og kommer til at hænge, hænger TI-processen, mens den enter på, at det eksterne program skal afslutte udførelsen. Aliasser i TurboIntegrator-funktioner Et aliasnan kan anendes i stedet for det tilhørende elementprincipalnan i regler eller i TurboIntegrator-funktioner. Brug af personlige arbejdsområder med TurboIntegrator-processer Dette afsnit beskrier, hordan sandkasser i personlige arbejdsområder anendes med TurboIntegrator-processer og -funktioner. Udfør en TurboIntegrator-proces manuelt med et personligt arbejdsområde eller en sandkasse Du kan manuelt udføre en proces med den aktie sandkasse i Serer Explorer ed at ælge Brug akti sandkasse til processen. Den aktie sandkasse bestemmes af, hilken sandkasse der i øjeblikket er algt i Cube Viewer. Til personlige arbejdsområder er den eneste tilgængelige sandkasse [Default]. Bemærk: Job, og de processer, de indeholder, kan ikke udføres mod et personligt arbejdsområde eller en sandkasse. Når en proces udføres som en del af et job, kan det kun udføres i forhold til basisdata. 4 TM1 TurboIntegrator

13 1. I Serer Explorer skal du åbne en oersigt i Cube Viewer. 2. Klik på sandkassen i listen oer tilgængelige sandkasser for at ælge den sandkasse, du il bruge til processen. 3. I delinduet med træstruktur skal du højreklikke på processen og klikke på Brug akti sandkasse for at aktiere indstillingen. 4. Højreklik på processen, og klik på Udfør. Resultater Processen udføres med den aktie sandkasse. Brug af TurboIntegrator-funktioner med sandkasser Følgende TurboIntegrator-funktioner gør det muligt for en TurboIntegrator-proces at kommunikere med personlige arbejdsområder og sandkasser. GetUseActieSandboxProperty SetUseActieSandboxProperty SererActieSandboxGet SererActieSandboxSet Disse funktioner ligner egenskaben Brug akti sandkasse, der er tilgængelig i Serer Explorer-grænsefladen. Der er flere oplysninger i afsnittet om TurboIntegrator-sandkassefunktioner i IBM Cognos TM1 Reference. Kapitel 1. TurboIntegrator - grundlæggende oplysninger 5

14 6 TM1 TurboIntegrator

15 Kapitel 2. Importér tekstfil I dette afsnit beskries, hordan du importerer tekstdata, f.eks. ASCII, med IBM Cognos TM1 TurboIntegrator. Sel om her TM1 -proces er forskellig, og import fra andre typer datakilder arierer, beskrier dette afsnit de trin, der gælder for de fleste processer. Procedurerne og eksemplerne anender filen NewEngland.cma, der installeres som en del af de eksempeldata, der er inkluderet i TM1. Opret en dimension fra en tekstfil Du kan bruge TurboIntegrator til at oprette en dimension fra en liste oer elementnane i en datakilde. Det er den hurtigste måde at oprette en dimension, som indeholder hundreder eller tusinder af elementer. Når du opretter en dimension med TurboIntegrator, definerer du en proces, der gemmes som et objekt på TM1 -sereren. Denne proces kan anendes af andre brugere, og den kan udføres når som helst eller med planlagte interaller. Sådan oprettes en dimension med TurboIntegrator: 1. Definér datakilden til TM1. Der er flere oplysninger i Definér en datakilde. 2. Identificér de ariabler, TM1 finder. Der er flere oplysninger i Identificér ariabler i datakilden på side Map ariablerne til deres datatyper. Der er flere oplysninger i Map ariabler på side Gem processen, og udfør den. Der er flere oplysninger i Gem og udfør TurboIntegrator-processen på side 13. Definér en datakilde Når du bruger TurboIntegrator, kræer de første to trin, at du definerer den datakilde, du læser data fra. I dette eksempel defineres ASCII-filen med nanet New- England.cma som datakilde til denne TurboIntegrator-proces. 1. Højreklik på Processer i det enstre indue til Serer Explorer, og ælg Processer, Opret ny proces. 2. Klik på Tekst på skillebladet Datakilde. Vinduet TurboIntegrator åbnes. 3. Klik på Gennemse. Dialogboksen Vælg inputfil åbnes. 4. Naigér til NewEngland.cma, ælg den, og klik på Åbn. NewEngland.cma findes enten i eksempeldatabiblioteket PData eller SData. His du har accepteret standardinstallationsbiblioteket til TM1, er den fuldstændige stiangielse til filen C:\Program Files\Cognos\TM1\Custom\TM1Data\SData\NewEngland.cma eller C:\Program Files\Cognos\TM1\Custom\TM1Data\PData\NewEngland.cma. Der kan blie ist en meddelelse, der angier, at du skal bruge UNC (Uniersal Naming Conention) til at angie filplaceringen. His du konstant skal udføre processer i forhold til en ASCII-fil, skal du bruge UNC og sørge for følgende: Copyright IBM Corp. 2007,

16 His du anender en Microsoft Windows TM1 -serer, skal ASCII-filen ære placeret i et delt Windows-bibliotek, så sereren kan anende den. His du anender en TM1 -serer på et UNIX-styresystem, skal filen ære placeret i et delt netærksbibliotek, som både TM1 Windows-klienten og TM1 UNIX-sereren kan anende. Bemærk: His du anender en TM1 -serer i et UNIX-styresystem, kan inputkildefilnanet ikke indeholde store bogstaer eller mellemrum. 5. Klik på OK i adarselsboksen. 6. Udfyld TurboIntegrator-dialogboksen på følgende måde: NewEngland.cma er en begrænset kilde, der anender kommaer som skilletegn, dobbelte anførselstegn som citationstegn, ingen titelrecords, punktum som decimalskilletegn og et komma som skilletegn for tusinder. His du il definere denne kilde, skal du angie følgende indstillinger: Vælg Afgrænset ud for Type skilletegn. Vælg Komma som Skilletegn. Indsæt " ed Anførselstegn. Lad feltet Antal titelrecords stå tomt. Indsæt. ed Decimaltegn. Indsæt, ed Tusindtalsskilletegn. 7. Klik på Prøe. TurboIntegrator iser et eksempel på kildedata nederst i induet. Brug af records med fast længde TurboIntegrator kan også importere data fra tekstfiler, der anender felter med fast bredde. His du il angie, at datakilden har felter med fast bredde, skal du, når du har angiet placeringen af datakildefile, ælge skilletegnstypen Fast bredde og derefter klikke på Angi feltbredde. Dialogboksen Dataprøe iser de første tre records af kildedataene. Gør følgende for at angie feltbredder baseret på indholdet af records i datakilden: 1. Klik på 1 kolonneoerskriften. En skillelinje ises i kolonneoerskriften og gennem de tre records. 2. Klik på skillelinjen, og træk den til en placering, der adskiller den første kolonne fra den anden kolonne. En ny kolonneoerskrift (2) ises. 3. Klik på kolonneoerskrift 2, og træk den nye skillelinje til en placering, der adskiller den anden kolonne fra den tredje kolonne. 4. Angi skillelinjer for alle resterende kolonner i tekstkilden. 5. Klik på OK for at ende tilbage til TurboIntegrator-induet. Identificér ariabler i datakilden Når du har defineret en datakilde, tildeler TurboIntegrator en ariabel til her kolonne i kilden. Du skal identificere disse ariabler efter type og indhold. Se følgende tekstdata som eksempel på denne proces: 8 TM1 TurboIntegrator

17 Tabel 1. Eksempler på tekstdata Kolonne 1 Kolonne 2 Kolonne 3 Kolonne 4 Kolonne 5 Kolonne 6 New England Massachusetts Boston Supermart Feb New England Massachusetts Springfield Supermart Feb New England Massachusetts Worcester Supermart Feb New England Connecticut Hartford Supermart Feb New England Connecticut New Haen Supermart Feb New England Connecticut Greenwich Supermart Feb De tre første kolonner danner et hierarki til en placeringsdimension, du bygger fra kildetekstfilen: New England-konsolideringen er øerst i hierarkiet. Staterne Massachusetts og Connecticut er ét nieau under New England. Den tredje kolonne, der indeholder bynane som Boston og Hartford, leerer enkle elementer på laeste nieau i hierarkiet. De resterende kolonner anendes ikke til oprettelse af placeringsdimensionen. Her er skillebladet Variabler på TurboIntegrator-induet til denne datastruktur: Tabel 2. Skillebladet Variabler Variabelnan Variabeltype Eksempelærdi V1 Streng New England V1 Streng New England Massachusetts Streng Massachusetts Boston Streng Boston SuperMart Streng SuperMart Feb Streng Feb V6 Numerisk TurboIntegrator tildeler her kolonne et ariabelnan og tildeler en ariabeltype baseret på eksempelærdien for her kolonne. Standardariabelnanene, f.eks. V1 og Massachusetts, kan ændres. Det er en god idé at gie ariablerne nane med betydning. Nane med betydning gør det lettere at læse og foretage fejlfinding i TurboIntegrator-scripts. His du il ændre et ariabelnan, skal du klikke på nanet i kolonnen Variabelnan og skrie et nyt nan. I denne øelse ble nanene på de første tre ariabler ændret sådan: Kapitel 2. Importér tekstfil 9

18 Eksempelærdi New England Massachusetts Boston Variabelnan Region State By Et ariabelnan skal begynde med et bogsta og kan kun indeholde følgende tegn: Tegn Store bogstaer Små bogstaer Beskrielse A til Z a til z Tal 0 til 9 Punktum. Understregningstegn _ Dollartegn $ Feltet Variabeltype identificerer indholdet af kolonnen. For eksempel indeholder den første kolonne med data strengen "New England". TurboIntegrator identificerer korrekt ariabeltypen som streng. Bemærk: Felterne Variabeltype er normalt angiet korrekt for ASCII-data men ikke for data, der er udtrukket fra en ODBC-datakilde. Feltet Indhold kan defineres med en af disse indstillinger: Indstilling Ignorér Element Konsolidering Data Beskrielse Ignorér indholdet af kolonnen ed behandling af datakilden. Kolonnen indeholder eksempelelementer til den dimension, du il oprette. Kolonnen indeholder konsoliderede elementer til den dimension, du il oprette. Kolonnen indeholder dataærdier. I dette eksempel skal du ignorere den kolonne, der indeholder dataærdierne. De kolonner, der indeholder dataærdier, importeres ikke, når du opretter en dimension. Attribut Kolonnen indeholder elementattributter til den dimension, du il oprette. 10 TM1 TurboIntegrator

19 Indstilling Beskrielse Andet Kolonnen indeholder data, der ikke falder inden for nogle af de fire tidligere kategorier. Denne indstilling anendes typisk til kolonner, der indeholder data, som behandles ia tilpassede ariabler og formler. Tekstdata i dette eksempel indeholder elementer og konsolideringer til en placeringsdimension: Det indeholder ingen attributter. Det indeholder ingen dataærdier, men disse ærdier er irreleante i forhold til oprettelsen af placeringsdimensionen, da de er elementer fra andre dimensioner. Sådan definerer du ariablerne til placeringsdimensionen: 1. Klik på skillebladet Variabler i induet TurboIntegrator. 2. Angi feltet Indhold til ariablerne Område, Stat og By på følgende måde: Variabel Region State By Indhold Konsolidering Konsolidering Element Variablen Område er nu identificeret som en konsolidering Variablen Stat er også identificeret som en konsolidering Variablen By er identificeret som et element på laeste nieau (ikke-konsolideret) Map ariabler Når du har identificeret ariablerne i datakilden, skal du mappe dem til elementer og konsolideringer. Klik på skillebladet Mapninger i induet TurboIntegrator for at begynde at mappe ariabler. Skillebladet Mapninger indeholder flere skilleblade. Skillebladet Kube er altid tilgængeligt. Alle andre skilleblader blier tilgængelige baseret på det kolonneindhold, du angier på skillebladet Variabler. His du f.eks. angier, at en kolonne indeholder elementer, blier skillebladet Dimension tilgængeligt. His du angier, at en kolonne indeholder konsolideringer, blier skillebladet Konsolideringer tilgængelige os. Deaktiér kubemapning Du skal ikke udføre nogen kubehandlinger, når du opretter en dimension. Sådan forhindrer du kubemapning: 1. Klik på skillebladet Kube. 2. Vælg Ingen handling i feltet Kubehandling. Kapitel 2. Importér tekstfil 11

20 Mapningsdimensioner His du identificerer kolonner i din datakilde som indeholdende elementer, skal du mappe disse elementer til den dimension, du opretter: 1. Klik på skillebladet Dimensioner. 2. Skri Placering i feltet Dimension. His flere elementer mapper til den samme dimension, skal du skrie dimensionsnanet til hert element. Når du skrier et nyt dimensionsnan i kolonnen Dimension, blier kolonnen Handling som standard Opret. His du skrier nanet på en eksisterende dimension, har du mulighed for at oprette eller opdatere dimensionen igen. His du ælger handlingen Opret igen, blier elementerne i den eksisterende dimension slettet og erstattet af data i datakilden. His du ælger handlingen Opdatér, opdateres dimensionen med eentuelle nye elementer, der findes i datakilden. 3. Vælg en type til hert element fra den releante elementtypemenu. Elementtypen angier typen af data, der identificeres af elementariablen. I TM1 er denne indstilling næsten altid numerisk. 4. Vælg indstillingen Elementrækkefølger. Elementrækkefølgen bestemmer, hordan elementer tilføjes til dimensionen under behandlingen. Data i dette eksempel indeholder et enkelt numerisk element, der mapper til en ny placeringsdimension. Det udfyldte skilleblad Dimensioner ises på følgende måde. Deaktiér datamapning Du skal ikke udføre nogen datamapning, når du opretter en dimension. Eksempel Da du har angiet Ingen handling på skillebladet Kubemapning Deaktiér kubemapning på side 11, blier dette skilleblad Data ikke tilgængeligt. Mapningskonsolideringer His du identificerer kolonner i din datakilde med konsolideringer, skal du mappe konsolideringsstier til den dimension, du opretter: 1. Klik på skillebladet Konsolideringer. Skillebladet iser de ariabler, der er defineret som konsolideringer, Område og Stat. Du kan definere konsolideringshierarkiet til dimensionen ed at angie den underordnede ariabel til her konsolideringsariabel. 2. Den direkte underordnede til konsolideringsariablen Område er Stat. Klik på knappen med den højre inkelparentes i feltet Underordnet ariabel til konsolideringen Område, ælg Stat, og klik på OK. 3. Den direkte underordnede til konsolideringsariablen Stat er By. Klik på knappen med den højre inkelparentes i feltet Underordnet ariabel til konsolideringen Stat, ælg By, og klik på OK. 4. For her konsolidering skal du klikke på knappen Komponentrækkefølge. Dialogboksen Angielse af rækkefølge for komponentelementer åbnes. 5. Klik på Automatisk, Nan og Stigende. 12 TM1 TurboIntegrator

21 Bemærk: Når du angier flere konsolideringer inden for samme dimension, skal alle konsolideringer angies til de samme indstillinger for "Angielse af rækkefølge for komponentelementer". His du angier to konsolideringer i samme dimension til forskellige indstillinger for "Angielse af rækkefølge for komponentelementer", genererer TurboIntegrator en fejl edrørende "Uoerensstemmelse i sorteringen af oplysninger for denne dimension", når du forsøger at gemme og udføre processen. Gem og udfør TurboIntegrator-processen Når du har defineret en datakilde og angiet ariabler, kompileres og gemmes TurboIntegrator-processen. His du il oprette dimensionen, skal du udføre processen. Opret en kun fra en tekstfil 1. Klik på Fil, Gem på menulinjen i TurboIntegrator. Dialogboksen Gem proces som åbnes. 2. Angi et nan til processen, og klik på Gem. His TM1 finder en fejl under kompilering og gemning, angier en fejlmeddelelse fejltypen. TurboIntegrator-induet forblier aktit, så du straks kan rette et. fejl. TM1 gemmer processen som et sererobjekt under Processer i Serer Explorer. Processen er nu tilgængelig til udførelse eller ændring. His du fil udføre processen og oprette dimensionen, skal du klikke på Fil, Udfør på menulinjen i TurboIntegrator. Du kan også udføre en proces direkte fra Serer Explorer ed at ælge processen og klikke på Proces, Udfør proces. His processen udføres uden fejl, iser TM1 en bekræftende meddelelse. His TM1 ikke kan udføre processen, ises en dialogboks med oplysninger om fejlen. Når NewEngland.cma er behandlet, oprettes en ny placeringsdimension. TurboIntegrator kan også oprette en hel kube fra en tekstfil. Denne procedure bygger også dimensioner og elementer og foretager databehandling. Proceduren i forbindelse med bygning af en kube ligner processen med at bygge en dimension: 1. Definér datakilden til TM1. Der er flere oplysninger i Definér kubedatakilden på side Identificér de ariabler, TM1 finder. Der er flere oplysninger i Definér kubeariabler på side Map de forskellige ariabler til deres forskellige datatyper i resultatkuben. Se Map kubeelementariabler til dimensioner på side 15, Map kubedataariabler på side 15, Map kubeariabler på side 15 og Map konsolideringsariabler på side Gem processen, og udfør den. Der er flere oplysninger i Gem og udfør kubeprocessen på side 16. TM1 inkluderer et bibliotek med eksempeldata med nanet TI_data. TI_data indeholder en fil med nanet import_cube.cs. I dette eksempel beskries, hor en kube bygges fra import_cube.cs. Kapitel 2. Importér tekstfil 13

22 Definér kubedatakilden Det første trin i oprettelsen af en kube fra en tekstfil er at definere datakilden. 1. Højreklik på ikonen Processer i det enstre indue i Serer Explorer, og ælg Opret ny proces. 2. Klik på skillebladet Datakilde i induet TurboIntegrator. 3. Vælg Tekst som Datakildetype. 4. Klik på knappen Gennemse ud for feltet Nan på datakilde, og ælg filen import_cube.cs i biblioteket TI_data. His du har accepteret standardinstallationbiblioteket, er den fuldstændige sti til TI_data-biblioteket C:\Program Files\Cognos\TM1\Custom\TM1Data\TI_Data 5. Angi Type skilletegn til Afgrænset, og ælg komma som skilletegn. Ignorér felterne Anførselstegn og Antal titelrecords i dette eksempel. 6. Kontrollér, at decimaltegnet er et komma (,), og tusindtalsskilletegnet er et punktum (.). 7. Klik på Prøe for at få ist de første records i datakilden. Her record i import_cube.cs indeholder 6 felter. De første fem felter indeholder oplysninger, der blier importeret til TM1 som elementnane. Den sjette kolonne indeholder kubedata. Variabelnan Variabeltype Eksempelærdi Indhold V1 Streng Faktisk Ignorér Massachusetts Streng Argentina Ignorér V3 Streng S Series 1.8 L Sedan Ignorér Units Streng Enheder Ignorér Jan Streng Jan Ignorér V6 Numerisk Ignorér Definér kubeariabler Når kildedataene til TurboIntegrator er identificeret, skal du identificere indholdet i hert felt i kilden. 1. Klik på skillebladet Variabler. TurboIntegrator angier standardærdier for de enkelte ariabler. 2. Til her ariabel skal du ælge en type på den tilknyttede menu Variabeltype. I dette eksempel kræes ingen ændringer til felterne Variabeltype. TM1 identificerer typen korrekt til her ariabel. 3. Til her ariabel skal du ælge en indholdstype på den tilknyttede menu Indhold. I dette eksempel skal alle ariabler med undtagelse af V6 identificeres som Element. V6 skal identificeres som Data. 14 TM1 TurboIntegrator

23 Map kubeariabler Du har identificeret ariabler til data, elementer og konsolideringer. Nu skal du mappe ariablerne og angie instruktioner til oprettelse af en ny kube. 1. Klik på skillebladet Mapninger. 2. Klik på skillebladet Kube. 3. Vælg Opret som kubehandling. 4. Skri import_cube i feltet Kubenan. 5. Vælg Lagring af ærdier som Datahandling. 6. Aktiér ikke algmuligheden Aktiér kubelogning. Når du har aktieret kubelogning, logger TM1 ændringer til kubedata under behandlingen. Du opretter en ny kube, så der er ingen grund til at logge ændringer. Map kubeelementariabler til dimensioner Map alle ariabler, du har identificeret, som har en elementtype, til passende dimensioner. 1. Klik på skillebladet Dimensioner. 2. Angi ærdier på skillebladet Dimensioner i henhold til følgende tabel. Elementariabel Eksempelærdi Dimension Rækkefølge i kube Actual Faktisk actsbud2 1 Argentina Argentina region2 2 V3 S Series 1.8 L Sedan model2 3 Units Enheder målinger 4 Jan Jan month For alle elementtyper skal handlingen angies til Opret og elementtypen til Numerisk. Map kubedataariabler I dette eksempel er der kun én dataariabel - V6. Du behøer ikke at mappe denne dataariabel. TurboIntegrator gør det for dig. Dataskillebladet er endda ikke aktieret i dette eksempel. TurboIntegrator tilføjer data til kuben på skæringspunktet for de oprettede dimensioner. His 2 eller flere ariabler er defineret som data på skillebladet Variabler, skal du angie oplysninger om, hor dataene skal tilføjes til kuben. Der er et uddybende eksempel på mapning af dataærdier til en kube i "øeprogrammet til TurboIntegrator". Map konsolideringsariabler Ingen ariabler i dette eksempel er defineret som konsolideringer på skillebladet Variabler. Skillebladet Konsolidering er ikke aktieret i dette eksempel. Der er et uddybende eksempel på mapning af konsolideringer til en kube i "øeprogrammet til TurboIntegrator". Kapitel 2. Importér tekstfil 15

24 Gem og udfør kubeprocessen Du skal gemme og nangie processen, før du kan udføre den. 1. Klik på knappen Udfør. Sådan gemmer og udfører du processen: TM1 beder om et nan, og om at du gemmer processen. 2. Gem processen som create_newcube. Efter nogle sekunder ises en bekræftelse på, at processen er udført. 3. Åbn Serer Explorer. Kuben import_cube er nu bleet oprettet og udfyldt, og alle de påkræede dimensioner er oprettet. 16 TM1 TurboIntegrator

25 Kapitel 3. Importér fra en ODBC-kilde Unicode og DNS Definér en ODBC-datakilde Ved hjælp af TurboIntegrator kan du oprette kuber og dimensioner fra data i relationelle databasetabeller. Du skal hae følgende software på din maskine for at kunne gøre det: Klientsoftware til den relationelle database, der er installeret på den samme maskine, som du udfører TurboIntegrator på. En ODBC-datakilde, der er oprettet til relationsdatabasen. Du bygger datakilder ia kontrolpanelet med Windows-datakilder. Når du har defineret ODBC-datakilden, er de trin, der skal udføres for at oprette en kube eller en dimension fra relationelle data, de samme som at oprette en kube eller en dimension fra en tekstfil. Der er en udførlig trinis ejledning i oprettelse af objekter i TurboIntegrator ed hjælp af en ODBC-kilde i "TurboIntegrator Tutorial." Bemærk: TM1 kræer DataDirect-styreprogram for at anende en Oracle ODBCkilde på Solaris eller AIX. Disse styreprogrammer leeres ikke sammen med TM1 og skal anskaffes separat. Når du konfigurerer DSN til at importere Unicode-data fra en Oracle-database med ersion 11g-klient/ODBC-styreprogram, skal du angie Enable Closing Cursors på skillebladet Application. TI-processerne udføres muligis ikke korrekt, his denne indstilling ikke er angiet. Oracle 11g ODBC-styreprogrammet understøtter ikke SQL_CLOSE-indstillingen til SqlFreeStmt. Sådan definerer du en ODBC-datakilde: 1. Åbn Serer Explorer. 2. Højreklik på ikonen Processer under den serer, du il oprette processen på, og ælg Opret ny proces. Vinduet TurboIntegrator åbnes. 3. Vælg den øerste ODBC i boksen Datakildetype. TurboIntegrator iser de felter, der er påkræede til at definere en ODBC-kilde. 4. Klik på Gennemse, og ælg et ODBC-datakildenan. Kun datakilder, der er defineret på den computer, som TM1 -sereren udføres på, kan anendes. 5. His de er påkræede for at kunne bruge denne kilde, skal du angie et gyldigt brugernan og kodeord til måldatabasen i felterne Brugernan og Kodeord. 6. I feltet Forespørgsel skal du angie en SQL-forespørgsel for at udtrække data fra kilden. Syntaksen og formatet på SQL-forespørgslen afhænger af den type database, du anender. His du f.eks. bruger en Microsoft Access Database, kan Copyright IBM Corp. 2007,

26 du anende Microsoft Access, åbne databasen, bruge SQL-oersigten og derefter kopiere SQL-sætningen til dette forespørgselsindue. Bemærk: His forespørgslen heniser til et tabelnan, der indeholder mellemrum, skal du angie nanet i dobbelte anførselstegn. 7. Klik på Prøe. His forespørgslen ar gyldig, og forbindelsen er defineret korrekt, ises de første ti records i måldatabasetabellen i TurboIntegrator-induet. Under "Identificér ariabler i datakilden" er der oplysninger om de trin, der skal bruges til at definere ODBC-ariabler. Under " Map ariabler" er der ejledning i, hordan ODBC-mapningsinstruktioner defineres. Under "Gem og udfør TurboIntegrator-processen" er der oplysninger om, hordan en TurboIntegrator-proces gemmes og udføres. Generér en TurboIntegrator-proces fra en MDX-sætning I dette afsnit beskries, hordan du udtrækker data fra en ODBO-datakilde ed hjælp af en MDX-sætning og importerer data i TM1. Det er bedst at generere en MDX-sætning ia en anden funktion og derefter bruge den fungerende MDX-sætning som basis for dataimporten til TM1. Når du importerer data, er det igtigt at begynde med en MDX-sætning, der har et begrænset antal kolonner. Nogle MDX-sætninger genererer et stort antal kolonner. Sådanne forespørgsler er upraktiske som startpunkt for en import. His du kun placerer de målinger, du er interesseret i, på kolonnerne, kan det ære med til at begrænse antallet af kolonner. Byg MDX TurboIntegrator-processen Når du har en MDX-sætning, der returnerer nyttige data, kan du bygge TurboIntegrator-processen. Følg disse trin for at komme i gang: 1. I Serer Explorer skal du højreklikke på Processer og ælge Opret ny proces. Vinduet TurboIntegrator åbnes. 2. I boksen Datakildetype skal du klikke på ODBO og ælge MDX-forespørgsel. 3. Angi de påkræede forbindelsesparametre på skillebladet Forbindelse i Turbo- Integrator-induet. Forbindelsesparametrene er leerandørafhængige. 4. Klik på Tilslut. His du får oprettet forbindelse, blier knappen Tilslut gråtonet, og du kan fortsætte til skillebladet MDX-forespørgsel. 5. Klik på skillebladet MDX-forespørgsel. 6. Indtast MDX-forespørgslen på dette skilleblad. Du kan også klippe en fungerende MDX-forespørgsel fra en anden applikation og indsætte den på dette skilleblad. 7. Klik på skillebladet Variabler. Til her kolonne, der er genereret af MDX-sætningen, genereres der én ariabel af TurboIntegrator. Kolonner, der indeholder rækketoptekster, mappes typisk som dimensionselementer. Kolonner, der indeholder dataelementer, mappes som data. 18 TM1 TurboIntegrator

27 8. Under "Map ariabler" er der flere oplysninger om at mappe ariabler til TM1 -strukturer. Når du har oprettet forbindelse til ODBO-datakilden og defineret MDX-sætningen, er proceduren i forbindelse med at afslutte TurboIntegratorprocessen den samme som ed ODBC-dataimport. Kapitel 3. Importér fra en ODBC-kilde 19

28 20 TM1 TurboIntegrator

29 Kapitel 4. Importér fra en TM1 -oersigt eller et udsnit Med IBM Cognos TM1 TurboIntegrator kan du udtrække data fra en kubeoersigt og oprette nye objekter med disse data. De trin, der skal udføres for at bygge en proces, som skal bruges til en TM1 -oersigt, er de samme som dem, der anendes til at definere andre datakilder med den undtagelse, at du først bygger en oersigt oer data, der specifikt er designet til import. Ikke alle TM1 -kubeoersigt kan importeres. Når du bygger en oersigt med parametre fra TurboIntegrator, fungerer importen her gang. Brug en TM1 -kubeoersigt som en datakilde Du kan definere en kubeoersigt som en datakilde. Se oplysningerne om at definere en datakilde i Opret en kubeproces. Følg derefter de procedurer, der er beskreet i "Importér en tekstfil"". Du kan også oprette en kubeoersigt ed hjælp af MDX-udtryk og bruge den MDX-baserede oersigt som en TurboIntegrator-datakilde. I det følgende ises den kolonnerækkefølge, der skal bruges i en MDX-baseret oersigt: member1, member1_prop1, member1_prop2,..., member1_propn, member2, member2_prop1,..., membern_propn, cell_prop1, cell_prop2,..., cell_propn, cell_alue Bemærk: Definitionen bruger notationen _prop som reference til de egenskaber for MDX-dimension eller -celle, som udtrykkeligt anmodes om i MDX-forespørgselsstrengen. TurboIntegrator-funktionerne ViewCreateByMDX, ViewMDXSet og ViewMDXGet fungerer sammen med MDX-oersigter. Der er information om disse funktioner i TM1 Reference-dokumentationen. Opret en kubeproces Du kan oprette en proces, der anender en kubeoersigt som en datakilde. 1. Højreklik på Processeri Serer Explorer, og ælg Opret ny proces. 2. Klik på TM1, og ælg Kubeoersigt i feltet Datakildetype. TurboIntegrator iser feltet Nan på datakilde. 3. Klik på Gennemse for at ælge fra en liste oer tilgængelige nane. Dialogboksen Gennemse sererkubeoersigter åbnes. 4. Vælg den kube, der indeholder de data, du il importere. 5. His en oersigt, du il bruge som datakilde, allerede findes, skal du ælge den oersigt. His en sådan oersigt ikke findes, skal du klikke på Opret oersigt for at åbne induet Udtræk af oersigt og oprette oersigten. Når oersigten er oprettet, skal du ælge den i dialogboksen Gennemse sererkubeoersigter. 6. Klik på OK. Copyright IBM Corp. 2007,

30 Den algte oersigt ises nu som datakilde for TurboIntegrator-processen. Fortsæt med trinene, der er beskreet i "Importér en tekstfil" for at udføre importen af TM1 -oersigten. Brug af TM1 -udsnit som datakilde Med TurboIntegrator kan du udtrække data fra TM1 -dimensionsudsnittet og flytte disse oplysninger til et andet TM1 -objekt. I følgende eksempel er konsolideringen Europe i dimensionen Område udtrukket og anendt til at udforme en ny dimension med nanet Område_Europe. Når du udtrækker oplysninger fra et dimensionsudsnit, er målobjektet typisk en anden dimension. Du kan ikke bygge en kube fra oplysninger, der er udtrukket fra et dimensionsudsnit. Proceduren med at udtrække data ed hjælp af TM1 -udsnit ligner andre TurboIntegrator-processer. Under Definér dimensionsudsnit som datakilde er der flere oplysninger om, hordan du kommer i gang. Definér dimensionsudsnit som datakilde Følg disse trin for at oprette en proces, der anender et dimensionsudsnit som en datakilde: 1. Højreklik på Processeri Serer Explorer, og ælg Opret ny proces. 2. Klik på TM1, og ælg Dimensionsudsnit i feltet Datakildetype. TurboIntegrator iser det enkelte felt, der kræes til at definere en kubeoersigtskilde. 3. Klik på Gennemse for at ælge fra en liste oer tilgængelige udsnit. Dialogboksen Gennemse sererudsnit åbnes. 4. Vælg den dimension, der indeholder de elementer, du il importere. 5. Vælg det udsnit, du il bruge som datakilde, og klik på OK. 6. Klik på Prøe. Elementerne i det algte dimensionsudsnit ises på skærmbilledet Prøe. Definér dimensionsariabler I dette eksempel blier de elementer, der er udtrukket fra udsnitsdatakilden, tilføjet som underordnede til en konsolidering på øerste nieau med nanet All Europe. Følg disse trin for at bygge en ny konsolidering: Inden du begynder Under "Definér kubeariabler" er der oplysninger om at identificere og definere ariabler i TurboIntegrator. 1. Klik på Ny ariabel. Variablen V2 ises på skillebladet Variabler. 2. Klik på Formel. Dialogboksen Behandling af ariabelformler åbnes. 3. Reidér formlen på følgende måde: 22 TM1 TurboIntegrator

31 V2= All Europe ; 4. Klik på OK. 5. Ret ariabeltypen for V2 til Streng. 6. Ret indholdsindstillingen for V2 til Konsolidering. I næste afsnit blier elementerne, der er importeret fra udsnitsdatakilden, tilføjet til konsolideringen All Europe. Map dimensionsariabler I dette eksempel skal du angie, at skillebladene Kube, Dimensioner og Konsolideringer skal oprette en ny dimension med nanet Europe. Europe har en enkelt konsolidering med nanet All Europe. Under "Map ariabler" er der flere oplysninger om proceduren for mapning af importerede data til TM1 -objekter. Definér skillebladet Kube Angi følgende indstillinger for skillebladet Kube: Handlingstype Kubehandling Datahandling Indstilling Ingen handling Lagring af ærdier Definér skillebladet Dimensioner Fra skillebladet Dimensioner kan du mappe indgående data til TM1 -dimensioner. I dette eksempel oprettes kun én dimension med nanet Europe. Angi følgende indstillinger på skillebladet Dimension: Nan på indstilling Elementariabel Dimension Handling Elementtype Indstilling Europe Region Opret Numerisk Definér skillebladet Konsolideringer Variablen All Europe, som du tilføjede tidligere, ises på skillebladet Konsolideringer. Bemærk, at eksempelærdien er angiet til den ærdi, du har oprettet i formlen. Da processen kun indeholder to ariabler, identificerer TM1 korrekt regionsariablen som underordnet til V2-ariablen. Der er ingen grund til at ændre indstillingen på skillebladet Konsolideringer. Gem og udfør dimensionen Når du har gemt og udført processen, opretter TM1 en ny dimension med nanet Europe med en enkelt konsolidering med nanet All Europe, som indeholder elementer på laeste nieau for alle europæiske områder. Under "Gem og udfør TurboIntegrator-proces" er der oplysninger om, hordan en TurboIntegrator-proces gemmes og udføres. Kapitel 4. Importér fra en TM1 -oersigt eller et udsnit 23

32 24 TM1 TurboIntegrator

33 Kapitel 5. Importér fra MSAS OLE DB til OLAP-datakilder Med IBM Cognos TM1 TurboIntegrator kan du importere data fra en hilken som helst ODBO-datakilde (OLE DB for OLAP), herunder Microsoft Analysis Serices. I dette afsnit ises, hordan du bruger TurboIntegrator til at importere kuber og dimensioner fra Microsoft Analysis Serices. En OLE DB til OLAP-datakilde identificeres med følgende parametre: ODBO-udbydernan ODBO-placering ODBO-datakilde ODBO-katalog ODBO-udbydernan Det nan, der er tildelt af ODBO-udbyderen, som identificerer deres elle flerdimensionale databaseserer. For eksempel anender TM1 OLE DB MD Proider, og Microsoft Analysis Serices anender "Microsoft OLE DB Proider for OLAP Serices 8.0". TurboIntegrator iser kun de ODBO-udbydere, du har installeret på sereren. ODBO-placering Placeringsfeltet er nanet på den placering, hor en administrator tildeler en bestemt forekomst af ODBO-udbydersericen. Den nøjagtige fortolkning af dette felt er leerandørafhængig. ODBO-datakilde Dette er nanet, som administratoren tildeler en gruppe kataloger på en bestemt placering. I Microsoft Analysis Serices er det nanet på en registreret serer. ODBC-katalog Dette er det nan, der er tildelt af administratoren til en bestemt samling af databaser (kuber, dimensioner og andre objekter). For Microsoft Analysis Serices er det nanet på databasen. Forbindelsesstreng: MSAS s. TM1 TM1 OLE DB for OLAP Proider er ændret, så den gier større fleksibilitet for programmører ed bygning af forbindelsesstrenge. Dette ble gjort for at gøre TM1 -forbindelsesstrenge kompatible med MSAS-forbindelsesstrenge. I tidligere ersioner af TM1 kræede pålogning ia TM1 OLE DB Proider følgende felter: Copyright IBM Corp. 2007,

34 Felt Placering Eksempel på indstilling Minserer Maskinnanet på TM1 -admin-sererært. Datakilde Sdata Nanet på TM1 -sereren. brugerid Admin TM1 -brugernanet. kodeord Apple Kodeordet til TM1 -brugeren. Du kan bruge oenstående parametre, eller du kan logge på TM1 ed hjælp af parametrene i følgende tabel. Disse parametre anendes også til at oprette forbindelse til Microsoft Analysis Serices fra TurboIntegrator. Felt Datakilde Eksempel på indstilling Minserer Maskinnanet på TM1 -admin-sererært. Katalog Sdata Nanet på TM1 -sereren. brugerid Admin TM1 -brugernanet. kodeord Apple Kodeordet til TM1 -brugeren. Opret forbindelse til en OLE DB til OLAP-datakilde ed brug af CAM-alidering His din TM1 -serer er konfigureret til at bruge CAM-alidering (Cognos Access Manager), skal du angie den CAM-naneområde-id, der bruges af sereren, når der oprettes forbindelse til en ODBO-datakilde. Du kan angie CAM-naneområdet i afsnittet Yderligere forbindelsesparametre på skillebladet Forbindelse i TurboIntegrator. CAM-naneområde-id'en skal angies i følgende format: Proider String="CAMNamespace=<CAM Namespace ID>" <CAM-naneområde-id> skal ære den interne CAM-naneområde-id - ikke det beskriende nan på naneområdet. 26 TM1 TurboIntegrator

35 Eksempel: Nedenstående tabel iser en CAM-naneområde-id, NTLM_NAME- SPACE, som indgår i egenskaben Yderligere forbindelsesparametre. Egenskab ODBO-udbyder ODBO-placering ODBOdatakilde ODBO-katalog ODBO-brugerid ODBO-kodeord Værdi IBM Cognos TM1 OLE DB MD-udbyder localhost Planning Sample user@mycompany.com (CAM-brugernanet på TM1-kildesereren) password_for_cam_userid Yderligere Proider forbindelsesparametre String="CAMNamespace=NTLM_NAMESPACE";InitialCatalog=empty Importér en MAS-kube Denne procedure beskrier, hordan en enkel kube skal importeres fra Microsoft Analysis Serices til TM1. Sådan importerer du en kube til TM1 fra Microsoft Analysis Serices: 1. Etablér forbindelsen til MAS-datakilden. Der er flere oplysninger i Opret forbindelse til Analysis Serices med TurboIntegrator. 2. Angi hilken kube, du importerer. Der er flere oplysninger i Angi kuben med skillebladet Indlæs ODBC-kube på side Definér dimensionerne. Der er flere oplysninger i Brug af skillebladet Kubedimensioner på side Gem processen, og udfør den. Der er flere oplysninger i Gem og udfør MAS-processen på side 29. Opret forbindelse til Analysis Serices med TurboIntegrator Brug TurboIntegrator til at oprette en proces, der opretter forbindelse til Microsoft Analysis Serices. 1. Udfør Architect, og log på med et gyldigt brugernan og kodeord. 2. Højreklik på Processer, og ælg Opret ny proces. Dialogboksen TurboIntegrator ises. 3. Klik på indstillingen ODBO, og ælg derefter Kube. Dialogboksen iser de indstillinger, der gør det muligt at oprette en ODBOforbindelsesstreng. Kapitel 5. Importér fra MSAS 27

36 4. Angi forbindelsesparametre i dialogboksen på følgende måde: Felt Værdi ODBO-udbyder Vælg Microsoft OLE DB Proider for OLAP Serices. ODBO-placering Lad denne parameter ære tom. ODBO-datakilde Angi maskinnanet på den serer, der er ært for Analysis Serices. ODBO-katalog Angi databasenanet på Analysis Serices. His du f.eks. il importere data fra Microsoft-eksempeldatabasen, skal du indtaste FoodMart 2000 i dette felt. ODBO-bruger-id Angi et gyldigt brugernan til Analysis Serices-databasen. ODBO-kodeord Angi et gyldigt kodeord til dette brugernan til Analysis Serices-databasen. Yderligere forbindelsesparametre Nogle ODBO-serere kan kræe yderligere parametre for at kunne oprette forbindelse. Angi parametrene i dette felt adskilt af semikolonner. 5. Klik på Tilslut. His du får oprettet forbindelse, blier knappen Tilslut gråtonet, og du kan fortsætte til skillebladet Indlæs ODBO-kube. Angi kuben med skillebladet Indlæs ODBC-kube På skillebladet Indlæs ODBO-kube kan du angie, hilken kube du importerer fra Analysis Serices sammen med andre oplysninger. Følg disse trin for at udfylde dette skilleblad. 1. Klik på skillebladet Indlæs ODBO-kube. 2. Vælg en kubehandling. Valgmulighederne beskries i følgende tabel: Indstilling Beskrielse Opret kube Kopierer data og metadata fra ODBO-datakilden og opretter en ny kube i TM1. Brug kun denne indstilling, når ingen af kuberne og dimensionerne, du importerer, findes på sereren. Opret kube igen Sletter en eksisterende kube, og genopbygger den med data og metadata fra ODBO-datakilden. Brug kun denne indstilling, når kuberne og dimensionerne findes, og du il erstatte dem med nye strukturer og data. Opdatér kube Kopierer data fra en eksisterende ODBO-kube, og indsætter den i en eksisterende kube. Denne indstilling ændrer ikke strukturen på kuber og dimensioner på sereren. 28 TM1 TurboIntegrator

37 Indstilling Ingen handling Beskrielse Standardærdien for skærmen. Processer, der angier Ingen handling, har ingen indflydelse på kubens data eller metadata. Brug det til at teste og fejlsøge i processer eller til at definere dine egne tilpassede operationer. Vælg Opret kube i dette eksempel. 3. Klik på Vælg ODBO-kube fra, og ælg en Analysis Serices-kube, der skal importeres til TM1. 4. Klik i feltet Vælg TM1-kube, der skal indlæses til. Angi et entydigt nan på kuben. 5. Vælg Lagring af ærdier på skærmbilledet Datahandling. Denne indstilling skrier celleærdier i ODBO-kuben til kuben. Med indstillingen Akkumulér ærdier kan du lægge ærdier sammen, efterhånden som de importeres. Brug af skillebladet Kubedimensioner Fra skillebladet Kubedimensioner kan du behandle importerede dimensioner, når de importeres til TM1. Som standard importeres alle dimensioner i ODBO-kuben. De oprettes i TM1 som nan_. For eksempel når dimensionen [customer] importeres i Analysis Serices, blier den tilhørende dimension i TM1 kaldt Customer_. I denne dialogboks findes følgende indstillinger: Du kan ælge at mappe ODBO-dimension til en eksisterende dimension. Det gør du ed at klikke på en dimension i kolonnen TM1-dimension og ælge en anden dimension. Du kan også importere ODBO-dimensionens elementer til en helt ny dimension. Klik i den tilhørende celle under kolonnentm1 -dimension, og skri derefter nanet på den nye dimension. Erstat f.eks. dimensionen customer_ med en dimension med nanet MinKundeDim. For her importeret dimension skal du ælge TM1 -dimensionsfunktionen. Vælg en af følgende indstillinger: Indstilling Opret Filtrér kun - MDX Ingen handling Beskrielse Importerer dimensionsdata fra ODBO-kuben og opretter en ny dimension med hele elementsættet fra dimensionen. Dette er standardhandlingen. Importerer dimensionsdata fra ODBO-kuben og opretter en ny dimension med et begrænset sæt elementer. Importér ikke denne dimension fra ODBO-datakilden. Gem og udfør MAS-processen Når du har udført dine ændringer på skillebladet Kubedimensioner, skal du klikke på for at gemme og udføre processen. Dialogboksen Gem proces som åbnes. Kapitel 5. Importér fra MSAS 29

38 Importér en MAS-dimension Gi processen et nan. Gi processen et nan i forhold til de data, du importerer. I dette eksempel skal du indtaste ODBO_Sales_Import. TM1 importerer dine data og opretter den nye kube. Der ises en dialogboks med status for importen. I dette afsnit beskries, hordan en dimension importeres fra Microsoft Analysis Serices til TM1. Følgende tabel iser dimensionen, som den ises i Analysis Serices. Figur 1. Eksempeldimension TM1 kræer, at alle elementer i en dimension har entydige nane. TM1 kræer også, at alle aliasser til elementerne har entydige nane. For at sikre at elementnanene er entydige, nangier TM1 alle konsolideringer og elementer i en importeret dimension med nanene på alle dets oerordnede i kantede parenteser adskilt af punktummer. Efter import til TM1 udfyldes udsnitsaliasserne med elementnanene fra Analysis Serices. Proceduren med at importere MAS-data ligner andre importprocesser. Definér MAS-forbindelsesparametre Det første trin ed import af Analysis Serices-dimensionen til TM1 er at oprette forbindelse til Analysis Serices og ælge indstillingen ODBO-dimension. Følg disse trin: 1. Udfør Architect, og log på med et gyldigt brugernan og kodeord. 2. Højreklik på Processer, og ælg Opret ny proces. Dialogboksen TurboIntegrator ises. 3. Klik på indstillingen ODBO, og ælg derefter Dimension. 4. Angi forbindelsesparametre i dialogboksen på følgende måde: 30 TM1 TurboIntegrator

39 Felt Værdi ODBO-udbyder Vælg Microsoft OLE DB Proider for OLAP Serices. ODBO-placering Lad denne parameter ære tom. ODBO-datakilde Angi maskinnanet på den serer, der er ært for Analysis Serices. ODBO-katalog Angi databasenanet på Analysis Serices. His du f.eks. il importere data fra Microsoft-eksempeldatabasen, skal du indtaste FoodMart ODBO-bruger-id Angi et gyldigt brugernan til Analysis Serices-databasen. ODBO-kodeord Angi et gyldigt kodeord for denne bruger til Analysis Serices-databasen. Yderligere forbindelsesparametre Lad dette felt ære tomt. 5. Klik på Tilslut. Knappen Tilslut blier gråtonet, hilket betyder, at der er oprettet forbindelse. Brug af skillebladet Indlæs ODBO-dimension Når du har oprettet forbindelse til Analysis Serices, skal du angie oplysninger om kilde- og destinationsdimensioner til dimensionsindlæsningsprocessen. Følg disse trin: 1. Klik på skillebladet Indlæs ODBO-dimension. 2. Vælg TM1 -dimensionsfunktion. Vælg en af følgende indstillinger: Indstilling Beskrielse Opret dimension Kopierer en dimension fra ODBO-datakilden og opretter en ny dimension. Opret dimension igen Sletter en eksisterende dimension, og genopbygger den med data fra ODBO-datakilden. Kapitel 5. Importér fra MSAS 31

40 Indstilling Opdatér dimension Ingen handling Beskrielse Opdatér dimension antager, at TM1 allerede har en dimension, som du il indsætte eller slette elementer i. His der er elementer i ODBO-datakilden, men ikke i TM1 : Elementerne tilføjes til dimensionen. His elementerne findes i TM1, men ikke i ODBOdatakilden, blier disse elementer ikke påirket af importen. Der foretages ingen ændringer til elementerne i den lokale dimension. His elementerne findes i ODBO-datakilden og den lokale dimension, importeres elementerne fra ODBO-datakilden, og de blier oprettet i den lokale dimension som <elementname>_1. Bemærk, at dette øger størrelsen på dimensionen. Standardærdien for skærmen. Processen har ingen indflydelse på dimensionen. 3. Klik på listen ODBO-kube indeholdende dimensionen, og ælg kuben, der indeholder den dimension, du il importere fra Analysis Serices. 4. Klik på listen Kubedimensioner, og ælg den dimension, du il importere. 5. His du opdaterer eller opretter en dimension igen, skal du klikke på TM1- dimension, der skal indlæses og ælge en dimension på listen. His du opretter en ny dimension, skal du skrie nanet på den nye dimension i feltet TM1 -dimension, der skal indlæses. Gem og udfør dimensions-mas-processen Når du har udført dine ændringer på skillebladet Indlæs ODBO-dimension, skal du klikke på ikonen Udfør for at gemme og udføre processen. Dialogboksen Gem proces som åbnes. Gi den nye proces et nan, og klik derefter på Gem. Importen begynder, og TM1 iser en dialogboks med status på importen. TM1 - Meddelelseslog Når processen er udført, kan der blie skreet mindre fejl til TM1 -meddelelsesloggen. His det er tilfældet, iser TM1 en meddelelsesboks. His du il hae ist serermeddelelsesloggen, skal du højreklikke på TM1 Serer i Serer Explorer og ælge Vis meddelelseslog. Dobbeltklik på fejlen i meddelelsesloggen for at få ist oplysninger om fejlen. 32 TM1 TurboIntegrator

41 Kapitel 6. Importér data med IBM Cognos TM1 Package Connector IBM Cognos TM1 Package Connector understøttes aktuelt til brug sammen med IBM Cognos Business Intelligence-pakker mod relations- og ODBC-datakilder. Der er flere oplysninger om den understøttede software under linket Supported Hardware and Software på ( dociew.wss?uid=swg ). Udfør følgende opgaer, når du importerer pakker ed hjælp af TM1 Package Connector: Opret en pakke i Framework Manager. Opret en TurboIntegrator-proces, der anender TM1 Package Connector. Dette emne beskrier, hordan du bruger TM1 Package Connector og indeholder også oplysninger om oprettelse af en pakke i Framework Manager. IBM Cognos TM1 Package Connector fungerer ikke med 64-bits ersioner of TM1 Perspecties eller TM1 Architect. IBM Cognos Package Connector er en algfri komponent, der er gemt på en separat cd, ds. ikke placeret på den primære TM1 -installationsdisk. Der er oplysninger om installation og konfigurering af IBM Cognos TM1 Package Connector i afsnittet "Installing the IBM Cognos TM1 Package Connector" i Planning Analytics Installation and Configuration-dokumentationen. Opret forbindelse til en Cognos BI Serer Når komponenterne er installeret og konfigureret, skal du følge denne ejledning for at oprette forbindelsen: 1. Udfør TM1. 2. Højreklik på gruppen Processer i det enstre indue i TM1 Serer Explorer, og ælg Opret ny proces. Vinduet TurboIntegrator åbnes. 3. Vælg IBM Cognos-pakke i dialogboksen Datakildetype. 4. Pakke er som standard algt. Husk: Pakke og dimension Ved hjælp af algmuligheden Pakke og dimension importeres data på en forenklet måde fra dimensionsmodellerede kilder, og det er ikke let at tilpasse dem. Du kan i stedet ælge Dimension, his du kun il importere hierarkier fra en enkelt dimension i en pakke. Tilpasset forespørgsel Valgmuligheden Tilpasset forespørgsel fungerer sammen med DMR og Copyright IBM Corp. 2007,

42 ikke-dmr-kilder og gier mere fleksibilitet mht. alg af elementer, der skal forespørges om, og sikrer en mere åben adgang til standard Turbo- Integrator-programmeringsmuligheder. Der er flere oplysninger i Opret forbindelse til publicerede pakker. 5. Angi forbindelsesoplysninger: His din IBM Cognos BI-serer tillader anonym logon, kan du klikke på "Log på." Ellers skal du angie dine logonoplysninger her: Valideringsnaneområde Listen iser alle tilgængelige alideringsnaneområder. Bruger-id og Kodeord Angi bruger-id og kodeord på en bruger i det algte alideringsnaneområde. Logons Gør det muligt for dig at håndtere logonoplysninger, der er knyttet til Turbo- Integrator-processen. Knappen blier aktieret, når du er logget på BI-sereren. Et logon med nanet "BI-sererlogon" oprettes automatisk for dig første gang, du aliderer med BI-sereren. His du opdaterer oplysningerne på skillebladet Forbindelse efter den første logon, opdaterer ændringerne ikke denne logon. Du skal bruge dialogboksen Administrér logons for at foretage ændringer til logonfunktionen. Du kan tilføje, ændre og fjerne logons. His du angier legitimationsoplysninger på skillebladet Forbindelse, og derefter klikker på Log på og ændrer Logon i induet Logon, opdateres legitimationsoplysningerne på skillebladet Forbindelse ikke. His du fjerner en logon, kan det medføre, at TurboIntegrator-processen ikke kan køre, his anonym logon deaktieres. Når du arbejder med dimensioner og målinger, kan der blie oprettet datakildelogons. Disse kan også administreres ia induet Logons. Log på/log af Klik på Log på for at logge på BI-sereren. Når du er logget på, aktieres Log af, så du kan logge af BI-sereren. Opret forbindelse til publicerede pakker - Pakke- og dimensionsindstilling Når du har oprettet forbindelse til BI-sereren, skal du flytte til skillebladet Pakke og ælge den pakke, du il arbejde med. His du ikke importerer målinger, efter du har algt en pakke, skal du fortsætte til skillebladet Dimension. 1. Klik på knappen Gennemse for at ælge mellem de tilgængelige pakker. Kun pakker, der indeholder dimensioner, kan ælges. Når har algt en pakke i induet Gennemse metadata, blier feltet Vælg pakke automatisk udfyldt. Knappen Redigér aktieres, når en pakke er algt. 2. Vælg indstillingen TM1-kube, der skal indlæses til. His du opretter en kube, skal du angie kubenanet. His du opretter en kube igen eller opdaterer en eksisterende kube, skal du ælge den på listen. 3. Angi de importhandlinger, der skal udføres. 34 TM1 TurboIntegrator

43 Angi indstillinger for Kubehandling og Datahandling til denne import som for enher anden type datakilde. I Mapningsariabler er der flere oplysninger. 4. His du il definere dimensioner i pakken, skal du klikke på skillebladet Dimension. 5. Definér hierarki- og attributstrukturen ed hjælp af dialogboksen, der ises, når du klikker på Vælg hierarkier eller Vælg attributter. Husk følgende oplysninger om hierarkier og attributter: Standardhierarki His du angier TM1 -dimensionen uden først at ælge hierarkier, ælger TM1 automatisk den første som standardhierarki. Du kan ændre alget ed at markere eller fjerne markeringen fra afkrydsningsfelterne. Vælg før mapning Du kan ælge hierarkier og alle underelementer som f.eks. filtre før mapning til en dimension. Når du udfylder dimensionen på den forudalgte hierarkidimension, tilføjes alle alg automatisk. His du fjerner markeringen fra en mappet dimension ed at fjerne dimensionsnanet i feltet, blier alle forudalgte hierarkier under de tilhørende dimensioner automatisk fjernet. Nan ersus Reference Hierarki iser hierarkinan og hierarkireference for klart at identificere det angine hierarki. Hierarkinan kan gentages, men hierarkireference er entydig. Filtre His et filter er defineret i pakken, og et hierarki ælges, blier knappen Vælg filtre tilgængelig, så du kan ælge filtre, der skal tilføjes. Filteret skal ære releant for det algte hierarki, ellers blier forespørgslen muligis ikke udført. Flere nieauer i et hierarki IBM Cognos tillader brugere at definere flere nieauer i et hierarki. Når et hierarki definerer flere nieauer, kan attributnane blier gentaget på tærs af forskellige nieauer. I en dimension med nanet By kan det f.eks. indeholde By, Geografi, Geografi_link os. I hert hierarki kan der ære defineret flere nieauer. Du kan f.eks. hae dimensioner som Nieauetiket, Nieaunummer, Entydigt hierarkinan os., som er de samme på tærs af forskellige nieauer under forskellige hierarkier. TM1 udfører konsolideringen af attributterne på basis af to faktorer: Eksternt attributnan og attributroller. Rangfølgen er først det eksterne attributnan og derefter attributrollerne. His en attribut indeholder den samme ærdi for Eksternt attributnan som en anden attribut, blier disse attributter konsolideret. His en attribut ikke indeholder det eksterne nan, blier dens rollesignatur (hor alle roller er sammensat til en rollesignatur) ealueret som faktoren til konsolideringen. I denne sammenhæng heniser "sammensat" til elementer med identiske roller, der grupperes sammen i en enkelt TM1 -attribut Når du angier attributmapning, blier alle attributter, his eksterne nan eller rollesignatur passer til de mappede attributter, algt under importen. Flere attributter kan mappes. 6. Vælg attributter Map en dimensionsattribut til en TM1 -attribut ed at udføre et af følgende: Kapitel 6. Importér data med IBM Cognos TM1 Package Connector 35

44 His du il mappe en attribut til en ny attribut, skal du angie et nan på den nye attribut i det tilhørende TM1 -attributfelt og derefter ælge en attributtype. Den nye attribut oprettes, når du udfører TurboIntegrator-processen. His du il mappe en attribut til en eksisterende attribut, skal du klikke på det tilhørende felt TM1-attribut, ælge en attribut og derefter ælge en Attributtype. Attributtype Tekst Numerisk Alias Beskrielse Identificerer attributter med en strengærdi. Identificerer attributter med en numerisk ærdi. Identificerer attributter, der er alternatie nane til dimensioner, som de knyttet til. Du kan bruge denne attribut til at få ist dimensioner ed deres alternatie nane i TM1 -brugergrænsefladen. Et dimensionsalias skal ære entydigt fra alle andre dimensionsaliasser eller faktiske dimensionsnane. Du skal nu mappe målinger til en dimension. Målinger ises som den sidste række på skillebladet Dimensioner. Målinger skal ælges ed at klikke på Vælg målinger. TurboIntegrator ælger ikke på forhånd målingerne, da der ikke er nogen standardmålinger. 7. Klik på Vælg målinger. Dialogboksen Vælg målinger ises. Bemærk: En pakke kan hae flere måledimensioner. Nanet på målingen inkluderer måledimensionsnanet fra pakken. 8. Vælg de enkelte målinger, du il importere til TM1. 9. Klik på Filtre for at ælge filtre, der skal anendes på målingsforespørgslen. Filteret skal ære releant for det algte hierarki, ellers blier forespørgslen muligis ikke udført. 10. Klik på OK. 11. Map målingerne til en dimension. His målingerne mapper til en eksisterende dimension, skal du klikke på kolonnen TM1-dimension og ælge den dimension, der sarer til målingen. His du il oprette en ny dimension fra målingen, skal du angie nanet på dimensionen i kolonnen TM1 -dimension. 12. Vælg en TM1 -dimensionsfunktion til målingerne. 13. Indstillinger for dimension Brug skillebladet Indstillinger for dimension til at definere Øerste konsolidering for angine dimensioner. 14. Redigér prompt Du kan klikke på knappen Prompt for at åbne et Cognos-promptindue for at angie og ændre promptærdier. His obligatoriske prompter findes i pakken, skal der angies promptærdier, før forespørgslen udføres af TurboIntegratorprocessen. Ellers udføres processen ikke. Du kan bruge knappen Prompter til brugergrænsefladen for at tillade angielse af ærdier eller interaller. Klik i cellen under kolonnen Værdi for at angie promptærdien. Eller du kan bruge følgende TurboIntegrator-processer/API'er. 36 TM1 TurboIntegrator

45 His du kender promptnanene, kan du direkte kalde CGAddPromptValues ed at angie promptnanet og -ærdier. Disse funktioner skal indtastes i prologen til den oerordnede TurboIntegrator-proces. Med disse funktioner kan du hente prompter, der er defineret i TurboIntegrator-processen. His du il definere dem i den underliggende TurboIntegratorproces, skal du hae startet induet Prompter i TurboIntegrator-processen. Klik på Prompter, træk prompterne fra alle definerede forespørgsler, og klik på OK for at gøre dem tilgængelige. Her gang du ændrer en dialogboks, skal du klikke på OK for at gøre prompterne tilgængelige. API til TurboIntegrator-proces CGPromptSize() Beskrielse returnerer det samlede antal prompter, der skal angies CGPromptGetNextMember(int index) returnerer prompten efter indeks (0- (CGPromptSize()-1)) CGAddPromptValues(promptName, angier promptærdier ed angiet promptnan ærdi 1, ærdi 2...) Eksempel count=cgpromptsize(); while(i<count); prmptname=cgpromptgetnextmember(i); CGAddPromptValues(prmptname, , ); i=i+1; end; 15. Når der er mappede dimensioner, hierarkier og målinger, kan du teste forespørgslen ed at klikke på Test forespørgsler. Test forespørgsler trigger udførelse af forespørgsler, før TurboIntegrator-processen udføres. Den bruges til at teste, om forespørgsler udføres korrekt og til at angie manglende promptærdier eller logonoplysninger. 16. Klik på afkrydsningsfeltet Vis naneområde for at inkludere naneområdet på listen Dimension. 17. Udfyld skillebladene Udidet og Plan, his det er nødendigt. Under Redigér udidede procedurer og job er der oplysninger. Package Connector genererer også TurboIntegrator-processen til de enkelte dimensioner. Det gier fleksibilitet til at tilføje dine egne scriptsætninger for TurboIntegrator-processen, his det er nødendigt. 18. Gem og udfør TurboIntegrator-processen. Se Gem og udfør TurboIntegratorprocessen. Flere hierarkier IBM Cognos TM1 Package Connector inkluderer kun ét hierarki pr. dimension ed udførelse af en målingsforespørgsel. His du ælger mere end ét hierarki til en dimension og inkluderer målinger i TurboIntegrator-processen, udfører TM1 Package Connector flere målingsforespørgsler, og erstatter hert hierarki efter tur. Denne funktionalitet er releant, his medlemmerne på laeste nieau til hert hierarki er forskellige fra hinanden. His medlemmerne på laeste nieau er de samme i hierarkierne, skal du oprette en TurboIntegrator-proces ed kun at ælge ét hierarki pr. dimension sammen med de ønskede målinger. Opret en separat proces for at flette flere hierarkistrukturer i den samme dimension. Kapitel 6. Importér data med IBM Cognos TM1 Package Connector 37

46 Importér en enkelt dimension Du kan bruge indstillingen Dimension på skillebladet Datakilde som en hurtig måde til at definere en enkelt dimension. Vælg Dimension i IBM Cognos-pakkeindstillingen til direkte at åbne skillebladet Dimension og angie de handlinger, der skal udføres og til at definere hierarkierne. 1. Find pakken. Klik på knappen Gennemse for at ælge mellem de tilgængelige pakker. 2. Identificér den Dimension, der skal indlæses fra:. Menuen iser de tilgængelige dimensioner i den algte pakke. 3. Identificér den TM1-dimension, der skal indlæses til: Menuen iser de tilgængelige dimensioner, his du opdaterer en eksisterende dimension. 4. Vælg en TM1-dimensionsfunktion på samme måde som for alle andre datakilder. I Mapningsdimensioner er der flere oplysninger. 5. Identificér Øerste konsolidering: His du il oprette en konsolidering på øerste nieau til dimensionen, skal du angie nanet på konsolideringen på øerste nieau her. Resultatdimensionen omfatter en konsolidering med det nan, du har indtastet. His du f.eks. indtaster Total i Øerste konsolidering, inkluderer dimensionen konsolidering på øerste nieau med nanet Total med alle importerede elementer som underordnede til konsolideringen. 6. Når der er mappede dimensioner, hierarkier og målinger, kan du teste forespørgslen ed at klikke på Test forespørgsler. Test forespørgsler trigger udførelse af forespørgsler, før TurboIntegrator-processen udføres. Den bruges til at teste, om forespørgsler udføres korrekt og til at angie manglende promptærdier eller logonoplysninger. Opret forbindelse til publicerede pakker - Indstillingen Tilpasset forespørgsel Du kan bruge indstillingen Tilpasset forespørgsel i IBM Cognos TM1 Package Connector til at oprette forbindelse til enher type dimensionalt modelleret kilde for at oprette en tilpasset forespørgsel. Den tilpassede forespørgsel er den eneste måde at oprette forbindelse til en ikke-dimensionalt modelleret kilde på. Om denne opgae Når du har oprettet forbindelse til IBM Cognos Business Intelligence (BI)-sereren, skal du angie den kildepakke, du il arbejde med, samt de felter i kildepakken, som du il importere til IBM Cognos TM1 i processen. 1. Klik på knappen Gennemse for at ælge mellem de tilgængelige pakker. Når du har algt en pakke i induet Gennemse metadata, blier feltet Vælg pakke automatisk udfyldt. Knapperne Redigér og Redigér forespørgsel blier tilgængelige, når en pakke er algt. 38 TM1 TurboIntegrator

47 Knappen Redigér iser oplysninger om datakilden og gør det muligt at oprette en tilpasset logon, his logon til indholdslageret kræer et kodeord. 2. Klik på knappen Redigér forespørgsel. De felter, der er til rådighed i kildepakken, ises. 3. Vælg hert felt, der skal bruges til udtrækningen, og ælg Tilføj. 4. Vælg Forespørgselsindstillinger: Prøe Viser en søjleformet liste. MDX iser den kode, der bruges til transformationen. Lig med Linker et forespørgselselement fra kildepakken eller -rapporten til en kolonne i forespørgslen. Det er kun nødendigt, his kilden er bleet ændret, og et forespørgselselement er bleet flyttet eller omdøbt. Ved hjælp af Lig med kan du sammenholde sikkerhedskopierne af kolonnerne og forespørgselselementer igen efter flytning eller omdøbning af et element. Automatisk opsummering Valgt som standard. Forespørgslen genererer SQL for at aggregere rækker. Til forespørgsler, der er baseret på relationelle pakker, kan du ed at aktiere funktionen Automatisk opsummering reducere det antal rækker, som Cognos TM1 Package Connector henter fra kildedataene, og dered yderligere forbedre ydeenen for kubens bygning. His kildedataene bruges på samme granularitet som den underliggende tabel, skal det ikke markeres. His kildedataene ikke er konsolideret, skal det markeres. Kontrollér, at forespørgslen har defineret korrekte attributter for id og faktabrug, for at denne indstilling er effekti. Disse indstillinger skal angies i kilden, enten Cognos Framework Manager eller rapporten. Gennemgå SQL for at sikre, at de korrekte grupperings- og opsummeringsfunktioner anendes. Brug ikke Automatisk opsummering til at beregne et gennemsnit. Normalt er det dog hensigtsmæssigt at benytte Automatisk opsummering. Undertryk NULL-ærdier Som standard er denne indstilling sat til at bruge kontrolindstillingen i den definerede pakke. Du tilsidesætter denne indstilling ed at ælge enten Ja (Undertryk NULL-ærdier) eller Nej (undertryk ikke). 5. Vælg knappen Validér for at erificere, at en gyldig forespørgsel kan genereres fra de algte oplysninger. 6. Klik på OK for at aktiere Prompter og knappen Prøe. Prompter Klik på Prompter, his promptærdier skal defineres.. Prøe Klik på Prøe for at få ist den MDX, der genereres, og for at få ist et eksempel på dataene, his du ønsker det. 7. Klik på skillebladet Variabler. Herfra er proceduren den samme som for enher anden TurboIntegrator-proces. Der er flere oplysninger i Identificér ariabler i datakilden på side 8. Gem, udfør og reidér TurboIntegrator-processen med TM1 Package Connector som datakilde Sådan gemmer, redigerer og udfører du processen. Kapitel 6. Importér data med IBM Cognos TM1 Package Connector 39

48 Om denne opgae Når du opretter en TurboIntegrator-proces ed brug af TM1 Package Connector som datakilde, gemmer TurboIntegrator det krypterede kodeord til Business Intelligence-alideringsnaneområdet. Når du redigerer en TurboIntegrator-proces, der bruger TM1 Package Connector som datakilde, skal du angie de legitimationsoplysninger, der skal bruges til at få adgang til Business Intelligence Serer, igen. Brug disse trin til at udføre en TurboIntegrator-proces. 1. Klik på knappen Udfør. TM1 beder om et nan, og om at du gemmer processen. 2. Gem processen. Der ises en bekræftelse på, at processen er udført. 3. Åbn Serer Explorer. Den kube, du har angiet, er nu bleet oprettet og udfyldt, og alle de påkræede dimensioner er oprettet. His du redigerer en TurboIntegrator-proces, skal du først angie de IBM Cognos BI-legitimationsoplysninger, som kræes for at få adgang til Business Intelligence Serer, igen. His du opretter en proces, skal du åbne tm1s.cfg og tilføje følgende konfigurationsparameter: EnableTIDatasourcePasswordAccess=T. Vis resultater Når du definerer en proces, der skal importere en pakke til TM1 og oprette en ny kube, sker der følgende: Til her dimension du ælger, som skal inkluderes i kuben, genererer TM1 en proces, der importerer dimensionen og opretter en tilhørende dimension. TM1 genererer en masterproces, der udfører oenstående processer, som opretter dimensioner, bygger kuben og importerer dataærdier. Det forespørgselselement, der er defineret som nøgle til nieauet i hierarkiet, anendes som elementnan. 40 TM1 TurboIntegrator

49 Kapitel 7. Redigér udidede procedurer Brug bulk load-tilstand I dette afsnit beskries administration af IBM Cognos TM1 TurboIntegrator-processer. Bulk load-tilstand aktierer TM1 til at køre i en speciel optimeret enkeltbruger- eller enkeltjob/procestilstand. Denne tilstand kan maksimere ydeenen for dedikerede opgaer på tidspunkter, hor der forentes lille eller ingen anden aktiitet. Eksempler på brug af bulk load-tilstand: En administrator, der manuelt skal udføre edligeholdelsesfunktioner. Et tidspunkt om natten, hor store mængder data indlæses. TM1 udføres typisk i flerbrugertilstand, hor flere brugere, job og processer alle kan anende samtidige data. I bulk load-tilstand forhindrer TM1 -sereren samtidig aktiitet ed midlertidigt at afbryde andre brugere, job og processer og eliminere de ekstra ressourcer, der kræes af et flerbrugermiljø. Bulk load-tilstand logger ikke automatisk brugere af, men afbryder kun midlertidigt deres forbindelse med TM1. Så snart bulk load-tilstanden er udført, blier brugere, der tidligere ar logget på, aktieret igen, og brugerinteraktionen med TM1 genoptages. Du kan aktiere bulk load-tilstand direkte i en TI-proces eller med TM1 API'et. I begge tilfælde skal du bruge kommandoer til at skifte til og forlade bulk load-tilstand. Bemærkninger til brug af bulk load-tilstand Oerej følgende, når du bruger bulk load-tilstand: Bulk load-tilstand iser ikke en meddelelse til brugerne for at adisere dem. Du skal planlægge og koordinere din brug af bulk load-tilstand ud fra det. Kun en enkelt bruger eller proces kan ære akti i bulk load-tilstand. Der kan ikke oprettes nye forbindelser til sereren, mens den fungerer i bulk load-tilstand. En TI-proces kan ikke bruge ExecuteCommand til at starte et kommandolinjeprogram for at logge på den samme TM1 -serer igen. Logonen blier ikke udført. Planlagte job, der er planlagt til at blie udført i aktieret bulk load-tilstand, blier deaktieret og udføres ikke. Start bulk load-tilstand Når sereren skifter til bulk load-tilstand, stoppes al behandling af andre tråde midlertidigt. Alle eksisterende brugertråde og igangærende job blier afbrudt. Kun den tråd, der startede bulk load-tilstanden, forblier akti. Alle planlagte job deaktieres med undtagelse af det job, der starter bulk load-tilstand. Alle systemspecifikke tråde og TM1 Top-forbindelse blier også afbrudt. Afslut bulk load-tilstand Når bulk load-tilstanden er deaktieret, blier alle system- og brugertråde genoptaget, og brugerlogoner blier tilladt. Copyright IBM Corp. 2007,

50 Tilpassede applikationer, der anender TM1 API til at aktiere bulk load-tilstand, skal også kalde den nødendige TM1 API-funktion for at afslutte bulk load-tilstand. His klientforbindelsen imidlertid blier afbrudt (netærket går ned, eller klienten logger af, går ned eller afbrydes), afslutter sereren automatisk bulk load-tilstand. På samme måde afslutter serer automatisk bulk load-tilstand, his en TI-proces eller TI-job udføres i bulk load-tilstand, og processen gennemføres (med eller uden fejl). Når sereren returnerer til normal flerbrugertilstand, blier job, som ar deaktieret, aktieret igen, og de ender tilbage til deres normale plan. His jobbene er planlagt til at blie udført men ble forhindret af bulk load-tilstanden, blier de ikke udført straks, men blier udført i henhold til planen. Det kan ære nødendigt at justere starttidspunktet på de planlagte job for at forhindre dem i at blie låst ude på de tidspunkter, hor du aktierer bulk load-tilstand. TurboIntegrator-proceskommandoer til bulk load-tilstand Du kan aktiere bulk load-tilstand i prolog- eller epilogafsnittet af en TI-proces. Af hensyn til effektiiteten anbefales det at aktiere bulk load-tilstand i den første, eller meget tæt på den første, sætning i prologafsnittet i processen. Når bulk load-tilstanden er aktieret i en proces, kan den kun deaktieres på den sidste linje i epilogafsnittet. His du forsøger at deaktiere bulk load-tilstanden et andet sted i processen, kompileres processen ikke. His tilstanden er aktieret i en TI-proces, forblier den aktieret, indtil den eksplicit deaktieres, eller indtil jobbet afsluttes. Det betyder, at du kan aktiere tilstanden i en proces i et job og derefter udføre en række TI-processer, før den deaktieres. Du kan også skifte til og afslutte bulk load-tilstanden gentagne gange og kun anende tilstanden til bestemte kritiske dele i jobbet. Brug følgende TI-kommandoer til at aktiere og deaktiere bulk load-tilstanden i en TI-tilstand. EnableBulkLoadMode() DisableBulkLoadMode() - Denne funktion kan kun anendes på den sidste linje i epilogafsnittet i TI-processen, når bulk load-tilstanden anendes. TM1 C API-funktioner til bulk load-tilstand Følgende TM1 C API-funktioner anendes til aktiering og deaktiering af bulk load-tilstand. Redigeringsprocedurer TM1SererEnableBulkLoadMode TM1SererDisableBulkLoadMode Der er flere oplysninger i IBM Cognos TM1 API-dokumentationen. Når du har angiet en datakilde, og har identificeret alle ariabler og defineret alle mapningsinstruktioner, genererer TurboIntegrator fire procedurer, der er baseret på de indstillinger, du har algt på TurboIntegrator-skillebladene. Disse procedurer identificeres som underordnede skilleblade på skillebladet Udidet. 42 TM1 TurboIntegrator

51 Der er følgende procedurer: Skilleblad Beskrielse Prolog En række sætninger, der skal udføres, før datakilden behandles. Metadata En række sætninger, der opdaterer eller opretter kube-, dimensions- og andre metadatastrukturer under behandlingen. Data En række sætninger, der behandler ærdier til her record i datakilden. Epilog En række sætninger, der skal udføres, når datakilden er behandlet. Du kan redigere disse procedurer for at inkludere TurboIntegrator-funktioner og TM1 -regelfunktioner, der udider mulighederne i TurboIntegrator. Du kan f.eks. redigere proceduren Data, så den inkluderer sætninger, der instruerer processen om at springe oer records med nulærdier eller skrie importerede records i en ekstern fil. Der er en fuldstændig lige oer alle tilgængelige TurboIntegrator- og TM1 -regelfunktioner i IBM Cognos TM1 Reference. Når du redigerer procedurer, skal du huske, at de enkelte procedurer er beregnet til at udføre bestemte typer handlinger på bestemte tidspunkter i en proces. Du skal derfor oprette handlinger eller sætninger, der passer til en gien procedure. Bemærk: Når datakilden til en proces er Ingen, ignoreres procedurerne Data og Metadata, når processen udføres. Funktioner eller sætninger på de underordnede skilleblade Data og Metadata udføres ikke, men TM1 iser ikke en fejl eller adarsel om, at en del af processen ikke er udført. Sådan redigeres en procedure: 1. Klik på skillebladet Udidet. 2. Klik på det underordnede skilleblad til den procedure, du il redigere. 3. Indsæt sætningerne i tekstfeltet enten før denne linje: #****GENERATED STATEMENTS START**** eller efter denne linje: Udfør en proces efter beho #****GENERATED STATEMENTS FINISH**** Vigtigt: Brugeroprettede sætninger kan indsættes før eller efter de genererede sætninger, men de kan ikke indsættes i de sætninger, der genereres af TurboIntegrator. His du il udføre en proces, når du il, skal du ælge processen i Serer Explorer og ælge Proces, Udfør proces. Du kan også udføre en proces fra TurboIntegrator ed at ælge Fil, Udfør. Kapitel 7. Redigér udidede procedurer 43

52 Brug af TM1RunTI 44 TM1 TurboIntegrator TM1RunTI er et ærktøj til kommandolinjegrænsefladen, som kan starte en IBM Cognos TM1 TurboIntegrator (TI)-proces eller -job inde fra enher applikation, der er i stand til at udstede styresystemkommandoer, ds. i stand til at udføre et systemkald. Denne funktion er af speciel interesse i applikationssituationer, hor TurboIntegrator-processer og -job skal grupperes, så det sikres, at processerne/jobbene kører parallelt. Den er også nyttig, fordi de processer og job, der ikke kan køre parallelt, så serialiseres i den rigtige rækkefølge. Bemærk, at TM1RunTI ikke afsluttes (returneres), før TurboIntegrator er afsluttet, hilket kan bruges til at serialisere kald, his kaldeprocessen eller -jobbet enter på, at TM1Runti skal afsluttes. Den eksekerbare TM1RunTI-fil (tm1runti.exe) findes i biblioteket bin i en TM1 -sererinstallation. Standardinstallationsplaceringen af tm1runti.exe er i C:\Program Files\IBM\ cognos\tm1\bin. Asynkrone kald og TM1 Kommandoen Udfør kræer to parametre. Den anden beskrier, om det skal ære et synkront eller et asynkront kald. Cognos TM1 -ærktøjer skal kun kaldes asynkront (Parameter 0) for at undgå sererfastlåsning, his systemet enter på en lås, der holdes af TurboIntegrator-processen/jobbet, og processen/jobbet enter på funktionen. Det samme råd gælder alle eksekérbare programmer, der kaldes af ExecuteCommand, his de logger på Cognos TM1. Bemærk: Brug aldrig et synkront kald, his ærktøjet logger på Cognos TM1. TM1RunTI-syntaks Syntaksen for TM1RunTI beskries i det følgende. tm1runti -? or tm1runti -help or tm1runt1 [<cmd_parm>...] [<ti_parm>...] where <cmd_parm> is one of: -i <filespec> -process <string> -chore <string> -connect <string> <connect_parm>... where <ti_parm> is: <parm_name> = <parm_alue> where <connect_parm> is one of: -adminhost <string> -serer <string> -user <string> -securitymode -retryattempts -retryinteral <password_parm> -AdminSrSSLCertAuthority <filespec> -AdminSrSSLCertID <id> -AdminSrSSLCertReList <filespec> -AdminSrSSLExportKeyId <id> -ExportAdminSrSSLCert <T F>

53 -CAMNamespace <string> where <password_parm> is one of: -pwd <string> -passwordfile <filespec> -passwordkeyfile <filespec> Parametre Parametre kan enten angies i en konfigurationsfil eller oerføres ia kommandolinjen. Parametre, der angies ia kommandolinjen, har forrang oer parametre, der er angiet i konfigurationsfilen. Dered er det muligt at hae konstante standardærdier for de relatit statiske parametre, f.eks. admin-ært og serer, samt mulighed for at angie ganske få parametre for enten at tilsidesætte standardærdier eller for at angie ærdier, der som regel ikke har standardærdier, f.eks brugernan eller TurboIntegrator-procesnan. Der benyttes et andet format, når en parameter angies ia kommandolinjen. Mens alle parametre oerføres som "-parameter_nan ærdi", behandles alt, som oerføres som "parameter_nan=ærdi" som en TurboIntegrator-procesparameter. Der er fire typer parametre: Kommandoparametre Bruges til at angie, hilken config-fil der skal bruges, hilken gruppe forbindelsesparametre der skal bruges, hilken TurboIntegrator-proces der skal udføres, eller hilket TurboIntegrator-job der skal udføres. Der skal kun angies en kommandoparameter ad gangen. His kommandolinjen indeholder både -process og -chore, il TM1RunTI udføre TurboIntegrator-processen og ignorere parameteren -chore. Forbindelsesparametre Bruges til at angie serernan, brugernan og andre oplysninger, der skal bruges til at oprette forbindelse til en Cognos TM1-serer. Kodeordsparametre Kan enten ære et brugernan og kodeord i almindelig tekst, eller et filnan, der indeholder et krypteret kodeord og en tilknyttet nøglefil til brug for dekryptering. TurboIntegrator-parametre Oerføres til den nangine TurboIntegrator-proces. De parametre, der angies ia kommandolinjen, skal indledes med en tankestreg (-) eller en skråstreg (/). Parameterærdien adskilles fra parameternanet med et mellemrum, og ærdien kan angies som den er eller i anførselstegn, his der er indlejrede mellemrum. Eksempel: tm1runti serer MyTM1Serer username John pwd "my secret" ti_parm1=yes ti_parm2="my alue" TM1RunTI-parametre Beskrielse Parameter i Værdi/Påkræet/Standardærdi Sti til konfigurationsfiler Streng/Nej/Ingen Kapitel 7. Redigér udidede procedurer 45

54 Beskrielse Parameter connect process chore help Værdi/Påkræet/Standardærdi Parameteren kan bruges til at angie et afsnit i konfigurationsfilen, der indeholder parametre til brug for oprettelse af sererforbindelser, f.eks. user, pwd, CAMnamespace os. Streng/Nej/Ingen Nanet på den TurboIntegrator-proces, der skal kaldes. Streng/Nej/Ingen Nanet på det TurboIntegrator-job, der skal kaldes. Streng/Nej/Ingen Viser hjælp på kommandolinjen (stdout). ikke anendelig/nej/ikke program? Viser en oersigt oer kommandolinjeparametre på kommandolinjen (stdout). ikke anendelig/nej/ikke program Connect-parametre Connect-parametre er almindelige i TM1-ærktøjer, og de kan defineres i deres eget afsnit for at udide genbruget og undgå besæret og risikoen, der er forbundet med at beare flere kopier. Parameter Værdi/Påkræet/ Standardærdi Beskrielse adminhost Streng/Nej/Ingen Cognos TM1-admin-ært seer Streng/Nej/Ingen Cognos TM1-serernan user Streng/Nej/Ingen Cognos TM1- eller CAM-nan AdminSrSSLCertAuthority Streng/Nej/ingen Den fuldstændige sti til filen med den certificeringsmyndighed, der har udstedt Cognos TM1-adminsererens certifikat. AdminSrSSLCertID Streng/Nej/ingen: API-standard er: tm1adminserer Nanet på den principal, som Cognos TM1-admin-sererens certifikat er udstedt til. Bemærk: Værdien af denne parameter bør ære ens identisk med SSLCertificateID-parameteren i filen Tm1admsr.ini. AdminSrSSLCertReList Streng/Nej/Ingen Den fuldstændige sti til den certifikattilbagekaldelsesfil, der er udstedt af den certificeringsmyndighed, som oprindeligt har udstedt Cognos TM1- admin-sererens certifikat. Der findes kun en certifikattilbagekaldelsesfil, his et certifikat er bleet tilbagekaldt. 46 TM1 TurboIntegrator

55 Parameter Værdi/Påkræet/ Standardærdi Beskrielse ExportAdminSrSSLCert Boolesk/Nej/F Angier, om certifikatet fra den certificeringsmyndighed, som oprindeligt udstedte Cognos TM1- admin-sererens certifikat, skal eksporteres fra certifikatlageret i Microsoft Windows ed runtime. His indstillingen er algt, skal du også angie en ærdi for AdminSrSSLEx-portKeyID som beskreet her. Find den releante TM1-sererkonfiguration i IBM Planning Analytics Installation and Configuration. AdminSrSSLExportKeyId Streng/Nej/Ingen Den id-nøgle, som bruges til at eksportere certifikatet fra den certificeringsmyndighed, som oprindeligt udstedte Cognos TM1- admin-sererens certifikat, fra certifikatlageret. Parameteren er kun nødendig, his du ælger at bruge certifikatlageret ed at angie ExportAdminSrSSLCert=T. Find den releante TM1- sererkonfiguration i IBM Planning Analytics Installation and Configuration. CAMNamespace Streng/Nej/ingen CAM-naneområde-id. Bemærk: Det er ikke nanet på CAM-naneområdet. Denne ærdi skal kun bruges, his Cognos TM1-sereren aliderer med CAM. TurboIntegrator-parametre Parametrene defineres af TurboIntegrator-processen og skal ære den korrekte type (tal eller streng). Beskrielse Parameter <ti_parm> Værdi/Påkræet/Standardærdi Angi strengen eller talærdien <alue> for parameteren med nanet <ti_parm>, som skal ære et gyldigt parameternan, som accepteres af den TurboIntegrator-proces, der udføres. <ærdi>/nej/ingen Kodeordsparametre Kodeord angies enten med almindelig tekst (anbefales ikke) ed hjælp af parameteren pwd eller ed hjælp af en krypteret fil, som angies med parameteren passwordfile. Kapitel 7. Redigér udidede procedurer 47

56 Parameter Værdi/Påkræet/ Standardærdi Beskrielse pwd Streng/Nej/Ingen Cognos TM1- eller CAM-kodeord passwordfile Streng/Nej/Ingen Den fuldstændige sti til den fil, der indeholder det krypterede kodeord for den angine bruger. His der ikke er angiet en sti, anendes Cognos TM1- sererbiblioteket. His denne indstilling angies, kan du ikke bruge -pwd. passwordkeyfile Streng/Nej/Ingen His passwordfile angies, er den fuldstændige sti til nøglefilen også påkræet, så kodeordet kan dekrypteres. Kodeordsfilen og nøglefilen kan oprettes ed hjælp af TM1Crypt-ærktøjet. Se også IBM Planning Analytics Installation and Configuration. TM1RunTI-konfigurationsfil TM1RunTI kan bruges med og uden en konfigurationsfil. His der er angiet en konfigurationsfil, læses denne fils parametre først. Parametre, der angies ia kommandolinjen, bruges derefter til at tilsidesætte dem, som er hentet fra konfigurationsfilen. Når en konfigurationsfil læses, henter TM1RunTI parametre fra [TM1RunTI]-afsnittet i konfigurationsfilen. His der findes en connect-parameter, hentes parameterærdier fra det tilknyttede afsnit [Connect <nan>] og bruges til at tilsidesætte alt, had der læses fra[tm1runti]. En -connect-parameter kan også angies ia kommandolinjen og tilsidesætter alle connect-parametre, der findes i konfigurationsfilen. Konfigurationsfilen indeholder: 1. Et enkelt TM1RunTI-afsnit. 2. Et eller flere afsnit, der definerer de TurboIntegrator-processer, der kan udføres. 3. Nul eller flere afsnit, der definerer forbindelsesparametre. Alle indgange skal starte i kolonne 1. Linjer, der starter med #, behandles som kommentarer. Afsnitsnane skal ære omgiet af firkantede parenteser [ ]. His et afsnitsnan gentages, benyttes kun det første. Parametre i et afsnit: må ikke ære omgiet af tomme linjer kan ises i tilfældig rækkefølge er angiet formatet nøgleord=ærdi. Parameterærdier skal ære omgiet af anførselstegn ("), his de indeholder mellemrum. 48 TM1 TurboIntegrator

57 Connect-afsnit For at lette edligeholdelse for forskellige serermiljøer, f.eks. udikling, test og produktion, kan connection-parametre angies for hert miljø i separate afsnit. Hert afsnit nangies ed hjælp af præfikset "Connect -" efterfulgt af et brugerdefineret nan. Eksempel: [Connect Production] [Connect Test] [Connect Deelopment] Procesafsnit Flere procesafsnit er tilladt. Hert afsnit har et nan, der sarer til en proces på sereren. Hert TurboIntegrator-procesafsnit bruges til at definere parametrene i TurboIntegrator-processen og deres standardærdier. His der er flere procesafsnit med samme nan, benyttes kun det første. Eksempel på konfigurationsfil I eksemplet ises afsnittet [TM1RunTI] og et afsnit for en enkelt TurboIntegratorproces ("my_ti_process"). Parametrene og deres standardærdier, som kan tilsidesættes af parametre angiet ia kommandolinjen, defineres under de indiiduelle afsnitsoerskrifter. [TM1RunTI] process=my_ti_process connect=production [Process - my_ti_process] num1="alue1" stringx="alue2" stringy="alue3" [Connect Production] adminhost= serer=mytm1serer user="mytm1adminserer" pwdfile="c:\tm1_admin_area\passwords\tm1_password.txt" AdminSrSSLCertAuthority=.\ssl\applixca.pem AdminSrSSLCertID=tm1adminserer AdminSrSSLCertReList= CAMNamespace=LOCAL_NTLM Behandlingslogik Konfigurationsparametre og kommandolinjeparametre behandles på følgende måde: 1. His angiet ed -i, åbnes konfigurationsfilen og eentuelle forbindelsesindstillinger, der er angiet i [TM1RunTI], behandles først. 2. Alle andre parametre i [TM1RunTI] behandles efterfølgende og kan tilsidesætte dem, der er angiet ia connect-parameteren. Kapitel 7. Redigér udidede procedurer 49

58 3. Kommandolinjeparameteren -connect behandles som det næste, his den findes. Den indlæser ærdier fra det tilknyttede [Connect - <forbindelse_nan>]- afsnit i config-filen og tilsidesætter eentuelle ærdier, der indlæses i de forrige trin. 4. De resterende kommandolinjeparametre behandles. His du f.eks. gemmer konfigurationsfilen i det foregående eksempel med nanet tm1tools.config og derefter udfører følgende: tm1runti i ".\tm1tools.config" passwordkeyfile c:\keystore\prodkey.dat connect prodsystem Eftersom parameteren -i er angiet, gør ærktøjet følgende: 1. Åbner config-filen og indlæser afsnittet [tm1runti] 2. Når det registrerer connect-parameteren i [tm1runti], indlæses parameterærdierne fra [Connect - testsystem] 3. Behandler kommandolinjeparametre: a. Når det registrerer connect-parameteren, indlæses parametrene fra [Connect prodsystem] b. Erstatter ærdien for passwordkeyfile. Nan på og placering af konfigurationsfil Kommandolinjeparameteren -i kan bruges til at angie nanet på en konfigurationsfil. Dette er især nyttigt, his flere Cognos TM1-serere understøttes i miljøet, fordi en anden konfigurationsfil kan anendes til de enkelte serere, og processer med ens nane på forskellige serere kan defineres med forskellige parametre. TM1RuntTI-returkoder og -fejlmeddelelser Følgende fejlmeddelelser anendes af TM1RunTI. Returkoder og fejlmeddelelser Returkode Meddelelse: Beskrielse 0 Ingen: Programmet er udført. 1 Kodeord ikke angiet: Kodeord er ikke angiet som et argument eller som en kodeordsfil. Kort hjælp: Nødendige parametre ikke angiet (bruger, serer, proces). Den korte hjælp sendes til stdout. Sarende til -? Ugyldigt antal parametre i <n>: Der er registreret flere parametre, end programmet faktisk understøtter. Det starter i <n> parameter. 2 Sererforbindelse er ikke oprettet: Programmet kan ikke oprette forbindelse til en Cognos TM1 -serer. 3 Kaldeproces<TI_name> er udført med mindre fejl: TurboIntegrator-processen er udført, men med mindre fejl. 4 Kaldeproces <TI_name> udført med meddelelser: TurboIntegrator-processen er udført, men har returneret meddelelser. 5 Fejl under hentning af kodeord: Programmet kan ikke hente kodeordet fra kodeordsfilen. En af de ørige iste fejlmeddelelser optræder muligis i stderr før denne og angier mere præcist, had problemet er. NULL nøgle er returneret fra læsning af nøglefilen <filnan>. 50 TM1 TurboIntegrator

59 NULL kodeord er returneret fra læsning af kodeordsfilen <filnan> Fejl under hentning af filstatus for <filnan> Fejl under åbning af <filnan>. Kan ikke allokere data til nøgle. Fejl under læsning af nøglefilen <filnan>. 6 TI-proces: <TI_name> ikke fundet på serer: <serer_name>: TI-processen er ikke fundet på den angine serer. 7 TI-proces: <TI_name>-parameteren kan ikke læses: Kan ikke læse parameteroplysninger fra TurboIntegrator-processen. 8 TI-proces: <TI_name> har ingen læseadgang: Den angine bruger har ikke læseadgang til TurboIntegrator-processen. 9 kaldeproces:<ti_name> har kaldt ProcessQuit.: TurboIntegrator-processen har kaldt ProcessQuit. 10 kaldeproces: <TI_name> er afbrudt: TurboIntegrator-processen er afbrudt. 11 TI-proces: <TI_name>-læsning af numerisk parameter <param_name>=<param_alue> ikke udført: En ikke-numerisk ærdi er oerført til en numerisk TurboIntegrator-parameter. 99 Anden TI-fejl: TurboIntegrator-processen er udført med en angiet fejl. Fejl returneres også fra TM1API. De ises som (TM1 API-fejl) <xxx>, hor <xxx> er den ærdi, der er defineret i TM1API. Udførelsestilstande og fejlbehandlingsbegrænsninger TM1RunTI kan udføres som en enkeltstående eksekérbar fil fra et styresystems batchscript eller fra en Cognos TM1 TurboIntegrator-proces. Den nemmeste måde at udføre TM1RunTI på er inde fra TurboIntegrator ed hjælp af kaldet ExecuteCommand() for at udføre den direkte. Eksempel: ExecuteCommand("tm1runti i myconfig.config -connect prodserer process update") Muligheden for at definere forbindelsesparametre og andre relatit statiske parameter i en konfigurationsfil gør det muligt at forenkle den parameterliste, der oerføres til TM1RunTI fra en kaldende TurboIntegrator-proces, samt at reducere edligeholdelse ed at centralisere forbindelsesoplysningerne. Udførelse af TM1RunTI direkte inde fra en TurboIntegrator-proces ha. ExecuteCommand() indeholder en igtig begrænsning. TM1RunTI returnerer en fejlkode, his den ikke udføres, men ExecuteCommand() returnerer ikke fejlkoden, og der er ingen mekanismer i TurboIntegrator til at få adgang til returkoden efter kaldet. En anden begrænsning, du skal ære opmærksom på, er, at processen benytter det samme aktuelle dre og bibliotek som den kaldende proces (sereren), som il ære databasebiblioteket. Der er flere oplysninger i TurboIntegrator-funktioner på side 2. Du håndterer fejl ed at udføre TM1RunTI fra et batchscript, der kaldes af ExecuteCommand, så fejlreturkoden kan hentes i CMD.EXE gennem ariablen ER- Kapitel 7. Redigér udidede procedurer 51

60 RORLEVEL, og så fejlmeddelelser kan logges eller registreres ed at omdirigere stderr. Der er forskellige muligheder til rådighed for programudikleren til brug for håndtering af fejlen: Skri fejloplysninger til databasen. Skri fejloplysningerne til en fil, og (i en efterfølgende TurboIntegrator-proces) indlæs oplysninger til en Cognos TM1 -kube. Kuben kan efterfølgende anendes til rapportering, adarsler os. Dette kunne skabe yderligere låsekonflikter i ersion og tidli- Bemærk: gere. Skri fejloplysningerne til en eller flere filer, og brug derefter FileExists() Turbo- Integrator-procesfunktionen inde fra den kaldende TurboIntegrator-proces til at teste om filen/filerne findes. Processen kan derefter udføre betingede handlinger, der er baseret på tilstedeærelsen af de filer, der er genereret af batchscriptet. Andre oerejelser edrørende TM1RunTI Yderligere oerejelser ed brug af TM1RunTI. Kodeordsikkerhed Det anbefales ikke at bruge kodeord på kommandolinjen til produktionsdistributioner. I stedet for at bruge kodeord på kommandolinjen skal kodeordet oerføres til programmet ed hjælp af parameteren passwordfile for at angie en fil, der indeholder krypterede kodeord. Der er også brug for en nøglefil, som skal dekryptere kodeordet, og denne angies ia parameteren passwordkeyfile. Filerne kan gemmes et sted, som det brugernan, der udfører ærktøjet, har adgang til, men de skal beskyttes af styresystemet, så andre brugere ikke kan få adgang til dem. En kombination af kodeord og nøgle kan genereres ed at bruge ærktøjet TM1Crypt, der er en del af standard-cognos TM1 -installationen. Der er flere oplysninger i IBM Planning Analytics Installation and Configuration. Flytbar på tærs af platforme Nanet på den eksekérbare TM1RunTI-fil (tm1runti.exe) er med små bogstaer af hensyn til forskellige platforme og til kompatibilitet med tm1top og andre Cognos TM1 -sererærktøjer. Serialisér TurboIntegrator-processer ed hjælp af synchronized() 52 TM1 TurboIntegrator IBM Cognos TM1 TurboIntegrator (TI)-funktionskald til synchronized() kan bruges i et TurboIntegrator-script til at gennemtinge seriel udførelse af et bestemt sæt TurboIntegrator-processer. Cognos TM1 -applikationsudiklere kan definere TurboIntegrator-processer (TI), der udføres som reaktion på brugerhandlinger eller udføres som batchprocesser. Medmindre TurboIntegrator-processer eksplicit er forhindret i det, kan de udføres parallelt. I isse applikationer bør TurboIntegrator-processer udføres serielt af hensyn til ydeenen. Inden introduktionen af denne nye funktion benyttede programudiklere dierse forskellige teknikker til at sikre, at TurboIntegrator-processer ble serialiseret. Den ene teknik går ud på at benytte objektlåse for at gennemtinge serialisering af processerne. Typisk skries en statusærdi til en kube for at aktiere kubens lås, når den klargøres til eksklusi adgangstilstand. Men indførelsen af parallel interak-

61 tion (PI) kan beirke, at denne metode ikke kan udføres. Som regel opstår der indbyrdes konflikt mellem dataskrininger. På denne måde skal en TurboIntegratorproces, der udføres i en kube, enten hente låsen og færdigudføres, eller også må den ente på, at låsen blier tilgængelig. I PI-tilstand tillader styring af flere samtidige ersioner, at flere skriefunktioner straks kan udføres. Da denne teknik ikke længere er gyldig, mens PI er aktieret, er synchronized() tilgængelig til eksplicit at starte serialisering i TurboIntegrator-proceskode. I afsnittet "TurboIntegrator-funktioner til proceskontrol" i kapitlet TurboIntegratorfunktioner i IBM TM1 Reference er der flere oplysninger om brugen af denne funktion. synchronized() IBM Cognos TM1 TurboIntegrator (TI)-funktionskald til synchronized() kan bruges i et TurboIntegrator-script til at gennemtinge seriel udførelse af et bestemt sæt TurboIntegrator-processer. Funktionen synchronized() anender følgende syntaks. synchronized(string) Parametre synchronized() kræer en enkel parameter, som er et brugerdefineret nan for et låseobjekt. Nanet på låseobjektet kan bruges i flere TurboIntegrator-processer for at serialisere deres udførelse som en gruppe. lockname Value=String Required?=Yes Default-none Det brugerdefinerede nan på et låseobjekt, som synkronisering skal finde sted på. I nane skelnes der ikke mellem store og små bogstaer, og mellemrum ignoreres. Længden på et nan må ikke oerstige 1023 tegn. Semantik En TurboIntegrator-proces kan foretage et ubegrænset antal kald til synchronized() med et ilkårligt antal låseobjekter. Serialisering er gældende fra det tidspunkt, hor synchronized() kaldes, til den indeholdte transaktion er udført. Eksempel: His synchronized() kaldes fra en underproces (Ps) i en masterproces (Pm) eller et masterjob (Cm), "frigies" låseobjektet, når Pm eller Cm er udført. Der er dog den undtagelse, at en SaeDataAll-funktion (SDA) kan "afslutte" en transaktion for tidligt - altså mens den udføres. Dette gælder også for låseobjekter. Kaldet synchronized() kan placeres hor som helst i et TurboIntegrator-script, men serialisering gælder for hele TurboIntegrator-processen, når det registreres. Antag en TurboIntegrator-proces med et synchronized()-kald midt i dets script og en funktion, O1, der går forud for det kald. To forekomster af denne TurboIntegrator-proces kan starte samtidigt. Det er muligt, at den ene forekomst gennemføres, inkl. dets kald til synchronized(), inden den anden forekomst når sit synchronized()-kald. I det tilfælde il brugeren få indtryk af, at processerne er udført samtidigt. Men his den anden proces når sit synchronized()-kald, inden den første pro- Kapitel 7. Redigér udidede procedurer 53

62 ces er færdigudført, il den anden proces ophæe alt, had den har udført indtil idere, og ente på, at den første blier færdig. I det tilfælde il brugeren få indtryk af, at de to processer er serialiseret. For at undgå den type forirring og for at optimere brugen af synchronized() anbefales det, at synchronized()-kald indgår som de første sætninger i en TurboIntegrator-proces. Eksempel Antag, at TurboIntegrator-proces P har brug for at opdatere to kuber, Cube_1 og Cube_2. Andre TurboIntegrator-processer har muligis også brug for at opdatere Cube_1 eller Cube_2. For at få alle TurboIntegrator-processer, der skal opdatere Cube_1 eller Cube_2, til at køre samtidig, skal P kalde synchronized() på følgende måde: scube_1= Cube_1 ; scube_2= Cube_2 ; se1= Elm1 ; se2= Elm2 ; se4= Units ; se5= Price ; Synchronized( scube_1 ); Synchronized( scube_2 ); CellPutn( 111, scube_1, se1, se2 ); CellPutn( 9.99, scube_2, se4, se5 ); #... Andre TurboIntegrator-processer, der skal opdatere Cube_1 eller Cube_2, skal også kalde synchronized( scube_1 ) og/eller synchronized( scube_2 ) på lignende is. I dette eksempel er nanene på de to låseobjekter de samme som nanene på kuberne. Men et låseobjekts nan behøer ikke at ære det samme som andre Cognos TM1 -objekter (kuber, dimensioner, udsnit os.).. Vedligehold og nangi låseobjekter Låseobjekter administreres internt af Cognos TM1. Der kræes ingen eksplicit oprettelse eller sletning fra brugerens side. Angi blot et låseobjekt ed nan i et synchronized()-kald. I nane på låseobjekter skelnes der ikke mellem store og små bogstaer eller mellemrum. His der f.eks. findes et låseobjekt med nanet 'Abc Def', kan der henises til det ed hjælp af nanene 'ABCDEF', 'ab cd ef' os. Med andre ord serialiseres udførelsen af en TurboIntegrator-proces med et kald til synchronized( 'Abc Def ) med udførelsen af en proces med et kald til synchronized( 'ABCDEF ). Nane på låseobjekter må højst ære på 1023 tegn. Udførelsesrækkefølge En gruppe af TurboIntegrator-processer, der indeholder synchronized() kald til samme låseobjekt, forhindres i at blie udført samtidigt. Deres faktiske udførelsesrækkefølge blier imidlertid ikke påirket. Så længe de ikke udføres samtidigt, af- 54 TM1 TurboIntegrator

63 gøres den rækkefølge, de udføres i, af mange andre faktorer, herunder planlægning af applikationsdesign og styresystemnieau. His udførelsesrækkefølgen er igtig, f.eks. his en af TurboIntegrator-processerne er afhængig af opdateringer, der er udført af en anden proces, så skal programudikleren bruge andre metoder til at sikre den ønskede udførelsesrækkefølge. Konfigurationsparameteren MaximumTIObjectLocks Parameteren MaximumTILockObjects begrænser størrelsen på listen oer låste objekter. Der er flere oplysninger i IBM Planning Analytics Installation and Configuration. TurboIntegrator-sikkerhed tildeles af administrator Den administrator, der opretter en TurboIntegrator-proces, tildeler sikkerhedsrettigheder til TurboIntegrator-processen. En TurboIntegrator-proces kan kun oprettes af en administrator, som har de administratorrettigheder, der er nødendige for at oprette en proces. Administratoren kan tildele rettigheder til processen. TurboIntegrator-processen har disse rettigheder, uanset hilke rettigheder der er tildelt til de brugere, der udfører processen. Brugere, der ikke er administratorer, skal hae læseadgang til TurboIntegrator-processer for at kunne se processerne i grænsefladen og udføre dem. Men sele Turbo- Integrator-processen beholder de rettigheder, som administratoren har tildelt. Se f.eks. en bruger og en administrator, hor: Bruger U1 kun har læseadgang til cube_1. Administratoren opretter en TurboIntegrator-proces, der udfører en CellPutN i cube_1, hilket kræer skrieadgang til kuben. Administratoren gier U1 læseadgang til TurboIntegrator-processen. U1 kan udføre TurboIntegrator-processen, og CellPutN udføres, sel om brugeren kun har læseadgang til cube_1. Det samme resultat opnås, his U1 har adgangen Ingen til cube_1. En bruger, der kun har læseadgang til en TurboIntegrator-proces, kan kun få ist og udføre processen. Brugeren kan ikke redigere processen for at ændre den ærdi, der sendes, eller den placering, hor data placeres. De betingelser, der er beskreet oenfor, gælder også, når en bruger udfører en TurboIntegrator-proces ia et job. For at forhindre U1 i at få adgang til TurboIntegrator-processen skal IBM Cognos TM1 -administratoren ikke gie U1 læseadgang til TurboIntegrator-processen. Kapitel 7. Redigér udidede procedurer 55

64 56 TM1 TurboIntegrator

65 Kapitel 8. Planlæg en proces til automatisk udførelse med job Du kan udføre processer efter beho (on demand), og du kan oprette et job til at udføre processer med definerede interaller. Disse to udførelsesmetoder udelukker ikke hinanden. Du kan når som helst udføre en proces, også sel om processen er planlagt til automatisk udførelse som et job. Et job er det TM1 -objekt, der udfører én eller flere processer med brugerdefinerede interaller. Et job består af: En liste oer processer, der skal udføres. En startdato og et startklokkeslæt til den første udførelse af jobbet. Angielse af hyppighed for udførelsen af jobbet. Når det er defineret, kan job aktieres og deaktieres efter beho. Adgang til jobfunktioner styres af sikkerhedsrettighederne for brugergrupper. Du skal ære medlem af ADMIN- eller DataAdmin-gruppen for at kunne oprette job på en serer. Brugere skal hae læserettigheder til et job for at kunne se jobbet i Serer Explorer og manuelt udføre jobbet. Du kan planlægge en proces til automatisk udførelse som et job fra TurboIntegrator. 1. Klik på skillebladet Plan i TurboIntegrator-induet. 2. Vælg indstillingen Planlæg denne proces som et job med nanet. 3. Angi et nan på processen i det efterfølgende felt. Som standard tildeler TurboIntegrator jobbet nanet på processen. 4. Klik på en dato i kalenderen for at angie en startdato til den første udførelse af jobbet. 5. Angi et klokkeslæt for angie et startklokkeslæt til den første udførelse af jobbet. 6. Angi felterne i feltet Hyppighed for jobudførelse for at definere det interal, jobbet skal udføres med. 7. Vælg et tidspunkt for jobudførelse. Lokal serertid - Udføres i den lokale serers tidszone (herunder perioder med sommertid). UTC-tid - Udføres altid i UTC-tid uanset perioder med sommertid. 8. Vælg Fil, Gem for at gemme processen med planlægningsoplysningerne. Når du planlægger en proces fra TurboIntegrator, aktieres jobbet automatisk og blier udført på det angine starttidspunkt. Du kan også oprette et job til en proces (eller en samling af processer) direkte fra Serer Explorer. 9. Vælg ikonen Job i Serer Explorer under den serer, hor du il oprette jobbet. 10. Vælg Job, Opret nyt job. Guiden Konfiguration af job åbnes. 11. På listen Tilgængelige skal du ælge den proces, du il oprette et job til. Copyright IBM Corp. 2007,

66 12. Klik på ikonen for højrepil. 13. Klik på Næste. 14. Klik på en dato i kalenderen for at angie en startdato til den første udførelse af jobbet. 15. Angi et klokkeslæt for angie et startklokkeslæt til den første udførelse af jobbet. 16. Angi felterne i feltet Hyppighed for jobudførelse for at definere det interal, jobbet skal udføres med. 17. Vælg et tidspunkt for jobudførelse. Lokal serertid - Udføres i den lokale serers tidszone (herunder perioder med sommertid). UTC-tid - Udføres altid i UTC-tid uanset perioder med sommertid. 18. Udfyld feltet Jobplan er akti. 19. Klik på Afslut. Dialogboksen Gem job som åbnes. 20. Angi et nan til jobbet, og klik på Gem. Redigér et job Sådan åbner du et job til redigering i Guiden Konfiguration af job: 1. Vælg jobbet i det enstre indue i Serer Explorer. 2. Vælg Job, Redigér job. Aktiér et job Deaktiér et job Slet et job Sådan aktierer du et job, der i øjeblikket er deaktieret: 1. Vælg jobbet i det enstre indue i Serer Explorer. 2. Aktiér indstillingen Job, Aktiér. Sådan afbryder du midlertidigt en planlagt udførelse af et job: 1. Vælg jobbet i det enstre indue i Serer Explorer. 2. Deaktiér indstillingen Job, Aktiér. Sådan sletter du et job: 1. Vælg jobbet i det enstre indue i Serer Explorer. 2. Vælg Job, Slet. Bemærk: Du kan ikke slette et aktit job. Du skal deaktiere et job, før du kan slette det. 58 TM1 TurboIntegrator

67 Udfør et job on demand Brug af ChoreCommit Sådan udfører du et job on demand: 1. Vælg jobbet i det enstre indue i Serer Explorer. 2. Vælg Job, Udfør. ChoreCommit er en egenskab i et job, der gør det muligt at angie, om processerne i et job skal committes som en enkelt transaktion, eller om processerne i et job skal committes som flere transaktioner. Et job udfører en række TurboIntegrator-processer som en enkelt Commit-transaktion. Enher lås, der opnås af den første proces, beares, indtil den sidste proces er færdig. Det betyder, at låse kan holdes i meget lange perioder. ChoreCommit gør det muligt for et job at blie udført, sådan at her enkelt TurboIntegrator-proces committes som en transaktion, når processen er færdig. Låsene holdes så kun, så længe en enkelt proces arer, i stedet for så længe jobbet arer. Jobegenskab Udfør et job ed sererstart Når job defineres, kan de identificeres som: Enkelt commit-tilstand Alle processer committes som en enkelt transaktion. Dette er ældre adfærd og standardadfærd. Multipel commit-tilstand Alle processer, der skal committes, blier committet, når de blier behandlet. Denne egenskab kan kun ændres, når et job er inaktit. Du kan udpege et job til et "startjob", der behandles, når sereren starter. Du definerer, at et job skal udføres, når sereren starter, ed at bruge konfigurationsparameteren StartupChores til at angie en liste oer job, der skal udføres, før sereren starter. Et job er en række opgaer, som kan udføres i rækkefølge, og som typisk er TurboIntegrator-processer. Der er oplysninger om denne parameter i IBM Planning Analytics Installation and Configuration. Startjob kan bruges som en måde at konfigurere sereren på inden behandling. Startjob kan udføres, før brugerne logger på, og før andre job begynder behandlingen. Da startjob udføres, før logon tillades, kan brugerne ikke oeråge startjobbene med 4TM1Top, og derfor er der ingen måde at annullere et startjob på undtagen at afbryde sererprocessen. Kapitel 8. Planlæg en proces til automatisk udførelse med job 59

68 60 TM1 TurboIntegrator

69 Kapitel 9. Understøttelse af Jaa-udidelser i TurboIntegrator Du kan bruge Jaa som scriptsprog til at oprette og køre TurboIntegrator-processer. De fleste TurboIntegrator-funktioner understøttes i Jaa og kan benyttes på samme måde som alle andre Jaa-metoder. Du kan oprette TurboIntegrator-processer med Jaa og bruge Jaa-biblioteker til at udide funktionerne i IBM Cognos TM1. Jaa-udidelser understøttes ikke i TM1 Rules. Aktiering og konfiguration af Jaa-udidelser Gør følgende for at aktiere og konfigurere Jaa-udidelser i IBM Cognos TM1. Konfigurér TM1-sereren, så den understøtter Jaa For at aktiere Jaa-understøttelse i TurboIntegrator skal du angie placeringen af den irtuelle Jaa-programfil.dll (jm.dll) i filen tm1s.cfg. His du kører en 64 bitersion af tm1s.exe, skal du angie en 64 bit-ersion af jm.dll. En 32 bit-ersion af tm1s.exe kræer en 32 bit-ersion af jm.dll. 1. Brug en teksteditor til at åbne filen tm1s.cfg for den TM1-serer, hor du il aktiere Jaa. Filen tm1s.cfg er placeret i TM1-sererens databibliotek. Du kan bruge IBM Cognos -konfigurationsærktøjet til at kontrollere placeringen af filen tm1s.cfg for din serer. 2. Tilføj linjen JaaJVMPath=<full_path_to_jm.dll> i filen tm1s.cfg. (I UNIX il stien sare til jm.dll, f.eks. libjm.so). 3. Gem filen tm1s.cfg. JaaJVMPath er en dynamisk konfigurationsparameter, der ikke kræer genstart af din TM1-serer. Opret Jaa-udidelsesbiblioteker Du skal oprette biblioteker for at kunne gemme Jaa-udidelser. Om denne opgae TM1 søger efter udidelser i flere specifikke biblioteker. Hert bibliotek er beregnet til at lagre en bestemt kategori af udidelser. Din implementering afgør, hilken kombination af disse biblioteker du skal oprette. 1. His du il gemme IBM-godkendte udidelser, skal du oprette underbiblioteket \jaaextensions\ibm under <tm1_install_dir>\bin64-biblioteket. Standardbiblioteket til 64-bits installationen af TM1 er C:\Program Files\IBM\cognos\ tm1_64, så den fuldstændige sti til det bibliotek, hor de IBM-godkendte udidelser opbeares, er C:\Program Files\IBM\cognos\tm1_64\bin64\ jaaextensions\ibm. 2. His du il gemme bruger-udidelser, der dækker hele installationen, skal du oprette underbiblioteket \jaaextensions\user under <tm1_install_dir>\ bin64-biblioteket. Copyright IBM Corp. 2007,

70 3. His du il gemme modelspecifikke udidelser, skal du oprette underbiblioteket }jaaextensions\ibm under TM1-sererens databibliotek. 4. His du il oprette brugerspecifikke udidelser, skal du oprette underbiblioteket }jaaextensions\user under TM1-sererens databibliotek. 5. Genstart TM1-sereren, når du har oprettet underbibliotekerne. Opret filen jaaextensions.policy Filen jaaextensions.policy, som skal ære placeret i biblioteket <tm1_install_dir>\configuration, gør det muligt at udføre bestemte klasser ed hjælp af Jaa-udidelserne. 1. Opret en tekstfil med nanet jaaextensions.policy i biblioteket <tm1_install_dir>\configuration. 2. Indsæt denne sætning, his alle klasser skal kunne udføres fra jaa-udidelser: grant { permission jaa.security.allpermission; }; 3. Gem filen jaaextensions.policy. Konfigurér Eclipse Jaa EE IDE Følg trinnene nedenfor for at konfigurere Eclipse Jaa EE IDE til IBM Cognos TM1 Jaa-udidelser. Om denne opgae Proceduren og de underliggende emner i proceduren hjælper dig med at konfigurere Eclipse og oprette enkle eksempelscripts, som iser, hordan Jaa-udidelser bruges i TM1. Du kan ændre eksemplerne og oprette dine egne tilpassede scripts. 1. Åbn Eclipse. 2. Klik på Arbejdsbænk. 3. Klik på Vindue > Åbn perspekti > Jaa for at åbne Jaa-perspektiet. 4. Klik på Fil > Jaa-projekt for at oprette et nyt Jaa-projekt. 5. Angi et Projektnan. 6. Klik på Afslut. 7. Højreklik på det nye projekt, og klik på Egenskaber. 8. Klik på Jaa-byggesti i induet Egenskaber. 9. Klik på skillebladet Biblioteker. 10. Klik på Tilføj eksterne JAR'er. 11. Tilføj jaatiapi.jar fra dit TM1-installationsbibliotek. 12. Klik på OK for at gemme egenskaberne. 13. Højreklik på det nye projekt, og klik derefter på Ny > Fil. 14. Angi extension.xml som filnan. 15. Klik på Afslut. 16. Klik på skillebladet Kilde, og angi følgende XML-kode: 62 TM1 TurboIntegrator

71 <extension> <id>my.extension</id> <name>my Extension</name> <ersion> </ersion> <scripts-package>my.scripts</scripts-package> </extension> XML-koden fortæller Jaa-udidelseskoden, at dette er en udidelse, og hor den kan finde elementerne: id - En entydig id for udidelserne, her udidelse skal hae sin egen id. name - Et fremisningsnan til udidelsen, muligis en kort beskrielse. ersion - Udidelsens ersionsnummer. Jaa-udidelser indlæser altid den seneste ersion af en udidelse, his der er flere udidelser med samme id. scripts-package - Fortæller Jaa-udidelsesprogrammet, hor det skal søge efter Jaa-udidelsens TurboIntegrator-scripts. 17. Udid det nye projekt i Eclipse. 18. Højreklik på SRC-folderen, og klik derefter på Ny > Pakke. 19. Tildel den nye pakke nanet my.scripts, og klik på Udfør. 20. Højreklik i delinduet Pakke på den nye my.scripts-pakke, og klik derefter på Ny > Klasse. 21. Udfyld dialogboksen Ny Jaa-klasse som følger: Kapitel 9. Understøttelse af Jaa-udidelser i TurboIntegrator 63

72 64 TM1 TurboIntegrator Figur 2. Dialogboksen Ny Jaa-klasse 22. Klik på Afslut. 23. Angi følgende kode i MyTestTI.jaa-klassen: package my.scripts; import com.ibm.cognos.tm1.jaati.tm1userthread; import com.ibm.cognos.tm1.jaati.ti.tifunctions; public class MyTestTI { public static double MyTestTI(String[] args) { TIFunctions ti = TM1UserThread.getTIFunctions(); if (args.length < 1) { throw new IllegalArgumentException(); } String dim = args[0]; if (ti.dimensionexists(dim)) { ti.dimensiondeleteallelements(dim); } else { ti.dimensioncreate(dim); } return 0; } }

73 Dette script benytter en enkelt parameter, nanet på en dimension. His dimensionen findes, slettes alle elementer. His den ikke findes, blier der oprettet en ny dimension med det nan. Det er et enkelt, men nyttigt script. Opret en Ant-byggefil Når du har skreet en klasse, skal du kompilere den i en JAR-fil på den korrekte placering. Det nemmeste måde at gøre det på, er at oprette en Ant-byggefil. 1. Højreklik på projektet MyExtension, og klik derefter på Ny > Fil. 2. Angi MyExtension som oerordnet folder, buildjar.xml som Filnan, og klik på Afslut. 3. Indtast følgende kode i den nye buildjar.xml-fil: <project name="myextension" default="createjar"> <property name="projecthome" location="." /> <property name="targetdir" location="c:/tm1/models/plansamp/}jaaextensions/user" /> <target name="createjar"> <jar destfile="${targetdir}/myextension.jar" basedir="${projecthome}/bin"> <manifest> <attribute name="class-path" alue="."/> </manifest> <fileset file="${projecthome}/extension.xml"/> </jar> </target> </project> Angi placeringen af targetdir-egenskaben til at ære den fuldstændige sti til folderen }EmbeddedJaa i dit TM1-sererdatabibliotek. Du kan nu konfigurere Eclipse, så JAR-filen blier bygget automatisk, her gang du ændrer en fil i projektet. 4. Højreklik på projektet MyExtension, klik på Egenskaber, og klik derefter på kategorien Byggeprogrammer. 5. Klik på Ny i induet med egenskaber til MyExtension. 6. Klik på Ant-byggeprogram, og klik derefter på OK. 7. Klik på Gennemse arbejdsområde Byggefil i induet Redigér konfiguration, og naigér derefter til Ant-byggefilen. 8. Vælg filen buildjar.xml, og klik derefter på OK. 9. Klik på skillebladet Mål i induet Redigér konfiguration. 10. Klik på Angi mål ud for feltet Autobygning. 11. Markér det eneste tilgængelige mål (createjar), og klik derefter på OK. 12. Klik på OK i alle efterfølgende meddelelser og dialogbokse. Din JAR-fil bygges med det samme og blier automatisk bygget igen, her gang du ændrer en af kildefilerne. Opret en indpakningsproces, som skal køre Jaa-udidelsesscripts i TurboIntegrator Når du har konfigureret Eclipse, skal du oprette en indpakningsproces for at kunne udføre TurboIntegrator-script fra Architect. 1. Åbn IBM Cognos TM1 Architect, og log på den serer, der er konfigureret til at køre Jaa-udidelser. 2. Opret en TurboIntegrator-proces. 3. Angi følgende sætning på skillebladet Prolog i den nye proces: ExecuteJaaN( my.scripts.mytestti, Hello ); Kapitel 9. Understøttelse af Jaa-udidelser i TurboIntegrator 65

74 4. Gem og udfør processen. Resultater I dette eksempel oprettes en ny dimension med nanet Hello. Den første parameter i ExecuteJaaN-funktionen er det fuldt kalificerede nan på de Jaa-udidelsesklasser, du har oprettet tidligere. Resten af parametrene, som oerføres til ExecuteJaaN, oerføres som argumenter til Jaa-udidelsen. Jaa-udidelsesfunktioner i TurboIntegrator Med funktionerne ExecuteJaaN og ExecuteJaaS kan du udføre Jaa-scripts fra en TurboIntegrator-proces. ExecuteJaaN ExecuteJaaN udfører en Jaa TurboIntegrator-proces, der returnerer et tal. His du il udføre en Jaa TurboIntegrator-proces, der returnerer en streng, skal du bruge ExecuteJaaS. Det er en TM1 TurboIntegrator-funktion, der kun er gyldig i TM1 TurboIntegrator. Syntaks ExecuteJaaN( JaaTIClass, [ OptionalParameter1, OptionalParameter2,...] ) Argument JaaTIClass OptionalParameters Beskrielse Det fuldstændige nan på den Jaa TurboIntegrator-klasse, du il udføre. Valgfrie parametre, der oerføres til sele Jaa TurboIntegrator-processen. Du kan oerføre alle de parametre, der er beho for. Du kan også undlade at oerføre parametre. Du kan kun oerføre strengparametre, ikke tal. Du kan bruge TurboIntegrator-funktionen StringToNumber til at oerføre tal til Jaa TurboIntegrator-scripts. Der er flere oplysninger under "StringToNumber" i TM1 Reference. En Jaa TurboIntegrator-klasse, som returnerer et tal, og som kan kaldes fra ExecuteJaaN, skal bruge følgende mønster: package com.example; import public class MyTestTI { public static double MyTestTI (String [] args) [... return...; } } 66 TM1 TurboIntegrator

75 Eksempel ExecuteJaaN( com.example.mytestti, First, Second, Third ); ExecuteJaaS ExecuteJaaS udfører en Jaa TurboIntegrator-proces, der returnerer en streng. His du il udføre en Jaa TurboIntegrator-proces, der returnerer et tal, skal du bruge ExecuteJaaN. Det er en TM1 TurboIntegrator-funktion, der kun er gyldig i TM1 TurboIntegratorprocesser. Syntaks ExecuteJaaS( JaaTIClass, [ OptionalParameter1, OptionalParameter2,...] ) Argument JaaTIClass OptionalParameters Beskrielse Det fuldstændige nan på den Jaa TurboIntegrator-klasse, du il udføre. Valgfrie parametre, der oerføres til sele Jaa TurboIntegrator-processen. Du kan oerføre alle de parametre, der er beho for. Du kan også undlade at oerføre parametre. Du kan kun oerføre strengparametre, ikke tal. Du kan bruge TurboIntegrator-funktionen StringToNumber til at oerføre tal til Jaa TurboIntegrator-scripts. Der er flere oplysninger under "StringToNumber" i TM1 Reference. En Jaa TurboIntegrator-klasse, der returnerer en streng og kaldes fra ExecuteJaaS, skal bruge følgende mønster. package com.example; import public class MyTestTI { public static String MyTestTI (String [] args) [... return...; } } Eksempel ExecuteJaaS( com.example.mytestti, First, Second, Third ); Understøttelse af arrays i funktioner, som accepterer et ariabelt antal parametre En af fordelene ed Jaa-udidelser i TurboIntegrator i forhold til almindelige TurboIntegrator-scripts er, at Jaa-udidelser understøtter oerførsel af et ariabelt antal parametre som et array. Kapitel 9. Understøttelse af Jaa-udidelser i TurboIntegrator 67

76 Flere TurboIntegrator-funktioner understøtter et ariabelt antal parametre, inklusie funktionerne CubeCreate, CellGetN, CellGetS, CellPutN og CellPutS. Funktionen CubeCreate bruger f.eks. én parameter til nanet på den nye kube, der skal oprettes, og et ariabelt antal parametre til de dimensioner, der udgør kuben. Du kan oerføre dimensionsparametrene direkte som i dette eksempel: ti.cubecreate("sales", "Months", "Regions", "Versions", "Sales Metrics"); Eller du kan oerføre et array af ærdier til funktionen som i dette eksempel: String[] dims = new String[] {"Months", "Regions", "Versions", "Sales Metrics"}; ti.cubecreate("sales", dims); Da du kan oerføre et array af ærdier, kan du oerføre et hilket som helst antal parametre. Du behøer ikke beslutte, når du skrier scriptet, hor mange parametre en funktion skal hae. Når du kører scriptet, kan du oprette et array uanset størrelse og oerføre det til en funktion (f.eks. CubeCreate), som accepterer et ariabelt antal parametre. Her er et eksempel på et Jaa TurboIntegrator-script, der kan oprette en ny kube med samme dimensionalitet som en eksisterende kube. Dette script fungerer uafhængigt af størrelsen på den eksisterende kube. Figur 3. Eksempel på et Jaa TurboIntegrator-script 68 TM1 TurboIntegrator

77 Dette eksempel henter dimensionerne for den eksisterende kube som en liste, konerterer listen til et array og oerfører arrayet til funktionen CubeCreate. TurboIntegrator-funktioner, som ikke understøttes i Jaa-udidelser Følgende TurboIntegrator-funktioner understøttes ikke i Jaa-udidelser. TurboIntegrator-funktioner, som ikke ises på listen, understøttes. ASCIIDelete ASCIIOutput SetInputCharacterSet SetOutputCharacterSet SetOutputEscapeDoubleQuote TextOutputFormatDate NewDateFormatter ParseDate DimensionTopElementName ODBCCLose ODBCOpen ODBCOPENx ODBCOutput SetODBCUnicodeInterface ProcessError ExecuteCommand ExecuteProcess GetProcessErrorFileDirectory GetProcessErrorFileName GetProcessName ItemReject ItemSkip ProcessBreak ProcessQuit Synchronized GetUseActieSandboxProperty SererActieSandboxGet SererActieSandboxSet SetUseActieSandboxProperty SererSandboxExists SererSandboxGet SererSandboxListCountGet CellSecurityCubeCreate CellSecurityCubeDestroy PublishView DataSourceSAPUsingRoleAuths DataSourceSAPUsingTexts Kapitel 9. Understøttelse af Jaa-udidelser i TurboIntegrator 69

78 Fejlsøgning i Jaa-udidelser Du kan fejlsøge i IBM Cognos TM1 Jaa-udidelser ed at skrie fejl og undtagelser til TM1-logfilen og ed at bruge Eclipse til ekstern fejlsøgning i Jaa-koden. Fejlsøgning i Jaa-kode med Eclipse Det er muligt at foretage fejlsøgning i Jaa-koden fra eksternt hold ed brug af Eclipse. Det, at man kan foretage fejlsøgning i processer ed brug af et rigtigt fejlsøgningsærktøj, gier Jaa-udidelser en stor fordel i forhold til almindelige TurboIntegrator-scripts. 1. Åbn filen Tm1s.cfg for den TM1-serer, hor Jaa-udidelserne er aktieret. 2. Tilføj følgende parameter til filen: JaaJVMArgs=-Xrunjdwp:transport=dt_socket,serer=y,suspend=n,address= Gem Tm1s.cfg. 4. Genstart TM1-sereren. 5. Klik i Eclipse på Kør > Fejlfindingskonfigurationer. 6. Blad ned i træstrukturen i enstre delindue. Find Eksternt Jaa-program og dobbeltklik på det for at oprette en ny profil. 7. Skift standardærdien for Port til Det sarer til ærdien address i den JaaJVMArgs-parameter, du har oprettet i trin Klik på Fejlfinding for at starte en ekstern fejlfindingssession. 9. Du tilføjer et breakpoint til koden på en af følgende måder: Dobbeltklik i margenen til den linje, hor du il hae et breakpoint. Placér markøren i den linje, hor breakpointet skal ære, og tryk på Ctrl+Shift+B. 10. Udfør TurboIntegrator-indpakningsprocessen igen med Jaa-udidelser. Udførelsen afbrydes ed breakpointet, og du fortsætte med næste trin. Skrining af fejl og andre oplysninger til TM1-sererlogfilen Jaa-udidelser i TM1 gier mulighed for at skrie til tm1serer.log-filen fra Jaascripts, og du kan derfor registrere informationer og hændelser, som er forbundet med dine scripts. Her er et eksempel på et script, som skrier en informerende meddelelse til TM1- sererlogfilen: 70 TM1 TurboIntegrator

79 Figur 4. Fejlfindingsscript til Jaa-udidelse Klassen Logger indeholder flere metoder, der kan bruges til at skrie på forskellige lognieauer: debug - en sætning, som kun ises ed forsøg på fejlfinding info - en logindgang, som gier nyttige (men ikke æsentlige) oplysninger warn - en logindgang, som beskrier et ikke-kritisk problem error - en logindgang, som beskrier noget, der er en æsentlig fejl fatal - en logindgang, som beskrier en kritisk fejl Her af disse funktioner kan bruges som i eksemplet og benytte en streng, der er skreet til loggen. Derudoer kan funktionerne acceptere både en streng og en undtagelse, i hilket tilfælde staksporingen af undtagelsen også logges. Integrér TM1 og Cognos Command Center ed brug af JaaTI Ved at kombinere CCC REST-API'en og TM1-handlingsknapper kan en TM1-bruger påbegynde udførelsen af en CCC-proces ed at klikke på en handlingsknap. Om denne opgae Den generelle proces er som følger: TM1-handlingsknappen starter en TI-proces. TI-processen foretager derefter et JaaTI-kald til CCC TM1-indpakningen. CCC TM1-indpakningen sender derefter en HTTPS REST-anmodning til CCCsereren. CCC TM1-indpakningen distribueres som en.jar-fil, der indeholder følgende JaaTI-klasser: StartProcessAsync(apiEndpoint, username, password, ecosystem, enironment, process, parameters) Bemærk: I forbindelse med den asynkrone anmodning skal du sætte længden på anmodningskøen til et tal, der er større end 0 (nul) i Værktøjer > Systemkonfiguration > Aktiitetslytter. Det definerer det maksimale antal samtidige anmodninger for en gien proces. StartProcess(apiEndpoint, username, password, ecosystem, enironment, process, parameters) Argumenterne til disse funktioner er: apiendpoint: Streng, For eksempel: Kapitel 9. Understøttelse af Jaa-udidelser i TurboIntegrator 71

80 username: Streng, det brugernan, der skal alideres password: Streng, det kodeord, der skal alideres ecosystem: Streng, nanet på økosystemet enironment: Streng, nanet på IT-miljøet process: Streng, nanet på processen parameters: Valgfri streng, som indeholder name=alue-par for procesparametrene. Flere par adskilles af mellemrum, og ærdier, som indeholder mellemrum, skal ære angiet i dobbelte anførselstegn, for eksempel: param=alue other_param="other alue". Returærdien for disse funktioner er: 0 (false) = ellykket 1 (true) = der er opstået en fejl 1. I TM1 : Konfigurér TM1 Serer, så den understøtter Jaa : a. Redigér tm1s.cfg. b. Tilføj linjen: JaaJVMPath=full_path_to_jm.dll. Filen jm.dll er typisk placeret i tm1_install_dir\bin64\jre\7.0\bin\default\jm.dll 2. Opret biblioteker med Jaa-udidelser (udidelser, der dækker hele installationen): Opret biblioteket tm1_install_dir\bin64\jaaextensions\user. 3. Opret filen jaaextensions.policy: a. Reidér tekstfilen jaaextensions.policy i biblioteket tm1_install_dir\ configuration. b. Indsæt denne sætning, his alle klasser skal kunne udføres fra Jaa-udidelser: grant { permission jaa.security.allpermission; } c. Gem filen jaaextensions.policy. 4. Kopiér jar-filen for Cognos Command Center Jaa-udidelserne til Turbo Integrator til det bibliotek med Jaa-udidelser, der ble oprettet i trin 2: a. Kopiér.jar-file fra CCC INSTALLDIR\TM1wrapper til tm1_install_dir\ bin64\jaaextensions\user. b. Tilføj CCC REST-API-certifikatet til TM1 Jaa JRE-certifikaterne. Dette kan gøres ed hjælp af keytool, som er placeret i tm1_install_dir\bin64\jre\bin. Eksempel: tm1_install_dir\bin64\jre\7.0\bin\keytool.exe -importcert -alias CCCRESTAPI -file ccc_rest_api_certificate.cer -keystore "tm1_install_dir\bin64\jaa\jre\lib\security\cacerts" -storepass changeit. c. Genstart TM1-sereren. 5. Opret en TM1 TurboIntegrator-proces, som kalder Cognos Command Centerindpakningsfunktionen: a. Åbn IBM Cognos TM1 Architect, og log på den serer, der er konfigureret til at køre Jaa-udidelser. b. Opret en ny TurboIntegrator-proces c. Angi følgende sætning på skillebladet Prolog i den nye proces: ExecuteJaaN( com.ibm.cognos.pmccsrtm1wrapper.startprocess, api-endpoint, user, password, Ecosystem, Enironment, Process, parameters ), Hor api-endpoint er URL'en til CCC-API, user er f.eks. nanet på den CCC-bruger, som kører processen, password er brugerens kodeord, ecosystem er nanet på økosystemet, enironment er nanet på IT-miljøet i økosystemet, process er nanet 72 TM1 TurboIntegrator

81 på processen i økosystemet og parameters er en algfri streng, som indeholder name=alue-par for procesparametre. Flere par adskilles af mellemrum, og ærdier, som indeholder mellemrum, skal ære angiet i dobbelte anførselstegn, for eksempel: parm=alue other_param="other alue". Returærdien er 0 for ellykket. I tilfælde af fejl returneres en ikke-nul-ærdi. d. Gem og udfør processen. 6. Følg trinnene i Konfigurér en handlingsknap til at udføre en proces ( com.ibm.swg.ba.cognos.tm1_dg_dlpr doc/ t_configurethebuttontorunaprocess_n50131.html %23ConfiguretheButtontoRunaProcess_N50131) for at konfigurere TM1- handlingsknappen, så den udfører den TM1 Turbo Integrator-proces, der er oprettet i trin 5. Kapitel 9. Understøttelse af Jaa-udidelser i TurboIntegrator 73

82 74 TM1 TurboIntegrator

83 Tillæg A. TurboIntegrator - øeprogram Via dette øeprogram blier du ledt gennem aancerede IBM Cognos TM1 Turbo- Integrator-funktioner. Øeprogrammet er designet til brugere, der skal implementere TM1 og udikle strategier for udnyttelse i deres organisationer. De aancerede bruger eller udikler er typisk ansarlig for oprettelse, edligeholdelse og udikling af kuber og dimensioner foruden dataimportprocesser. Før du anender dette øeprogram skal du hae et godt kendskab til begreberne i TM1 og kende TM1 -funktioner. I øeprogrammet lærer du at bruge TurboIntegrator til at oprette dimensioner og kuber, importere flade filer og ODBC-datakilder. Du får også ist, hordan du kan udide TurboIntegrators funktionalitet ed at bruge aancerede scriptfunktioner. Øeprogrammet indeholder også tip til, hordan du løser et TurboIntegrator-problem. Definér biblioteket til øeprogramdata TurboIntegrator - Oersigt Dette øeprogram anender eksempeldata, der leeres med TM1. Før du begynder at bruge øeprogrammet, skal du angie, at dit lokale sererdatabibliotek skal henise til eksempeldataene. Sådan angier du databiblioteket: 1. Klik på TM1 i det enstre indue i Serer Explorer, og ælg Fil, Indstillinger. Dialogboksen Indstillinger åbnes. 2. Klik på knappen Gennemse til det lokale sererdatabibliotek for at naigere til TurboIntegrator-eksempeldatabiblioteket. Eksempeldatabiblioteket har nanet TI_data, og det er placeret i biblioteket <install_dir>\samples\tm1\ti_data\, f.eks. C:\Program Files\IBM\Cognos\ TM1_64\samples\tm1\TI_Data\. 3. Klik på OK i dialogboksen Indstillinger for at angie databiblioteket og genstarte den lokale serer. Med TM1 TurboIntegrator kan du oprette processer, der automatiserer dataimporten, styringen af metadata og andre opgaer. En proces er et objekt, der består af: En beskrielse af en datakilde Et sæt ariabler, der hører til de enkelte kolonner i datakilden Et sæt mapninger, der definerer relationerne mellem ariabler og datastrukturer i TM1 -databasen. En prologprocedure, der består af en række handlinger, der skal udføres, før datakilden behandles. En metadataprocedure, der består af en række handlinger, der opdaterer eller opretter kube-, dimensions- og andre metadatastrukturer. Copyright IBM Corp. 2007,

84 En dataprocedure, der består af en række handlinger, der skal udføres for her record i datakilden. En epilogprocedure, der skal udføres, når datakilden er behandlet. Et sæt parametre, der kan anendes til at generalisere en proces, så den kan bruges i flere situationer. Du kan bruge TurboIntegrator til at importere data fra ODBC-kilder, ASCII-filer, SAP-baserede data, flerdimensionale OLAP-kilder, TM1 -kubeoersigter og TM1 -dimensionsudsnit. TurboIntegrator indeholder en komplet sæt funktioner, du kan bruge til at udide behandlingsmulighederne med. Du kan bruge disse funktioner til at oprette scripts, der eksporterer data til ASCII-filer og ODBC-kilder, eller som bruger betingede udtryk til at styre behandlingen. Ud oer disse TurboIntegrator-funktioner kan du også indsætte alle TM1 -regelfunktioner i en procesdefinition med undtagelse af funktionerne STET og UNDEFVALS. Adgang til TurboIntegrator styres ia brugergrupper. Du skal ære medlem af AD- MIN-gruppen for at få adgang til alle TurboIntegrator-funktioner og definere processer på en netærks-tm1 -serer. Der er ingen grænseflade som hjælp til oprettelsen af TurboIntegrator-funktioner. Du skal angie funktioner direkte på det releante underordnede skilleblad til skillebladet Udidet. Strengargumenter til TurboIntegrator-funktioner skal angies i enkelte anførselstegn. Et semikolon (;) skal inkluderes for at angie slutningen af her funktioner i TurboIntegrator-induet. Opret en TurboIntegrator-proces Oprettelsen af en proces består af 5 trin. Hert trin udføres ed at angie indstillinger eller redigere ærdier på et separat skilleblad i TurboIntegrator-induet. Følgende trin skal udføres for at oprette en proces: 1. Definér en datakilde 2. Angi ariabler 3. Map data 4. Redigér udidede scriptfunktioner 5. Planlæg den udførte proces Du skal udfylde skillebladene i TurboIntegrator-induet i rækkefølge for at oprette en proces. Du kan ikke fortsætte til et nyt skilleblad, før du har angiet alle oplysninger på det aktuelle skilleblad. Opret dimensioner ed hjælp af TurboIntegrator Du kan bruge TM1 TurboIntegrator til at oprette en liste oer elementer til en dimension fra en af de mulige datakilder, herunder ODBC- og ASCII-filer. Det er en hurtig måde at oprette en lang liste af elementer på, f.eks. tusind nane sammen med en kundedimension. Eksempel på ASCII-fil Dette er den afgrænsede ASCII-fil (example.cma), du skal bruge til at bygge en dimension og importere data. 76 TM1 TurboIntegrator

85 "New England", "Massachusetts", "Boston", "SuperMart", "Feb", "New England", "Massachusetts", "Springfield", "SuperMart", "Feb", "New England", "Massachusetts", "Worcester", "SuperMart", "Feb", Her record i denne kildefil har seks felter, horaf de tre blier brugt til at oprette eksempeldimensionen. De første to felter blier de konsoliderede elementer. Det tredje felt blier det numeriske element. De resterende felter ignoreres. I dimensionseditoren har eksempeldimensionen følgende struktur: New England Massachusetts Boston Springfield Worcester De numeriske ærdier fra Boston, Springfield og Worcester konsolideres til Massachusetts-totaler, som konsolideres til New England-totaler. Opret en dimension fra en ASCII-fil Sådan opretter du en dimension med eksempelfilen example.cms: 1. I det enstre indue i Serer Explorer skal du ælge Processer under den lokale serer. 2. Vælg Proces, Opret ny proces. Vinduet TurboIntegrator åbnes. 3. Vælg Tekst som Datakildetype. 4. Klik på knappen Gennemse ud for Nan på datakilde, og ælg filen example-.cma i biblioteket TI_data. 5. Lad feltet Nan på datakilde på serer stå tomt. 6. Angi skilletegnstypen til Afgrænset og skilletegnet til Komma. 7. Spring oer felterne Anførselstegn og Antal titelrecords, da der ikke er nogen anførselstegn eller titelrecords i inputfilen. Decimaltegnet skal ære et komma (,), og tusindtalsskilletegnet skal ære et punktum (.). 8. Klik på knappen Prøe for at få ist records fra kildefilen example.cma. Ved hjælp af disse records kan du undersøge strukturen af records i datakilden. Identificér ariabler: Når kildedataene er indlæst i TurboIntegrator, skal du identificere indholdet i hert felt i kilden. TM1 tildeler en ariabel til hert felt i kilden. 1. Klik skillebladet Variabler for at få ist følgende oplysninger, der iser en række for her ariabel i datakilden. Variabelnan Variabeltype Eksempelærdi Indhold V1 Streng New England Ignorér Tillæg A. TurboIntegrator - øeprogram 77

86 Variabelnan Variabeltype Eksempelærdi Indhold Massachusetts Streng Massachusetts Ignorér Boston Streng Boston Ignorér Supermart Streng Supermart Ignorér Feb Streng Feb Ignorér V6 Numerisk Ignorér Den første kolonne i gitteret tildeler et ariabelnan til hert datakildefelt. His du il tildele dine egne ariabler, skal du klikke på den releante celle og indtaste et nyt ariabelnan. Den anden kolonne tildeler en ariabeltype til her ariabel. Dette identificerer datatypen i kildefeltet. Du kan ændre typen ed at ælge en fra listen. Den tredje kolonne, Eksempelærdi, iser indholdet af den første record af datakilden. I oenstående billede er New England indholdet af det første felt i den første record i example.cma. Kolonnen Indhold bestemmer datatypen (Element, Konsolidering, Data, Attribut, Andet eller Ignorér), som her ariabel identificerer. I eksemplet identificerer de første tre ariabler konsolideringer og elementer til et regionalt hierarki. 2. I kolonnen Indhold til ariablen V1 skal du ælge Konsolidering på listen. 3. Gør det samme for ariablen Massachusetts. 4. Vælg Element for ariablen Boston. 5. Vælg Ignorér for alle andre ariabler, da de ikke blier anendt til at oprette dimensionen. Variabelnan Variabeltype Eksempelærdi Indhold V1 Streng New England Konsolidering Massachusetts Streng Massachusetts Konsolidering Boston Streng Boston Element Supermart Streng Supermart Ignorér Feb Streng Feb Ignorér V6 Numerisk Ignorér Map ariabler: Når du har identificeret ariabler i datakilden, skal du mappe dem til TM1 -objekter. 1. Klik på skillebladet Mapninger og derefter det underordnede skilleblad Kube. 78 TM1 TurboIntegrator

87 2. Da du ikke opretter en kube, skal du ælge Ingen handling i feltet Kubehandling. 3. Datahandling er irreleant, da du ikke opretter eller opdaterer en kube. Du kan springe oer dette felt. 4. Indstillingen Kubelogning er ikke releant, da du ikke behandler dataærdier. Vælg ikke denne indstilling. 5. Klik på det underordnede skilleblad Dimensioner. Dette gitter har en række til her ariabel, du har identificeret som indholdstypen Element. Du skal angie en elementtype og identificere dimensionen, som elementet tilhører. 6. His du opretter en ny dimension, skal du skrie Eksempel i kolonnen Dimension til ariablen Boston. 7. Vælg Opret på listen Handling. 8. Vælg Numerisk på listen Elementtype. Variablen Boston mappes nu som et numerisk element til en ny dimension med nanet Eksempel. Du kan nu mappe de ariabler, der er identificeret som konsolideringer. 9. Klik på det underordnede skilleblad Konsolideringer. TM1 identificerer begge konsolideringsariabler som medlemmer af den nye eksempeldimension. Du behøer kun at identificere den underordnede ariabel til de enkelte konsolideringer. 10. Til konsolideringsariablen V1 skal du ælge Massachusetts som Underordnet ariabel. 11. Til konsolideringsariablen Massachusetts skal du ælge Boston som Underordnet ariabel. 12. Redigér ikke ærdien for Vægt for nogen af konsolideringsariablerne. Konsolideret ariabel Dimension Rækkefølge Underordnet ariabel Vægt for kompo- Eksempelærdinenter V1 Eksempel Mass New England Efter input Mass. Eksempel Boston Massachusetts Efter input Al mapning er udført. His du il, kan du klikke på skillebladet Udidet og derefter klikke idere gennem de forskellige underordnede skilleblade for at få ist de scripts, der er genereret af TurboIntegrator, som opretter den nye eksempeldimension og indsætter konsolideringer og elementer. Senere i dette øeprogram gennemgås TurboIntegrator-scripts mere udførligt. Gem og udfør processen: Sådan gemmer og udfører du processen: 1. Klik på knappen Udfør. TM1 beder dig om at gemme processen. 2. Gem processen som create_example_dimension. Tillæg A. TurboIntegrator - øeprogram 79

88 Det er en god idé at gemme processer med beskriende nane. Efter nogle sekunder ises en bekræftelse på, at processen er udført. 3. Luk induet Turbo Integrator. 4. Åbn Serer Explorer. 5. Højreklik på den nye eksempeldimension, og ælg Redigér dimensionsstruktur. Eksempeldimensionen ises i Dimensionseditoren. 6. Klik på for at sortere dimensionsmedlemmer efter hierarkinieau. Eksempeldimensionen oprettes. New England er et konsolideret element, der indeholder Massachusetts (konsolideret element), som indeholder Boston, Springfield og Worcester (numeriske elementer). Opret en dimension fra en ODBC-kilde Denne del af øeprogrammet leder dig gennem oprettelsen af en dimension fra en ODBC-datakilde. Proceduren ligner proceduren at oprette en dimension fra en ASCII-fil. Definér datakilden: Før du fortsætter med øeprogrammet, skal du tilføje en Microsoft Access-database som en ODBC-datakilde for at gøre den tilgængelig i TurboIntegrator. 1. Åbn Windows-dialogboksen ODBC-datakildeadministrator. Den procedure, der kræes til at få adgang til dialogboksen, er forskellig i forhold til den Windows-ersion, du anender. Der flere oplysninger om dette i Windows-onlinehjælpen. 2. Klik på knappen Tilføj på DSN-skillebladet. Dialogboksen Opret ny datakilde ises. 3. Vælg tmicrosoft Access Drier, og klik på Udfør. Dialogboksen ODBC Microsoft Access-konfiguration ises. 4. Skri NewDB i feltet Nan på datakilde. 5. Klik på knappen Vælg. Dialogboksen Vælg en database ises. 6. Naigér til biblioteket TI_Data, og ælg NewDB.mdb. 7. Klik på OK for at afslutte dialogboksen Vælg en database. 8. Klik på OK for at afslutte dialogboksen ODBC-datakildeadministrator. Access-databasen NewDB er nu tilgængelig som en ODBC-kilde. Forespørgsel til datakilden: Sådan opretter du en forespørgsel til datakilden: 1. I Serer Explorer skal du højreklikke på ikonen Processer og ælge Opret ny proces. Vinduet TurboIntegrator åbnes. 2. Vælg ODBC som Datakildetype. 3. Klik på Gennemse ud for boksen Nan på datakilde. 80 TM1 TurboIntegrator

89 4. Dialogboksen ODBC-datakilder ises. 5. Vælg NewDB, og klik på OK. NewDB.mdb har én tabel, ACCOUNT, med 27 felter. Du skal skrie en SQLforespørgsel for at ælge oplysninger fra seks af dem. Alle ODBC-forespørgsler skal bruge SQL-dialekten til den underliggende DBMS. Syntaksen for en MS Access-forespørgsel er forskellig fra en Informix-forespørgsel, en SQL Serer-forespørgsel os. His du il garantere den korrekte syntaks, skal du først oprette forespørgslen ed hjælp af forespørgselsfaciliteten i den underliggende DBMS og derefter kopiere forespørgslen og indsætte den i feltet TurboIntegrator-forespørgsel. 6. I feltet Forespørgsel skal du skrie følgende sætning nøjagtig som den åbnes: SELECT [ACCOUNT_ID], [PARENT_ID], [NAME], [TYPE], [SALESREP], [SALESTEAM] FROM ACCOUNT; 7. Klik på Prøe for at få ist de første ti records, der returneres af forespørgslen. Brug en parameter i SQL: Du kan oprette en parameter, der skal bruges i feltet Datakilde og derefter kalde parameteren som en del af en forespørgsel. Eksempel i følgende SQL-sætning: SELECT * FROM customer WHERE last_name = Smith Du kan erstatte ærdien af Smith med parameteren 'plastname', så SQL-sætningen kommer til at se sådan ud: SELECT * FROM customer WHERE last_name =?plastname? Oerej følgende, når du opretter en parameter: Du skal først oprette TI-processen med en ODBC-kilde. Dette udfylder skillebladet Variabler. Du kan nu bruge ariablen DATASOURCEQUERY til at oerskrie ærdien i forespørgselstekstfeltet på skillebladet Datakilde. Antal kolonner fra det returnerede sæt skal passe til det tal, der ble oprettet, da IT-processen ble udiklet. Kolonnernes datatype skal også passe. Det er igtigt at sætte parameteren i enkelte anførselstegn, når det er en strengparameter. His det er en numerisk parameter, skal du ikke bruge enkelte anførselstegn. F.eks. kan en forespørgsel, der anender numerisk parameter, ære: SELECT * FROM customer WHERE last_name =?pquantity? For at oprette parameteren skal du bruge skillebladet Udidet på TurboIntegratordialogboksen til at erstatte standard-po-parameteren med den parameter, du il bruge, f.eks.: pefternan. Identificér ariabler: Når du har oprettet en forespørgsel til kildedataene, skal du identificere indholdet af hert felt i resultatet af forespørgslen. 1. Klik på skillebladet Variabler. Bemærk, at kolonnen Variabelnan er bleet udfyldt med de korrekte kolonnenane fra databasen. Tillæg A. TurboIntegrator - øeprogram 81

90 2. Reidér algene i kolonnen Indhold til disse alg. Variabelnan ACCOUNT_ID PARENT_ID NAME VÆRDITYPE (TYPE) SALESREP SALESTEAM Indhold Ignorér Ignorér Element Konsolidering Konsolidering Konsolidering Du er nu klar til at mappe ariabler. Map ariabler: Map ariabler ed at mappe elementer til dimensioner og derefter mappe konsolideringsariabler. 1. Map elementer til dimensioner. a. Klik på skillebladet Mapninger, og klik derefter på det underordnede skilleblad Dimensioner. Den enkelte ariabel, du har identificeret som et element, ises i gitteret. b. I kolonnen Dimension skal du skrie DB. c. Vælg Opret på menuen Handling. d. Vælg Numerisk på menuen Elementtype. 2. Map konsolideringsariabler. a. Klik på det underordnede skilleblad Konsolideringer. TM1 identificerer her konsolideringsariabel som mapning til DB-dimensionen. b. Angi den underordnede ariabel til her konsolideringsariabel. Kons.- ariabel VÆRDITYPE (TYPE) SALESREP SALESTEAM Underordnet ariabel SALESREP NAME VÆRDITYPE (TYPE) Gem og udfør processen: Sådan gemmer og udfører du processen: 1. Klik på knappen Udfør. TM1 beder dig om at gemme processen. 2. Gem processen som create_db_dimension. Efter nogle sekunder ises en bekræftelse på, at processen er udført. 82 TM1 TurboIntegrator

91 3. Luk induet Turbo Integrator. 4. Åbn Serer Explorer. 5. Dobbeltklik på den nye DB-dimension. DB-dimensionen ises i udsnitseditoren. 6. Vælg Redigér, Sortér, Hierarki på menulinjen i udsnitseditoren for at få ist dimensionselementer og konsolideringer. DB-dimensionen indeholder oer 40 elementer og har fire hierarkinieauer. Opret en kube, og behandl data Det næste eksempel iser, hordan TM1 TurboIntegrator skal bruges til at oprette en kube, dimensioner og elementer og behandle data på samme tid. Definér datakilden Udfør følgende trin for at definere en datakilde. 1. Højreklik på ikonen Processer i det enstre indue i Serer Explorer, og ælg Opret ny proces. Vinduet TurboIntegrator åbnes. 2. Klik på skillebladet Datakilde i induet TurboIntegrator. 3. Angi Type datakilde som Tekst, Type skilletegn som Afgrænset og Skilletegn som Komma. Ignorér felterne Anførselstegn og Antal titelrecords. 4. Kontrollér, at decimaltegnet er et komma (,), og tusindtalsskilletegnet er et punktum (.). 5. Klik på knappen Gennemse ud for feltet Nan på datakilde, og ælg filen newcube.cs i biblioteket TI_data. 6. Klik på Prøe for at få ist de første 10 records i datakilden. Her record i newcube.cs indeholder 20 felter. Du kan blade hen oer fremisningsgitteret for at få ist alle felter. Identificér ariabler Når kildedataene er indlæst i TurboIntegrator, skal du identificere indholdet i hert felt i kilden. 1. Klik på skillebladet Variabler. Nogle ariabler anender Vn-nanginingsregler, mens andre anender nane, der passer til den første record i kildefilen. 2. His du il simplificere redigeringsprocessen, skal du omdøbe alle ariabler ed hjælp af Vn-nanginingsreglen. Den første ariabel skal hae nanet V1, den anden ariabel V2 os. Når du er færdig, skal skillebladet Variabler se sådan ud: Tillæg A. TurboIntegrator - øeprogram 83

92 3. Til her ariabel skal du ælge en type på den tilknyttede liste Variabeltype. Til ariablerne V1, V2 og V19 er typen Numerisk. For alle andre ariabler er typen Streng. 4. Til her ariabel skal du ælge en indholdstype på den tilknyttede liste Indhold. Se følgende tabel for at identificere indholdstypen for her ariabel. Variabelnan Indhold Variabelnan Indhold V1 Data V11 Konsolidering V2 Data V12 Konsolidering V3 Data V13 Konsolidering V4 Element V14 Element V5 Konsolidering V15 Konsolidering V6 Konsolidering V16 Konsolidering V7 Konsolidering V17 Element V8 Konsolidering V18 Element V9 Konsolidering V19 Element V10 Element V20 Element 84 TM1 TurboIntegrator