OnTakt Changelog

Server 4.10.21, Client 2.1.20, Proxy 2.7.8

11/28/2023

Production charting

New features

• The machines page now allows charting an arbitrary number of days (ending with the current day) instead of just the current day or week.
• Production pages now allow charting any range of days instead of just a day or week at a time.
• When choosing dates to chart on the production page, there is now an indicator on days with parts.
• When charting multiple days, there are now vertical separators between days.
• Machine action buttons are now shown on the production page in addition to expanded machine cards.
• Manually creating parts will default to the current time on the last day of the selected time window rather than the end of the last selected day.

Bugs fixed

• Fixed incorrect goal rendering on production parts with cross-day shifts.
• Fixed incorrect cross-day shift rendering on production charts.
• Double-clicking a day in the date range selection calendar will select only that day.
• Ellipsize shift labels instead of overlapping them when there are too many to fit across the width of the production chart.
• Fixed tool replacements not showing up correctly in the table under the production chart.
• Fixed incorrect goal calculations when charting time spans that include days with and without shifts.
• Downtime that started on a previous day and has not yet ended is now shown as current downtime on machine cards.

Tool management

New features

• Item-oriented tool receiving: click "Receive into inventory points" in an inventory item's menu to distribute the received quantity into inventory points, rather than selecting multiple items to receive into a single inventory point.
• The inventory point manager is now a dialog window, leaving more screen space for the inventory items table.
• Tool post-replacement checklists: items must be checked off after replacing a tool. These items can be defined in global settings and overridden for individual tools.
• When filtering the tools table by machine, switching to the tool assemblies table will now automatically filter by that machine's current process.
• Added an inventory point merge button.

==== Bugs fixed ====*Fixed server error preventing importing tools from a spreadsheet.

• Fixed the tool life tab of the part editor not fitting on shorter screens.
• Fixed "tools using this item" inventory item link not showing all tools due to the "only show tools that are past their warning threshold" filter applying by default.

Other changes

• Added support for reading macro variables from Haas machines without MTConnect using Q-Commands.
• Added a global setting to disable the "production stopped" machine status.
• Ignoring zero part counts is now an opt-in setting on each machine instead of automatically affecting all FOCAS machines.
• Removed useless machine filter from programs table on process pages.
• The log message "Skipped field '...' when applying dict to <...> because the current user is not allowed to write to it" will no longer appear for fields that no users are allowed to modify.

API changes

• Added an optional month query parameter to /overview endpoints.
• Deprecated POST /api/tools/inventory/<inventory_point_id>/receiveOrder. Use the new POST /api/tools/ordering/items/<item_id>/receiveOrder endpoint instead.

Server 4.10.18, Client 2.1.16, Proxy 2.7.7

10/17/2023

Tools

• Tool assemblies can be marked as shared.
  • When the machine in their assigned process switches to a different process, these tool assemblies will automatically be moved to the newly active process.
  • Shared tool assemblies are shown in the tool assemblies table for all processes on their machine unless Show shared tool assemblies is switched off above the table.
• Tools and assemblies now have an image field for a photo or diagram to make setup and calibration documentation easier.
  • Click the image cell to upload an image or view/update the existing image.
  • The image column is hidden by default in the tools table. To show it, click the Columns button and drag it into the Selected area.
• The image column is always shown in the tool assemblies table.
• The inventory item selector in the tool editor is now searchable.
• In order mode, inventory items are now displayed in the table as long as their suggested quantity is greater than zero.
  • Entering a quantity of zero will no longer remove an item from the table.
  • Clearing the quantity field will display the suggested quantity.
• Tools can now have a replacement message that is displayed to the user after replacing the tool.
• Added a global setting to automatically increase the minimum on-hand quantities of inventory items to ensure there is at least one per machine using tools based on that item.
• Work report improvements:
  • The tool work report can now be run without including tool replacements. If the tool replacements chart is not enabled, the tool work chart is aligned to number of cuts instead of time.
  • Added total parts and work to the tool work report.
  • Added TMAC tool work limits to tool work report charts.
• Added a tool alarm report.
• Improved the tool editor's assembly selection dropdown:
  • The location and process name of each assembly are now displayed.
  • The list is searchable by assembly name, process name, or assembly location.

Machines

• The proxy now looks up and reports the monitor ID for TMAC alarms. This means that TMAC alarms reported after installing this version will link to the specific recording from the event editor.
• Downtime categories can now be customized from by clicking "Downtime categories" in the machines section of the global settings window or the edit button next to the category dropdown in the downtime editor.
• Clicking the machine name at the top of a production page now shows a list of all machines with their current status, and clicking on a machine in the list will switch to its production page without resetting the date selection.
• Reworked parts are now listed next to scrapped parts under the production chart.
• When opening parts from the production chart, the part editor will have a States tab that shows the state history of the machine between the previous part and the selected part. This is not available for the first part of each day.
• Added a per-machine setting to send a notification when the machine finishes a cycle with at least one part.
• Machines page filters are now persisted between page loads.
• Added custom shift notes fields.
  • Set these up in Global settings > Machines > Custom shift notes fields.
  • Values entered for custom fields will be included in shift notes submission notifications.

Processes

• The processes table now has a menu for each row that allows manipulating the process without opening its dedicated page first.
• This same menu is also available as a toolbar on each process's page.
• The changeover button in the process menu allows running a changeover from any other process to the selected process.
• Processes can now be duplicated.

General improvements

• Added OPC-UA support for SINUMERIK 840D sl controls.
• Added start and end times to the "downtime blocks with notes" table in the downtime report.
• Downtime with notes in the downtime report now have edit buttons that open the downtime editor for that block in the client.
• Added a tool number column to the tool replacements table on the production page.
• Added confirmations when closing the shift notes entry wizard or switching between days.
• Downtime report improvements:
  • Pie chart legends are now tables.
  • Legend entries now include the total value lost.
  • Renamed "Reason" chart to "Planned".
  • Improved layout for printing in portrait mode.
