Wprowadzenie możliwości pobierania potwierdzeń dostarczenia dla wysyłki do usługi e-Doręczenia

Zmiany funkcjonalne w wersji 2026.0.0

W wersji 2026.0.0 umożliwiono pobieranie potwierdzeń dostarczenia wysyłki do usługi e-Doręczenia. W tym celu:

• utworzono skrypt C#, umożliwiający pobranie potwierdzenia otrzymania wiadomości z usługi e-Doręczenia oraz zapisanie potwierdzenia.
• przygotowano przykładowy typ obiegu i rozszerzono opis pobierania potwierdzeń dostarczenia oraz zapisywania ich w kontrolce typu Załącznik na tym typie obiegu: oprócz kontrolek „Do:”, „Temat:”, „Treść:”, „Załączniki”, „Wyślij wiadomość” i kontrolki typu Komunikat, skonfigurowanych zgodnie z opisem dostępnym na stronie https://pomoc.comarch.pl/bpm/index.php/dokumentacja/wysylanie-wiadomosci-do-uslugi-e-doreczenia/, dodano następujące kontrolki:
• Pobierz potwierdzenie dostarczenia (identyfikator: Pobierz_potwierdzenie) – to kontrolka typu Własna akcja, po kliknięciu w którą nastąpi pobranie potwierdzenia dostarczenia; należy na niej zaznaczyć opcję „Odśwież po wykonaniu“, która pozwala na przeładowanie dokumentu (zob. Wprowadzenie automatycznego odświeżania karty obiegu po wykonaniu własnej akcji), a następnie zapisanie pliku z bazy w kontrolce typu Załącznik; w ramach kontrolki należy wprowadzić następujący skrypt:

var eDorClient = EDorService.CreateClient();

string messageId = Globals.MainFrame.messageId.Text;

int documentId = Globals.Common.DocumentId ?? 0;

// nazwa (identyfikator) kontrolki załącznik, która ma przechowywać zapisane potwierdzenie

string attachmentControlName = "Potwierdzenie_dostarczenia";

try

{

eDorClient.FetchReceiptEvidence(messageId, documentId, attachmentControlName);

//Globals.MainFrame.Pobierz_potwierdzenie_CSSCRIPT.Text = messageId;

}

catch (Exception ex)

{

throw ex;

}

Powyższy kod C#Script umożliwia pobranie potwierdzenia dostarczenia oraz zapisanie go w kontrolce typu Załącznik „Potwierdzenie dostarczenia“ (identyfikator: Potwierdzenie_dostarczenia);

• • Potwierdzenie dostarczenia (identyfikator: Potwierdzenie_dostarczenia) – to kontrolka typu Załącznik;w kontrolce zostaje dodany dokument PDF potwierdzenia dostarczenia po tym, jak pomyślnie wykonano akcję po kliknięciu w kontrolkę „ Pobierz potwierdzenie dostarczenia“;
• Potwierdzenie dostarczenia (identyfikator: Czy_Potwierdzono) – kontrolka typu Tekst, obserwująca kontrolkę „Pobierz potwierdzenie dostarczenia (identyfikator: Pobierz_potwierdzenie) i samą siebie (jest dodana w polu „Kontrolki powiązane“); dla kontrolki należy wprowadzić następujące zapytania:
  • W polu „Inicjowanie“ po wyborze „SQL OD“:

select 'Nie dokonano sprawdzenia dostarczenia wiadomości.'

• • • W polu „Wzór na wartość“ po wyborze „SQL OD“:

SELECT  
    CASE  
        WHEN EXISTS ( 
            SELECT 1 
            FROM do.DF_WorkCF wcf 
            JOIN do.DF_ConfCFCardDokFlow dko ON wcf.DWC_DKOId = dko.DKO_ID 
            JOIN do.DF_WorkCFBin bin ON wcf.DWC_ID = bin.DWB_DWCID 
            WHERE wcf.DWC_DWDId = @^DocumentId@ 
                -- nazwa (identyfikator) kontrolki załącznik przechowującej potwierdzenie 
                  AND dko.DKO_Name = 'Potwierdzenie_dostarczenia' 
                  AND bin.DWB_Archival = 0 
        ) THEN 'Potwierdzenie jest dostępne do pobrania.' 
        ELSE 'Dostarczenie nie zostało jeszcze potwierdzone.' 
    END

W ramach kontrolki wyświetlana jest informacja dotycząca pobierania potwierdzenia dostarczenia:

• • Jeśli nie wykonano jeszcze własnej akcji z kontrolki „Pobierz potwierdzenie dostarczenia” – wyświetlana jest informacja: „Nie dokonano sprawdzenia dostarczenia wiadomości.”
• Jeśli wykonano własną akcję z kontrolki „Pobierz potwierdzenie dostarczenia” i potwierdzenie zostało poprawnie zapisane w bazie – widoczna jest informacja: „Potwierdzenie jest dostępne do pobrania”
• Jeśli wykonano własną akcję z kontrolki „Pobierz potwierdzenie dostarczenia”, ale potwierdzenie jeszcze nie istnieje w bazie – widoczna jest informacja: „Dostarczenie nie zostało jeszcze potwierdzone.“