Referensmanual. XOR Compact AB 1997-

Transkript

1 Referensmanual XOR Compact AB 1997-

2 OpenClient SetBalanceGroups SetResultGroups GetNextVoucherNo GetReservedAccount GetStandardText VoucherRowAdd AccountAdd ObjectAdd PersonAdd ArticleAdd GetNextNumber DueDateCalc InvoiceHeaderAdd InvoiceRowAdd InvoiceFooterAdd LedgerAdd GetRemainder DeleteInvoice XGetAccount XGetObject XGetPerson XGetArticle CloseClient... 47

3 DbOpen DbClose DbLock, DbUnlock RecAdd - XBAdd RecReturn - XBReturn RecFind - XBFind RecBest - XBBest RecExist - XBExist RecFirst - XBFirst RecLast - XBLast RecNext - XBNext RecPrev - XBPrev RecWrite - XBWrite RecDel TrBegin, TrEnd DateSystem YMDToDate DayOfWeek BeginWeek EndWeek EndWorkWeek DayOfYear BeginYear EndYear BeginMon EndMon Year(X) Mon Day(X) Week CLIENT - Företagsregister ACCOUNT - Kontoregister OBJECT - Objektregister BALANCE Saldoregister VOUCHER - Verifikatradsregister AUTO - Automatfördelningsregister DEFAULT Reserverade konton TEXT - Textregister HISTORY - Anteckningsregister PERSON - Personregister PERSSALES - Personstatistikregister LEDGER - Reskontraregister INVOICE Fakturaregister m.m INVOICEROW Fakturaradsregister m.m ARTICLE - Artikelregister ARTSALES - Artikelstatistikregister

4 Denna skrift är en referensmanual till API:t för XORBASE 4.0, den databasmotor vilken XOR Compact 4.0 begagnar sig av. Manualen riktar sig till de som avser att skriva försystem eller tilläggsprogram till XOR Compact 4.0, och förutsätter att läsaren är någorlunda insatt i grundläggande programmeringsmetodik något av programspråken BASIC, Visual Basic, C eller C++ databasbegrepp såsom register, poster, nycklar o.dyl. ekonomiska begrepp såsom konto, verifikationer, objekt, reskontra o.dyl Inledningsvis ges exempel på vad man kan åstadkomma med API:t samt vad man bör tänka på innan man börjar implementera en applikation. Därefter beskrivs i tur och ordning API:ts s.k. högnivå-, lågnivå- och juliandatumrutiner med deklarationer för varje enskild rutin samt en del programexempel. Sist finns en beskrivning av databasens uppbyggnad med alla registerstrukturer, nycklar och returkoder.

5 XORBASE 4.0 är namnet på den databasmotor som XOR Compact 4.0 använder sig av. Du kan som programutvecklare av kringsystem (t.ex. löne-, skatte- eller analysprogram) använda denna motor för att läsa och skriva information i XORBASE-databaser. Gränsnittet, eller API:t, mellan ditt kringsystem och databasen utgörs av det dynamiska länkbiblioteket XORBASE4.DLL, vilket består av ett antal högnivå-, lågnivå- och datumrutiner som ditt kringsystem kan använda sig av (filen XORBASE4.DLL placeras vid installation av XOR Compact 4.0 i samma katalog som COMPACT4.EXE). Både XORBASE4.DLL och XFILES4.DLL måste finnas antingen i samma katalog som din applikation eller i Windowskatalogen. Om du väljer att öppna DLL-filerna explicit via LoadLibrary så kan du använda de filer som ligger i XOR Compact katalogen. Då behöver de inte finnas någon annanstans på hårddisken. Med kan din applikation ställa om och läsa av redovisnings- och faktureringsspecifik information i databasen, samt skapa nya poster på ett enkelt sätt. Dessa är särskilt lämpliga att använda sig av om du utvecklar ett försystem som skall till XOR Compact 4.0. Med får din applikation ett mer direkt kommando över databasen och kan skapa, radera, söka och ändra poster i alla register efter behov. Med kan ditt program behandla den datumtyp, s.k., som XORBASE använder. Juliandatum definieras som ett löpande heltal motsvarande antalet dagar som passerat sedan Det finns en signifikant skillnad mellan hög- och lågnivårutinerna: Högnivårutinerna kan endast hantera, medan lågnivårutinerna kan hantera. Följande bild illustrerar hur din applikation kommunicerar med API:t: Här ser man att: högnivårutinerna egentligen består av färdigskrivna sekvenser av lågnivårutiner man med lågnivårutinerna kan operera på flera databaser samtidigt man med lågnivårutinerna kan utföra mer fundamentala operationer på databasen datumrutinerna inte opererar på databasen

6 Principen för många standardoperationer på databasen, t.ex. läsning av poster, är följande (skrivet i pseudokod): Deklarera nödvändiga variabler (post, nyckel, hjälpvariabler m.m.) Tilldela variablerna startvärden Öppna databasen Sök upp första posten i urvalet med avseende på angiven nyckel Så länge (det finns fler poster), utför [ Om aktuell post tillhör ditt urval, så Behandla aktuell post (t.ex. uppdatera, ta bort, skriv ut m.m) Hämta nästa post ] Stäng databasen En standardoperation kan vara att t.ex. fylla en kontolista med kontonummer och kontonamn. Nedanstående exempel (i BASIC) gör just detta och följer ovanstående princip: Dim dbase As String Dim directory As String Dim DB As Long Dim acc As AccountType Dim accno As String * 7 Dim ok As Integer dbase = "compact" + Chr$(0) directory = "c:\compact4\0001" + Chr$(0) DB = DbOpen(dbase, directory, 0&, 0) If DB = 0& Then Print "Misslyckades med att öppna databasen" End End If ok = RecFind(DB, ACCOUNT, 1, ByVal accno, acc) Do While ok = DbOk If (Left$(acc.accNo) = "1") acc.accno = Left$(acc.accNo, Instr(acc.accNo, Chr$(0)) - 1) acc.accname = Left$(acc.accName, Instr(acc.accName, Chr$(0)) - 1) list1.additem acc.accno & " " & acc.accname End If ok = RecNext(DB, ACCOUNT, 1, acc) Loop DbClose(DB)

7 Din applikation kan med XORBASE 4.0 API bilda en länk mellan XOR Compact 4.0 och andra databaser/administrativa program. Nedanstående bild illustrerar hur är kopplad till en som används av ett. Din Applikation kan t.ex. skapa poster i XOR Compact 4.0 som grundar sig på information som ett Annat Administrativt Program lagrat i en ACCESSdatabas. Denna information kan vara timkostnad och tidsåtgång för utförda arbeten av olika personer i ett tjänsteproducerande företag; Din Applikation kan utifrån denna information via XORBASE 4.0 API skapa fakturor för dessa arbeten, som sedan kan skrivas ut och bevakas i XOR Compact 4.0.

