Nexeed
    • Introduction
    • User manual
      • General descriptions
        • Result lists
        • Scope Concept
      • Basic setup
        • Connection management
        • Scope Management
          • Configuration Scopes
          • Reporting Scopes
      • Traceability
        • Types of evaluations
        • Search Forms for creating an evaluation
        • Part Protocol
          • Quick Search
          • Extended Search
          • Part View
          • Process View
          • Component View
          • Part Information
          • Process Information
        • Forward Search
          • Quick Search
          • Extended Search
        • Backward Search
        • Tool Usage
        • Packaging Information
          • Quick Search
          • Extended Search
      • Archiving
        • Enable archiving
        • Monitoring
      • Quality Gate
        • Types of Quality Gate Checks
        • Working with Test Specifications
        • Testing of Test Specifications
          • Basic test client
          • Expert test client
          • JSON based test client
      • Terms and definitions
        • Archiving states
        • Connection states
        • Packaging data
        • Part blocks
        • Process data
        • SPC session data
        • Test Specifications
    • Operations manual
      • Overview
      • System architecture and interfaces
        • Data Collector Service
        • Data Browser Service
        • Archiving Bridge Adapter Service
        • Configuration Service
        • Quality Gate Service
        • Reporting Service
        • Quality Database (QDB)
        • Archiving Bridge Adapter Service database
      • System requirements
      • Migration from previous versions
        • Migration from MES QualityData
        • Part Traceability upgrades
      • Setup and configuration
        • Base configuration
        • Quick start configuration
        • Application and service account roles
        • Scope-based configurations
        • Data Collector Service
        • Data Browser Service
        • Archiving Bridge Adapter Service
        • Reporting Service
        • Quality Database (QDB)
        • Module database
        • Archiving Bridge Adapter Service database (QDAB)
        • Resources in Part Traceability
        • Dos and don’ts in databases
      • Start and shutdown
      • Regular operations
      • Failure handling
      • Backup and restore
      • Logging and monitoring
      • Known limitations
    • Developer documentation
      • Deep Dives
        • Forwarding via Data Publisher
        • Resolving of Scopes
      • Quality Gate Checks
        • Structuring of Test Specifications
        • Input and output parameters
          • Check Block List
          • Check Complete (location based)
          • Check Complete (process based)
          • Check Component
          • Bypass Check Complete
          • Check Trace Mapping
          • Check Characteristics
      • Troubleshooting
    • API documentation
      • Data Browser Service
      • Data Collector Service
        • Structure and content of telegrams
          • basicInfo
          • partDetails
          • componentTrace
          • additionalInfo
          • packaging
      • Quality Gate Service
      • Archiving Bridge Adapter Service
    • Glossary
Part Traceability
  • Industrial Application System
  • Core Services
    • Block Management
    • Deviation Processor
    • ID Builder
    • Multitenant Access Control
    • Notification Service
    • Ticket Management
    • Web Portal
  • Shopfloor Management
    • Andon Live
    • Global Production Overview
    • KPI Reporting
    • Operational Routines
    • Shift Book
    • Shopfloor Management Administration
  • Product & Quality
    • Product Setup Management
    • Part Traceability
    • Process Quality
    • Setup Specs
  • Execution
    • Line Control
    • Material Management
    • Order Management
    • Packaging Control
    • Rework Control
  • Intralogistics
    • AGV Control Center
    • Stock Management
    • Transport Management
  • Machine & Equipment
    • Condition Monitoring
    • Device Portal
    • Maintenance Management
    • Tool Management
  • Enterprise & Shopfloor Integration
    • Archiving Bridge
    • Data Publisher
    • Engineering UI
    • ERP Connectivity
    • Gateway
    • Information Router
    • Master Data Management
    • Orchestrator

Nexeed Learning Portal

  • Part Traceability
  • Developer documentation
  • Troubleshooting

Troubleshooting

This troubleshooting documentation is designed specifically for application engineers and developers. It provides focused guidance on diagnosing and resolving issues encountered during application and integration of Part Traceability.

Troubleshooting details or known limitations that are relevant to end-users or operational procedures are documented separately in the Operations Manual or User Manual.

Test parts create processing issues

Problem description

There are various part types which are processed on the production line repeatedly, leading to an excessive number of entries in the quality database. This behavior causes the content of the Part Protocol growing to a size where it cannot be displayed any longer due to a timeout of the browser.

Proposed solution

Ensure that the Part ID for this component is not reused too frequently. Instead, update the Part ID as needed to prevent an excessive accumulation of entries in the quality database.

Default Configuration Scope is erroneously returned

Problem description

When a scope is created via the API and a part telegram is sent to the Data Collector Service within one second, the caching mechanism (which updates once a second) may inadvertently return the default_config Scope. This issue is most likely to occur in cases where API calls are part of automated tests of modules integrating Part Traceability’s APIs.

Proposed solution

Introduce a delay or verify timestamps to ensure that the cache has been updated before processing the part telegram after the new scope is created.

SAP information is not displayed in Packaging Information

Problem description

The SAP Pallet Number or SAP Box Number are not displayed in the Result List of Packaging Information, even though the information has been sent to Part Traceability and has been persisted in the database.

Proposed solution

Ensure packaging data for a single Part ID has matching types:

  • For a Box, set result type to 0 (Box) and info type to 1 (SAP Box Number).

  • For a Pallet, set result type to 1 (Pallet) and info type to 2 (SAP Pallet Number).

Package ID is not displayed in Packaging Information

Problem description

The Pallet Package ID or Box Package ID is not displayed in the Result List of Packaging Information, even though the information has been sent to Part Traceability and has been persisted in the database.

Proposed solution

The data sent must set a relation between the result id and a childPackageId. There is no need to set a relation between the result id and a partID.

ReadLocationCounter API limitations

Problem description

When using the ReadLocationCounter functionality in Data Browser Service’s public API QueryRds endpoint, passing a locationPath parameter (starting with "LINE…​") results in an error. The API only accepts locationId parameters for retrieving counter data. The current implementation does not support path-based location references.

Proposed solution

Use only numeric location identifiers (locationId) instead of location paths when calling ReadLocationCounter. Any locationPath parameters must be converted to their corresponding locationId values before making the API call.

Connection string reuse across multiple scopes

Problem description

A database connection string cannot be reused across multiple scopes, as this leads to conflicts and unpredictable behavior in the system. Each scope requires its own dedicated connection string to maintain proper data isolation and system stability.

Proposed solution

For production environments, ensure each scope has a unique connection string. For testing purposes, duplicate the connection in _Part Traceability > Configuration > Connection Management and modify the connection string by appending RETRY_DELAY=3 to create a distinct connection identifier while maintaining the same underlying database connection parameters.

Example
DATA SOURCE="(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(RETRY_DELAY=1239)(HOST=ab0orapth043.br.some-company.com)(PORT=38000)))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=SCPY02_app.br.some-company.com)))"

Contents

© Robert Bosch Manufacturing Solutions GmbH 2023-2025, all rights reserved

Changelog Corporate information Legal notice Data protection notice Third party licenses