基于Square9 GlobalCapture SDK的C#自定义工作流节点开发学习方向求助

Hey there! Let's break down what you need to learn to get your Square9 GlobalCapture custom node up and running—especially that PDF-to-JPG conversion you're working on. I'll start with the immediate error you're hitting, then walk through the core areas to focus on.

First, that The method or operation is not implemented error you're seeing? It's likely because you're calling methods from the CaptureNode base class that either aren't properly initialized in your setup, or you're missing required implementation steps the SDK expects. Let's start with the fundamentals:

1. Square9 CustomNode SDK Core Concepts #

• Master the CaptureNode Base Class: Your Convert class inherits from CaptureNode, but you're only overriding the Run() method right now. Dig into the SDK docs to understand what mandatory methods you need to implement (like Initialize() for configuration setup) and which base class methods are safe to call. The example repo you're using shows working implementations—study how those nodes structure their class overrides.
• Understand the Process & Document Object Lifecycle: The Process.Document object has strict rules for how you interact with it. Methods like GetPage() or AddPage() might require specific prerequisites (like valid document state, or proper handling of file paths in the Square9 environment). Start by replicating simple actions from the example repo (like logging document metadata) before trying to modify pages.

2. C# Basics Tailored to This Project #

Since you're new to C#, focus on these project-specific skills:

• Class Inheritance & Method Overriding: You need to grasp how base classes work, which methods you're required to override, and how to safely extend them. The "not implemented" error could stem from missing a required override or misusing base class functionality.
• Error Handling & Logging: Square9 relies on proper exception handling to report node issues. Add try/catch blocks to your Run() method to capture detailed errors, and use LogHistory() to output meaningful debug info (like exception messages) instead of generic test text.
• External Library Integration: You're using Syncfusion for PDF conversion—learn how to properly reference NuGet packages in your project, and how to dispose of resources like PdfLoadedDocument or Bitmap to avoid memory leaks (critical for long-running workflow nodes).

3. Square9 Workflow Node Development Best Practices #

• Start with a Minimal Working Node: Don't jump straight to PDF conversion. First build a node that only logs a success message and runs without errors. Once that works, incrementally add small features (like retrieving a document ID, then a page path) to validate each step.
• Respect the Square9 Execution Environment: Custom nodes run in a restricted context—you can't assume full access to system file paths or resources. Check the knowledge base docs for rules on file handling, library compatibility, and resource limits.
• Test Syncfusion Code Separately: Before integrating PDF-to-JPG logic into your node, build a standalone C# console app that uses Syncfusion to convert a local PDF to JPG. Confirm that works first—this isolates whether issues come from Syncfusion or the Square9 SDK.

4. Debugging Square9 Custom Nodes #

• Enable Detailed Logging: The Square9 web app has debug logging options—check the knowledge base to turn these on. This will give you more specific error details than the generic "not implemented" message.
• Iterate with Small Deployments: Every time you make a tiny code change, deploy and test the node. This makes it easy to pinpoint exactly which line or method is causing the error.

Quick Tweak to Your Current Code #

To start troubleshooting, simplify your Run() method to focus on safe logging and basic document interaction:

public override void Run()
{
    try
    {
        LogHistory("Custom Node initialized successfully");
        // Test basic document metadata access first
        var documentId = Process.Document.Id;
        LogHistory($"Processing document with ID: {documentId}");
    }
    catch (Exception ex)
    {
        LogHistory($"Error encountered: {ex.Message}\n{ex.StackTrace}");
        throw; // Re-throw to let Square9 handle the exception properly
    }
}

This will help you confirm if the node can run without errors before adding the PDF conversion logic.

内容的提问来源于stack exchange，提问作者Reals