8 Om du designar ett s.k. försystem som skall överföra verifikatrader till en XORBASE-databas måste du Bestämma dig för en specifik verifikatnummerserie i XOR Compact. Kontrollera nästa lediga nummer i verifikatnummerserien (med rutinen GetNextVoucherNo). Uppdatera konto- och företagssaldon. När du förbereder en överföring av verifikatrader är det nödvändigt att veta vilket verkligt kontonummer ett visst konto har för att du överhuvudtaget skall kunna skapa verifikatrader i XORBASE. Eftersom databasen stöder olika kontoplaner, kan samma konto (t.ex. ) ha olika kontonummer i olika databaser (t.ex. i en databas som använder BAS95 och i en databas som använder EUBAS97). För att en enkel databasoperation skall bli oberoende av kontoplan, finns det ett register i databasen som innehåller de reserverade kontona. Detta register heter DEFAULT och posterna består av två fält: DefNo= AccNo= reserverat konstant nummer för det reserverade kontot det verkliga kontonumret som används bl.a. i databasens verifikat- och kontoregister För att ta reda på vilket kontonummer i databasen ett visst konto har, används lämpligen högnivårutinen. Följande reserverade konton finns definierade i databasen: 1 Utgående moms 1 2 Utgående moms 2 10 Ingående moms 1 11 Ingående moms 2 17 Ingående moms 4 18 Lagerkonto 19 Årets resultat 20 Kundfordringar 21 Debiterade frakter 22 Avgift 23 Öresutjämning 24 Ränteintäkter 25 Finansiella poster 26 Försäljning 27 Varuköp 28 Leverantörsskulder 29 Inbetalningskonto 30 Kontantfakturering 31 Räntekostnader 32 Justeringskonto 33 Utgående kassarabatt 34 Ingående kassarabatt 35 Kursvinst 36 Kursförlust 37 Export EU försäljning 38 Övrig exportförsäljning 39 Utbetalningskonto 40 Momsavräkning 41 Deb. Frakter export 42 Avgift Export

9 För att du enkelt skall kunna överföra data till XOR Compact 4.0 i ditt försystem finns det ett antal högnivårutiner för detta ändamål (att operera på databasen med lågnivårutinerna kräver en viss programmeringsvana). Med högnivårutinerna kan du på ett enkelt sätt göra korta programsekvenser som t.ex. överför transaktionsrader, konton, objekt, personer, artiklar, fakturor, reskontraposter med eller utan transaktioner till redovisningen. För att i fleranvändarmiljöer eliminera risken att två parallellt exekverande program uppdaterar samma post i samma databas samtidigt (vilket innebär en fatal inkonsekvens i databasen), används i alla databassammanhang någon form av låsning. Låsning innebär att endast ett program tillåts operera åt gången. XORBASE4 kan användas i fleranvändarmiljö, vilket ställer ett antal krav på dig som utvecklare av försystem: I XORBASE4 används fillåsning, och högnivårutinerna som du kan använda för att hantera detta heter och ; utför en fillåsning i fleranvändarsystem och denna fillåsning släpps först när anropas. Alla anrop till databasen förutsätter att du först öppnar databasen med funktionen. Efter utförda operationer måste du stänga databasen med. låser. Därför bör du INTE anropa en gång i början av ditt program och en gång i slutet av ditt program, eftersom detta låser databasen för andra användare så länge ditt program exekverar. Anropa istället och före och efter varje deloperation i ditt program. Då låser ditt program databasen under kortast möjliga tid, och tillåter att andra program får tillgång till databasen när ditt program inte behöver den. XOR Compact öppnas automatiskt i rätt läge av högnivårutinerna, d.v.s. du behöver inte bry dig om att själv öppna databasen rätt. Dock måste du kontrollera om databasen är öppen och hur den då blivit öppnad. Därför är det viktigt att du testar returvärdet från. Om XOR Compact redan är öppen 'exklusivt' (d.v.s. när en användare är inne och endast en användare får vara inne i databasen åt gången), tillåts inte att operationen genomförs. XOR Compact måste då stängas först. Om XOR Compact däremot är öppen i 'Fleranvändarmiljö' går det alldeles utmärkt att överföra data.

10 Vissa av lågnivårutinerna är specialskrivna för de nyare varianterna av Visual Basic; Visual Basic 4.0, 5.0 och VBA Visual Basic for Applications). De lågnivårutiner som är listade i vänster kolumn nedan bör begagnas om du använder VB. Använd i dessa fall mostsvarande rutiner med prefix i den högra kolumnen. Dessa rutiner motsvarar i funktion rutinerna till vänster. Dessa båda typer av rutiner ( och ) är, d.v.s. om du använda en -rutin i din utvecklingsmiljö, så riskerar du felkörningar om du använder motsvarande -rutin. Du kan alltså inte helgardera dig med att alltid använda -rutinerna. RecAdd RecReturn RecFind RecBest RecExist RecFirst RecLast RecNext RecPrev RecWrite XBAdd XBReturn XBFind XBBest XBExist XBFirst XBLast XBNext XBPrev XBWrite XOR Compact 4.0 packar internt sina strukturer (poster) med 1-byte-boundary. Detta innebär att program som kommunicerar via XORBASE4.DLL måste ha använda samma packning för sina strukturer som Compact 4.0 (d.v.s. 1-byte-boundary). De flesta vanliga programmeringsspråk och kompilatorer stöder detta, med undantag för, och, samt vissa 4GL-verktyg som inte hanterar begreppen Aligned structures, Packed records eller User defined types. Användare av bör arbeta med rutinerna. För nyare varianter av, ex., och, används 4 bytes alignment av user defined types. De flesta av rutinerna som använder user defined types har därför utökats med en uppsättning rutiner för att avhjälpa problemen med. Använd -rutinerna istället för -rutinerna i fall du har 4 bytes alignment. Dessa rutiner är utkommenterade med efter -rutinerna i exemplen.

11 Om du delar in det arbete ditt program skall göra i väl avgränsade logiska arbetsmoment (och dokumenterar dessa för sig), blir programmet lättare att förstå och felsöka under utvecklingen. Dessutom förenklas underhållet betydligt då ny funktionalitet skall läggas till eller om de grundläggande förutsättningarna för programmet förändras (t.ex. om standarden för ett visst filformat förändras). Detta ger en bra översikt över de variabler du har tillgängliga, vilket minskar risken för dubbel deklaration och eventuella tvetydigheter. När du under ditt programmeringsarbete dessutom finner att du behöver fler variabler, så behöver du inte vara oklar över var någonstans du skall deklarera dem. Vidare blir de naturligtvis enklare att hitta och att omdeklarera om de behöver ändras, byggas ut, bortkommenteras eller tas bort. En variabel som används utan att du har tilldelat den ett värde, kan i många fall ge upphov till svårhittade programkörningsfel. Returvärdet från en för programflödet kritisk funktion (t.ex. och i XORBASE 4.0 API) bör testas för att undvika att gränsfall och specialfall inte får oväntade konsekvenser. Detta är viktigt för att du inte ska orsaka korruptioner i filen eller databasen. En hängande handle kan dessutom ge upphov till kraftiga prestandaproblem vid efterföljande fil- och/eller databasoperationer. Undvik brutala hoppsatser (såsom t.ex. ) de är nästan aldrig användbara, utan tjänar endast till att försvåra läsbarheten och därmed också försvåra framtida underhåll. Vad du än programmerar (skapar/ändrar/lägger till); en liten programsnutt, funktion, procedur, rutin eller skript, bör testas under samma förutsättningar som när programkoden kommer att användas. Din interna representation av årtal måste kunna hantera 4-positioners årtal ( ) för att klara av det nära stundande tusenårsskiftet. Detta gäller naturligtvis också år Detta underlättar avsevärt framtida underhåll av programkoden. Varje program och varje i programmet ingående funktion/procedur/rutin/skript bör inledas med ett stycke kommentarer som beskriver i klartext vad programkoden utför, samt vilket datum och av vem programkoden skrevs. Ett komplicerat avsnitt inuti en funktion/procedur/rutin/skript som utför en avgränsad del av arbetet, bör även det inledas med någon/några kommentarer till vad just det avsnittet utför.