• Clicking the tool assembly name in the TMAC alarms table will now open the tool assembly editor.
• The user who replaced a tool is now displayed in the tool replacement history table and in the tool replacement editor.
• Added a button to remove the value for a variable from the part editor.
• Added maintenance issue column to downtime table on production page.
• If a process to filter is selected on the tools page, it will now carry over when switching to the tool assemblies page.
• The program and process editors are now both linked from the overview tab of the machine editor.
• The interface language will now change immediately when the browser's language changes without requiring a page refresh.
• The license name is now pre-filled in the feedback form linked from the user menu.
• Individual users can now turn on developer mode for themselves from the API keys section of the user settings window. This will display object IDs in tables and editors to make it easier to manipulate objects with the OnTakt API.
• Italian translation has been completed.
• Added the PUT /api/alerts API endpoint for showing (and optionally messaging) custom alerts.
• Added the GET /api/maintenance/issues/:id API endpoint for retrieving a single maintenance issue.

Bugs fixed

• Fixed TMAC alarms falsely showing zero savings when reporting events in a notification.
• Fixed TMAC tool and section not showing up in the TMAC alarms table on production pages.
• Auto-ended downtime blocks will now update in the client without requiring a manual refresh.
• The name, notes, and suppliers columns of the inventory item table now wrap when the text is too long.
• The client will no longer allow submitting maintenance issues without a name.
• Fixed the reports page not loading report parameters from the URL on page load, which prevented the "tool work" shortcut menu item from working correctly.
• Fixed scheduled reports not updating the last run date when running as a background task.
• Use the correct external URL for links in reports (requires OnTakt Daemon 1.0.5)
• Fixed goals not charting for past days.
• Fixed machine tag listings only including the first letter of each tag.
• Fixed a bug in the input fields for relative time parameters when scheduling a report where negative offsets were not accessible with the number field spin buttons.
• Fixed a bug where the description of a downtime category could not be set empty.
• Fixed a bug where the associated machine column of the shift manager was not wrapping machines onto multiple lines.
• Accessing a report generation URL (for example, by clicking "Run report" in a scheduled report notification), will now redirect to the login page instead of showing an authentication error if there is no active login session.
• Fixed the duplicate tool assembly dialog freezing after clicking OK.

Server 4.10.5, Client 2.1.6, Proxy 2.7.4

8/16/2023

New features

Machines

• Machine states are now customizable. Learn more
• Multiple shifts can now be defined and assigned to machines. Learn more
• New report: utilization history.
• Users can now set their own idle and feed hold time limits for color fading.
• Downtime start/end times can now be set manually in the downtime editor.
• Server messages are now translated according to the Accept-Language header.
• Selecting tags in the machines page filter popup will show aggregated data from machines matching the filter.
• Utilization is now shown when expanding machine cards.
• Clicking programs table rows on the production page will now open the program editor.
• Machine feed rate override is now charted as a line instead of a gradient fill.
• Added a "false alarm" flag to events. The events report will call these out separately.
• Alarms can now be linked to downtime. The events report will show the value of an event from the value of its associated downtime.
• Programs can now be created manually before they are reported by a machine.
• When opening the downtime editor for a block that was previously set to auto-end and has already auto-ended, the downtime block will no longer reset to waiting for its end condition.
• Overview charts can now be exported as CSV by clicking the download button in the window header.

Tools

• When replacing tools that last replaced in test mode, there is now a confirmation to continue the test, and if confirmed, the tool can be indexed indefinitely.
• Added an "Import" button to inventory point menus for importing inventory counts from a spreadsheet file.
• The tables in the inventory verification window now show a part number column and allow searching by part number in addition to name.
• Tool usage days are now counted based on days with shifts scheduled instead of always Monday through Friday when "weekdays" is selected as the day counting type.

Inventory

• The header row of the inventory items table now stays fixed at the top when scrolling.
• When in order or receive mode, the selection sidebar for inventory items will shrink the rest of the page instead of covering the table.
• When in receive mode, entering a quantity greater than zero will select the row.
• Inventory page table columns can now be customized. Customizations are saved per-user and will apply on any computer a user logs into. Each mode (display, order, receive) has its own set of columns to customize.
• The tool number column of the inventory verification window is now sortable.

Reports

• A notification channel can now be an email address instead of a webhook URL. This requires configuring an email server in the global notification settings to work.
• Added a "Work report" button to tool menus that links to the reports page with the tool work report and tool already selected.
• Added optional tool and section parameters to the tool work report.
• The tool work report charts are now separated by time increment.
• The "Copy" button on the reports page now copies a link to the page with the report parameters filled in instead of copying a link to the report output.
• Added a machine utilization report, which allows exporting custom state history charts.
• Added tool work report, charting work done by tools in TMAC alongside their replacement history.
• The report type list now has a search box at the top.

Interface cleanup

• Date inputs now support typing in dates directly.
• Date range start and end inputs have been replaced with a unified date range input that allows selecting ranges on the calendar or typing in the range directly.
• Added per-user settings to hide display variables from machine cards and stop alarm flashing after a set interval.
• The shift bars at the top of production charts are now hidden by default, but can be enabled from the layers menu.
• Fixed the total number of corners not showing up in the tool usage column of the tools table and removed the number of corners remaining.
• The alerts pane can now be closed by clicking outside of it.
• New application icon.

Bugs fixed

• Fixed tools without an inventory item being excluded from the tools column of the tool assemblies table, which falsely showed "Empty" without an expand button when there were no other tools in the assembly.
• Fixed manual date entry not working when the browser language is set to something other than English.
• Fixed process changeover alert title translations.
• Translated and internationalized reports.
• Removed the system check report as it was superseded in usefulness by the alert system years ago.
• The "last NC/TMAC contact" times will now only update when the proxy communicated with the machine and not when the proxy is just reporting a communication error.
• Spanish and German translations are complete.
• Fixed HTTP errors being returned as internal server errors with a support file.
• Delete button icons are now consistent.
• Fixed translation formatting error in proxy alert title.
• Fixed XMC integration.
• Fixed reports failing to generate when only one machine is selected.
• Fixed audit log failing to record updates of objects with timestamp fields.
• Fixed machine custom alarms not matching correctly.
• Fixed kudos report failing to generate when downtime received kudos in the selected time window.
• Fixed kudos report failing to render emoji correctly.
• Report errors no longer appear as JSON (when report is requested with GET).
• Demo machine feed rate override values are now more realistic.
• Fixed machine cards failing to indicate current downtime for downtime that has no end time set.
• Tools table filter popup card will now close automatically when clicking outside of it.
• Fixed single-section tool notes showing line breaks as "<br>".
• Fixed "tool created successfully" message not being formatted correctly.
• Event bus deletion messages can now have an array of deleted object IDs instead of just one, which should improve performance significantly when deleting hundreds or thousands parts in bulk.
• The audit log no longer stores all properties and instead stores only changed properties. This will reduce the size of the database significantly, so during the upgrade, unchanged properties will be removed from old audit log entries. This may take a few minutes depending on the size of the audit log table
• Fixed an "error 404" popup when opening the tool editor to create a new tool.

