businessobject-function-test

Execute business object functions with input parameters to test functionality and verify results using real data.

Instructions

#Test a Business Object Function

Execute a business object function with provided input parameters for testing purposes. This allows you to test your functions with real data and see the results.

Common Base Data Type IDs:

String: "22ED1F787B6B0926AB0577860AF7543705341C053EB1B4A74E7CC199A0645E52"
Integer: "B9B1191E0B70BA0845CF4F6A4F4C017594F8BA84FD2F1849966081D53A8C836D"
Boolean: "2788FB5AA776C62635F156C820190D0FD3D558765201881A77382093F7248B39"
Date: "06A9841478D7BE17C423F11C38CD6829E372093DBEC144F2A85FC7165BE8CD80"
Float: "C09139C72F5A8A7E0036BA66CE301748BD617F463683EE03F92EDAAAA4AF8BC7"
Any: "D31053204B4A612390A2D6ECDF623E979C14ADC070A7CB9B08B2099C3011BCAB"

Parameter Usage:

Use parameter "name" if no alias is defined
Use parameter "alias" instead of name if alias is defined in the function
Values must match the expected data type

Error Handling:

Wrong BO/function name → 404 error
Missing required parameters → 400 error
Wrong parameter names → 400/500 error
Invalid parameter values → 400/500 error

Input Schema

TableJSON Schema

Name	Required	Description
`businessObjectName`	Yes
`functionName`	Yes
`inputParameters`	No	Input parameters for the function

Implementation Reference

src/tools/server-businessobject-tools.ts:231-279 (handler)

The handler function for the 'businessobject-function-test' tool. It fetches the function's input parameters, maps provided test values to them, fetches data types, constructs a test request, executes the test via simplifier.testServerBusinessObjectFunction, and formats the success or error response.

}, async ({ businessObjectName, functionName, inputParameters }) => {
  return wrapToolResult(`test Business Object function ${businessObjectName}.${functionName}`, async () => {
    const boParameters = (await simplifier.getServerBusinessObjectFunction(businessObjectName, functionName)).inputParameters

    const testParameters: BusinessObjectTestParameter[]  = await Promise.all(boParameters.map(async cparam => {
      const dataType = await simplifier.getDataTypeByName(cparam.dataType.name)
      return {
        name: cparam.name,
        value: inputParameters.find(p => p.name === cparam.name)?.value,
        dataType: dataType,
        dataTypeId: dataType.id,
        optional: cparam.isOptional,
        transfer: true,
      } satisfies BusinessObjectTestParameter;
    }))

    const testRequest: BusinessObjectTestRequest = {
      parameters: testParameters
    };

    const trackingKey = trackingToolPrefix + toolNameBusinessObjectFunctionTest
    const result = await simplifier.testServerBusinessObjectFunction(businessObjectName, functionName, testRequest, trackingKey);

    // Format the response nicely
    if (result.success) {
      return {
        success: true,
        message: `Function '${functionName}' executed successfully`,
        result: result.result,
        executedWith: {
          businessObject: businessObjectName,
          function: functionName,
          parameters: testParameters.map(p => ({ name: p.name, value: p.value, dataType: p.dataTypeId }))
        }
      };
    } else {
      return {
        success: false,
        message: `Function '${functionName}' execution failed`,
        error: result.error || result.message || "Unknown error",
        executedWith: {
          businessObject: businessObjectName,
          function: functionName,
          parameters: testParameters.map(p => ({ name: p.name, value: p.value, dataType: p.dataTypeId }))
        }
      };
    }
  });
});

src/tools/server-businessobject-tools.ts:217-224 (schema)

Zod input schema for the tool defining parameters: businessObjectName (string), functionName (string), inputParameters (array of {name: string, value: unknown}).

{
  businessObjectName: z.string(),
  functionName: z.string(),
  inputParameters: z.array(z.object({
    name: z.string().describe("Parameter name (or alias if defined)"),
    value: z.unknown().describe("Parameter value - can be any JSON value"),
  })).optional().default([]).describe("Input parameters for the function")
},

src/tools/server-businessobject-tools.ts:215-231 (registration)

Registration of the tool using McpServer.tool() method, specifying name, description, input schema, hints, and handler function.

server.tool(toolNameBusinessObjectFunctionTest,
  functionTestDescription,
  {
    businessObjectName: z.string(),
    functionName: z.string(),
    inputParameters: z.array(z.object({
      name: z.string().describe("Parameter name (or alias if defined)"),
      value: z.unknown().describe("Parameter value - can be any JSON value"),
    })).optional().default([]).describe("Input parameters for the function")
  },
  {
    title: "Test a Business Object Function",
    readOnlyHint: true,
    destructiveHint: false,
    idempotentHint: true,
    openWorldHint: false
  }, async ({ businessObjectName, functionName, inputParameters }) => {

simplifier-mcp