GetStamTabelRecords – gegevens van een stamtabel ophalen

Met de functie GetStamTabelRecords worden gegevens van een stamtabel opgehaald. Het kan voorkomen dat bepaalde velden in een tabel nog niet beschikbaar zijn. Indien deze wenselijk zijn om een koppeling te realiseren dan kun je hierover contact met ons opnemen. Naast GetStamTabelRecords is er ook een functie UpdateStamTabelRecords voor het aanpassen van de stamrecords.

Mogelijke WHEREOPERATORS zijn:
=
>
>=
<
<=
LIKE

Alle combinaties van WHEREFIELDS/WHEREOPERATORS/WHEREVALUES zorgen voor een AND-combinatie. Velden in de FIELDS-, WHERE- and VALUE-opties worden via een TAB character (Char(9)) gescheiden.
Indien je een OR query wilt maken dan combineert je de zoekvelden in 1 WHEREFIELD gescheiden door een ; (puntkomma)

Voorbeeld
WHEREFIELDS=NAAM;PLAATS
WHEREOPERATORS=LIKE
WHEREVALUES=%A%

Hiermee krijg je de debiteuren/crediteuren/prospects waar de naam of plaats een A bevat.

Note 1: Als in de SELECTFIELDS/WHEREFIELDS/WHEREOPERATORS/WHEREVALUES-clausule meerdere velden zijn opgenomen, dan moeten deze velden worden gescheiden door een TAB character (Char(9)).

Note 2: Houdt er bij het doorgeven van data binnen PHP rekening mee dat de characters zoals & en > of < niet zomaar kunnen worden doorgegeven. Maak hiervoor gebruik van de character data indicatie <![CDATA[Test < kleiner dan]]> .

Voor de een aantal stamtabellen kunt u naast de WHEREFIELD, WHEREOPERATORS en WHEREVALUES een extra TAG opnemen:

DELDATE_VA Bij een geselecteerd aantal stamtabellen geef je als waarde de datum vanaf je de verwijderde gegevens wilt ophalen (beschikbaar vanaf versie 4.6.0 of hoger).
MUTDATE_VA Bij bijna alle stamtabellen geef je als waarde de datum vanaf waarvan je de gegevens wilt ophalen.
Als je gebruik wilt maken van DELDATE_VA en MUTDATE_VA haal dan eerst de verwijderde records op. Verwijder deze records eerst uit je eigen systeem en voeg daarna pas de gemuteerde gegevens toe. Bijvoorbeeld: artikel 9000 wordt verwijderd en aansluitend maak je een nieuw artikel 9000 aan en voeg je deze toe.
GETVRD Bij het artikel kun je aangeven of je bij het ophalen van het artikel direct de TECHVRD_MAGxx en VRIJVERKVRD_MAGxx van dat artikel wilt. Voeg deze tag alleen toe als je de voorraad ook echt nodig heb. Deze voorraad velden moeten worden samengesteld uit andere tabellen en zijn dus een extra belasting voor de server/database. De velden TECHVRD_MAGxx en VRIJVERKVRD_MAGxx moet je niet opvragen, deze worden automatisch toegevoegd aan de resultset. De xx in de velden worden vervangen door het nummer van het magazijn.
PDF_BESTAND De aanwezigheid van deze TAG is voldoende om aan de tabel de dossierstukken te koppelen. Deze optie geeft naast de tabel met stamgegevens een tweede tabel terug waarin dossierstukken staan. Houdt er rekening mee dat het ophalen van de dossierstukken een extra belasting is voor de servers. Bij het ophalen van 100 facturen met 10 dossierstukken al dan niet met meerdere pagina’s zijn het al snel 1000 dossierstukken (PDF bestanden). Probeer het ophalen van de dossierstukken dan ook tot een minimum te beperken en deze alleen op te halen indien dit noodzakelijk is. De indeling van deze teruggekomen tabel kan per tabel afwijken. Dit in verband met de unieke koppeling naar de verschillende tabellen. Bij onder andere de tabellen:
Door de PDF_BESTAND variabele te vullen met de waarde PDF_UBL_BESTAND worden niet alleen de PDF’s maar ook de andere dossierstukken die aan de boekingsregel zijn gekoppeld opgehaald (o.a. UBL/XML bestand)..

