DataFlex

Sync a Local Tree Up with Preview and Traversal Control

Demonstrates the Chilkat Ftp2.SyncRemoteTree2 method, which uploads a local tree to the current remote directory with extra controls. The arguments are the local root, the upload mode, whether to descend into subdirectories, and whether to run preview-only. In preview mode the results are available via the SyncPreview property.

Note: The local paths are relative to the application's current working directory. Absolute paths may also be used. Supply the paths appropriate to your own environment.

Background: The preview flag is what makes this valuable: run it first to see exactly which files would be uploaded — without transferring anything — then run it again for real once the plan looks right. That dry-run step is a strong safeguard before a large or destructive-looking sync. The descend flag lets you limit the operation to the top level, and the mode is the same set of upload rules as SyncRemoteTree.

Chilkat DataFlex Downloads

Download Chilkat for DataFlex

DataFlex

Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoFtp
    Integer iMode
    Boolean iBDescend
    Boolean iBPreviewOnly
    String sTemp1

    Move False To iSuccess

    //  Demonstrates the Ftp2.SyncRemoteTree2 method, which uploads a local tree to the current remote
    //  directory with extra traversal and preview controls.  The 1st argument is the local root, the
    //  2nd is the upload mode, the 3rd selects whether to descend into subdirectories, and the 4th
    //  selects preview-only (no actual transfers).

    Get Create (RefClass(cComChilkatFtp2)) To hoFtp
    If (Not(IsComObjectCreated(hoFtp))) Begin
        Send CreateComObject of hoFtp
    End

    Set ComHostname Of hoFtp To "ftp.example.com"
    Set ComUsername Of hoFtp To "myFtpLogin"

    //  Normally you would not hard-code the password in source.  You should instead obtain it
    //  from an interactive prompt, environment variable, or a secrets vault.
    Set ComPassword Of hoFtp To "myPassword"

    Get ComConnect Of hoFtp To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoFtp To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get ComChangeRemoteDir Of hoFtp "public_html" To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoFtp To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    //    0 = all selected files
    //    1 = files missing on the server
    //    2 = missing, or newer locally
    //    3 = only files that exist remotely and are newer locally
    //    4 = missing, or a different size
    //    5 = missing, different size, or newer locally

    Move 5 To iMode

    //  Descend into subdirectories.
    Move True To iBDescend

    //  Preview only: determine what WOULD be uploaded without transferring anything.  The results are
    //  available via the SyncPreview property.
    Move True To iBPreviewOnly

    Get ComSyncRemoteTree2 Of hoFtp "qa_data/site" iMode iBDescend iBPreviewOnly To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoFtp To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    //  SyncPreview lists the files that would be uploaded.
    Get ComSyncPreview Of hoFtp To sTemp1
    Showln sTemp1

    Get ComDisconnect Of hoFtp To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoFtp To sTemp1
        Showln sTemp1
        Procedure_Return
    End



End_Procedure