Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- techdoc:dmsakce [08.02.2025 13:00] – vytvořeno - upraveno mimo DokuWiki 127.0.0.1
+++ techdoc:dmsakce [23.04.2025 12:38] (aktuální) – turych
@@ Řádek 1: / Řádek 1: @@
-==== Speciální akce nad dokumenty v DMS ESO9 ====
+==== Akce nad dokumenty v DMS ESO9 ====
 === Spojování PDF dokumentů ===
 Ve formulářích s DMS lze použít akci na tlačítko, která provede spojení označených PDF dokumentů do jediného. Pokud je některý ze spojovaných PDF dokumentů otočen (např. špatným naskenováním), otočí se při spojování správně tak, aby výsledný dokument měl všechny stránky otočené stejně.\\
@@ Řádek 19: / Řádek 19: @@
 <code>
 <input type="button" value="Podepsat digitálně" name="Actx_Eso9lib.CPDFsign" >
+</code>
+=== Digitální podepisování dokumentů formou stored procedury v databázi ===
+Digitální podepsání PDF dokumentů je dostupné (kromě akce na tlačítko ve formuláři, viz výše) i formou stored procedury v aplikační databázi.\\
+Syntaxe stored procedury je následující:\\
+<code>
+CREATE OR ALTER PROCEDURE dbo.SignPDF
+  @sInputFileGUID    NVARCHAR(80)
+ ,@iIDcert           INT
+ ,@MultipleSign      BIT
+ ,@sOutputFileName   NVARCHAR(255)
+ ,@iOutputDocumentID INT           OUTPUT
+ ,@Status            INT           OUTPUT
+ ,@ErrorMessage      NVARCHAR(MAX) OUTPUT
+AS EXTERNAL NAME [PDFSign].[PDFSign].SignPDF
+</code>
+Významy jednotlivých parametrů:\\
+  * //@sInputFileGUID// - identifikátor vstupního (podepisovaného) PDF dokumentu z dokumentové databáze
+  * //@iIDcert//- ID certifikátu použitého pro digitální podpis.
+  * //@MultipleSign// - příznak, zda v případě již existujícího podpisu PDF dokument znovu podepsat dalším podpisem.
+  * //@sOutputFileName// - jméno podepsaného PDF dokumentu, který se zde zakládá. Pokud bude prázdné, vygeneruje se jméno souboru z původního + ".signed.pdf"
+  * //@iOutputDocumentID// - ID nově založeného podepsaného PDF dokumentu.
+  * //@Status// - výsledek volání: 0=OK, -1=chyba.
+  * //@ErrorMessage// - popis chyby.
+Příklad podepsání PDF dokumentu stored procedurou:
+<code>
+DECLARE @InputPDFFileGUID NVARCHAR(80)
+DECLARE @OutputPDFFileName NVARCHAR(255)
+DECLARE @IDCert INT
+DECLARE @MultipleSign BIT = 0
+DECLARE @iOutputDocumentID INT = 0
+DECLARE @Status INT = 0
+DECLARE @ErrorMessage NVARCHAR(MAX)
+-- GUID vstupního PDF souboru
+set @InputPDFFileGUID = 'efa02085-d2fe-4c56-87c4-8799f581d18e'
+-- jméno výstupního souboru - může být prázdné
+set @OutputPDFFileName = ''
+-- ID podepisovacího certifikátu
+set @IDCert = 1
+-- zavolání stored procedury
+EXEC dbo.SignPDF
+    @InputPDFFileGUID,
+    @IDCert,
+    @MultipleSign,
+    @OutputPDFFileName,
+    @iOutputDocumentID OUTPUT,
+    @Status OUTPUT,
+    @ErrorMessage OUTPUT
+-- kontrola výsledku
+IF @Status = 0 -- OK
+BEGIN
+    PRINT 'PDF signed successfully!'
+    PRINT 'ID = ' + CAST(@iOutputDocumentID AS NVARCHAR(10))
+END
+ELSE           -- chyba
+BEGIN
+    PRINT 'Error signing PDF: ' + ISNULL(@ErrorMessage, 'Unknown error')
+    PRINT 'Status code: ' + CAST(@Status AS NVARCHAR(10))
+END
 </code>