Twinfield API Data Model
Twinfield SQL-Driverattributen |
Het SQL-stuurprogramma voor Twinfield heeft veel kenmerken die kunnen worden verfijnd om de verwerking te verbeteren in scenario's met onbetrouwbare netwerkverbindingen naar de API-server van Twinfield of met grote hoeveelheden gegevens. Ook hebben veel drivers driver-specifieke attributen om het feitelijke gedrag te finetunen of data te verwerken die niet aan de specificaties voldoen.
Aan de Twinfield-driverattributen wordt een standaardwaarde toegekend die zelden behoeft te worden gewijzigd. Indien nodig kunnen echter wijzigingen worden aangebracht op vier niveau's die in de onderstaande tabel met afzonderlijke vinkjes zijn aangegeven:
•Connection string: de connection string uit het settings*.xml bestand en toegepast tijdens het aanmelden.
•Set SQL-statement: een set SQL-statement dat moet worden uitgevoerd nadat de verbinding tot stand is gebracht.
•Aanmelden: waarde die door de gebruiker interactief moet worden opgegeven tijdens het aanmelden in een gebruikersinterface.
De verbindingsstring voor Twinfield is te vinden in het settings*.xml bestand dat voor de database wordt gebruikt. De referentiehandleidingen bevatten instructies voor het verplaatsen van de settings*.xml bestanden. Settings*.xml-bestanden bevinden zich meestal in de map %USERPROFILE%\invantive in de meeste implementatiescenario's. Elke datacontainer van een database in de connection string kan een connectionString element hebben waarin de naam en de waarden van attributen worden gespecificeerd. Zowel naam als waarde moeten naar behoren worden geëscaped volgens de XML-semantiek. De feitelijke toepassing van de waarde gebeurt uitsluitend tijdens het aanmelden. Er moet een nieuwe verbinding tot stand worden gebracht om de waarde van het driverattribuut te wijzigen met behulp van een connection string.
Het set SQL-statement kan na aanmelding worden uitgevoerd. De syntaxis is: set NAME VALUE, of voor een gedistribueerde database: set NAME@ALIAS VALUE. In sommige scenario's moet u de naam van de driverattribuut tussen vierkante haken zetten om te voorkomen dat de naam wordt ontleed, bijvoorbeeld wanneer een gereserveerd SQL-trefwoord deel uitmaakt van de naam. De nieuwe waarde wordt direct na uitvoering van de set-statement van kracht. Het set-statement kan tijdens een sessie zo vaak worden uitgevoerd als nodig is.
Driverattributen die interactief op een waarde kunnen worden ingesteld worden meestal weergegeven in het aanmeldvenster. Afhankelijk van het platform en de ontwerpbeslissingen van de ontwerper van de gebruikersinterface kunnen sommige of alle beschikbare driverattributen beschikbaar worden gesteld.
De Twinfield-driver kan worden geconfigureerd via de volgende attributen:
Code |
Omschrijving |
Oorsprong |
Standaardwaarde |
Instellen uit Connection String |
Instellen met Set SQL-statement |
Instellen uit Driversbestand |
Instellen uit Aanmelden |
|---|---|---|---|---|---|---|---|
analysis-enforce-row-uniqueness |
Dwing rijen af om uniek te zijn voor software-analyse. Een vingerafdruk wordt berekend uit de hele rij gegevens wanneer de primaire-sleutelkolom onbekend is. |
Shared |
False |
✓ |
✓ |
✓ |
|
api-access-token |
itgen_pae_api_access_token_desc |
|
|
✓ |
|
✓ |
✓ |
api-client-id |
itgen_pae_api_client_id_desc |
|
|
✓ |
|
✓ |
✓ |
api-client-secret |
itgen_pae_api_client_secret_desc |
|
|
✓ |
|
✓ |
✓ |
api-redirect-url |
itgen_pae_api_redirect_url_desc |
|
|
✓ |
|
✓ |
✓ |
api-refresh-token |
itgen_pae_api_refresh_token_desc |
|
|
✓ |
|
✓ |
✓ |
api-scope |
itgen_pae_api_scope_desc |
|
|
✓ |
|
✓ |
|
api-token-url |
itgen_pae_api_token_url_desc |
|
|
✓ |
|
✓ |
|
bulk-delete-page-size-rows |
Aantal te verwijderen rijen per batch bij bulk verwijderen. |
Shared |
10000 |
✓ |
✓ |
✓ |
|
bulk-insert-page-size-bytes |
Geschatte maximale grootte in bytes van de batch bij het invoegen in bulk. |
Shared |
10000000 |
✓ |
✓ |
✓ |
|
bulk-insert-page-size-rows |
Aantal in te voegen rijen per batch bij bulkinvoer. |
Shared |
10000 |
✓ |
✓ |
✓ |
|
debug-old-transaction-fields-nullable |
Of transactienummer, regelnummer, kantoor en dagboek optioneel moeten zijn op transacties. |
Twinfield |
True |
✓ |
|
✓ |
|
debug-old-transaction-number-as-string |
Of het Twinfield transactienummer een string moet zijn in plaats van een getal. |
Twinfield |
True |
✓ |
|
✓ |
|
download-error-other-exception-max-tries |
Maximum aantal pogingen wanneer een ongekwalificeerde fout optreedt tijdens het ophalen van gegevens. |
|
3 |
✓ |
✓ |
✓ |
|
download-error-other-exception-sleep-initial-ms |
Initiële slaaptijd in milliseconden tussen pogingen wanneer een ongekwalificeerde fout optreedt tijdens het ophalen van gegevens. |
|
10000 |
✓ |
✓ |
✓ |
|
download-error-other-exception-sleep-max-ms |
Maximale slaaptijd in milliseconden tussen nieuwe pogingen wanneer een ongekwalificeerde fout optreedt tijdens het ophalen van gegevens. |
|
300000 |
✓ |
✓ |
✓ |
|
download-error-other-exception-sleep-multiplicator |
Vermenigvuldigingsfactor voor de slaap tussen pogingen wanneer een ongekwalificeerde fout optreedt bij het ophalen van gegevens. |
|
2 |
✓ |
✓ |
✓ |
|
environment |
Omgevingscode die wordt gebruikt tijdens het aanmelden op Twinfield |
Twinfield |
|
✓ |
|
✓ |
✓ |
force-case-sensitive-identifiers |
Beschouw identifiers als hoofdlettergevoelig, onafhankelijk van de mogelijkheden van het platform. |
Shared |
False |
✓ |
✓ |
✓ |
|
forced-casing-identifiers |
Forced casing van identifiers. Keuze uit: Unset, Lower, Upper en Mixed. |
Shared |
|
✓ |
✓ |
✓ |
|
http-disk-cache-compression-level |
Compressieniveau voor de HTTP-schijfcache, variërend van 1 (weinig) tot 9 (intensief). Standaard is 5. |
Shared |
5 |
✓ |
✓ |
✓ |
|
http-disk-cache-directory |
Directory waar de HTTP-cache is opgeslagen. |
Shared |
C:\Users\guido\Invantive\Cache\http\guido\shared |
✓ |
✓ |
✓ |
|
http-disk-cache-ignore-write-errors |
Of schrijffouten naar de schijfcache moeten worden genegeerd. |
Shared |
False |
✓ |
✓ |
✓ |
|
http-disk-cache-max-age-sec |
Maximaal aanvaardbare leeftijd in seconden voor het gebruik van gegevens in de HTTP-schijfcache. |
Shared |
2592000 |
✓ |
✓ |
✓ |
|
http-get-timeout-max-ms |
HTTP GET timeout maximum on retry (ms) |
|
24000 |
✓ |
✓ |
✓ |
|
http-get-timeout-ms |
HTTP GET timeout (ms) |
|
601000 |
✓ |
✓ |
✓ |
|
http-memory-cache-compression-level |
Compressieniveau voor de HTTP geheugencache, variërend van 1 (weinig) tot 9 (intensief). Standaard is 5. |
|
5 |
✓ |
✓ |
✓ |
|
http-memory-cache-max-age-sec |
Maximaal aanvaardbare leeftijd in seconden voor het gebruik van gegevens in de HTTP-geheugencache. |
|
14400 |
✓ |
✓ |
✓ |
|
http-post-timeout-max-ms |
HTTP POST timeout maximum on retry (ms) |
|
58000 |
✓ |
✓ |
✓ |
|
http-post-timeout-ms |
HTTP POST timeout (ms) |
|
602000 |
✓ |
✓ |
✓ |
|
include-inaccessible-companies |
Opnemen van ontoegankelijke bedrijven voor de huidige gebruiker in lijst van partities, zoals sjabloonbedrijven die momenteel niet in de API kunnen worden herkend. |
Twinfield |
False |
✓ |
|
✓ |
✓ |
invantive-sql-compress-sparse-arrays |
Of de sparse arrays in resultatensets moeten worden gecomprimeerd tijdens de compressie. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-correct-invalid-date |
Of ongeldig geachte data moeten worden gecorrigeerd omdat ze vóór 01-01-1753 liggen. Als ze nul zijn, worden ze verwijderd. Anders worden ze vervangen door 01-01-1753. |
SQL Engine V1 |
False |
✓ |
✓ |
✓ |
|
invantive-sql-execution-profile-disk-path |
itgen_pae_invantive_sql_execution_profile_disk_path |
SQL Engine V1 |
c:\temp\profiles |
✓ |
✓ |
✓ |
|
invantive-sql-execution-profile-to-disk |
itgen_pae_invantive_sql_execution_profile_to_disk |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-forward-filters-to-data-containers |
Of filters moeten worden doorgestuurd naar gegevenscontainers. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-share-byte-arrays |
Of het geheugen dat wordt gebruikt door identieke byte-arrays in resultatensets tijdens compressie moet worden gedeeld. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-share-strings |
Of het geheugen dat wordt gebruikt door identieke strings in resultatensets tijdens compressie moet worden gedeeld. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-shuffle-fetch-results-data-containers |
Of resultaten uit gegevenscontainers moeten worden geschud. |
SQL Engine V1 |
False |
✓ |
✓ |
✓ |
|
invantive-use-cache |
Of de resultaten van een query in de cache moeten worden opgeslagen. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-max-events |
Maximum aantal te registreren oproepgebeurtenissen vanaf de laatste activering. |
Shared |
|
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-max-seconds |
Maximum aantal seconden om oproepen te registreren vanaf de laatste activering. |
Shared |
|
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-on-error |
Registreert native calls naar data container backend als disk files wanneer de call een fout heeft opgeleverd. |
Shared |
False |
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-on-success |
Registreert native calls naar data container backend als disk files wanneer de call geen error opleverde. |
Shared |
False |
✓ |
✓ |
✓ |
|
log-native-calls-to-trace |
Log native calls naar data container backend op de trace. |
Shared |
False |
✓ |
✓ |
✓ |
|
max-url-length-accepted |
De maximaal aanvaarde URL-lengte voordat er een fout optreedt. |
Shared |
8000 |
✓ |
✓ |
✓ |
|
max-url-length-desired |
De maximale gewenste URL-lengte. |
Shared |
8000 |
✓ |
✓ |
✓ |
|
maximum-length-identifiers |
Niet-standaard maximale lengte in tekens van identificatienamen. |
Shared |
|
✓ |
✓ |
✓ |
|
minimum-length-text |
Breid alle tekstkolommen uit tot deze lengte om de verwerking van XML mogelijk te maken die langere tekstwaarden gebruikt dan de XSD specificeert. |
XML |
|
✓ |
|
|
✓ |
partition-slot-based-rate-limit-length-ms |
Totale lengte in milliseconden over alle slots van een partitiegebaseerde snelheidslimiet. |
Shared |
60000 |
✓ |
|
✓ |
|
partition-slot-based-rate-limit-slots |
Aantal slots per partitiegebaseerde snelheidslimiet. Nul betekent geen slotgebaseerde snelheidslimiet. |
Shared |
|
✓ |
|
✓ |
|
pre-request-delay-ms |
Vertraging voorafgaand aan het verzoek in milliseconden per verzoek. |
Shared |
0 |
✓ |
✓ |
✓ |
|
reauthenticate-max-tries |
Maximum aantal pogingen na een mislukte herauthenticatie. |
Twinfield |
5 |
✓ |
|
✓ |
|
requested-page-size |
Voorkeur aantal rijen om te wisselen per rondreis; alleen effectief op beperkte platforms zoals AFAS Online. |
Shared |
|
✓ |
✓ |
✓ |
|
requests-parallel-max |
Maximumaantal parallelle gegevensaanvragen van afzonderlijke partities op de gegevenscontainer. |
Shared |
4 |
✓ |
✓ |
✓ |
|
result-set-memory-cache |
Actie: ingesteld op "leeg" om leeg te maken. |
XML |
|
|
✓ |
|
|
slot-based-rate-limit-length-ms |
Totale lengte in milliseconden over alle slots van een slot-based snelheidslimiet. |
Shared |
60000 |
✓ |
|
✓ |
|
slot-based-rate-limit-slots |
Aantal slots van een slot-based rate limit. Nul betekent geen slot-based rate limit. |
Shared |
|
✓ |
|
✓ |
|
standardize-identifiers-casing |
Herschrijf alle identifiers naar de aanbevolen standaard platform-specifieke casing wanneer een datamodel op een case-afhankelijk platform wordt gewijzigd. |
Shared |
True |
✓ |
✓ |
✓ |
|
standardize-identifiers |
Herschrijf alle identifiers naar de voorkeurstandaarden zoals geconfigureerd door standardize-identifiers-casing en maximum-length-identifiers. |
Shared |
True |
✓ |
✓ |
✓ |
|
trace-uncompressed-xml-cumulative |
Stuur ongecomprimeerde XML respons payload naar tracelogging wanneer ophalen voltooid is. |
Twinfield |
False |
✓ |
✓ |
✓ |
|
trace-uncompressed-xml |
Stuur ongecomprimeerde XML respons payload naar trace logging. |
Twinfield |
False |
✓ |
✓ |
✓ |
|
transaction-tables-page-size |
Gewenst aantal rijen dat per API-aanroep wordt opgehaald voor transactiegegevens. |
Twinfield |
50000 |
✓ |
✓ |
✓ |
✓ |
use-http-disk-cache-read |
Of HTTP-reacties van eerdere query's die op schijf zijn opgeslagen, moeten worden gebruikt om de huidige query te beantwoorden. |
Shared |
False |
✓ |
✓ |
✓ |
|
use-http-disk-cache-write |
Of HTTP-reacties op schijf moeten worden opgeslagen. |
Shared |
False |
✓ |
✓ |
✓ |
|
use-http-memory-cache-read |
Of HTTP-reacties van eerdere in het geheugen opgeslagen query's die de huidige query kunnen beantwoorden, moeten worden gebruikt. |
|
True |
✓ |
✓ |
✓ |
|
use-http-memory-cache-write |
Of HTTP antwoorden van vorige queries moeten worden onthouden voor gebruik door toekomstige queries. |
|
True |
✓ |
✓ |
✓ |
|
use-metadata-memory-cache |
Of de eerder berekende metadata in het geheugen moeten worden gebruikt. |
XML |
True |
✓ |
✓ |
✓ |
|
use-result-memory-cache |
Of de in het geheugen opgeslagen resultaten van eerdere zoekopdrachten die de huidige zoekopdracht kunnen beantwoorden, moeten worden gebruikt. |
XML |
False |
✓ |
✓ |
✓ |
|
10-06-2024 19:08 Versie 24.1.3-BETA+4689
