{"id":2986,"date":"2025-06-19T14:21:10","date_gmt":"2025-06-19T11:21:10","guid":{"rendered":"https:\/\/www.collectionpro.fi\/?post_type=ht_kb&p=2986"},"modified":"2025-06-19T14:21:13","modified_gmt":"2025-06-19T11:21:13","slug":"file-synchronizer","status":"publish","type":"ht_kb","link":"https:\/\/www.collectionpro.fi\/en\/help\/file-synchronizer\/","title":{"rendered":"File Synchronizer"},"content":{"rendered":"\n

File Synchronizer (FS)<\/strong>\u00a0synchronizes the assets stored in a directory and all its sub-directories with\u00a0Collection Pro<\/strong>.<\/p>\n\n\n\n

Every asset found in that file system hierarchy is added to Collection Pro, and the created record is extended with metadata pointing back to the original source asset. If the source asset is changed or renamed, the linked record is also updated accordingly. This gives users the flexibility to browse assets either through Collection Pro or via the familiar file server. For example, in-house teams can work directly on the file server, while Collection Pro can be used to distribute assets to external users or customers.<\/p>\n\n\n\n

Installation<\/h2>\n\n\n\n

FS is a stand-alone\u00a0service application<\/strong>\u00a0installed directly on a\u00a0Windows file server<\/strong>\u00a0that provides a directory to be monitored and synchronized, including all sub-directories.<\/p>\n\n\n\n

    \n
  • The installer is available for download.<\/li>\n\n\n\n
  • After installation, the\u00a0Collection Pro connection<\/strong>\u00a0must be configured in the\u00a0afs.xml<\/code>\u00a0configuration file.<\/li>\n\n\n\n
  • Configuration is managed via an\u00a0ACC plugin<\/strong>, available from the plugin registry.<\/li>\n<\/ul>\n\n\n\n

    Instances<\/h2>\n\n\n\n

    FS supports\u00a0multiple instances<\/strong>, each monitoring a specific directory (including sub-directories) and synchronizing that file system hierarchy with a single object type and pool in Collection Pro.<\/p>\n\n\n\n

    Each instance has a\u00a0unique name<\/strong>, referenced in the FS service application configuration file. The instance table provides the following status information:<\/p>\n\n\n\n

      \n
    • Enabled<\/strong>\u00a0\u2013 Whether the instance is actively monitoring.<\/li>\n\n\n\n
    • Status<\/strong>\u00a0\u2013 Indicates if the service is running and processing events.<\/li>\n\n\n\n
    • Queue Size<\/strong>\u00a0\u2013 Number of unprocessed file system events.<\/li>\n\n\n\n
    • Unknown Assets<\/strong>\u00a0\u2013 Assets found in the file system without a linked Fylr record.<\/li>\n\n\n\n
    • Unknown Records<\/strong>\u00a0\u2013 Fylr records with missing source assets.<\/li>\n\n\n\n
    • Unknown Categories<\/strong>\u00a0\u2013 Fylr hierarchy items with missing directories.<\/li>\n\n\n\n
    • Hash Problems<\/strong>\u00a0\u2013 Mismatches between internal AFS hashes and asset locations.<\/li>\n<\/ul>\n\n\n\n

      Instance configuration<\/h3>\n\n\n\n

      Each instance can be configured with the following options:<\/p>\n\n\n\n

      Table <\/th><\/th><\/tr><\/thead>
      Synchronize directory<\/td>Directory to be monitored by FS.<\/td><\/tr>
      Asset table<\/td>Table used to synchronize assets.<\/td><\/tr>
      Pool<\/td>If the table is pool-managed, select the pool for new records.<\/td><\/tr>
      Asset field<\/td>File field in the table where FS stores assets.<\/td><\/tr>
      Filesystem table<\/td>Hierarchical table for storing additional file system structure data.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Syncback<\/th><\/th><\/tr><\/thead>
      Enable sync back<\/td>Allows FS to write assets uploaded directly into Collection Pro back into the file system if their record is assigned to a directory structure item.<\/td><\/tr>
      Limit to records matching<\/td>Restrict sync-back to records matching a specific query. If left empty, all assigned records will be synced back.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Time-outs<\/th><\/th><\/tr><\/thead>
      Action time-out<\/td>Delay between receiving a file system event and executing the corresponding Collection Pro operation.<\/td><\/tr>
      Time-out for resync runs<\/td>Interval for full checks between Collection Pro and the file system to detect missed assets or records.<\/td><\/tr>
      Time-out for resync fixes<\/td>Delay before fixing issues found during re-sync. Recommended to keep this above one hour.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Exclusions<\/th><\/th><\/tr><\/thead>
      List of regular expressions<\/td>Assets with paths matching any listed regex will be ignored by FS. These can include full or partial path patterns.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Service configuration<\/h3>\n\n\n\n

      After installation, configure the Collection Pro connection in InstallDir\/conf\/afs.xml.<\/p>\n\n\n\n

      <\/p>\n","protected":false},"excerpt":{"rendered":"

      File Synchronizer (FS)\u00a0synchronizes the assets stored in a directory and all its sub-directories with\u00a0Collection Pro. Every asset found in that file system hierarchy is added to Collection Pro, and the created record is extended with metadata pointing back to the original source asset. If the source asset is changed or renamed, the linked record is…<\/p>\n","protected":false},"author":2,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[80],"ht-kb-tag":[],"class_list":["post-2986","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-add-ons"],"_links":{"self":[{"href":"https:\/\/www.collectionpro.fi\/en\/wp-json\/wp\/v2\/ht-kb\/2986"}],"collection":[{"href":"https:\/\/www.collectionpro.fi\/en\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.collectionpro.fi\/en\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.collectionpro.fi\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.collectionpro.fi\/en\/wp-json\/wp\/v2\/comments?post=2986"}],"version-history":[{"count":1,"href":"https:\/\/www.collectionpro.fi\/en\/wp-json\/wp\/v2\/ht-kb\/2986\/revisions"}],"predecessor-version":[{"id":2988,"href":"https:\/\/www.collectionpro.fi\/en\/wp-json\/wp\/v2\/ht-kb\/2986\/revisions\/2988"}],"wp:attachment":[{"href":"https:\/\/www.collectionpro.fi\/en\/wp-json\/wp\/v2\/media?parent=2986"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.collectionpro.fi\/en\/wp-json\/wp\/v2\/ht-kb-category?post=2986"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.collectionpro.fi\/en\/wp-json\/wp\/v2\/ht-kb-tag?post=2986"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}