Export Connectors

Export connectors zijn de standaard methode in Ultimo om data geautomatiseerd naar externe systemen te exporteren. Ze worden getriggerd door gebeurtenissen in Ultimo (statuswijzigingen, workflows) en kunnen data versturen via bestanden of webservice-aanroepen.

Beschikbaarheid: Premium, Enterprise

Wat is een Export Connector?bewerken

Een export connector is een configuratie in Ultimo die bepaalt: - Wanneer data wordt geexporteerd (trigger) - Welke data wordt meegestuurd (entiteiten en properties) - Waarheen de data gaat (bestand of webservice) - In welk formaat de data wordt verstuurd (XML, JSON, CSV)

Export connectors worden geconfigureerd in de Ultimo Configuration Tool (UCT) onder het menu Business Integration.

Triggersbewerken

Export connectors worden geactiveerd door gebeurtenissen binnen Ultimo:

Voorbeeld: Export bij statuswijzigingbewerken

Wanneer een Job de status "Afgemeld" (Completed) krijgt, wordt automatisch een export getriggerd die de werkordergegevens naar het ERP-systeem stuurt.

Configuratiebewerken

Basisinstellingenbewerken

Entiteiten en propertiesbewerken

Configureer welke entiteiten en properties worden meegenomen in de export: - Selecteer de bron-entiteit (bijv. Job, Equipment) - Kies de relevante properties - Stel eventuele filters in

Exportformatenbewerken

XML exportbewerken

<?xml version="1.0" encoding="utf-8"?>
<Data>
  <Object Type="Job">
    <Property Name="Id" Value="00001" />
    <Property Name="Description" Value="Storing verhelpen" />
    <Property Name="Status" Value="3" />
    <Property Name="Equipment.Id" Value="EQ-001" />
    <Property Name="Department.Id" Value="01" />
    <Property Name="CompletionDate" Value="2025-03-15" />
  </Object>
</Data>

JSON exportbewerken

{
  "Data": [
    {
      "Type": "Job",
      "Id": "00001",
      "Description": "Storing verhelpen",
      "Status": 3,
      "Equipment": "EQ-001",
      "Department": "01",
      "CompletionDate": "2025-03-15"
    }
  ]
}

CSV exportbewerken

Id;Description;Status;Equipment;Department;CompletionDate
00001;Storing verhelpen;3;EQ-001;01;2025-03-15
00002;Preventief onderhoud;3;EQ-002;01;2025-03-16

Webservice exportbewerken

Export connectors kunnen data direct naar een externe webservice sturen:

Voorbeeld: Export naar extern systeembewerken

De connector stuurt bij een statuswijziging van een Job een POST request naar een extern ERP-systeem:

WebServiceUrl: https://erp.mijnbedrijf.nl/api/workorders
WebServiceMethod: POST
WebServiceHttpHeaders: Content-Type: application/json

XSLT Transformatie bij exportbewerken

Net als bij import-connectors kunnen export connectors een XSLT transformatie gebruiken om de Ultimo data om te zetten naar het formaat dat het externe systeem verwacht:

<xsl:stylesheet version="1.0"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:output method="xml" encoding="UTF-8" indent="yes"/>

  <xsl:template match="/Data">
    <WorkOrders>
      <xsl:for-each select="Object[@Type='Job']">
        <WorkOrder>
          <OrderNumber><xsl:value-of select="Property[@Name='Id']/@Value"/></OrderNumber>
          <Description><xsl:value-of select="Property[@Name='Description']/@Value"/></Description>
          <AssetCode><xsl:value-of select="Property[@Name='Equipment.Id']/@Value"/></AssetCode>
          <CompletedDate><xsl:value-of select="Property[@Name='CompletionDate']/@Value"/></CompletedDate>
        </WorkOrder>
      </xsl:for-each>
    </WorkOrders>
  </xsl:template>
</xsl:stylesheet>

Logging en monitoringbewerken

Controleer de Event Log in Ultimo voor: - Tijdstip van uitvoering - Aantal geexporteerde records - HTTP response status van het externe systeem - Foutmeldingen

Praktische tips voor consultantsbewerken

1. Retry logica: Configureer retry-mechanismen voor webservice exports om tijdelijke netwerkfouten op te vangen
2. Idempotentie: Zorg dat het externe systeem dezelfde export meerdere keren kan ontvangen zonder dubbele records
3. Filtering: Exporteer alleen de benodigde properties om de payload klein te houden
4. Azure: Bij Azure-omgevingen zijn bestandsexports naar lokale shares niet mogelijk; gebruik webservice exports
5. Testen: Test export connectors in een acceptatie-omgeving voordat je ze in productie activeert
6. Monitoring: Activeer altijd LogErrorToEventLog voor productie-connectors

Gerelateerde artikelenbewerken

• import-connectors -- Import connectors configuratie
• rest-api -- REST API voor real-time integratie
• Integraties overzicht