Legt fest, ob Teil-Downloads während der Synchronisation aktiviert oder deaktiviert werden sollen

Syntax

setKeepPartialDownload( Boolean value )

Parameter

Bemerkungen

UltraLite kann Downloads, die aufgrund von Kommunikationsfehlern fehlschlagen, neu starten. UltraLite verarbeitet den Download so, wie er empfangen wird. Wenn ein Download unterbrochen wird, bleibt die Teil-Download-Transaktion in der Datenbank und kann bei der nächsten Synchronisation wieder aufgenommen werden.

Um anzuzeigen, dass UltraLite Teil-Downloads speichern soll, geben Sie Connection.syncParms.setKeepPartialDownload(TRUE) an, andernfalls wird der Download bei einem Fehler zurückgesetzt.

Wenn ein Teil-Download aufbewahrt wurde, wird das Ausgabefeld connection.SyncResult.getPartialDownloadRetained auf TRUE gesetzt, sobald connection.synchronize beendet wird. Wenn getPartialDownloadRetained gesetzt ist, können Sie einen Download wiederaufnehmen. Hierzu rufen Sie connection.synchronize mit connection.syncParms.setResumePartialDownload(TRUE) auf. Es wird empfohlen, den Wert TRUE für KeepPartialDownload beizubehalten, auch für den Fall anderer Kommunikationsfehler. Wird ein Upload übersprungen, so wird kein Download ausgeführt.

Der Download, den Sie während eines wiederaufgenommenen Downloads empfangen, ist so alt wie der Download, der ursprünglich begonnen wurde. Wenn Sie die aktuellen Datumswerte benötigen, können Sie unmittelbar nach dem wiederaufgenommenen Download einen weiteren Download ausführen.

Bei der Wiederaufnahme eines Downloads sind einige der SyncParms-Felder ohne Bedeutung. Sie erhalten die Publikationen, die beim ursprünglichen Download angefordert wurden. Die einzigen Felder, die festgelegt werden müssen, sind setResumePartialDownload(boolean) und setUserName(String). Die Felder setKeepPartialDownload(boolean), setDownloadOnly(boolean) und setDisableConcurrency(boolean) können bei Bedarf festgelegt werden und funktionieren wie üblich.

Wenn ein Teil-Download existiert und nicht mehr benötigt wird, können Sie Connection.rollbackPartialDownload aufrufen, um die fehlgeschlagene Download-Transaktion zurückzusetzen. Wenn Sie versuchen, erneut zu synchronisieren, ohne ResumePartialDownload festzulegen, wird der Teil-Download zurückgesetzt, bevor die nächste Synchronisation beginnt.

Weitere Hinweise finden Sie unter Verfahren bei Synchronisationsfehlern.