OneSpan Sign How To:Document Extraction(.NET SDK)

最近、ドキュメント抽出の使用についていくつか質問があるので、それについてブログを作成するとよいと思いました。機能の使用方法についてブログを書いているときはいつでも、「OneSpan Sign How To」シリーズに入れます。
PDFフォームフィールドの構成
まず最初に、OneSpan Signがそれらをどのように認識できるかという名前のフォームフィールドを持つPDFが必要になります。フォームフィールド名の適切な形式の詳細については、ドキュメンテーション 。以下は、私が使用したPDF文書です。画像のフィールドにフォームのフィールド名を付けて、すべての名前を示しています。
ご覧のとおり、ドキュメントの2つの署名者は「Signer1」と「Preparer1」になります。これらは、以下のコードセクションで使用されるカスタムIDであり、OneSpan Signに各署名者に関連付けるフィールドを知らせます。
コード
したがって、ドキュメントを適切に設定したら、コードを記述できます。このブログでは、C#とOneSpan Sign .NET SDKを使用します。以下に、上記のサンプルPDFに使用したコードを示します。
システムの使用; System.IOを使用します。 Silanis.ESL.SDKを使用; Silanis.ESL.SDK.Builderを使用; System.Diagnosticsを使用します。 名前空間CreateAndSendPackage { クラスCreateAndSendPackage { プライベート静的文字列apiUrl = "https://sandbox.esignlive.com/api"; プライベート静的文字列apiKey = "YOUR_API_KEY"; public static void Main(string [] args) { EslClient eslClient = new EslClient(apiKey、apiUrl); FileStream fileStream1 = File.OpenRead( "C:/PATH_TO_FILE/sampleDocumentExtract.pdf"); DocumentPackage superDuperPackage = PackageBuilder.NewPackageNamed( "Test Document Extraction") .WithSettings(DocumentPackageSettingsBuilder.NewDocumentPackageSettings()) .WithSigner(SignerBuilder.NewSignerWithEmail( "signer.email @example .com ") .WithFirstName( "ジョン") .WithLastName( "スミス") .WithCustomId( "Signer1") ) .WithSigner(SignerBuilder.NewSignerWithEmail( "preparer.email @example .com ") .WithFirstName( "Michael") .WithLastName( "ウィリアムズ") .WithCustomId( "Preparer1") ) .WithDocument(DocumentBuilder.NewDocumentNamed( "testDocumentExtraction") .FromStream(fileStream1、DocumentType.PDF) .EnableExtraction() ) .Build(); PackageId packageId = eslClient.CreatePackage(superDuperPackage); eslClient.SendPackage(packageId); } } }
この例のコードは非常に単純で、この機能だけに関連付けられている部分はさらに単純です。それぞれの「WithSigner」呼び出しで、カスタムIDが、前にブログで示したPDFフォームの画像のIDと一致することがわかります。.WithDocumentには、"EnableExtraction"への呼び出しもあります。これが行われるため、署名の場所を定義する必要がなく、誰がドキュメントに署名する必要があるかがわかります。これは、PDFのIDと関連するフォームフィールド名ですでに処理されています。
それはどのようなものか
このコードを実行すると、署名者ごとに適切なフィールドを持つパッケージが作成されます。これは、Signer1が表示するものです。
ご覧のとおり、ユーザーが入力できるように必須フィールドが強調表示されています。名前フィールドは、署名が完了するとOneSpan Signによって自動的に入力されます。同様に、作成者はこれを確認します。
そこにあります。署名プロセスは、パッケージで定義したとおりに行われます。読んでくれてありがとう!質問がある場合や、ブログで取り上げてもらいたいトピックがある場合は、コメントセクションに投稿してください。