Server 4.10.1, Client 2.1.1, Proxy 2.7.0

6/27/2023

The OnTakt frontend/client application has been completely overhauled with a new interface. The layout and organization is the same as before, but the new framework behind the interface should offer increased performance and browser compatibility, with greater flexibility for future improvements.

The interface has also been prepared for translation, with several languages coming soon.

New features

• More NC and TMAC alarm information is now recorded, including the alarm code and other machine-specific attributes.
• The alerts pane can now be filtered by alert severity.
• The machine card expanded details section has been redesigned to organize the information into NC and TMAC sections.
• OEE and tool history windows now scroll infinitely instead of needing to click "load more" each time.
• All users can now create their own API keys that provide the same level of access as their account.
  • A new API key should be created for each application that will use the OnTakt API. This allows revoking an API key without disrupting other applications' usage of the OnTakt API.
  • The global API token is no longer accessible, but it will still work for administrator-level access if already in use.
• NC and TMAC alarm indicators on machine cards are now icons instead of red squares for clarity.
• Importing tools with the spreadsheet template will now create inventory items if the "Durable" column is filled in.
• When importing tools with the spreadsheet template, assemblies will now be named after the first tool row with a given location.
• Added a setting that allows users of the "shop" access level to replace tools into test mode.
• The machine runtime report now also includes a pie chart showing the time spent in each execution state.
• Tools table column customizations are now stored per-user instead of per-computer, so custom layouts will follow each user no matter what computer they log in from, and they will not affect other users.
• The inventory item of the tool history window now shows the inventory item selected during the previous replacement/rebuild, so for each row it is the inventory item in use during that replacement's lifetime.
• Machine cards now change color when the machine is inside a downtime block.
• The per-program usage of a tool can now be viewed from the tool editor before replacing the tool.
• The margin and part report default filenames now include the selected start and end dates.
• Support for reading the feed rate override from Okuma milling machines via MTConnect.
• The columns of the tools table can now be reordered.
• The last part count a machine reported is now shown in the variables tab of the machine editor.
• Allow selecting which tools table columns to display.
• Clicking on an inventory point now opens the inventory verification window. Inventory points can be renamed from the actions menu instead.
• Added close button to top right of part and event editor windows.
• The number of parts in the chart selection area is now shown in the context menu.
• The state history page now has an option to switch to week view instead of a single day.
• Tool type icons have been redesigned for improved clarity.
• OnTakt will now prompt to refresh the page after midnight to maintain performance and data consistency. If TV mode is active, the page will refresh without prompting.
• There is now a button in the user menu to send feedback or request support.
• Help buttons are now native browser links so the URL can be previewed by hovering.

Bugs fixed

• Fixed the part editor not saving changes when clicking OK.
• Fixed the part editor previous/next part buttons only working once after opening from a chart.
• Fixed tool replacements not showing up in the life chart of the tool history window after being edited.
• FANUC FOCAS machines that report a part count of zero will now be ignored until they report a different part count to avoid creating ghost parts when FOCAS falsely reports the part count as zero.
• Part counts in production chart context menu actions are now formatted correctly.
• When reading FOCAS part counters, a read of zero will trigger a fallback read of a different variable to double-check.
• Additional checks when getting FOCAS alarms to avoid reading garbage characters.
• Partially successful FOCAS machine updates will now be sent to the server, which will report errors reading variables, feed rate override, emergency stop state, and alarms to the user as alerts instead of skipping the update.
• Shifts that cross midnight (start time is later in the day than end time) will no longer cause part goals to be negative, charts to have goals that decrease throughout the day, or machines to falsely show as "production stopped".
• Typing to search the "running processes" field of the inventory ordering form no longer fails to filter the list.
• Part and event report notification messages are now formatted correctly.
• The downtime report is no longer overly precise when displaying durations.
• Fixed not being able to click into fields of the user editor when opened from the options window.
• State history charts no longer fail to render immediately in Safari.
• Fixed some external links not working.
• Fixed release notes dialog sizing on mobile devices.
• Improved machines and tools page header button layout on mobile devices.
• Detect when report output pop-ups are blocked by Safari and show an error message.
• Display variables for machines using FANUC FOCAS are now requested even when they are not used otherwise.
• Rename tool "location" to "Tool #" and warn when it is not set on a tool assembly.
• Machine card preview charts now wait to download and render chart data until they are scrolled into view to improve performance and reduce memory usage for instances with many machines.
• Fixed inventory table not sorting by order and receive quantities.
• Fixed tools table and processes table filter dropdowns showing the selected item's ID instead of its name when the page loads with a value already selected.
• Fixed machine card production chart previews growing outside their containers as new parts are rendered.
• Machine card production chart previews are now re-rendered when the available width for the chart changes due to resizing the window.
• Fixed tools table not sorting by type.
• Fixed production page downtime table not sorting by duration.
• Fixed awkward machine editor scrolling on small viewports.
• Fixed feed rate always rendering as solid black on production charts.
• TV mode will now autoplay correctly when the controls are hidden.
• Inventory verification window:
  • Fixed the location column of the "present tools" table always being blank.
  • Fixed the "other tools" table not showing any tools.
  • Fixed "remove from inventory point" button not working.