12 XOR Compact 4.0 och XORBASE4 är internt skrivet och dokumenterat på engelska bl.a. för att förenkla samarbete med andra länder. Därför är också alla funktions- och databasdeklarationer i denna manual på engelska. Här följer en liten engelsk-svensk ordlista med några vanliga begrepp inom ekonomi och handel: account amount article client currency discount freight interest invoice ledger object price residual stock tax T.O.D. T.O.P. unit V.A.T. voucher weight W.O.D. konto belopp artikel klient (företag) valuta rabatt frakt ränta faktura reskontra objekt (projekt/kostnadsställe) pris rest lager skatt leveransvillkor betalningssätt enhet moms verifikat vikt leveranssätt

13 Följande tre listor är översikter över de högnivå- lågnivå- och juliandatumrutiner som ingår i XORBASE 4.0 API: Skapar ett konto i databasen Skapar en artikel i databasen Stänger en företagsdatabas Tar bort en hel faktura ur fakturaregistret Räknar ut förfallodag Hämtar nästa löpnummer för olika posttyper Hämtar nästa verifikatnummer i serien Hämtar restbeloppet på kund- el. leverantörsfaktura Hämtar ett specifikt reserverat konto Hämtar en text ur textregistret Avslutar en faktura (skapar en fakturafot) Skapar ett fakturahuvud till en faktura Skapar en rad till en faktura Skapar en kund- el. leverantörsreskontrapost Skapar ett objekt i databasen Öppnar en företagsdatabas Skapar en person (kund, leverantör el. egendefinierad typ) Ställer in första och sista balansgrupp Ställer in första och sista resultatgrupp Lägger till en verifikatsrad Hämtar ett specifikt konto i databasen Hämtar en specifik artikel i databasen Hämtar ett specifikt objekt i databasen Hämtar en specifik kund el. leverantör i databasen Stänger en företagsdatabas Låser en företagsdatabas för andra program/användare Öppnar en företagsdatabas Låser upp en företagsdatabas för andra program/användare Lägger till nuvarande post i angivet register Letar upp en post i angivet register enligt best fit Tar bort en post ur angivet register Kontrollerar om en specifik post finns i angivet register Letar upp en post i angivet register Letar upp första posten i angivet register Letar upp sista posten i angivet register Går till (laddar in) nästa post i angivet register Går till (laddar in) föregående post i angivet register Returnerar en ev. uppdaterad post till angivet register Skriver in en post i angivet register Flaggar för början av en kritisk databasoperation Flaggar för slutet av en kritisk databasoperation

14 Returnerar datumet för första dagen i månaden Returnerar datumet för första dagen i veckan Returnerar datumet för första dagen på året Returnerar dagens nummer (1-31) för angivet juliandatum Returnerar datumet från datorns systemklocka Returnerar veckodagen som ett nummer (1-7) Returnerar dagen på året som ett nummer (1-365) Returnerar datumet för sista dagen i månaden Returnerar datumet för sista dagen i veckan Returnerar datumet för sista arbetsdagen i veckan Returnerar datumet för sista dagen på året Returnerar månadens nummer(1-12) för angivet juliandatum Returnerar veckonumret (1-52/53) för angivet juliandatum Returnerar året som ett heltal för angivet juliandatum Konverterar tre heltal (år, månad, dag) till ett juliandatum

15