Door de PDF_BESTAND variabele te vullen met PDF_COUNT worden niet de PDF’s opgehaald maar komt in het DIGDOS bestand een veld PDF_COUNT terug waarin het aantal gekoppelde dossierstukken staan. Hierdoor is de hoeveelheid data die over de lijn gaat natuurlijk een stuk kleiner (sneller).

Door de DELDATE_VA variabele te vullen worden de verwijderde gegevens van de stamtabel opgehaald. Hierbij kunnen eventueel de normale selecties worden gebruikt. (Bijvoorbeeld, alleen verwijderde artikelen uit artikelgroep -x) Alleen verwijderde items worden dan opgehaald. Nb. Opvragen van verwijderde items i.c.m. dossierstukken of technische voorraad etc.. is uiteraard onzin. Alleen tabellen die hieronder zijn gemarkeerd met kunnen worden geselecteerd. (Beschikbaar vanaf 4.6.0 of hoger)
Door bij de velden het virtuele veld DATLSTMUT toe te voegen zal er aan ieder record dit veld worden toegevoegd met daarin de datum waarop het record voor het laatst is aangepast. I.v.m. performance dit veld alleen toevoegen als dat ook noodzakelijk is. (Beschikbaar vanaf 4.7.2c of hoger)
Momenteel zijn de volgende tabellen beschikbaar:
GetStamtabelRecords(ByVal PartnerKey As String, ByVal Omgevingscode As String, ByVal SessionId As String, ByVal Selectie As DataSet, ByRef Records As DataSet, ByRef foutmelding As String) As Boolean

SOAP REQUEST
```
<code><?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetStamtabelRecords xmlns="https://cloudswitch.imuisonline.com/">
      <PartnerKey>string</PartnerKey>
      <Omgevingscode>string</Omgevingscode>
      <SessionId>string</SessionId>
      <Selectie>
        <xsd:schema>schema</xsd:schema><![CDATA[zie voorbeeld]]></Selectie>
      <Records>
        <xsd:schema>schema</xsd:schema>xml</Records>
      <Foutmelding>string</Foutmelding>
    </GetStamtabelRecords>
  </soap12:Body>
</soap12:Envelope></code>
```
VOORBEELD VAN WAARDE VOOR TAG <Selectie></Selectie>, VOOR HET OPHALEN VAN GEGEVENS

Als in de WHEREFIELDS/WHEREOPERATORS/WHEREVALUES-clausule meerdere velden zijn opgenomen. dan moeten deze velden worden gescheiden door een TAB character. (Char(9))

Om descending te sorteren wordt een :D

toegevoegd aan het veld ORDERBY.
```
<NewDataSet><Table1>
<TABLE>tabelnaam</TABLE>
<SELECTFIELDS>velden</SELECTFIELDS>
<WHEREFIELDS>veld</WHEREFIELDS>
<WHEREOPERATORS>operator</WHEREOPERATORS>
<WHEREVALUES>waarde</WHEREVALUES>
<MUTDATE_VA >datum</MUTDATE_VA > (Optioneel)
<ORDERBY>veld</ORDERBY>
<MAXRESULT>0</MAXRESULT>
<PAGESIZE>10000</PAGESIZE>
<SELECTPAGE>1</SELECTPAGE>
</Table1></NewDataSet>
```
SOAP RESPONSE
```
<?xml version="1.0" encoding="utf-8"?> <soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"> <soap12:Body> <GetStamtabelRecordsResponse xmlns="https://cloudswitch.imuisonline.com/"> <GetStamtabelRecordsResult>true</GetStamtabelRecordsResult> <Records> <xsd:schema>schema</xsd:schema>xml</Records> <Foutmelding></Foutmelding> </GetStamtabelRecordsResponse> </soap12:Body> </soap12:Envelope>
```

Kennisbank Cloudswitch (API)

GetStamTabelRecords – gegevens van een stamtabel ophalen

Over KING Software

Over KING Software

E-MAILADRESSEN

Kennisbank Cloudswitch (API)

Gerelateerde Artikelen

Over KING Software

Over KING Software

E-MAILADRESSEN