LogoLogo
More help and supportPhocas website
  • Home
  • Getting started
    • Navigation
    • Homepage
    • Data access
    • User licenses, profiles and permissions
    • Account settings
    • Databases
    • Periods
      • Offset dates
      • Default period for a database
    • Sharing and folders
      • Share a dashboard, favorite, or alert
    • Subscriptions
  • Analytics
    • Take a tour of Analytics
    • Work with the grid
    • View a summary of the data
    • Customize your view (Analytics)
      • Change the mode
        • Period mode
        • Period Variance mode
        • Period Stream mode
        • Moving mode
        • Stream mode
        • Total mode
        • Transaction mode
        • Matrix mode
        • Matrix Variance mode
        • Matrix Share mode
        • Variance mode
        • Search mode
        • Market mode
        • Custom mode
      • Change the properties (Analytics)
      • Change the measures (Analytics)
      • Change the stream
      • Use the activity filter
      • Change the data format
      • Change the period (Analytics)
    • Drill down into your data (view transactions)
    • Filter data (use dimensions)
    • Select data (Analytics)
    • Focus on data (Analytics)
    • Copy or export data
    • Search for data
      • Perform a basic search
      • Perform an advanced search
      • Search for similar or comparative data (right-click filter)
    • Add levels to the grid (grid nesting)
    • Compare data with Matrix mode
    • Get more options for viewing data
    • Visualize your data in a chart
      • Bar and Column charts
      • Combo chart
      • Pareto chart
      • Waterfall chart
      • Line chart
      • Area and % Area charts
      • Pie and Donut charts
      • Bubble chart
      • Radar chart
      • Gauge chart
      • Bullet chart
      • Summary and Ring Summary charts
      • Map charts
      • Configure the chart options
      • Select and focus on a chart segment
      • Export a chart as an image
      • Use the chart legend
    • Save favorites and add to dashboards (Analytics)
    • Reset data
    • Phocas AI
    • Flex Modes
      • Switch modes
      • Filter data (Flex Modes)
      • Apply conditional formatting
      • Add levels to the grid (Flex Modes)
      • Manage columns (Flex Modes)
      • Save and share a favorite (Flex Modes)
      • View your data in a chart (Flex Modes)
  • Financial Statements
    • Take a tour of Financial Statements
    • Overview of access to financial statements
    • Customize your view (Financial Statements)
      • Change the properties (Financial Statements)
      • Change the measures (Financial Statements)
      • Change the period (Financial Statements)
      • Change the current data
      • Change the budget data
      • Change the columns
      • Change the style
      • Change the rows (activity filter)
    • Filter the financial information
    • Select and focus on data (Financial Statements)
    • Copy or export financial information
    • Add a level in a financial statement
    • View financial information in a matrix (change column groups)
    • Add and view comments (Financial Statements)
    • View transactions (Financial Statements)
    • View financial information in a chart
      • Create a Pie and Donut chart (Financial Statements)
      • Create a Value card
      • Export a financial chart widget as an image
    • Save and share favorites (Financial Statements)
    • Add financial analysis to a dashboard
    • Manage financial statements
      • Overview of financial statements and dimensions
      • Create a financial statement
      • Delete a financial statement
      • Customize a financial statement
        • Rename a financial statement
        • Reorder a financial statement
        • Customize account groups
        • Customize calculations
          • Functions for Profit & Loss calculations
          • Formulas for financial ratios
        • Customize headings and spacers
        • Set the revenue row in a Profit & Loss statement
        • Customize columns
        • Customize a Cash Flow statement
          • Common account mapping for Cash Flow statements
        • Rebuild the database
      • Set the financial year end date
      • Map the Retained Earnings account(s)
      • Restrict access to accounts
      • Manage budget streams (Financial Statements)
        • Create a budget (Financial Statements)
      • Use statistical streams
      • Use multiple currencies
      • Manage dimension groups
      • Map categories from your Chart of Accounts
  • Budgets & Forecasts
    • Overview of key terms and concepts
      • Budgets versus forecasts
      • Users and data access
      • Relationship with the Financial Statements module
      • 3-statement budgeting
      • Filtering methods
      • Demand planning
      • Loan repayments
    • Take a tour of Budgets & Forecasts
      • Explore the budget workbook
      • Explore the forecast workbook
      • Explore the Balance Sheet and Cash Flow budgets and forecasts
    • Customize your view (Budgets & Forecasts)
      • Filter a worksheet (search for items)
      • Group period columns
      • Use layouts
    • Use session filters
    • Edit values in a worksheet
      • Open workbook notes
      • Use keyboard shortcuts
      • Copy and paste values
      • Use comparison rows
      • Use sum and working lines
      • Use formulas
      • Spread totals
      • Revert to the baseline values
      • Edit the Balance Sheet budget
      • View and use headcount data
    • Refresh a workbook
    • Use workflows
      • Contribute to the workflow
      • View the workflow history
      • View workflow comments
    • View budget information in a chart
    • Open baseline, comparative, or opening balance data
    • Review the budget or forecast
      • Add and view cell comments
      • View and restore the cell history
      • View the audit log
      • Compare actuals, budgets and forecasts
    • Export a workbook or worksheet tab
    • Manage budgets and forecasts
      • Create a budget workbook
        • Filtered budget or forecast
        • Multi-currency budget
        • Unclassified data
        • Period types in budgets
        • Additional measures for driver-based budgeting
      • Create a forecast workbook
      • Clone a workbook
      • Import a budget or forecast
      • Edit the workbook setup
      • Roll a budget forward
      • Add more detail to a budget or forecast
      • Add worksheet tabs (drivers)
        • Balance Sheet and Cash Flow tabs
        • Manual Entry tab
        • Database tab
        • Headcount tab
          • Headcount tab FAQs
        • Reference tab
        • Lookup tab
        • Allocations tab
        • Scratch Pad tab
      • Manage worksheet tabs
      • Add notes to a workbook
      • Customize the format of measures
      • Manage the workflow
      • Manage user access and notifications
      • Publish a budget, forecast or other worksheet tab
      • Fix the baseline in a budget
      • Delete or restore a workbook
      • Delete a stream (Budgets & Forecasts)
      • Troubleshoot performance issues
  • Rebates
    • Overview of rebates
    • Get started with Rebates
    • Projects
    • Rules
      • Parent-child rebate rules
      • Rebates calculation methods
      • Yearly rebates
      • Quarterly rebates
      • Monthly rebates
      • Whole rule period rebates
      • Retrospective rebates
      • Pro rata rebates
    • Calculations
      • Run a calculation
      • Schedule calculations
      • View calculation results and transactions
      • Post calculation results
    • Seasonal calendars
    • Rebates analysis
    • Rebates near miss analysis
  • CRM
    • Overview of CRM
    • Agenda
    • Contacts
    • Accounts
    • Leads
    • Activities
      • Microsoft 365 Outlook calendar integration
    • Campaigns
    • CRM analysis
    • CRM administration
  • Favorites
    • Save a favorite
    • Manage favorites
    • Set a favorite as your default view
    • Use alerts
  • Dashboards
    • Use dashboards
    • Create a dashboard
    • Set a dashboard as your homepage
    • Manage dashboards
  • Administration
    • Overview of access to data (Administration)
    • Users
      • Add, update or delete a user account
        • User maintenance form
        • User permissions
      • Create a user template
      • Manage a user's database access and restrictions
      • Manage user passwords
      • Monitor user activity
      • Lock user accounts
      • Impersonate a user
    • Profiles
    • Folders (Administration)
    • Favorites (Administration)
    • Dashboards (Administration)
    • Subscriptions (Administration)
    • Periods (Administration)
      • Period types
      • Working days
    • Databases (Administration)
    • Sync Sources
    • Connectors
    • Configuration
      • Set up SSO
      • Set up SSO with Microsoft Entra ID
    • Logs
    • Designer
      • Modify a database
      • Get your data into Phocas
      • Design a database
        • Create a database
        • Add (connect) data to a database
        • Map data to the database
        • Save your database design
      • Design a financial database
      • Build a database
      • View and revert to older design versions
      • Add a budget file to a financial database
      • Add a budget file to a non-financial database (easy budget upload)
    • Sync
      • Automatically join or split items during Sync (split view)
      • Schedule the sync process
      • Migrate Sync
      • Test the sync process
    • Reserved words and characters
    • End of year maintenance tips
  • OTHER INFORMATION
    • File upload
    • Encrypt (share secrets)
    • Glossary
    • Release notes
      • Analytics release notes
      • Financial Statements release notes
      • Budgets and Forecasts release notes
      • Rebates release notes
      • Administration release notes
    • System requirements
    • Technical limitations
    • Security information
    • Scheduled upgrade and maintenance periods
    • More help and support