• Fixed file download spinners stopping before the file has been completely downloaded.
• Fixed inventory verification window quantities resetting when focus leaves a quantity input field.
• Fixed tool notes and stickout display in the tools table.
• Limit height of machine card production chart thumbnails.
• Fixed tools table not sorting by parts remaining when sorting by the usage column.
• Fixed "favorite machine" toggle button tooltip text.
• Fixed server error when deleting machines.
• Fixed server error when restoring database.
• Variables reported by the machine with excessive floating point precision will now be rounded when used as a display variable.
• Machine utilization will no longer be incorrectly reported as less than 0% or greater than 100%.
• Machine state history charts should no longer sometime show incorrect times in tooltips.
• The "analyze historical run times" button is no longer shown in the process editor when creating a new process.

API changes

• The alarm format in machine state updates has changed from an object to an array of alarm objects. For more information, see the machine state format specification. This is not a breaking change yet because the server will still accept the old format.
• The new API key system requires the use of Authorization: Bearer <API_KEY> instead of X-Auth-Token: <API_TOKEN>.
• Removed date and timeRange query parameters (deprecated in 4.9.1) from the following endpoints:
  • GET /api/machines/:id/goals
  • GET /api/machines/:id/chart
  • GET /api/processes/:id/chart
  • GET /api/programs/:id/chart
• Removed the day query parameter (deprecated in 4.9.1) from GET /api/parts.
• Removed the shift property (deprecated in 4.9.1) from the object returned by /chart endpoints.

Server 4.9.4, Proxy 2.6.7

5/01/2023

• Added machine model for DMG MORI via MTConnect.
• Added machine system for connecting to XMC.
• Paths can now be specified in NC URLs when using MTConnect. This is only required for DMG MORI machines at this time.
• The system check report is no longer incorrectly listed as a spreadsheet.

Server 4.9.3, Client 1.6.4, Proxy 2.6.6

4/26/2023

New features

• Combined tool & assembly creator makes it easier to get started entering tool data.
• The state history chart for the selected time window is now shown under production charts.
• Tool assembly tables now show the tool types each assembly contains for faster identification.
• There is now a warning icon on a machine's card in place of a process if there is no active process.
• Machine states are now recorded. This can be viewed from the States page.
• Downtime can now be set to end automatically when the machine either produces a part or becomes active.
• Users can now choose the page they see by default when opening OnTakt.
• Tool replacements can now be only one of: broken, scheduled, or preemptive.
• Tool changeovers can now be performed in advance by clicking the Changeover button on a process in the processes table.
• Programs that are not in a process (unassigned programs) are now displayed alongside processes instead of on their own page.
• Tools can now be filtered by warning state, so only tools that are past their warning life threshold are shown. This is enabled by default to reduce page load time, but it can be disabled to show all tools from the filter menu.
• The inventory page is now a top-level navigation item.
• The tool assemblies page has been removed from the main navigation and is now accessible from the tools page.
• Machine states can now be mapped for customization or compatibility.
• The notification channel selection radio buttons have been replaced with a searchable drop-down.
• Added downtime tracking.
• Added tool replacement test mode.
• Added "scheduled" as a tool replacement reason and changed "damage types" to "tool condition".
• When manually creating parts, it is now possible to change the program and timestamp.
• Inventory items can now have a minimum on-hand quantity in addition to the existing safety stock days.
  • Added "minimum on-hand quantity" and "safety stock" columns to inventory item table in "order" mode.
  • Added "brand" and "corners" columns to inventory item table in all modes.
• Tables under production charts will no longer be shown if they are empty.
• Maintenance issues now appear when entering shift notes.
• Audit logs and the trash are now filtered by date.
• The parts report can now be broken up into a chosen interval, and it is now returned as a Microsoft Excel spreadsheet.
• Improved chart context menu layout.
• Tool assemblies can now be linked to TMAC alarms. This will happen automatically if there is an assembly with the location indicated in the TMAC alarm, and the relevant tool can be changed for any TMAC alarm in the event editor.
• Tool assemblies linked to TMAC alarms will appear in the alarm's table row under production charts.
• When rebuilding a durable tool, if the chosen substitute tool is already in an assembly, it will now offer an option to move the tool from that assembly automatically.
• There is now a "tool replacement minimum usage" setting. When replacing tools with usage below this threshold, either flag selection or notes entry will be required.
• Tool life expectancy alerts now have a button to open the editor for the affected tool.
• There are now more specific "broken" tool conditions. When replacing a broken tool, one of these options may be chosen, otherwise note entry will be required.
• There is now a per-machine setting that will send changeover messages to the machine's notification channel.
• The proxy will now report errors it encounters while communicating with TMAC to the server and they will appear in the alerts pane alongside NC communication alerts.
• Tool assemblies can now be created from inside the tool editor.
• Tool assemblies can now be created from the process page tool assemblies table.
• Release notes are now pulled from the knowledge base for only the current software versions.
• Editing tool replacement part counts and day counts is now allowed.
• During durable tool rebuild, the substitute tool (if selected) is now recorded and displayed in the tool's history.
• Part and day counts in the tool history window are now formatted with thousands separators according to the browser's language settings.
• TMAC event details are now displayed in a simpler format.
• Process tool replacement history charts now load one year of data at a time to reduce load time and browser memory usage.
• Replacements of tools that were replaced while they were not assigned to a process now show an indicator in the machine tool replacements table under production charts explaining why they appear on all machines.

Bugs fixed

