Neo4j Verify Service SetupInstall

Overview

This node verifies whether a specified service in a Neo4j database has all the necessary configurations completed to accept bookings. It checks the service's existence, booking mode, duration, linked business hours, staff availability, and required resource setup. This verification helps ensure that the service is fully prepared before enabling appointment scheduling or booking functionalities.

Common scenarios for this node include:

• Validating service readiness during setup or deployment of a booking system.
• Automating checks in workflows to prevent incomplete services from being offered to customers.
• Generating recommendations for missing configurations to guide administrators on what needs to be fixed.

For example, if you have a service identified by a service ID and want to confirm it is properly linked to a business, has defined business hours, assigned staff with availability, and required resources configured, this node will perform those checks and output a detailed status report.

Properties

Output

The node outputs a JSON object containing detailed verification results about the service setup:

• service: Information about the service including:

  • id: The service ID.
  • name: The service name.
  • duration: Duration of the service in minutes.
  • bookingMode: The booking mode (e.g., StaffOnly, ResourceOnly, StaffAndResource).

• businessHours: Status of business hours setup:

  • isComplete: Boolean indicating if business hours are configured.
  • issues: Array of issues found related to business hours.

• staffSetup: Status of staff assignment and availability:

  • isComplete: Boolean indicating if staff setup is complete.
  • issues: Array of issues related to staff availability.
  • details: Optional detailed info about each staff member’s availability.

• resourceSetup: Status of resource requirements:

  • isComplete: Boolean indicating if resource types and instances are properly set.
  • issues: Array of issues related to resource configuration.
  • details: Optional detailed info about each resource type.

• overallStatus: A string indicating overall readiness, either "ready" or "incomplete".

• recommendations: An array of suggestions to fix any detected issues.

If the node detects incomplete setups, it marks the overall status as "incomplete" and provides actionable recommendations.

Dependencies

• Requires connection credentials to a Neo4j database, including host, port, username, password, and optionally database name.
• Uses the official Neo4j driver to connect and query the database.
• Requires proper permissions to read service, business, staff, and resource data in the Neo4j instance.

Troubleshooting

• Neo4j credentials not fully configured: Ensure all required fields (host, port, username, password) are correctly set in the node credentials.
• Service not found or not linked to a business: Verify the provided service ID exists and is connected to a business node in Neo4j.
• Booking mode or duration not set: Confirm these properties are defined for the service in the database.
• Business hours missing: Check that the business linked to the service has at least one business hour entry.
• No staff linked or no availability set: For booking modes involving staff, ensure staff members are linked to the service and have availability schedules.
• Resource types missing or improperly configured: For booking modes involving resources, verify resource types are linked and have valid total capacity and instances created.

Errors thrown by the node typically indicate which part of the setup is incomplete or misconfigured, guiding users to correct the underlying data in Neo4j.

Links and References

• Neo4j Official Documentation
• Neo4j JavaScript Driver
• n8n Documentation