navigate_to_pim

Instructions

Implementation Reference

• src/tools.ts:184-234 (handler)

  The core handler function for the 'navigate_to_pim' tool. It generates and returns a detailed text response with navigation steps to the PIM page, assuming the user is logged in. Includes error handling.

      async () => {
        try {
          const navigationSteps = [
            "Locate the left-hand navigation menu",
            "Find the 'PIM' menu item in the navigation list",
            "Click on the 'PIM' link to navigate to the PIM module",
            "Wait for the PIM page to load"
          ];
  
          const response = {
            success: true,
            message: "PIM navigation tool executed successfully",
            steps: navigationSteps,
            target_module: "PIM",
            expected_url: "/web/index.php/pim/viewPimModule",
            note: "This tool provides navigation instructions for the PIM module. Requires user to be logged in first."
          };
  
          return {
            content: [
              {
                type: "text",
                text: `PIM Navigation Tool Response:
                
  ✅ Tool: navigate_to_pim
  🎯 Target Module: PIM (Personal Information Management)
  🔗 Expected URL: ${LOGIN_CREDENTIALS.targetUrl}/web/index.php/pim/viewPimModule
  
  📋 Navigation Steps:
  ${navigationSteps.map((step, index) => `${index + 1}. ${step}`).join('\n')}
  
  💡 Note: This tool assumes the user is already logged in and has access to the navigation menu.
  The PIM module provides functionality for managing employee personal information, employment details, and related HR data.
  
  🔧 For browser automation integration, this tool can be extended to:
  - Verify user is logged in before navigation
  - Click the PIM menu item using Playwright
  - Wait for page load confirmation
  - Handle navigation errors or timeouts
  - Provide feedback on successful navigation`
              }
            ]
          };
  
        } catch (error) {
          throw new McpError(
            ErrorCode.InternalError,
            `PIM navigation tool failed: ${error instanceof Error ? error.message : String(error)}`
          );
        }
      }

• src/tools.ts:179-236 (registration)

  The registration function for the 'navigate_to_pim' tool, called with the MCP server instance. Defines the tool name, description, input schema (empty), and inline handler.

  export function registerNavigateToPimTool(server: McpServer): void {
    server.tool(
      "navigate_to_pim",
      "Navigates to the PIM (Personal Information Management) page using the left-hand navigation menu. Assumes user is already logged in.",
      {},
      async () => {
        try {
          const navigationSteps = [
            "Locate the left-hand navigation menu",
            "Find the 'PIM' menu item in the navigation list",
            "Click on the 'PIM' link to navigate to the PIM module",
            "Wait for the PIM page to load"
          ];
  
          const response = {
            success: true,
            message: "PIM navigation tool executed successfully",
            steps: navigationSteps,
            target_module: "PIM",
            expected_url: "/web/index.php/pim/viewPimModule",
            note: "This tool provides navigation instructions for the PIM module. Requires user to be logged in first."
          };
  
          return {
            content: [
              {
                type: "text",
                text: `PIM Navigation Tool Response:
                
  ✅ Tool: navigate_to_pim
  🎯 Target Module: PIM (Personal Information Management)
  🔗 Expected URL: ${LOGIN_CREDENTIALS.targetUrl}/web/index.php/pim/viewPimModule
  
  📋 Navigation Steps:
  ${navigationSteps.map((step, index) => `${index + 1}. ${step}`).join('\n')}
  
  💡 Note: This tool assumes the user is already logged in and has access to the navigation menu.
  The PIM module provides functionality for managing employee personal information, employment details, and related HR data.
  
  🔧 For browser automation integration, this tool can be extended to:
  - Verify user is logged in before navigation
  - Click the PIM menu item using Playwright
  - Wait for page load confirmation
  - Handle navigation errors or timeouts
  - Provide feedback on successful navigation`
              }
            ]
          };
  
        } catch (error) {
          throw new McpError(
            ErrorCode.InternalError,
            `PIM navigation tool failed: ${error instanceof Error ? error.message : String(error)}`
          );
        }
      }
    );
  }

• src/tools.ts:241-246 (registration)

  Helper function that registers all tools, including navigate_to_pim, on the MCP server.

  export function registerAllTools(server: McpServer): void {
    registerPerformLoginTool(server);
    registerGetLoginCredentialsTool(server);
    registerTestConnectionTool(server);
    registerNavigateToPimTool(server);
  }

• src/index.ts:28-28 (registration)

  Top-level call to register all tools (including navigate_to_pim) on the MCP server instance during server initialization.

  registerAllTools(server);

• src/tools.ts:256-256 (helper)

  The navigate_to_pim tool is listed in the getAvailableTools() array for listing available tools.

  "navigate_to_pim"