Hier finden Sie Antworten auf die am häufigsten gestellten Fragen


FAQ-Datenaustausch:

  • Wird mit einem Job immer der gesamte Datenbestand einer (oder mehrerer) Entität(en) eines „Mandanten“ oder nur geänderte Daten zurückgeliefert?
    • Üblicherweise wird zu Beginn der Nutzung der AxeraApi-Schnittstelle der vollständige Datenbestand eines Kunden vom ERP(axera, wowinex, powerhaus) über die AxeraApi zum Partner übertragen. Nach erfolgter Komplettübertragung werden nur "Delta"-Übertragungen vorgenommen. In Prinzip updatet der Empfänger den Datenbestand ständig auf seiner Seite.

  • Gibt es die Möglichkeit, zum Testen einen Datensatz zur Verfügung zu stellen, welcher so realitätsnah wie möglich ist?
    • Dies setzt voraus, dass es einen gültigen Vertrag zwischen dem jeweiligen HLRE -(Pilot)Kunde - Haufe Lexware Real Estate und dem jeweiligen Partner gibt, worin vertragsrechtliche Inhalte festgehalten werden.

  • Kann ein FileJob bzw. eine TemporarySharedAccessSignatureUri mehrer Blobs/Dateien enthalten oder ist das Verhältnis immer 1:1?
    • Ja, bei regulären FileJobs können mehrere Dateien unter dem "TemporarySharedAccessSignatureUri-Link" zu finden sein.

  • Wofür sind die "UniqueEntityIdentifier" im Datensatz vorhanden?
    • Die "UniqueEntityIdentifier" sind in unserem Produktsystem müssen aber auch im Partnersystem vorhanden sein, denn nur so kann garantiert werden das beide Parteien (Kunde und Partner) sich über dieselben Daten unterhalten/austauschen. Da der "UniqueEntityIdentifier" einzigartig und eindeutig ist.


FAQ-Ver-/Enschlüsselung:


  • Gibt es eine Vorgabe, wie lang der Salt sein soll?
    • Nein, gibt es nicht.


FAQ-Lizenzinformationen:


  • Weshalb erhalte ich zweimal Endpoints in dem Endpunkt GET LicenseinformationGet , einmal als Endpoints[...] und einmal als ListOfEndpoints[...]?
    • Die Endpoints[...] sind alle Endpoints die der ServiceVersion der spezifischen Lizenz entsprechen für die man gerade abfragt: Wenn eine Lizenz für den Service CloudApi in Version 1 ausgestellt ist würden hier also alle Endpunkte der Version 1 enthalten sein.

      Die ListOfEndpoints[...] befinden sich unterhalb eines Service Knoten und beinhaltet die Endpunkte aller verschiedenen Versionen die der Service (theoretisch) unterstützt. Das heisst z.B. ListOfEndpoints[...] kann den gleichen CreateJob-Endpunkt zwei mal beinhalten mit zwei unterschiedlichen URLs für Version 1 und Version 2.
      Da wir aktuell nur eine Version 1 des Services CloudApi anbieten ist die ListOfEndpoints[...] Liste aktuell noch identisch mit der Endpoints[...] Liste.

      Die ListOfEndpoints[...] haben nur informatorischen Wert und die Endpunkte die tatsächlich genutzet werden sollten sind in Endpoints[...] zu finden. Die eigentlichen Endpunkte, die der Lizenzinhaber nutzen sollte und der Service Version der Lizenz entsprechen sind in Endpoints[...] zu finden.

FAQ-Umgang mit zwei Datenbanken:

  • Wie sollten Sie als Partner von wowinex vorgehen, wenn Ihre Kunden mehrere Produktiv-Datenbanken betreiben und die CloudApi nutzen möchten?

    • Wenn Ihre Kunden mehrere Produktiv-Datenbanken betreiben, können sie für jede dieser Datenbanken eine separate CloudApi-Lizenz erhalten. Als Partner erhalten Sie die entsprechenden Zugangsdaten für jede einzelne Lizenz.

    • Bitte beachten Sie, dass die Daten aus den verschiedenen Produktiv-Datenbanken vollständig voneinander getrennt sind und bei der Kommunikation wie separate Kunden behandelt werden müssen.

    • Es steht Ihnen frei, die Daten aus den verschiedenen Datenbanken zusammenzuführen. Allerdings liegt es in Ihrer Verantwortung, den geeigneten Übertragungskanal auszuwählen, über den die Daten bei Ihnen eingehen.