Powered by GitBook

© Phocas Software

On this page
  • Prerequisites
  • User account
  • Timing
  • Schedule sync
  • Set an alert on Sync failure
  • Set Designer builds to be based on scheduled Sync data
  • Only sync data items used in a database
  • Troubleshooting

Was this helpful?

  1. Administration
  2. Sync

Schedule the sync process

Rather than manually run the sync process every time, set a time to run the sync regularly, using Windows Task Scheduler.

PreviousAutomatically join or split items during Sync (split view)NextMigrate Sync

Last updated 2 months ago

Was this helpful?

User permission: Administration > Sync

You can automate the Sync process via a Windows scheduled task. Phocas uses the Run a Program option and defines the PhocasCLI.exe as the program and the Sync File with the run switch -r.

Prerequisites

Before you schedule the sync process, think about the account that will be used for the Windows Task Scheduler and the sync timing.

User account

Windows Task Scheduler requires a user account to run the Sync process. If you use a real user account for this, you run the risk of the schedule failing to launch (see the Troubleshooting section below). Therefore, we recommend you set up a dedicated (service) account to run the Windows Task Scheduler job. For example, an account called PhocasScheduler. This type of account satisfies the following requirements:

  • It will never be disabled.

  • Its password will never expire or be changed.

  • It has the Local Security Policy “Logon as a Batch Job” permission.

  • It has appropriate access to SQL, ODBC, file locations, and so on.