• Fixed the daily goal always being zero for days where a machine has not yet finished a part.
• Inventory items are now correctly removed from the suggested order list when they are no longer needed after deselecting processes from the run list.
• Fixed an error that occurred when creating a missing variable alert for a machine that does not have a process loaded, resulting in no alert shown.
• Fixed date inputs in variable chart and shift notes.
• Fixed utilization calculating incorrectly when the first state of the day is not an active state.
• Fixed date/time input for manual part creation and maintenance entries.
• Fixed machine goals always charting as zero.
• The utilization calculation displayed above state history charts will now update in real time as the chart updates.
• Only time in the past is considered when calculating utilization, so it will no longer be lower earlier in the day.
• Better context menu event handling for charts to improve the states page on mobile devices.
• The time range of state history charts is now defined by the server's time zone.
• State history charts now include the first and last state in the selected time range even if extends outside the range.
• The order of machines will no longer update to reflect changes from another client until the page is refreshed.
• Production charts will now always clip to the selected time window.
• Fixed production chart date navigation moving one day at a time when set to week mode.
• Fixed server error when creating a tool without a maintenance status specified.
• Fixed tool creation window not loading correctly.
• Fixed server error when reporting downtime without specifying a category.
• Fixed server error when completing a maintenance reminder.
• Fixed server error when an inventory point contains an invalid (non-integral) quantity of a tool.
• The x-axes of variable charts are now aligned even when a part does not have a value for the given variable.
• Fixed the selection in the machine drop-down of the maintenance item creator jumping to the top every time new machine data arrives.
• Tool usage counts are now formatted correctly (with thousands separators) in the usage column of the tools table.
• Preemptive tool replacements are no longer counted in average tool life.
• Fixed some help buttons linking to "#undefined" on the knowledge base pages.
• Tables in report output had invisible text in dark mode.
• Fix error in TMAC alert handling.
• Fixed server error when loading shift notes.
• Variable charts will no longer show incorrect values in part tooltips when parts are added to the chart.
• TMAC alarm lines on charts will no longer appear as the wrong color or with the wrong tooltip after navigating between production days.
• Suggested process alerts will no longer suggest processes from machines other than the program's own.
• Variable charts now include parts that don't have all the specified variables, but do have at least one.
• The displayed part count of a tool replacement is no longer cleared when saving the tool replacement. No part count data was permanently lost, but it would not be shown until the page was refreshed.
• NC alarm names will now have leading and trailing spaces removed before being saved to the database. Previous alarms already in the database will be cleaned up during the update.

Reports

• Added a downtime report that analyzes downtime by cause.
• The reports page now shows a brief description of each report and an icon indicating whether it returns a webpage or a spreadsheet.
• Reports that return webpages are now opened in new windows to allow side-by-side viewing.
• The margin (formerly profit) report now has a "total margin" column.
• The margin report can now be broken into a chosen interval.
• The tool usage report now includes tool cost.
• The parts report no longer falsely reports 0 parts for some days.
• Machine runtime reports no longer have blanks for missing process IDs.
• Machine runtime reports now calculate total time correctly.

API changes

• Process.last_cycle is now an object with finished and program_id fields instead of an array of the part's timestamp, the machine's ID, and the machine's name. This is not considered a breaking change because the last_value field for processes was not documented, but it is now in the API models documentation.
• Added start and end parameters to the following endpoints, deprecating their date and timeRange parameters:
  • GET /api/machines/:id/chart
  • GET /api/machines/:id/goals
  • GET /api/processes/:id/chart
  • GET /api/programs/:id/chart
• If the start and end timestamps supplied to GET /api/machines/:id/chart extend beyond a single day, the returned shift.start and shift.end values will be the start of the shift on the first day and the end of the shift on the last day. The shift object returned by this endpoint is now deprecated for this reason.
• The broken, preemptive, and scheduled fields of tool replacements are now stored as one field, where 1 means broken, 2 means preemptive, and 3 means scheduled.
• The GET /api/tools endpoint now has a warn_life query parameter that only returns tools past their warning life threshold.
• The CSV export report has been removed. All the data it could export is accessible via the API, and database exports can be downloaded for offline processing instead.
• The "new process is not loaded on the machine" error returned by POST /api/processes/:from/changeover/:to now has a dedicated response status of HTTP 412.
• POST /api/processes/:from/changeover/:to now has a planned query parameter that bypasses the 412 return code.
• Added start and end parameters to the following endpoints to allow filtering results by time:
  • GET /api/maintenance/issues
  • GET /api/auditLog
  • GET /api/auditLog/user/:user_id
  • GET /api/auditLog/action/:action
  • GET /api/auditLog/:object_type/:object_id
  • GET /api/auditLog/trash
• Fixed typo of machine filter parameter name in documentation of GET /api/maintenance/issues.
• Maintenance issue objects now include downtime information.
• The program_filename field of POST /api/parts/create has been changed to program_id in both name and behavior.
• Fixed variable parameters on GET /api/parts behaving like var[NAME] parameters (all must be present instead of any must be present).
• Added optional start and end parameters to GET /api/tools/replacements/process/:id to narrow results by time

Server 4.8.7, Client 1.5.14

2/22/2023

New features

• Maintenance items can now be scheduled by machine runtime in addition to normal clock time.
• When selecting a substitute tool in the durable tool replace wizard, there is now an option to show only tools that are "ready for use".
• There is now a button to edit processes directly from the processes page without first opening a process.
• The program editor can now be opened directly from machine cards by clicking the program name.
• When undoing audit log entries, the undo button now indicates progress and success states.
• Process cycle time can now be entered in different time units.

Bugs fixed

• Tool replacements will no longer fail to render in the shift notes wizard.
• Some mapped variables were failing to save when parts were produced. This should be fixed now.
• Fixed machine goal alerts not firing.
• Help links have been updated to point to the new knowledge base page locations.
• Fixed a rare divide-by-zero error when calculating a machine's status color.
• Single-machine processes (the fact that processes can only contain programs from one machine) is now enforced by the database to prevent assignment errors by the server.
• Fixed machine deletion messages not getting sent to the proxy, causing the proxy to continue attempting to communicate with it and possibly fill the log with errors.
• Audit logs and the trash list will now load much faster.

Breaking changes

• Removed API endpoint POST /api/processes/updateCycleTimes. Use PATCH /api/processes/:id for each process individually instead

Server 4.8.6, Proxy 2.6.5

2/08/2023

New features

