Categorie: entities Bijgewerkt: 2026-05-27 import connector integratie xslt synchronisatie

ImportConnector (Importkoppeling)

ImportConnector is de configuratie-entiteit voor gegevensimport in Ultimo: elke connector beschrijft hoe externe data (XML, CSV of webservice-respons) wordt opgehaald, getransformeerd via XSLT en in de Ultimo-database geïmporteerd. De connector ondersteunt meerdere invoerformaten (InputFormat), flexibele planningopties (ScheduleType, TimeBetweenImports, TimePattern) en post-verwerking (PostDataAction). Via ExecuteAsUser worden importen uitgevoerd met de rechten van een specifiek serviceaccount, wat autorisatiecontroles afdwingt ook tijdens automatische runs. Aanvullende XSLT-parameters worden beheerd via ImportConnectorXsltParameter.

Entiteitsnaam: ImportConnector Databasetabel: ImportConnector Primaire sleutel: IMCID (UltimoString(50))

Contextsbewerken

Value Naam Beschrijving
0 ImportConnectorContext.None Standaard

Statussenbewerken

Value Naam Beschrijving
-1 ImportConnectorStatus.Trash Trash
0 ImportConnectorStatus.None None
1 ImportConnectorStatus.Inactive Niet actief
2 ImportConnectorStatus.Active Actief

Belangrijkste propertiesbewerken

De entiteit heeft in totaal 73 properties. Hieronder de belangrijkste; gebruik lookup_entity("ImportConnector") voor de volledige lijst.

Property Type Kolom Nullable Default Omschrijving
Id UltimoString(50) IMCID Nee Unieke naam/ID van de importkoppeling (max. 50 tekens), de primaire sleutel
Description UltimoString(200) IMCDESCR Ja Beschrijvende naam van de connector zoals die in de UCT-lijsten verschijnt
CompanyForUser Company IMCUSERCOMPID Ja Bedrijfscontext die wordt gehanteerd bij de uitvoering van de import
Credential Credential IMCCRDID Ja Inloggegevens (gebruikersnaam/wachtwoord of certificaat) voor de bronsysteem-verbinding
CsvAction ConnectorAction? IMCCSVACTION Ja Actie die op het CSV-bronbestand wordt uitgevoerd na afloop van de import (bv. verwijderen, archiveren)
Culture CountryCode? IMCCULTURE Ja Cultuurinstelling voor het parsen van datum/getal-formaten in het bronbestand
ExecuteAsUser User IMCEXECUTEASSUSEID Ja Systeemgebruiker (User) namens wie de import wordt uitgevoerd voor autorisatiecontroles
FileSystemPath FileSystemPath IMCFSPID Ja Pad naar de directory waar bestanden worden opgehaald of geplaatst
InputFormat ConnectorFormat IMCINPUTFORMAT Nee 1 Invoerformaat van de brondata: XML (standaard, waarde 1), CSV of webservice
Language CountryCode? IMCLANGUAGE Ja Taalinstelling voor de vertaling van gelokaliseerde waarden in de brondata
LastImport DateTime? IMCLASTIMPORT Ja Tijdstip van de meest recente importpoging (geslaagd of mislukt)
LastImportSuccess DateTime? IMCLASTIMPORTSUCCESS Ja Tijdstip van de laatste geslaagde import
LDAPImportConnector LDAPImportConnector IMCLDAPICID Ja Verwijzing naar een LDAP-importconnector-definitie voor gebruikerssynchronisatie
NextImport DateTime? IMCNEXTIMPORT Ja Gepland tijdstip voor de volgende automatische importrun
PostDataAction ConnectorAction? IMCPOSTDATAACTION Ja Actie die na verwerking van de data wordt uitgevoerd (bv. statuswijziging in bronsysteem)
RecordCreateDate DateTime? IMCRECCREATEDATE Ja SYSDATETIME Aanmaaktijdstip van de connector-definitie; automatisch gevuld
SaveFilesUntil Date? IMCSAVEFILESUNTIL Ja Datum tot wanneer bronbestanden worden bewaard voor herverwerking of audit
ScheduleType ScheduleType IMCSCHEDULETYPE Nee 0 Type planning: handmatig (0), interval of tijdpatroon
TimeBetweenImports Duration IMCTIMEBETWEENIMPORTS Nee 0 Minimale wachttijd tussen twee automatische importruns (duration)
TimePattern TimeslotPattern IMCTIMEPATTERN Ja Tijdslotpatroon dat de exacte momenten van automatische runs bepaalt
WebServiceAuthorizationType HttpAuthorizationType IMCWEBSERVICEAUTHTYPE Nee 0 Authenticatiemethode voor webservice-bronnen (0 = geen, Basic, Bearer, etc.)
AllowTruncate Boolean IMCALLOWTRUNCATE Nee 0 Indien actief, mogen bestaande records worden afgekapt bij volledige herlaad-imports
AttachmentUrl UltimoString IMCATTACHMENTURL Ja URL van bijlagen die bij de te importeren records horen
Context Context IMCCONTEXT Nee Context van de connector (momenteel alleen None)
CsvChangeStatusTo UltimoString(50) IMCCSVCHANGESTATUSTO Ja Waarde waarnaar de status in het CSV-bronbestand wordt gezet na verwerking
CsvEntityToImport UltimoString(50) IMCCSVENTITYTOIMPORT Ja Naam van de Ultimo-entiteit waarnaar de CSV-rijen worden geïmporteerd
CsvHasHeaderLine Boolean IMCCSVHASHEADERLINE Nee 0 Of de eerste regel van het CSV-bestand een kolomheader bevat
CsvHeaderLine UltimoString IMCCSVHEADERLINE Ja Expliciet opgegeven headerregel voor CSV-bestanden zonder ingebouwde header

Relaties met andere entiteitenbewerken

Property Verwijst naar Nullable
CompanyForUser Company Ja
Credential Credential Ja
ExecuteAsUser User Ja
FileSystemPath FileSystemPath Ja
LDAPImportConnector LDAPImportConnector Ja

Onderliggende / verwijzende entiteiten (1-op-veel)bewerken

De volgende entiteiten verwijzen naar ImportConnector:

Entiteit Via property
ImportConnectorXsltParameter ImportConnector
OciConnector ImportConnector

Tips voor consultantsbewerken

Database Detailsbewerken

De tabel dba.ImportConnector bevat 71 kolommen, 0 eigen trigger(s), 0 externe triggers en 5 foreign keys.

Belangrijke defaultsbewerken

Kolom Default
ImcContext 0
ImcRecStatus 0
ImcAllowTruncate 0
ImcCsvHasHeaderLine 0
ImcCsvTrimValues 0
ImcInputFormat 1
ImcLogErrorToEventLog 0
ImcLogSuccessToEventLog 0
ImcPostDataUseGrouping 0
ImcProcess 0
ImcRecCreateDate sysdatetimeoffset()
ImcRollbackOnError 0
ImcRunNumber 0
ImcSchedule 0
ImcScheduleType 0

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.

Zie ookbewerken