16 Följande programsekvens överför två transaktionsrader till ett verifikat. Du kan naturligtvis också överföra transaktionsrader inuti slingor (t.ex. for -, while -, eller repeat m.m.). long db; if ((db = ("0001", "C:\\COMPACT4")) > 5L) { (db, 0, 0L, 1, 1995, 4, 24, "Faktura 1", "3011", "", ); (db, 0, 0L, 2, 1995, 4, 24, "Faktura 1", "1010", "", ); (db); } else ErrorBox("Felkod %ld", db); Dim DB As Long Dim client As String Dim path As String Dim text As String Dim accno As String client = "0001" + Chr$(0) path = "C:\COMPACT4" + Chr$(0) DB = (client, path) if DB > 5& Then text = "Faktura 1" + Chr$(0) accno = "3011" + Chr$(0) (DB, 0, 0&, 1, 1995, 4, 24, text, accno, "", #) accno = "1010" + Chr$(0) (DB, 0, 0&, 2, 1995, 4, 24, text, accno, "", #) (DB) Else Print "Felkod + Str(DB)" Endif Dessa operationer sker med mer automatik och därmed med högre säkerhet än om motsvarande operationer hade utförts med lågnivårutinerna. I fallet ovan sker med automatik en uppräkning av verifikatnumret och en uppdatering av saldoregistret och övrig statistik.

17 Med kan du även testa om kontot existerar. Om kontot inte existerar kan du hämta korrekt konto för t.ex. försäljning och kassa med högnivårutinen. Du kan även börja med att anropa som i nästa exempel. Använd alltid reserverade konton om sådana finns. if ((db = OpenClient("0001", "C:\\COMPACT4")) > 5L) { char accno[8]; } (db, DEFSALES, accno); (db, 0, 0L, 1, 1995, 4, 24, "Faktura 1", accno, "", ); (db, DEFCASH, accno); (db, 0, 0L, 2, 1995, 4, 24, "Faktura 1", accno, "", ); CloseClient(db); Dim DB As Long Dim client As String Dim path As String Dim text As String Dim accno As String client = "0001" + Chr$(0) path = "C:\COMPACT4" + Chr$(0) DB = OpenClient(client, path) if DB > 5& Then text = "Faktura 1" + Chr$(0) (DB, DEFSALES, accno) (DB, 0, 0&, 1, 1995, 4, 24, text, accno, "", #) (DB, DEFCASH, accno) (DB, 0, 0&, 2, 1995, 4, 24, text, accno, "", #) CloseClient(DB) Else Print "Felkod + Str(DB)" Endif

18 Du kan också upprätta nya konton i XOR Compact på ett enkelt sätt med rutinen.dennaskapar ett nytt konto om kontot inte redan finns. Om parametern Force sätts till True kommer ett redan existerande kontos namn att ändras till det namn du anger i accname. if ((db = OpenClient("0001", "C:\\COMPACT4")) > 5L) { (db, "3011", "Försäljning", 0, False); VoucherRowAdd(db, 0, 0L, 1, 1995, 4, 24, "Faktura 1", "3011", "", ); (db, "1010", "Kassa", 0, False); VoucherRowAdd(db, 0, 0L, 2, 1995, 4, 24, "Faktura 1", "1010", "", ); CloseClient(db); } Dim DB As Long Dim client As String Dim path As String Dim text As String Dim accno As String Dim accname As String client = "0001" + Chr$(0) path = "C:\COMPACT4" + Chr$(0) DB = OpenClient(client, path) if DB > 5& Then text = "Faktura 1" + Chr$(0) accno = "3011" + Chr$(0) accname = "Försäljning" + Chr$(0) (DB, accno, accname, 0, False) VoucherRowAdd(DB, 0, 0&, 1, 1995, 4, 24, text, accno, "", #) accno = "1010" + Chr$(0) accname = "Kassa" + Chr$(0) (DB, accno, accname, 0, False) VoucherRowAdd(DB, 0, 0&, 2, 1995, 4, 24, text, accno, "", #) CloseClient(DB) Else Print "Felkod + Str(DB)" Endif

19 På samma sätt som i föregående exempel upprättar du ett nytt objekt med funktionen : if ((db = OpenClient("0001", "C:\\COMPACT4")) > 5L) { (db, "A1", "Alpha 1", False, False); VoucherRowAdd(db, 0, 0L, 1, 1995, 4, 24, "Faktura 1", "3011", "A1", ); (db, "A2", "Alpha 2", False, False); VoucherRowAdd(db, 0, 0L, 2, 1995, 4, 24, "Faktura 1", "1010", "A2", ); CloseClient(db); } Dim DB As Long Dim client As String Dim path As String Dim text As String Dim accno As String Dim objno As String Dim objname As String client = "0001" + Chr$(0) path = "C:\COMPACT4" + Chr$(0) DB = OpenClient(client, path) if DB > 5& Then text = "Faktura 1" + Chr$(0) accno = "3011" + Chr$(0) objno = "A1" + Chr$(0) objname = "Alpha 1" + Chr$(0) (DB, objno, objname, False, False) VoucherRowAdd(DB, 0, 0&, 1, 1995, 4, 24, text, accno, objno, #) accno = "1010" + Chr$(0) objno = "A2" + Chr$(0) objname = "Alpha 2" + Chr$(0) (DB, objno, objname, False, False) VoucherRowAdd(DB, 0, 0&, 2, 1995, 4, 24, text, accno, objno, #) CloseClient(DB) Else Print "Felkod + Str(DB)" Endif

20 Rutinerna, och gör det enkelt att överföra dina fakturor till XOR Compact för att kunna skriva ut dem och sedan använda XOR Compact:s förnämliga reskontra. Principen är att man först eventuellt skapar kunden och/eller artikeln om dessa inte finns. Kundnumret bestämmer olika standardvärden för fakturan och artikelregistret kommer att uppdateras automatiskt. Därefter skapar du fakturahuvudet och de på fakturan ingående fakturaraderna. Om rutinerna anropas och kunden eller artikeln inte finns i databasen, så får du ett felmeddelande. Följande exempel skapar fakturahuvud och fakturarader under förutsättning att kund och artikel finns i databasen: if ((db = OpenClient("0001", "C:\\COMPACT4")) > 5L) { (db, "1001", XCUSTINVOICE, 0L, 1995, 4, 22, RELEASED); (db, XCUSTINVOICE, 0L, 1, "001", "Kristallvas", "st", "", "", 1, , 0.0, , 0.0, 0.0); (db, XCUSTINVOICE, 0L, 2, "002", "Kristallskål", "st", "", "", 2, , 0.0, , 0.0, 0.0); (db, XCUSTINVOICE, 0L, , 50.00, 0.0, 0,0, ); CloseClient(db); } Dim DB As Long Dim client As String Dim path As String Dim persno As String Dim artno As String Dim artname As String Dim unit As String client = "0001" + Chr$(0) path = "C:\COMPACT4" + Chr$(0) DB = OpenClient(client, path) if DB > 5& Then persno = "1001" + Chr$(0) (DB, persno, XCUSTINVOICE, 0&, 1995, 4, 22, RELEASED) unit = "st" + Chr$(0) artno = "001" + Chr$(0) artname = "Kristallvas" + Chr$(0) (DB, XCUSTINVOICE, 0&, 1, artno, artname, unit, "", "", 1, #, 0.0#, #, 0.0#, 0.0#) artno = "002" + Chr$(0) artname = "Kristallskål" + Chr$(0) (DB, XCUSTINVOICE, 0&, 1, artno, artname, unit, "", "", 2, #, 0.0#, #, 0.0#, 0.0#) (DB, XCUSTINVOICE, 0&, #, 50.00#, 0.0#, 0,0#, #) CloseClient(DB) Else Print "Felkod + Str(DB)" Endif

21 Följande exempel skapar först en kund och två artiklar med hjälp av rutinerna och och sedan en faktura (huvud och rader) baserad på dessa poster: if ((db = OpenClient("0001", "C:\\COMPACT4")) > 5L) { (db, CUSTOM, "", "1001", "XOR AB", "", "Anckargripsg. 3", " MALMÖ", "", " ", " ", "Magnus", -1, -1, -1, False); InvoiceHeaderAdd(db, "1001", XCUSTINVOICE, 0L, 1995, 4, 22, RELEASED); (db,"","001","kristallvas", 25.0, 5.0, , , False); InvoiceRowAdd(db, XCUSTINVOICE, 0L, 1, "001", "Kristallvas", "st", "", "", 1, , 0.0, , 0.0, 0.0); (db,"","002","kristallskål",30.0,5.0,350.00,200.00,false); InvoiceRowAdd(db, XCUSTINVOICE, 0L, 2, "002", "Kristallskål", "st", "", "", 2, , 0.0, , 0.0, 0.0); InvoiceFooterAdd(db, XCUSTINVOICE,0L,950.00,50.00,0.0,0,0, ); CloseClient(db); } Dim DB As Long Dim client As String Dim path As String Dim persno As String Dim persname As String Dim persadr2 As String Dim persadr3 As String Dim persphone As String Dim persfax As String Dim persref As String Dim artno As String Dim artname As String Dim unit As String client = "0001" + Chr$(0) path = "C:\COMPACT4" + Chr$(0) DB = OpenClient(client, path) if DB > 5& Then persno = "1001" + Chr$(0) persname = "XOR AB" + Chr$(0) persadr2 = "Anckargripsg. 3" + Chr$(0) persadr3 = " MALMÖ" + Chr$(0) persphone = " " + Chr$(0) persfax = " " + Chr$(0) persref = "Magnus" + Chr$(0) (DB, CUSTOM, "", persno, persname, "", persadr2, persadr3, "", persphone, persfax, persref, -1, -1, -1, False); InvoiceHeaderAdd(DB, persno, XCUSTINVOICE, 0&, 1995, 4, 22, RELEASED) unit = "st" + Chr$(0) artno = "001" + Chr$(0) artname = "Kristallvas" + Chr$(0) (DB, "", artno, artname, 25.0#, 5.0#, #, #, False) InvoiceRowAdd(DB, XCUSTINVOICE, 0&, 1, artno, artname, unit, "", "", 1, #, 0.0#, #, 0.0#, 0.0#) artno = "002" + Chr$(0) artname = "Kristallskål" + Chr$(0) (DB, "", artno, artname, 25.0#, 5.0#, #, #, False) InvoiceRowAdd(DB, XCUSTINVOICE, 0&, 1, artno, artname, unit, "", "", 2, #, 0.0#, #, 0.0#, 0.0#) InvoiceFooterAdd(DB, XCUSTINVOICE, 0&, #, 50.00#, 0.0#, 0,0#, #) CloseClient(DB) Else Print "Felkod + Str(DB)" Endif

22 Med funktionen kan du överföra utskrivna fakturor från ett annat försystem och uppdatera endast reskontran och bokföringen i XOR Compact. Därefter kan du låta XOR Compact sköta påminnelser, krav och räntefakturering. När du använder sker följande: Reskontran uppdateras automatiskt. Bokföringen uppdateras automatiskt. Kundstatistik uppdateras automatiskt. Som du ser i exemplet nedan är det mycket enkelt att överföra data på detta sätt. utför en fillåsning i fleranvändarmiljö innan operationen utförs och denna fillåsning släpps först när anropas. if ((db = OpenClient("0001", "C:\\COMPACT4")) > 5L) { (db, CUSTOM, "1001", FA, 0L, "", 1995, 4, 22, , , True); (db, CUSTOM, "1002", KN, 0L, "", 1995, 4, 22, , , True); CloseClient(db); } Dim DB As Long Dim client As String Dim path As String Dim persno As String client = "0001" + Chr$(0) path = "C:\COMPACT4" + Chr$(0) DB = OpenClient(client, path) if DB > 5& Then persno = "1001" + Chr$(0) (DB, CUSTOM, persno, FA, 0&, "", 1995, 4, 22, #, #, True) persno = "1002" + Chr$(0) (DB, CUSTOM, persno, KN, 0&, "", 1995, 4, 22, #, #, True) CloseClient(DB) Else Print "Felkod + Str(DB)" Endif

23 Du kan enkelt hämta huvudposter ur olika grundregister för att t.ex. fylla en lista eller testa om en specifik huvudpost finns. Exemplet nedan använder rutinen för att hantera databasens kontoregister. Med rutinen hämtas först konton ur databasen och sedan testas (med samma rutin) om kontot finns. På samma sätt kan man hantera objekt, personer och artiklar. Högnivårutinerna för detta heter, respektive. long db; if ((db = OpenClient("0001", "C:\\COMPACT4")) > 5L) { char accno[7], accname[31]; int ok; *accno = \0 ; for (ok = (db, accno, accname, TRUE, FALSE ); ok == TRUE; ok = (db, accno, accname, FALSE, FALSE)) { // Fyll lista med konton (accno och accname) } strcpy(accno, 3011 ); // test if accno exists if ((db, accno, accname, TRUE, TRUE)) VoucherRowAdd(db, 0, 0L, 1, 1995, 4, 24, "Faktura 1", accno, "", ); CloseClient(db); } else ErrorBox("Felkod %ld", db); Dim DB As Long Dim client As String Dim path As String Dim text As String Dim accno As String * 7 Dim accname As String * 31 client = "0001" + Chr$(0) path = "C:\COMPACT4" + Chr$(0) DB = OpenClient(client, path) if DB > 5& Then accno = "3011" + Chr$(0) Test if accno exists if (DB, accno, accname, 1, 1) text = "Faktura 1" + Chr$(0) VoucherRowAdd(DB, 0, 0&, 1, 1995, 4, 24, text, accno, "", #) accno = "1010" + Chr$(0) VoucherRowAdd(DB, 0, 0&, 2, 1995, 4, 24, text, accno, "", #) Endif CloseClient(DB) Else Print "Felkod + Str(DB)" Endif

24 Skapar ett konto i databasen Skapar en artikel i databasen Stänger en företagsdatabas Tar bort en hel faktura ur fakturaregistret Räknar ut förfallodag Hämtar senaste löpnummer för olika posttyper Hämtar nästa verifikatnummer i serien Hämtar restbeloppet på faktura Hämtar ett specifikt reserverat konto Hämtar en text ur textregistret Avslutar en faktura (skapar en fakturafot) Skapar ett fakturahuvud till en faktura Skapar en rad till en faktura Skapar en kund- el. leverantörsreskontrapost Skapar ett objekt i databasen Öppnar en företagsdatabas Skapar en person(kund,leverantör el. egendefin.typ) Ställer in första och sista balansgrupp Ställer in första och sista resultatgrupp Lägger till en verifikatsrad Hämtar ett specifikt konto i databasen Hämtar en specifik artikel i databasen Hämtar ett specifikt objekt i databasen Hämtar en specifik kund el. lev. i databasen

25 Funktionen öppnar företagets databas, vilken identifieras av. Funktionen testar om det är ok att börja utföra operationer i databasen och returvärdet utgörs av en handle av typen (se nedan). Om denna är giltig (>5), så kan operationer på databasen utföras. Denna handle används sedan för att identifiera databasen, och anges som första parameter vid användandet av övriga rutiner. clientno dbpath Företagets nummer t.ex. "0001" (Övningsbolaget). Sökvägen till XORBASE4.DLL. > 5L En giltig handle till databasen. 0L Databasen kan inte öppnas. 1L Minnesallokeringsproblem. 2L Företagsnumret finns inte i listan i XCLIENT.DBI. 3L Företaget är redan öppet i. 4L Operationen har avbrutits i. 5L Företagsnumret finns inte i databasen.

26 Funktionen sätter första och sista balansgrupp. Funktionen behöver inte anropas för Sveriges vidkommande, då svenska värden användes som standard ( = 10 och = 29). first last Första gruppen i balansgrupperna. Sista gruppen i balansgrupperna.

27 Funktionen sätter första och sista resultatgrupp samt sista försäljningsgrupp. Funktionen behöver inte anropas för Sveriges vidkommande, då svenska värden används som standard (first = 30, last = 99 och lastsales = 39). first last lastsales Första gruppen i resultatgrupperna. Sista gruppen i resultatgrupperna. Sista gruppen i försäljningsgrupperna.

28 Funktionen hämtar nästa verifikatnummer i verifikatserien. serie Verifikatserien i XOR Compact. Serierna ligger mellan 0 och 9 där främst serierna 5 till 7 skall användas. Nästa verifikatnummer i serien. 0 används för bokföring 1 används för kundbokning (fakturering) 2 används för inbetalningar 3 används för leverantörsbokning (fakturering) 4 används för utbetalningar 5-7 är fria serier 8 används för bokslutsprogram 9 används för revisoröverföring

29 Funktionen används för att hämta ett reserverat konto. db no Handle till databasen (från ). Något av följande värden: DEFVATOUT DEFVATIN DEFSTOCK DEFYEARRESULT DEFCUSTOMER DEFFREIGHT DEFFEE DEFADJUSTMENT DEFINTERIN DEFFINANCE DEFSALES DEFPURCHASE DEFSUPPLIER DEFPAYIN DEFCASH DEFINTEROUT DEFCHANGE DEFDISCOUNTOUT DEFDISCOUNTIN DEFXPROFIT DEFXLOSS DEFEXPSALES DEFEXPSALES2 DEFPAYOUT DEFVAT DEFFREIGHTEXP DEFFEEEXP Utgående moms Ingående moms Lagerkonto Årets resultat Kundfordringar Frakt Expeditionsavgift Öresavrundning Ränteintäkter Finansiella poster Försäljning Inköp Leverantörskuld Inbetalningskonto (bank) Kassakonto Ränteutgifter Justeringskonto (lager) Utgående kassarabatt Ingående kassarabatt Kursvinst Kursförlust Exportförsäljning EU Exportförsäljning Utbetalningskonto (bank) Momsavräkning Frakt Export Expeditionsavgift Export accno 1L 0L Buffert i vilken kontonumret returneras av funktionen. Bör kunna ta emot 6 siffror. Kontot fanns. Kontot hittades inte.

30 Funktionen används för att utifrån ett reserverat nummer ta fram en text ur textregistret, vilket används i många olika sammanhang i XOR Compact (se nedan). För Sveriges vidkommande kan dessa nummer hittas i filen TEXT2.SCR. db no text 1L 0L Handle till databasen från. Textnummer (se i TEXT2.SCR Buffert i vilken texten returneras. Denna måste kunna ta emot 127 tecken. Texten fanns. Texten hittades inte. Kontoklass- och kontogrupptexter Loggkategoritexter Säljare Objekttexter Företagstexter Verifikattexter Reserverade texter Leveransvillkor Leveranssätt Avgiftstexter Faktura- och fakturaradstexter Kravtexter Enheter Titeltexter för dokument Betalningsvillkor Seriekoder Persontyper Persongrupper Persontexter Artikelgrupper Kontofunktioner

31 Funktionen används för överföring av verifikatrader från ett försystem. Den uppdaterar saldoregistret och relevant statistik automatiskt. db Handle till databasen från. serie Verifikatserienummer i XOR Compact. Serierna ligger mellan 0 och 9. 0 används för bokföring 1 används för kundbokning (fakturering) 2 används för inbetalningar 3 används för leverantörsbokning (fakturering) 4 används för utbetalningar 5-7 är fria serier 8 används för bokslutsprogram 9 används för revisoröverföring no Verifikatnummer. För att få nästa lediga verifikatnummer kan du använda rutinen eller sätta till 0. Då hämtas automatiskt nästa nummer. transno transaktionsnummer (radnummer) inom verifikatet (börjar på 1). year Året uttryckt med siffror, t.ex.: month Månaden uttryckt som siffra : day Dagen uttryckt som siffra : 1-31 (30, 28/29). text Transaktionstext till varje enskild verifikatrad (försök ange så relevant accno information som möjligt). Kontonummer som skall användas. Om du är osäker på vilket kontonummer du skall använda, kan du använda funktionen för att hitta kontot. Du kan även upprätta nya konton i XOR Compact med rutinen. objno objektnummer som skall användas. Kan vara en tom sträng (""). Om du är osäker på om objektet finns kan du använda för att lägga upp nya objekt. amount Transaktionsbeloppet. -1L Felaktigt datum. Kontrollera att året är angivet som 1995 och inte L Datum ligger utanför räkenskapsåren i XOR Compact. -3L Objektet finns inte. -4L Verifikatnumret finns redan. (Du har angivet ett felaktigt nummer). >0L Verifikatnumret (operationen lyckades).

32 Funktionen upprättar ett konto i XOR Compact om det inte redan finns. db accno name group force Handle till databasen från. Kontonummer (max 6 tecken). Kontonamn (max 30 tecken). Kontogrupp. Om gruppen sätts till 0 så beräknas den. Om värdet sätts till 1 uppdateras namnet på kontot om det finns. Om värdet sätts till 0 ändras inget. -1 Om force är 0 och kontot redan finns. 0 Operationen lyckades. >0 Databasfelkod.

33 Funktionen upprättar ett objekt i XOR Compact om det inte redan finns. db Handle till databasen från. objno Objekt ID (max 10 tecken). name Objektnamn (max 30 tecken). multi 1 om objektet skall vara av projekttyp (flerårigt), annars 0. force Om värdet sätts till 1 uppdateras namnet på objektet om det finns. Om värdet sätts till 0 ändras inget. -1 Om force är 0 och objektet redan finns. 0 Operationen lyckades. >0 Databasfelkod.

34 Funktionen upprättar en person i XOR Compact om den inte redan finns. db perstype group persno name adr1 adr2 adr3 adr4 phone fax ref top tod wod force Handle till databasen från. Persontyp (, kund eller, leverantör). Även andra värden är möjliga (3 = leveransadress, 4 = prospekt, 5 = privat). Persongrupp (max. 10 tecken). Person ID (max. 10 tecken). Personnamn (max. 30 tecken). Personadress 1 - Besöksadress (max. 30 tecken). Personadress 2 - Boxadress. (max. 30 tecken). Personadress 3 - Postnummer och ort. (max. 30 tecken). Personadress 4 - Land. (max. 30 tecken). Telefonnummer (max. 20 tecken). Telefaxnummer (max. 20 tecken). Referens. (max. 20 tecken). Betalningsvillkor (ett heltal större än 0, se XOR Compact). Ange -1 för standardvärde. Leveranssvillkor (ett heltal större än 0, se XOR Compact). Ange -1 för standardvärde. Leveranssätt. (ett heltal större än 0, se XOR Compact). Ange -1 för standardvärde. Om värdet sätts till 1 uppdateras fälten om posten finns. Om värdet sätts till 0 uppdateras inget. -1 Om force är 0 och personen redan finns. 0 Operationen lyckades. >0 Databasfelkod.

35 Funktionen upprättar en artikel i XOR Compact om den inte finns. db group artno name items min price purch force Handle till databasen från. Artikel grupp (max. 10 tecken). Artikel ID (max. 15 tecken). Artikelnamn (max. 50 tecken). Antal i lager. Beställningspunkt. Artikelpris. Inköpspris. Om värdet sätts till 1 uppdateras fälten om artikeln finns. Om värdet sätts till 0 justeras inget. -1 Om force är 0 och artikeln redan finns. 0 Operationen lyckades. >0 Databas felkod.

36 Funktionen returnerar löpnummer för poster av typen. Nästa lediga löpnummer kan alltså fås genom att addera 1 till detta. type en av följande typer: XORDER order XCUSTINVOICE kundfakturor/kreditnotor XPURCHASE inköp XSUPPINVOICE leverantörsfaktura/kreditnotor XPAY betalningsnummer Nästa löpnummer för typen.

37 Funktionen beräknar förfallodagen utifrån en sträng i XOR Compact. buf Sträng innehållande betalningsvillkoret, t.ex. : 10 dagar netto Fri månad + 15 dagar Fri månad - 2 dagar Netto kontant. begin Juliandatum från vilken förfallodagen skall beräknas Ett juliandatum beräknat från begin. Datumet beräknas på följande sätt: Om inga siffror finns i strängen = 0 dagar. Om siffror finns i början av strängen = NN dagar Om siffror finns inuti strängen = fri månad +/- NN dagar

38 Funktionen skapar ett fakturahuvud. db persno type invno Handle till databasen från. Kund ID (max. 10 tecken). Fakturatyp. Kan vara: XORDER Order XCUSTINVOICE Faktura/kreditnota XPURCHASE Inköp Fakturanummer. Om du inte vet numret kan du hämta det med rutinen. Du kan också ange 0L för att få nästa nummer automatiskt. year Fakturadatum (år). Året uttryckt med siffror (t.ex. 1995). month Fakturadatum (månad). Månaden uttryckt som siffra (1-12). day Fakturadatum (dag). Dagen uttryckt som siffra : (1 31). status Fakturastatus. Kan vara: NOTPRINTED Ej utskriven PRINTED Utskriven TRANSFERED Överförd PERMANENT Permanent NOTREADY Ej färdig -1 Felaktig fakturatyp. -2 Personen finns inte. -3 Felaktigt datum. -4 Datumet ligger utanför räkenskapsåret. 0 Operationen lyckades. >0 Databasfelkod.

39 Funktionen skapar en fakturarad i XOR Compact. Artikelstatistik uppdateras om artikelid (ARTNO) är giltigt (artikeln finns). db Handle till databasen från. type Fakturatyp (samma som i ). Kan vara: XORDER Order XCUSTINVOICE Faktura/kreditnota XPURCHASE Inköp invno Fakturanummer (samma som i ). rowno Fakturaradnummer (börjar på 1). artno ArtikelID (max. 15 tecken). Om en tom sträng ("") anges, används inte artikelregistret, annars måste ett befintligt artikelid anges. Finns inte artikeln, kan du skapa den med rutinen. name Artikelnamn. Om inget artikelid angivits kan namnet vara upp till 80 tecken långt. unit Enhet (max. 10 tecken). accno Kontonummer (max. 6 tecken). Om en tom sträng ( ) anges, används det reserverade kontot om artikeln inte finns. objno ObjektID (max. 10 tecken). items Mängd. price Pris exklusive moms. reduct Rabatt %. amount Radbelopp exklusive moms. vat Momsbelopp för raden. tb Täckningsbidrag för raden (kan vara 0.00). -1 Felaktig typ. -2 Artikeln finns inte. -3 Angivet konto finns inte. 0 Operationen lyckades. >0 Databasfelkod.

40 Funktionen avslutar fakturan med totaler. db type invno sum freight fee vat amount Handle till databasen från. Fakturatyp. Samma som i. Kan vara: XORDER Order XCUSTINVOICE Faktura/kreditnota XPURCHASE Inköp Fakturanummer (samma som i ). Summan av fakturaraderna exklusive moms. Frakt. Expeditionsavgift. Momsbelopp Totalt fakturabelopp. -1 Felaktig typ. -2 Fakturan finns inte. 0 Operationen lyckades. >0 Databasfelkod.

41 Funktionen skapar reskontraposter i XOR Compact med automatisk uppdatering av personstatistik. db perstype persno type invno Handle till databasen från. Persontyp (kan vara CUSTOM (kund) eller SUPPLY (leverantör)). PersonID (max. 10 tecken). Reskontratyp. Kan vara något av följande: FA Faktura KN Kreditnota RF Räntefaktura AC A contopost BE Betalning Faktura/löpnummer (även vid Betalning). Anger du 0L får du automatiskt nästa lediga löpnummer (annars kan rutinen användas för att få nästa löpnummer. Vid Betalning måste anges exakt, eftersom nästa lediga nummer då inte kan användas suppinv Leverantörens fakturanummer om det är känt. Ange annars en tom sträng "". year Bokföringsdatum, år, uttryckt med siffror (t.ex. 1995). month Bokföringsdatum, månad, uttryckt som siffra (1-12). day Bokföringsdatum, dag, uttryckt som siffra: (1 31). amount vat update Reskontrabelopp inklusive moms. Momsbelopp. Anges som 1 om bokföringen skall uppdateras (detta är vanligast, men bokningarna kan ju utföras på andra sätt). Saldoregistret uppdateras automatiskt. -1 Felaktig typ. -2 Personen finns inte. -3 Felaktigt datum. -4 Datumet ligger utanför räkenskapsåret. -5 Huvudposten finns inte för betalningsposten. -6 Posten finns redan. 0 Operationen lyckades. >0 Databasfelkod.

42 Funktionen hämtar restbeloppet på en huvudpost (faktura e.d.) i XOR Compact. db perstype no amount 1L 0L Handle till databasen från. Persontyp (kan vara CUSTOM (kund) eller SUPPLY (leverantör)). Huvudpostens nummer. Buffert i vilken rutinen returnerar restbeloppet. Huvudposten finns. Huvudposten finns inte.

43 Funktionen raderar en faktura i fakturaregistret (om fakturan inte har överförts till reskontran). Om det finns artikelstatistik på fakturaraderna justeras denna samtidigt. Funktionen kan radera poster som redan är överförda till reskontran. Dessa poster måste motkonteras med en kreditnota och båda posterna måste sedan betalas. Rutinen kan användas för detta ändamål. db no 1L 0L Handle till databasen från. Huvudpostens nummer. Huvudposten finns. Huvudposten finns inte.

44 Funktionen hämtar en kontopost från XOR Compact. Kan även användas för kontrollera om ett konto finns. db accno accname first exact 1L 0L Handle till databasen från. Kontonummer (max. 6 tecken). Kontonamn (max. 30 tecken). Ange 1 vid första anropet i operationen och 0 vid efterföljande anrop (se exempel för sid. 22). Ange 1 om du vill utföra en exakt sökning, annars 0 (best fit). En post hittades. Ingen post hittades.

45 Funktionen hämtar en objektpost från XOR Compact. Kan även användas för kontrollera om ett objekt finns. db objno objname first exact 1L 0L Handle till databasen från. ObjektID (max. 10 tecken). Objektnamn (max. 30 tecken). Ange 1 vid första anropet i operationen och 0 vid efterföljande anrop (se exempel för sid. 22). Ange 1 om du vill utföra en exakt sökning, annars 0 (best fit). En post hittades. Ingen post hittades.

46 Funktionen hämtar en personpost från XOR Compact. Kan även användas för kontrollera om en person finns. db persno persname perstype first exact 1L 0L Handle till databasen från. PersonID (max. 10 tecken). Personnamn (max. 30 tecken). Ange CUSTOM om det kunder som söks, SUPPLY om det är leverantörer. Ange 1 vid första anropet i operationen och 0 vid efterföljande anrop (se exempel för sid. 22). Ange 1 om du vill utföra en exakt sökning, annars 0 (best fit). En post hittades. Ingen post hittades.

47 Funktionen hämtar en artikelpost från XOR Compact. Kan även användas för att kontrollera om en artikel finns. db objno objname first exact 1L 0L Handle till databasen från. ArtikelID (max. 15 tecken). Artikelnamn (max. 50 tecken). Ange 1 vid första anropet i operationen och 0 vid efterföljande anrop (se exempel för sid. 22). Ange 1 om du vill utföra en exakt sökning, annars 0 (best fit). En post hittades. Ingen post hittades.

48 Stänger företagsdatabasen. db Handle till databasen från.

49

50 XOR Compact 4.0 packar internt sina strukturer (poster) med 1-byte-boundary. Detta innebär att program som kommunicerar via XORBASE4.DLL måste ha använda samma packning för sina strukturer som Compact 4.0 (d.v.s. 1-byte-boundary). De flesta vanliga programmeringsspråk och kompilatorer stöder detta, med undantag för, och, samt vissa 4GL-verktyg som inte hanterar begreppen Aligned structures, Packed records eller User defined types. Användare av bör arbeta med rutinerna. För nyare varianter av, ex., och, används 4 bytes alignment av user defined types. De flesta av rutinerna som använder user defined types har därför utökats med en uppsättning rutiner med prefix för att avhjälpa problemen med (se nedanstående lista). Använd dessa -rutiner istället för -rutinerna i fall du har 4 bytes alignment (dessa rutiner är utkommenterade efter rutinerna i exemplen). Tänk på att och -rutinerna är ömsesidigt uteslutande! Om du kan använda en -rutin i din utvecklingsmiljö, så riskerar du felkörningar om du använder motsvarande -rutin. RecAdd RecReturn RecFind RecBest RecExist RecFirst RecLast RecNext RecPrev RecWrite XBAdd XBReturn XBFind XBBest XBExist XBFirst XBLast XBNext XBPrev XBWrite

51 De nycklar som används i databasen för att identifiera olika poster i de 16 registerna finns beskrivna längst bak i denna manual. Första nyckeln för varje register är alltid den, d.v.s. den nyckel som. Övriga nycklar är sorteringsnycklar och kallas. En nyckel som består av fält kan i din programkod utgöras av en pekare till ett eller en. En nyckel som består av fält utgörs av en pekare till en strukturvariabel.

52 Följande programexempel (i och ) går igenom alla poster i kontoregistret och skriver ut kontonummer och kontonamn för varje post. De lågnivårutiner som behövs för detta ändamål är (öppnar databasen) (hämtar första posten) (hämtar nästa post) (stänger databasen) char dbase[] = "compact"; char dir[] = "c:\\compact4\\0001"; char linebuf[126]; long DB; Account acc; int ok;... if (( DB = (dbase, dir, 0L)) == 0L) return False; for (ok = (DB, ACCOUNT, 2, &acc); ok == DbOk; ok = { wsprintf(linebuf, "%s %s", (char *)acc.accno, (char *)acc.accname); TextOut(thisDC, 0, 0, linebuf, lstrlen(linebuf)); }... (DB); return True; Dim dbase As String Dim directory As String Dim DB As Long Dim acc As AccountType Dim ok As Integer dbase = "compact" + Chr$(0) directory = "c:\compact4\0001" + Chr$(0) DB = (dbase, directory, 0&) If DB = 0& Then Print "Misslyckades med att öppna databasen" End End If... ok = (DB, ACCOUNT, 1, acc) ok = (DB, ACCOUNT, 1, acc) Do While ok = DbOk acc.accno = Left$(acc.accNo, Instr(acc.accNo, Chr$(0)) - 1) acc.accname = Left$(acc.accName, Instr(acc.accName, Chr$(0)) - 1) list1.additem acc.accno & " " & acc.accname ok = ok = Loop... (DB)

53 Låt oss anta att du vill överföra 3 verifikatrader som anger en försäljning på kr, moms på kr och en motkontering på kr till kassan där försäljningen har gått in. Du använder serie F (internt nr 5) för ändamålet. En överföring kan då implementeras då implementeras enligt följande: #include "xorbase.h" void Transfer(void) { Client cl; Account acc; Default def; Voucher vou; Balance bal = { 0 }; BalanceKey1 bk1; long DB; char name[] = "compact"; char dir[] = "c:\\compact4\\0001"; int period; // struktur för företagsinfo // struktur för konto // struktur för standardkonto // struktur för transaktioner // databas handle // databas namn // företagskatalog if ((DB = (name, dir, 0L, 0)) == 0L) // öppna databasen return; (DB, CLIENT, 1, "0001", &cl); // företagsinformation för 0001 vou.vrno = ++cl.clientver[5]; // nästa lediga nummer i serie F vou.vrtransno = 1; // transaktionsrad 1 vou.vrdate = (); // datum är dags datum i julian // date vou.vrserie = 5; // serie F (internt 5) vou.vrchange = 0; // ingen ändring StrCpy(vou.vrText, "Från försystem"); // fri text vou.vramount = ; // försäljningsbelopp def.defno = 26; // standardkonto för försäljning (DB, DEFAULT, 1, &def.defno, &def); StrCpy(vou.accNo, def.accno); // sätta dit försäljningskontot *vou.objno = '\0'; // inget objekt (DB, ACCOUNT, 1, def.accno, &acc); // Hämta konto. StrCpy(bk1.accNo, vou.accno); *bk1.objno = \0 ; // inget objekt (DB, BALANCE, 1, &bk1, &bal); // uppdatera saldo och hitta // grupp. period = Mon(vou.vrDate); // beräkna period bal.accsaldo[period] += vou.vramount; // uppdatera saldo cl.clientsales += vou.vramount; // uppdatera Client klass 3 cl.clientprofit += vou.vramount; // uppdatera Client klass 3-8 vou.vrcode = acc.accvat; // sätt momskod (DB, BALANCE, &bal); // skriv tillbaka Account posten (DB, VOUCHER, &vou); // upprätta transaktionsrad 1 ++vou.vrtransno; // transaktionsrad 2 vou.vramount = ; // momsbelopp def.defno = 1; // standardkonto utgående moms 1 (DB, DEFAULT, 1, &def.defno, &def); StrCpy(vou.accNo, def.accno); // sätt dit momskonto (DB, ACCOUNT, 1, def.accno, &acc); // Hämta konto. StrCpy(bk1.accNo, vou.accno); *bk1.objno = \0 ; // inget objekt (DB, BALANCE, 1, &bk1, &bal); // uppdatera saldo och hitta // grupp. bal.accsaldo[period] += vou.vramount; // uppdatera saldo cl.clientbalance += vou.vramount; // uppdatera Client klass 1 2 vou.vrcode = acc.accvat; // sätt momskod (DB, BALANCE, &bal); // skriv tillbaka Account posten

54 (DB, VOUCHER, &vou); // upprätta transaktionsrad 2 } ++vou.vrtransno; // transaktionsrad 3 vou.vramount = ; // kassabelopp def.defno = 30; // standard kassakonto // kontantförsäljning (DB, DEFAULT, 1, &def.defno, &def); StrCpy(vou.accNo, def.accno); // sätta dit kassakontot (DB, ACCOUNT, 1, def.accno, &acc); // uppdatera saldo och hitta // grupp StrCpy(bk1.accNo, vou.accno); *bk1.objno = \0 ; // inget objekt (DB, BALANCE, 1, &bk1, &bal); // uppdatera saldo och hitta // grupp. bal.accsaldo[period] += vou.vramount; // uppdatera saldo cl.clientbalance += vou.vramount; // uppdatera Client klass 1-2 vou.vrcode = acc.accvat; // sätt momskod (DB, BALANCE, &bal); // skriv tillbaka Account posten (DB, VOUCHER, &vou); // upprätta transaktionsrad 3 (DB, CLIENT, &cl); // skriv tillbaka Client posten (DB); // stäng databasen

55 Sub Transfer () Dim cl As ClientType företagsstruktur Dim acc As AccountType kontostruktur Dim bal As BalanceType balansstruktur Dim bk1 As BalanceKey1Type nyckelstruktur Dim def As DefaultType struktur för reserverade konton Dim vou As VoucherType struktur för transaktioner Dim DB As Long databas handle Dim period As Integer dbase = "compact" + Chr$(0) directory = "c:\compact4\0001" + Chr$(0) DB = (dbase, directory, 0&, 0) If DB = 0& Then Exit Sub End If databasens namn företagsnummer 0001 katalog öppna databasen cl.clientno = "0001" + Chr$(0) ok = (DB, CLIENT, 1, ByVal cl.clientno, cl) företagsinformation ok = (DB, CLIENT, 1, ByVal cl.clientno, cl) företagsinformation cl.clientver(5) = cl.clientver(5) + 1 nästa lediga nummer i serie F vou.vrno = cl.clientver(5) vou.vrtransno = 1 transaktionsrad 1 vou.vrdate = () datum är dags datum vou.vrserie = Chr$(5) serie F (internt 5) vou.vrchange = Chr$(0) ingen ändring vou.vrtext = "Från försystem" fri text vou.vramount = -4000# försäljningsbelopp def.defno = 26 standard konto för försäljning ok = (DB, DEFAULT, 1, def.defno, def) ok = (DB, DEFAULT, 1, def.defno, def) vou.accno = Rtrim$(def.accNo) + Chr$(0) sätt dit försäljningskontot vou.objno = Chr$(0) inget objekt ok = (DB, ACCOUNT, 1, ByVal Rtrim$(def.accNo), acc) uppdatera saldo och hitta grupp ok = (DB, ACCOUNT, 1, ByVal Rtrim$(def.accNo), acc) uppdatera saldo och hitta grupp bk1.accno = Rtrim$(def.accNo) + Chr$(0) bk1.objno = Chr$(0) ok = (DB, BALANCE, 1, bk1, bal) ok = (DB, BALANCE, 1, bk1, bal) period = Mon(vou.vrDate) sätt dit försäljningskontot beräkna period bal.accsaldo(period) = bal.accsaldo(period) + vou.vramount uppdatera saldo cl.clientsales = cl.clientsales + vou.vramount uppdatera Client kl.3 cl.clientprofit = cl.clientprofit + vou.vramount ' uppdatera Client klass 3-8 vou.vrcode = acc.accvat sätt momskod ok = (DB, BALANCE, bal) skriv tillbaka Account posten ok = (DB, BALANCE, bal) skriv tillbaka Account ok = (DB, VOUCHER, vou) upprätta transaktionsrad 1 ok = (DB, VOUCHER, vou) upprätta transaktionsrad 1 vou.vrtransno = vou.vrtransno + 1 transaktionsrad 2 vou.vramount = -1000# momsbelopp def.defno = 1 standard konto utgående moms 1 ok = (DB, DEFAULT, 1, def.defno, def) ok = (DB, DEFAULT, 1, def.defno, def) vou.accno = Rtrim$(def.accNo) + Chr$(0) sätta dit momskontot