dynamics_get_audit_history
Retrieve audit history records from Dynamics CRM to track system changes, user activities, and data modifications for compliance and troubleshooting.
Instructions
Consulta histórico de auditoria do sistema
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "dynamics_get_audit_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entityLogicalName | No | ||
| userId | No | ||
| top | No | ||
| operation | No | all |
Implementation Reference
- src/tools/telemetry/index.ts:322-358 (handler)The handler function for 'dynamics_get_audit_history' that queries the Dynamics API for audit records based on input filters.
server.tool( "dynamics_get_audit_history", "Consulta histórico de auditoria do sistema", GetAuditHistorySchema.shape, async (params: z.infer<typeof GetAuditHistorySchema>) => { const filters: string[] = []; if (params.entityLogicalName) { filters.push(`objecttypecode eq '${params.entityLogicalName}'`); } if (params.userId) { filters.push(`_userid_value eq '${params.userId}'`); } if (params.operation !== "all") { const opMap: Record<string, number> = { Create: 1, Update: 2, Delete: 3 }; filters.push(`operation eq ${opMap[params.operation]}`); } const result = await client.list("audits", { select: [ "auditid", "objecttypecode", "operation", "action", "_userid_value", "createdon", "changedata", ], filter: filters.length > 0 ? filters.join(" and ") : undefined, orderby: "createdon desc", top: params.top, }); return { content: [ { type: "text" as const, text: `## Histórico de Auditoria\n\nRegistros: ${result.value.length}\n\n${JSON.stringify(result.value, null, 2)}`, }, ], }; } ); - src/tools/telemetry/index.ts:36-41 (schema)Zod schema definition for 'dynamics_get_audit_history' input validation.
export const GetAuditHistorySchema = z.object({ entityLogicalName: z.string().optional(), userId: z.string().optional(), top: z.number().default(50), operation: z.enum(["all", "Create", "Update", "Delete"]).default("all"), });