ExportConnector (Exportkoppeling)
ExportConnector is de configuratie-entiteit voor gegevensexport vanuit Ultimo naar externe systemen: elke connector beschrijft welke entiteit wordt geëxporteerd (EntityToExport), in welk formaat (OutputFormat), via welke XSLT-transformatie en naar welk bestemming (bestand of webservice-endpoint). De connector ondersteunt planningopties (ScheduleType, TimeBetweenExports, TimePattern), IP-filtering (IpAddressRangeValidationV4) en een pull-endpoint (EndpointEnabled) zodat externe systemen de export zelf op kunnen halen. Eventuele XSLT-parameters worden beheerd via ExportConnectorXsltParameter; filters en join-definities via ExportConnectorFilter en ExportConnectorJoin.
Entiteitsnaam: ExportConnector
Databasetabel: ExportConnector
Primaire sleutel: EXCID (UltimoString(50))
Contextsbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| 0 | ExportConnectorContext.None | Standaard |
Statussenbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| -1 | ExportConnectorStatus.Trash | Trash |
| 0 | ExportConnectorStatus.None | None |
| 1 | ExportConnectorStatus.Inactive | Niet actief |
| 2 | ExportConnectorStatus.Active | Actief |
Belangrijkste propertiesbewerken
De entiteit heeft in totaal 56 properties. Hieronder de belangrijkste; gebruik
lookup_entity("ExportConnector")voor de volledige lijst.
| Property | Type | Kolom | Nullable | Default | Omschrijving |
|---|---|---|---|---|---|
| Id | UltimoString(50) | EXCID | Nee | Unieke naam/ID van de exportkoppeling (max. 50 tekens), de primaire sleutel | |
| Description | UltimoString(200) | EXCDESCR | Ja | Beschrijvende naam van de connector zoals die in de UCT-lijsten verschijnt | |
| CompanyForUser | Company | EXCUSERCOMPID | Ja | Bedrijfscontext die wordt gehanteerd bij de uitvoering van de export | |
| Credential | Credential | EXCCRDID | Ja | Inloggegevens voor de doelsysteem-verbinding (bv. bij HTTP POST naar een externe API) | |
| Culture | CountryCode? | EXCCULTURE | Ja | Cultuurinstelling voor het formatteren van datum/getal-waarden in de exportuitvoer | |
| ExecuteAsUser | User | EXCEXECUTEASSUSEID | Ja | Systeemgebruiker (User) namens wie de export wordt uitgevoerd voor rechtencontrole | |
| Language | CountryCode? | EXCLANGUAGE | Ja | Taalinstelling voor de vertaling van gelokaliseerde waarden in de exportuitvoer | |
| LastExport | DateTime? | EXCLASTEXPORT | Ja | Tijdstip van de meest recente exportpoging (geslaagd of mislukt) | |
| LastExportSuccess | DateTime? | EXCLASTEXPORTSUCCESS | Ja | Tijdstip van de laatste geslaagde export | |
| NextExport | DateTime? | EXCNEXTEXPORT | Ja | Gepland tijdstip voor de volgende automatische exportrun | |
| OutputFormat | ConnectorFormat | EXCOUTPUTFORMAT | Nee | 1 | Uitvoerformaat van de export: XML (standaard, waarde 1), CSV of JSON |
| RecordCreateDate | DateTime? | EXCRECCREATEDATE | Ja | SYSDATETIME | Aanmaaktijdstip van de connector-definitie; automatisch gevuld |
| SaveFilesUntil | Date? | EXCSAVEFILESUNTIL | Ja | Datum tot wanneer exportbestanden worden bewaard voor audit of herlevering | |
| ScheduleType | ScheduleType | EXCSCHEDULETYPE | Nee | 0 | Type planning: handmatig (0), interval of tijdpatroon |
| TimeBetweenExports | Duration | EXCTIMEBETWEENEXPORTS | Nee | 0 | Minimale wachttijd tussen twee automatische exportruns (duration) |
| TimePattern | TimeslotPattern | EXCTIMEPATTERN | Ja | Tijdslotpatroon dat de exacte momenten van automatische runs bepaalt | |
| WebServiceAuthorizationType | HttpAuthorizationType | EXCWEBSERVICEAUTHTYPE | Nee | 0 | Authenticatiemethode voor de HTTP-doelverbinding (0 = geen, Basic, Bearer, etc.) |
| Context | Context | EXCCONTEXT | Nee | Context van de connector (momenteel alleen None) |
|
| CsvHasHeaderLine | Boolean | EXCCSVHASHEADERLINE | Nee | 0 | Of de CSV-uitvoer een kolomheaderregel bevat |
| CsvSeparator | UltimoString(1) | EXCCSVSEPARATOR | Ja | Scheidingsteken voor CSV-export (bv. ; of ,) |
|
| CustomQueryWorkflow | UltimoString(100) | EXCCUSTOMQUERYWORKFLOW | Ja | Naam van een workflow die een aangepaste selectie-query levert voor de export | |
| EndpointEnabled | Boolean | EXCENDPOINTENABLED | Nee | 0 | Indien actief, stelt de connector een HTTP-endpoint beschikbaar waarop externe systemen de export kunnen ophalen (pull-model) |
| EntityToExport | UltimoString(50) | EXCENTITYTOEXPORT | Ja | Naam van de Ultimo-entiteit waarvan records worden geëxporteerd | |
| ErrorWorkflow | UltimoString(50) | EXCERRORWORKFLOW | Ja | Naam van een workflow die wordt uitgevoerd als de export mislukt | |
| ExportToFileName | UltimoString(100) | EXCEXPORTTOFILENAME | Ja | Bestandsnaam (sjabloon) voor het exportbestand; mag datum-expressies bevatten | |
| FailCount | Int32 | EXCFAILCOUNT | Nee | 0 | Aantal opeenvolgende mislukte exportpogingen; wordt gereset bij succes |
| FileType | UltimoString(4) | EXCFILETYPE | Ja | Bestandsextensie van het exportbestand (bv. xml, csv, json) |
|
| IpAddressRangeValidationV4 | UltimoString | EXCIPADDRESSRANGEVALIDATIONV4 | Ja | Whitelist van IPv4-adressen of CIDR-ranges die het pull-endpoint mogen aanroepen |
Relaties met andere entiteitenbewerken
| Property | Verwijst naar | Nullable |
|---|---|---|
| CompanyForUser | Company | Ja |
| Credential | Credential | Ja |
| ExecuteAsUser | User | Ja |
Onderliggende / verwijzende entiteiten (1-op-veel)bewerken
De volgende entiteiten verwijzen naar ExportConnector:
| Entiteit | Via property |
|---|---|
| ExportConnectorFilter | Id.ExportConnector |
| ExportConnectorJoin | Id.ExportConnector |
| ExportConnectorProperty | Id.ExportConnector |
| ExportConnectorXsltParameter | ExportConnector |
Tips voor consultantsbewerken
- Push vs. pull-model: Standaard werkt de ExportConnector als push (Ultimo stuurt het bestand naar een bestemming). Zet
EndpointEnabled = truevoor een pull-endpoint: het externe systeem haalt de data zelf op. Beveilig het pull-endpoint altijd metIpAddressRangeValidationV4en/ofWebServiceAuthorizationType. - XSLT-transformatie: De veldmapping staat in de XSLT die bij de connector hoort, niet in de entiteitsrij. Gebruik
lookup_import_connector/find_import_connectorsof raadpleeg de UCT om de XSLT te bekijken. Parameters zijn beschikbaar viaExportConnectorXsltParameter. - Filters en joins: Gebruik
ExportConnectorFilterom te bepalen welke records worden geëxporteerd (bv. alleen gewijzigde records of records met een specifieke status). MetExportConnectorJoinvoeg je gerelateerde entiteitsdata samen in één export. - ExecuteAsUser met leesrechten: Net als bij de ImportConnector dient
ExecuteAsUsereen dedicated service-account te zijn. Geef het account alleen leesrechten op de te exporteren entiteiten, plus eventueel schrijfrechten als de export een statuswijziging triggert. - ErrorWorkflow voor foutafhandeling: Configureer
ErrorWorkflowom bij exportfouten een notificatie te sturen of een herpoging in te plannen. Zo ontgaan exportfouten niet aan de beheerder. - CsvSeparator en culture: Stel bij CSV-exports altijd zowel
CsvSeparatoralsCulturein om te voorkomen dat komma's in getallen conflicteren met het scheidingsteken. Gebruik;als separator voor NL-locale exports.
Database Detailsbewerken
De tabel dba.ExportConnector bevat 52 kolommen, 0 eigen trigger(s), 0 externe triggers en 3 foreign keys.
Belangrijke defaultsbewerken
| Kolom | Default |
|---|---|
ExcContext |
0 |
ExcRecStatus |
0 |
ExcCsvHasHeaderLine |
0 |
ExcLogErrorToEventLog |
0 |
ExcLogSuccessToEventLog |
0 |
ExcMultilingualExport |
0 |
ExcOutputFormat |
1 |
ExcRecCreateDate |
sysdatetimeoffset() |
ExcRunNumber |
0 |
ExcSchedule |
0 |
ExcScheduleType |
0 |
ExcSendResultEmailSuccess |
0 |
ExcTimeBetweenExports |
0 |
ExcWebServiceAuthType |
0 |
ExcWebServiceHttpExpect100 |
1 |
Brondatabewerken
Let op: De wiki-samenvatting hierboven toont een curated subset van properties en praktische consultant-tips. Voor ground truth (exacte kolomnamen, alle properties, defaults, triggers) gebruik de onderstaande tools.
- Entity-definitie —
lookup_entity("ExportConnector")· reference/entities/ExportConnector Alle properties, contexts en statussen. Bron:Entities.xml. - DB-schema —
lookup_table_schema("ExportConnector")· reference/tables/ExportConnector Alle DB-kolommen, triggers, computed columns en defaults. Bron:database-schema.json. - Gerelateerde workflows —
find_workflows("", entity="ExportConnector")Alle Before/After Save events en andere workflow-ActionFields. Bron:workflows.xml.
Zie ookbewerken
- export-connector - Algemeen artikel over de exportconnector-functionaliteit in Ultimo
- import-connector - Import-tegenhanger van de exportconnector
- user - Systeemgebruikers die als ExecuteAsUser worden gebruikt
- odata-filters - OData-filters die in export-queries worden toegepast
- workflow-engine - Workflows die exports kunnen triggeren of bij fouten reageren
- rest-api - REST API-patronen voor het aanroepen van export-endpoints