• There is now an export button in the variable chart window that will download the displayed data as a CSV file for offline analysis.
• Tool replacements are now listed in a table under production charts.
• Support for Mazak MAZATROL controls via MTConnect has been added.
• A new "machine runtime" report has been added that breaks down the total time the machine spent running during a selected timeframe by process.
• Tools now have a "replacement duration" field to store the amount of time it should take to perform a tool replacement. This field is not yet used by OnTakt internally, but it is available for data entry.
• Tools now have an "offset number" field to store the offset of the tool's data in the machine control's memory. This field is also not used by OnTakt internally at this time.
• The tool torque specification field now allows a choice between metric (N⋅m) and imperial (lb⋅ft) units. This is for reference only so conversion is not performed automatically.
• Tools without a life set have their usage column highlighted green in the tools table to indicate that they should be checked for wear more often until their first replacement.
• Use searchable dropdowns instead of system dropdowns where possible. This makes finding items in the list faster and allows them to appear in single-window in-browser screen captures.
• Process run times in machine run report have been changed from running total to individual.
• For each machine, you can now specify the maximum length of time TMAC monitoring can be disabled before a warning notification is sent to its notification channel. This message will have a link to the TMAC web interface.
• You can now select a display variable for a process to show its value on the machine's color chip while the process is loaded.
• There are now "select all" and "deselect all" buttons in the tool changeover verification window.
• Machine variables are now always sent with machine objects, so the variables display in the machine editor can now update in real time instead of requiring a refresh button click.
• The tool assembly editor now has buttons to add or create tools directly.
• If an "Open in TMAC" button is disabled in the event editor, a message will now explain why.
• If someone else edits the notes of a part or event you are editing, it will prompt you to accept their changes or keep your own. If the part or event is deleted, the editor will close and explain why.
• Tools can now be bulk-imported into a process by downloading a spreadsheet template from the process's details page under the tool assemblies table.
• Added a button to duplicate maintenance items.
• The time zone list in the options window is now searchable.
• Added an option to filter inventory items by active machine when in receive mode.
• Added a button to load more audit log entries at the bottom of the list.
• Added help text to inventory item order and receive tabs.
• Improved performance of part, event, and tool replacement queries and charting.
• The processes table can now be filtered by machine.
• The total number of tools is now displayed on the tools page filter button.
• The total number of tool assemblies is now displayed on the tool assemblies page filter button.
• If a substitute tool is specified when replacing a durable tool, the substitute tool's status is automatically set to "in service". The "received from rebuild" status is no longer available for selection in the web interface, but tools that already have this status will continue to display it, and tools can still be assigned this status via the API.
• When duplicating an assembly, new names can now be specified for tools set to be duplicated.
• Feed rate override is available as a layer on production charts. Turn on the "Feed rate" switch under a chart to see it.
• Feed rate override can now be read from machines with FANUC controls.
• In the variable charting window, only variables that exist on parts produced in the selected time range are listed.
• Tools now have a number of "slots". This determines how many inventory items to consume during a replacement/rebuild of the tool, is displayed next to the item name in the tool replacement/rebuild wizard, and will multiply order quantities.
• The part count variable can now again be set for a machine, allowing parts from programs not in a process to count parts. If the active process on a machine has a part count variable of its own, it will override the machine's setting as long as the process is loaded.
• Added a toggle in the part variable charting window to switch the x-axis of the charts from time to number of parts for even spacing.
• Added a goal calculator to the process editor that will allow setting the cycle time by entering the number of parts that should be produced during each shift.
• A message will be sent to a machine's notification channel when it has not produced a part on schedule. This can be disabled in each machine's notification settings.
• Line breaks in tool notes are now displayed in the tools table
• Production chart pages now include a table breaking down the number of parts produced by program and part flags.
• Added Previous and Next buttons to the part editor that navigate between parts in the order they appear on the chart.
• Report generation errors now return a support file.
• Experimental support for adding 3D printers run by OctoPrint as machines. Part counting may be unreliable at this time.
• Haas macro variables are now numbered consistently with the control's numbering scheme.
• Requests for data from machines are now offset by random sub-second times in order to reduce network load caused by all machines sending data at the same time.
• The part editor's tool life table now also displays the usage as a progress bar.
• Date/time display formatting uses the browser's language setting
• Variables recorded on a part can now be edited.
• Clicking on a part from a part variable chart will now open a new part editor instead of closing the chart and reusing the existing editor window.
• Part variable chart formatting has been improved.
• Tool assemblies can now be duplicated.
• Tool assemblies can now be merged.
• Tools now have a "torque specification" field.
• Added tool types for holders and bodies.
• Changed labels on tool replacement cancellation confirmation buttons to be more intuitive.
• Allow shop users to edit event notes.
• Added an API endpoint (POST /api/machines/:id/update) and a "custom" machine system type for building custom machine integrations using Caron MiConnect or other software.
• Tool assembly and location are now shown in the tool replacement detail window.
• View combined replacement and rebuild history for all tools in an assembly.
• Tool rebuild status is shown in the notes column of the tools table for tools that have it set.
• Mark parts as "reworked" and they will appear yellow in part charts
• In addition to selecting many parts at once to scrap, you can now remove their scrapped status and change their reworked status in bulk as well. Just right-click the part selection and click "Flag".
• Inventory items now have only one part number for all suppliers.
• Tools will keep track of which inventory item they were using at the time of replacement to allow for easier analysis of longevity between equivalent items.
• Updated Microsoft Teams webhook support to support their new URL format.

Kudos to you

To encourage helpful notes, you can now give kudos to other users for good documentation by clicking the reaction emoji under a note. You can choose your own personal reaction emoji in your user settings. Managers can run a kudos report to see which users received the most kudos in a given time period.

Which user gets credit for the helpful note depends on the target: for tool replacements this will be the user who replaced the tool; for parts and events it will be whoever last saved changes; and for maintenance entries and issues it will be whoever created the entry or issue.

Processes

Program groups have been replaced with processes, which are containers for a machine, programs, tool assemblies, and settings that define a real-world process.

During the upgrade

• Program groups that contain at least one program will be converted to processes automatically.
• If a program group contains programs from multiple machines, the machine to which the most programs belong will be kept in the process, and all other programs will be ungrouped.
• Settings from a group's programs will be combined into the settings for the process using the following rules:
  • Common variable map: merge all program maps into one superset map
  • Cycle time: average of program settings
  • Parts per cycle: most common of program settings
  • Part count variable: most common of program settings
• Tools that are assigned to program groups and already in assemblies and will have their assembly added to the new process created for the program group.
• Tools that are assigned to program groups but not in an assembly will be placed into new assemblies named with the program group and tool location, and then the new assembly will be added to the new process. If multiple tools assigned to the same program group are in the same location, they will be added to the same assembly.
• Tool reorder notifications are now configured in the options window.

Bugs fixed