See the Microsoft page to learn more about such accounts. It’s up to your IT team to choose the appropriate account for your organization's security policy.

Timing

Phocas generally syncs over night so that data is accurate as at close of business the day before. Consider the following points:

  • When the data will be analyzed? Will it be analyzed or changed over the weekend?

  • If you use GETDATE() calculations, consider which side of midnight you are syncing.

  • If syncing multiple times per day, is there a time window required?

  • Are there any other processes running that might affect the sync at that time?

Schedule sync

The steps below are a basic guide, but you might also want to look online for Microsoft's instructions on using Windows Task Scheduler. When you schedule Sync, other options become available, as outlined on this page.

  1. Set up an account to use for the Windows Task Scheduler (see Prerequisites section above).

  2. Create and save your Sync file.

  3. Open Windows Task Scheduler, create a basic task, give it a name, and click Next.

  4. For the trigger, select how frequently you want to run the task. In this example, it will run every day at 10.01am.

  5. For the action:

    1. Click Start a program, then click Browse and locate the PhocasSyncCLI.exe file.

    2. In the Add argument box, enter the location of your sync file in quotation marks with -r at the beginning, for example: -r “c:\phocas\sync\sales\yourfilename.sync” Avoid using spaces in your file and folder names, as it could cause the task scheduler to fail. In the example above, the -r attempts to mitigate this risk.

  6. Click Next and Finish. Your sync will now run on a schedule.

  7. Ensure that the task runs even when you are signed out of Phocas: Locate the task in the list, right-click on the task and click Properties, then on the General tab, select Run whether user is logged on or not and click OK.

Set an alert on Sync failure

See the Troubleshooting section below for information about failures.

Set Designer builds to be based on scheduled Sync data

If data has been scheduled to sync regularly (for example each night), typically users expect the database at the other end to re-build almost immediately with this new data. For this to occur, a database must be set to build when a sync occurs.

There are two schedule frequency options applicable to Sync: After sync of any source in this design and After sync of all selected sources.

Only sync data items used in a database

After the initial sync of data, you can choose to only sync data items that are used in a Phocas database design in Designer (and exclude unused items). For example, if a Sync file has ten data items listed in the Data Items tab but only three have been used in a database, the unused seven data items will not be synced.

In Sync, select the Configuration tab and select the Only Sync Data Items… checkbox.


Troubleshooting

The most common reasons for sync failing to run are related to the account that's used for the Windows Task Scheduler:

  • The password is changed or expired.

  • The user leaves the organization and their account is disabled or deleted.

  • The security policy is changed to exclude the Local Security Policy “Logon as a Batch Job” permission.

If you discover that there are suddenly no Sync Logs in Phocas, check the Windows Task Scheduler. You can see the name of the account (Windows Credentials) being used on the General tab. The History tab will contain Launch Failure messages, assuming the history function is enabled. The error value for the message depends on the issue. For example, value 2147943731 means the account is disabled.

To relaunch the schedule, you need to resolve the issue with the account. For example, enter in the new password. To avoid such issues, use a dedicated account for the Windows Task Scheduler (see Prerequisites section above).

(Optional) .

To receive an email alert if a Sync fails, go to your and select Sync failures under Email notifications.

See for more information.

Service Accounts
Test the new sync process
account settings
Build a database