• Fixed the internal server error that occurred when deleting machines.
• Non-integral numbers are now allowed in the "notify when" field of the common variable mapping window.
• In the case where a machine selection dropdown is opened when a value is already selected, it will no longer jump back to the top of the list when machine data is updated.
• The NC authentication field (which may be named differently depending on a machine's system type) will no longer be clobbered by saving changes to a machine without entering a new value.
• The report output viewport now has a light background to match its printed appearance even when the dark color scheme is selected by the operating system.
• "Machine not configured" alerts will no longer show up for machines of the "custom" system type
• Maintenance reminders will now only be sent once between entries.
• Machine part counts are once again exposed via the API as Machine.last_part_count. Note that if a machine is using a variable as a part counter, this will be the last reported value of the selected variable instead of the control's part counter.
• Improves proxy log message when a machine is missing a TMAC API key
• Fixed "assigned to any loaded process" tool table filter returning all tools.
• In the tool replacement wizard, the substitute tool selection is now cleared when the tool substitution option is unchecked, so the server will no longer reject these replacements.
• The "create inventory item" button in the tool editor now correctly selects the newly created item.
• In the variable mapping window, variables set to "never notify" will no longer show a useless and confusing value entry field.
• The "Add to inventory point" option when selecting inventory items now works again.
• Fixed "chamfer fill" typo of "chamfer mill" tool types.
• The job ID field of TMAC events should now be populated for future alarms.
• NC alarms from machines using FOCAS should no longer have garbage trailing characters.
• OctoPrint machines in the "finishing" state are now treated as running instead of idle.
• Many parts created at the same time will no longer be removed during upgrade
• Fixes a segmentation fault that occurred when there was an error parsing MTConnect XML
• Fixed the maintenance page machine selection not filtering maintenance issues table.
• Fixed "move selected items to another inventory point" not working in the inventory verification window.
• Dropdowns no longer scroll horizontally.
• Unknown tool maintenances states will no longer cause errors during page rendering, and will instead show up as "(Unknown status)".
• Percentage-based tool life tracking is no longer used for alerts, so the tool life reported in alerts and notifications will now match the tool life displayed in the OnTakt interface.
• The y-axis range of charted variables is no longer required to contain zero.
• Audit log tables were not rendering correctly
• Fix server error when rebuilding a durable tool with a substitute tool selected.
• Improved reliability of data from FANUC controls by disconnecting from and reconnecting to the control each time the proxy updates machine data. This was the behavior of proxy versions <2.5.0.
• Fix TMAC data not being recorded on the server
• Client version 1.5.5 displayed goals incorrectly in machine cards.
• Server version 4.7.5 failed to create parts for programs not belonging to a process.
• Demo machines will no longer generate negative feed rate override values
• Programs without names will no longer cause a suggested process alert.
• Tool usage report generation no longer fails with an error when some tools do not have an inventory item set.
• The location column of the inventory verification window now shows values again.
• The tool usage tab of the part editor will now display correctly when there are tools that are not in an assembly.
• Fixed a bug in the part editor's tool life table that prevented tool locations from showing up.
• Fixed part variables not being saved during part creation.
• Parts without a value for a variable will no longer cause errors in the variable charts. Instead, they will be skipped on the chart.
• When a variable is not being reported, showing the alert will no longer cause a database write loop
• Fixes a bug where mapped variables do not get saved with parts.
• Chart context menus will no longer run off the right edge of the screen.
• The variable list in the machine editor now behaves more predictably.
• Fixes a typo in the missing variable system alert
• Fixes a bug where every part produced on a machine would create two parts in OnTakt. This update will automatically remove duplicate parts and restore tool life during installation.
• Fixes multiple parts created at the same time being connected in the wrong order on part charts when using Safari or Chromium-based browsers like Google Chrome and Microsoft Edge:[[File:20221115_sawtooth.png|sawtooth and fixed charts]
• Fix "Add Supplier" button not working when creating a new inventory item.
• Fix the audit log undo button not working in most cases.
• Show undefined OEE as 0% instead of N/A.
• Fix error when deleting a tool that is in an assembly.
• Tool active time ("in use for x days") was shown in tools table even when the lifetime expectancy was not set on the tool.
• Fix error when clearing database before restoring a backup

FANUC compatibility improvements

• The proxy now reads the main program instead of the current sub-program, so program names should now be consistent between parts.
• To improve communication reliability, only variables set in OnTakt for program selection, part counting, or in the current process's variable map will be read from the machine.
• Feed rate override is now read from machines with FANUC controls.

Known issues

• Tool replacements created prior to updating will show up on all production charts of all machines. This is because the data associating tool replacements to a machine was not previously recorded. Tool replacements created after updating will be associated to a given process and therefore only a single machine.
• If tools are assigned to multiple program groups, it is not determinate which process they will end up assigned to. This should be reviewed manually after the upgrade.
• Downgrading after installing this upgrade will result in a loss of data (tool and program assignments will be removed), so make sure to take a backup of the OnTakt database before upgrading to this version.

Breaking changes

Functionality

• Program groups have been removed and more or less replaced by processes.
• Tools cannot be directly assigned to programs or processes; they must be placed into an assembly and then the assembly can be assigned to a process.
• When sorting the tools table by usage, tools without a part life set are now treated as having an infinite part life
• Restoring database backups is no longer allowed via the API. Use the service management panel instead.
• Now only administrators can change the time zone and global shift time options. Machine-specific shift times can still be set by planners

Data model

• Tools no longer have a location directly; this must be set on their assembly.
• part_count_cv can no longer be set on a machine directly; it must be set on a process.
• time_per_part, cv_map, parts_per_cycle, and part_count_cv can no longer be set on programs directly; they must be set on a process.
• Tools no longer have a redundant monitoring property. If the monitoring_dest property is set to a non-null value, monitoring is enabled.
• The ToolOrderItem type has been renamed to InventoryItem.
• The order_item and order_item_id properties of the Tool type have been renamed to inventory_item and inventory_item_id.

API changes

• /api/parts now allows specifying multiple machines, and the preferred parameter name is now machine_id instead of machine.
• Added /api/parts/:id for getting details of a single part.
• The tmac_3 field has been removed from the Machine type. OnTakt has not supported TMAC MP for over a year.
• The inspection_part_id field has been removed from the Part type. Parts are now referenced from the Inspection side
• Removed /api/parts/withVariables. Use /api/parts with variable parameter(s) instead.
• Deprecated the day parameter of /api/parts, and it may be removed in a future server update. Use the new start and end parameters instead
• Demo machines must now have the demo system type explicitly selected in machine settings.
• The goals data item returned by /api/machines/:id/chart is now an array of arrays instead of an object.
• /socket/proxy/:machineId/:dataSrc has been removed. Use the new /socket/proxy with tagged messages instead. The proxy now uses a single socket communicate with the server for all machines instead of one per machine and TMAC unit to reduce the number of concurrent network connections each must maintain.
• MTConnect XML parsing now happens on the proxy instead of the server. This should not change any behavior and offers the benefit of increased performance, but there may be unforeseen inconsistencies in data handling
• Removed /api/program_groups/...
• Moved GET /api/programs/variables to GET /api/processes/variables
• Replaced GET /api/tools/replacements/program/:id with GET /api/tools/replacements/process/:id
• Removed POST /api/parts/scrap; call POST /api/parts/flag with {"scrapped": true} instead.
• The order_item query parameter of GET /api/tools/ has been renamed to inventory_item.
• The order_items field returned by POST /api/tools/inventory/:id/receiveOrder is now called inventory_items

Client 1.4.6, Server 4.6.4

9/21/2022

New features

• All NC alarms can now send notifications, not just those with "ALARM_A" in their name.
• Added buttons in the notifications tab of the options window to send a test message to configured notification channels.
• Users can now edit notes and conditions of previous tool replacements.
• Added a help page describing machine colors.
• New tool types:
  • Boring: Burnisher, Tap, Thread mill
  • Cutting: Ballnose endmill, Chamfer mill, Double chamfer mill, Dovetail, Groover, Radial endmill
  • Durable: Drive, EDM electrode pins, Filter
  • Inserts: Groover, Rougher
  • Other: Hone, Part-off blade
• New icons for existing tool types:
  • Boring: Reamer
  • Cutting: Endmil
• Added good, scrapped, and total part counts to the overview cards on the machines page
• Offer to refresh the page if the server reports a different version after the event bus has reconnected.
• Now you can select along the x-axis of tool replacement life charts to limit the replacements shown in the table.
• Added tool, section, and time increment columns in the TMAC events table on machine production pages.
• Added a dropdown to the tool editor to change which assembly the tool belongs to.
• Internal server changes for better database performance and parity with Inspection
• Field to enter brand of tool order items.
• Field to enter pack quantity of tool order items to round up to a multiple of it when generating orders.
• Simplified order spreadsheet columns.
• When rebuilding durable tools, the location field of the original tool will be moved to the substitute tool.
• Added maintenance module for scheduling repeated maintenance tasks or measurements, and for logging/tracking machine issues
• Added tool life chart to tool replacement history window

Bugs fixed

• Disabled the "Finish" button of the tool replacement wizard while the replacement is submitting to reduce double-submissions.
• When creating tool order items, only the name entered was saved, but now all fields work correctly.
• After creating a tool order item from the inventory tab of the tool editor, the newly created item will once again be selected automatically
• Fixed a bug where good and total part counts would not update correctly in part chart tooltips after navigating between days or scrapping parts.
• Fixed a memory leak on the tools page that caused the browser tab to crash or the browser to reject network requests depending on when the memory limit for the tab was reached.
• Fixed a bug that prevents database changes from being saved when an external notification is sent by the action that made the changes
• Check tool list when adding to assembly to prevent database corruption.
• Start the y-axis of tool life charts at zero
• Fixes an issue where turning the tool history window chart on, off, and back on would freeze the page
• Fixed time rounding in production chart compare mode
• Fixes a bug introduced in client 1.2.0 that caused the tools table Usage column to sort by part count instead of parts remaining. After installing client 1.2.1, it will sort by parts remaining again

Breaking changes

• For API users: Tool.folder has been removed.
• Some server code has been extracted and merged with redundant code from Inspection into WPU, so there may be new bugs introduced for edge cases

Client 1.2.0, Server 4.4.0, Proxy 2.4.0

7/27/2022 This update can take a few minutes longer than usual to install because usage breakdowns for all existing tool replacements must be back-calculated. During this time, OnTakt may not be available. Please keep this in mind while deciding when to install this update.

New features

• Click the pin button for a tool on the tools page to keep it at the top of the table when sorting. The pinned state of a tool is shared across all users.
• Tool replacement breakdowns are saved when the tool is replaced, so the data will not change if the tool is unassigned from programs/groups.
• Durable tool rebuild status is now tracked and can be set in the tool editor or from the rebuild wizard.
• For machines with FANUC controls, the reported program name will now be populated with the program's comment if one is set on the control.

Bugs fixed

Production monitoring

• TMAC alarms are now correctly color-coded in charts.
• Compare mode on part charts now counts all parts between the selected parts, including both endpoints, regardless of their scrapped status.
• The "launch TMAC job editor" button in the event window now works correctly. This only applies to TMAC events recorded after installing server version 4.4.0 and proxy version 2.4.0.
• Part and event editor windows now open reliably when using the buttons in the tables on the machine production pages instead of clicking on the chart.

Reporting

• Production overview (heatmap) windows now clear when opening instead of showing irrelevant data.
• Production overview generation is now more accurate when counting parts produced shortly before or after midnight, and about 53 times faster overall.
• Periodic machine reports sent to Slack/Teams will now be for the current day instead of yesterday.

Tool management

• Favorite tools are now respected by all tool filter modes.
• Tool replacements that index the tool past the number of corners set on the order item will be rejected.

Machine connection

• The current part count is now read at the correct memory address from FANUC controls, so it is no longer necessary to use a macro variable for all programs.
• Alarm names are now read at the correct memory address from FANUC controls, so they will no longer show up missing the first four characters.
• For TMAC alarms, the jobId field will contain the ID of the current job, in addition to the current job field that contains its name.

Breaking changes

• The physical attributes tab of the tool order item editor has been removed. This data is still accessible for reading and writing via the API.
• For API users: /api/tools/replacements/:id/usage has been removed. Read the parts property of returned ToolReplacement objects instead