Last edited by Martin Straka
Jun 15, 2018
Soubor: username_YYYY___0.db
10 tabulek: messages, files, hashes, events, raw_message_data,
raw_delivery_info_data, supplementary_message_data,
certificate_data, message_certificate_data, process_state
Operace čtení, nemění stav db, vrací pouze určitou hodnotu z tabulky:
const Isds::Envelope getMessageReplyData(qint64 dmId) const
vrací obálku zprávy. Vstupem je Id zprávy.
int getMessageType(qint64 dmId) const
vrací typ zprávy (odeslaná/přijatá). Vstupem je Id zprávy.
enum MsgVerificationResult isMessageVerified(qint64 dmId) const
vrací příznak, jestli byla zpráva verifikována. Vstupem je Id zprávy.
bool messageLocallyRead(qint64 dmId) const
vrací true, jestli byla zpráva lokálně přečtena. Vstupem je Id zprávy.
QString descriptionHtml(qint64 dmId, bool verSignature = true) const
vrací HTML popis obálky jako string. Vstupem je Id zprávy a příznak, jestli se mají do výpisu přiřadit i informace o podpisu zprávy.
QString envelopeInfoHtmlToPdf(qint64 dmId, const QString &dbType) const
vrací HTML popis obálky pro generovaní PDF. Vstupem je Id zprávy a typ DS.
QString fileListHtmlToPdf(qint64 dmId) const
vrací HTML popis příloh pro generovaní PDF. Vstupem je Id zprávy.
QString deliveryInfoHtmlToPdf(qint64 dmId) const
vrací HTML popis doručenky pro generovaní PDF. Vstupem je Id zprávy.
QList<Isds::Document> getMessageAttachments(qint64 msgId) const
vrací seznam příloh zprávy. Vstupem je Id zprávy.
QList<AttachmentEntry> attachEntries(qint64 msgId) const
vrací seznam informací o přílohách pro model. Vstupem je Id zprávy.
int getMessageStatus(qint64 dmId) const
vrací stav zprávy. Vstupem je Id zprávy.
QList<qint64> getAllMessageIDsWithoutAttach(void) const
vrací seznam ID zpráv, které nemají staženy přílohy.
QList<qint64> getAllMessageIDs(enum MessageType messageType) const
vrací seznam ID zpráv podle typu zprávy. Vstupem je typ zprávy (odeslaná/přijatá).
QByteArray getCompleteMessageBase64(qint64 dmId) const
vrací RAW zprávy. Vstupem je Id zprávy.
QByteArray getCompleteMessageBase64(qint64 dmId) const
vrací RAW zprávy v base64. Vstupem je Id zprávy.
bool isCompleteMessageInDb(qint64 dmId) const
vrací true, jestli je zpráva stažena včetně příloh a doručenky. Vstupem je Id zprávy.
QByteArray getCompleteMessageRaw(qint64 dmId) const
vrací RAW zprávy. Vstupem je Id zprávy.
QByteArray getDeliveryInfoBase64(qint64 dmId) const
vrací RAW doručenky v base64. Vstupem je Id zprávy.
const Isds::Hash getMessageHash(qint64 dmId) const
vrací strukturu s hash. Vstupem je Id zprávy.
QStringList getMessageForHtmlExport(qint64 dmId) const
vrací informace o zprávě pro export do HTML. Vstupem je Id zprávy.
QStringList getMessageForCsvExport(qint64 dmId) const
vrací informace o zprávě pro export do CSV. Vstupem je Id zprávy.
int getMessageProcessState(qint64 dmId) const
vrací stav zpracování zprávy. Vstupem je Id zprávy.
QByteArray getMessageTimestampRaw(qint64 dmId) const
vrací RAW časové razítko zprávy. Vstupem je Id zprávy..
FilenameEntry msgsGetAdditionalFilenameEntry(qint64 dmId) const
vrací dodatečné informace o zprávě. Vstupem je Id zprávy.
QDateTime msgsVerificationDate(qint64 dmId) const
vrací čas ověření zprávy. Vstupem je Id zprávy.
QJsonDocument getMessageCustomData(qint64 msgId) const
vrací informace o autorovi zprávy ve formátu JSON. Vstupem je Id zprávy.
bool msgCertValidAtDate(qint64 dmId, const QDateTime &dateTime, bool ignoreMissingCrlCheck = false) const
vrací true jestli vyprší platnost podpisu zprávy do určeného data. Vstupem je Id zprávy, datum do vypršení a něco.
int msgsUnreadWithin90Days(enum MessageType type) const
vrací počet nepřečtených zpráv, které nejsou starší 90ti dnů. Vstupem je orientace zprávy.
int msgsUnreadInYear(enum MessageType type, const QString &year) const
vrací počet nepřečtených zpráv korespondujících s časem dodání. Vstupem je orientace zprávy a rok dodání.
MsgId msgsMsgId(qint64 dmId) const
vrací id a čas dodání zprávy. Vstupem je Id zprávy.
QList<ContactEntry> uniqueContacts(void) const
vrací seznam unikátních kontaktů získaných ze zpráv v databázi.
QList<MsgId> getAllMessageIDsFromDB(void) const
vrací seznam zpráv (ID) všech zpráv.
QList<qint64> getAllMsgsIDEqualWithYear(const QString &year) const
vrací seznam zpráv (ID), jejíchž datum dodání odpovídá zadanému roku. Vstupem je rok dodání zprávy.
QList<MsgId> msgsDateInterval(const QDate &fromDate, const QDate &toDate, enum MessageDirection msgDirect) const
vrací seznam zpráv (ID), jejíchž datum dodání je v zadaném intervalu. Vstupem je interval datumů a orientace zpráv.
SoughtMsg msgsGetMsgDataFromId(const qint64 msgId) const
vrací dodatečné informace o zprávě. Vstupem je Id zprávy a ID datové schránky.
bool isRelevantMsgForImport(qint64 msgId, const QString databoxId) const
vrací true jestli zpráva je adekvátní pro import do zvoleného účtu. Vstupem je Id zprávy a ID datové schránky.
QList<SoughtMsg> msgsAdvancedSearchMessageEnvelope(qint64 dmId, const QString &dmAnnotation, const QString &dbIDSender, const QString &dmSender, const QString &dmAddress, const QString &dbIDRecipient, const QString &dmRecipient, const QString &dmSenderRefNumber, const QString &dmSenderIdent, const QString &dmRecipientRefNumber, const QString &dmRecipientIdent, const QString &dmToHands, const QString &dmDeliveryTime, const QString &dmAcceptanceTime, enum MessageDirection msgDirect) const
vrací seznam zpráv (částečné informace z obálky), které odpovídaly vyhledávacím kriteriím. Vstupem je Id zprávy a různé položky z obálky.
Operace, které vrací seznamy zpráv pro zvolené složky ze seznamů účtů.
QList<RcvdEntry> msgsRcvdEntries(void) const
QList<RcvdEntry> msgsRcvdEntriesWithin90Days(void) const
QList<RcvdEntry> msgsRcvdEntriesInYear(const QString &year) const
QStringList msgsYears(enum MessageType type, enum Sorting sorting) const
QList< QPair<QString, int> > msgsYearlyCounts(enum MessageType type, enum Sorting sorting) const
QList<SntEntry> msgsSntEntries(void) const
QList<SntEntry> msgsSntEntriesWithin90Days(void) const
QQList<SntEntry> msgsSntEntriesInYear(const QString &year) const
Operace, které modifikují obsah tabulek, mění stav databáze:
bool setMessageLocallyRead(qint64 dmId, bool read = true)
Nastavuje příznak přečtenosti u zprávy. Vstupem je Id zprávy a stav přečtenosti zprávy (true = lokálně přečteno). Vrací true, jestli se operace provedla úspěšně.
bool insertMessageEnvelope(const Isds::Envelope &envelope, const QString &_origin, enum MessageDirection msgDirect)
Vloží obálku zprávy do databáze. Vstupem je struktura popisující obálku zprávy, doplňující informace o obálce a orientaci zprávy (odeslaná/přijatá). Vrací true, jestli se operace provedla úspěšně.
bool updateMessageEnvelope(const Isds::Envelope &envelope, const QString &_origin, enum MessageDirection msgDirect)
Aktualizuje existující obálku zprávy v databázi. Vstupem je struktura popisující obálku zprávy, doplňující informace o obálce a orientaci zprávy (odeslaná/přijatá). Vrací true, jestli se operace provedla úspěšně.
bool msgsUpdateMessageState(qint64 dmId, const QString &dmDeliveryTime, const QString &dmAcceptanceTime, int dmMessageStatus)
Aktualizuje stav a informace o doručení zprávy v databázi. Vstupem je Id zprávy, čas dodání, čas doručení a stav právy. Vrací true, jestli se operace provedla úspěšně.
bool insertOrUpdateMessageAttachment(qint64 dmId, const Isds::Document &document)
Vloží obálku zprávy do databáze. Vstupem je Id zprávy a struktura popisující soubor přílohy zprávy. Vrací true, jestli se operace provedla úspěšně.
bool deleteMessageAttachments(qint64 dmId)
Odstraní přílohy zprávy z databáze. Vstupem je Id zprávy. Vrací true, jestli se operace provedla úspěšně.
bool insertOrUpdateMessageHash(qint64 dmId, const Isds::Hash &hash)
Vloží nebo aktualizuje hash zprávy v databázi. Vstupem je Id zprávy a struktura nesoucí hash info. Vrací true, jestli se operace provedla úspěšně.
bool insertOrUpdateMessageEvent(qint64 dmId, const Isds::Event &event)
Vloží nebo aktualizuje událost (info o doručení) zprávy v databázi. Vstupem je Id zprávy a struktura nesoucí popis události. Vrací true, jestli se operace provedla úspěšně.
bool insertOrReplaceCompleteMessageRaw(qint64 dmId, const QByteArray &raw, int messageType)
Vloží nebo aktualizuje RAW zprávy v databázi. Vstupem je Id zprávy, raw zprávy a orientaci zprávy (odeslaná/přijatá). Vrací true, jestli se operace provedla úspěšně.
bool insertOrReplaceDeliveryInfoRaw(qint64 dmId, const QByteArray &raw)
Vloží nebo aktualizuje RAW doručenky v databázi. Vstupem je Id zprávy, raw doručenky. Vrací true, jestli se operace provedla úspěšně.
bool updateMessageAuthorInfo(qint64 dmId, enum Isds::Type::SenderType senderType, const QString &senderName)
Aktualizuje dodatečné informace o zprávě v databázi. Vstupem je Id zprávy, typ odesílatele a název odesílatele. Vrací true, jestli se operace provedla úspěšně.
bool msgsDeleteMessageData(qint64 dmId)
Odstraní všechny záznamy o zprávě z databáze. Vstupem je Id zprávy. Vrací true, jestli se operace provedla úspěšně.
bool setMessageVerified(qint64 dmId, bool verified)
Nastaví příznak o ověření podpisu zprávy do databáze. Vstupem je Id zprávy. Vrací true, jestli se operace provedla úspěšně.
bool setMessageProcessState(qint64 dmId, enum MessageProcessState state)
Nastaví příznak o stavu vyřizování zprávy do databáze. Vstupem je Id zprávy. Vrací true, jestli se operace provedla úspěšně.
bool copyCompleteMsgDataToAccountDb(const QString &sourceDbPath, qint64 msgId)
Okopíruje zprávu z jedné databáze do druhé databáze. Vstupem je cesta k cílové databázi a Id zprávy. Vrací true, jestli se operace provedla úspěšně.
bool copyRelevantMsgsToNewDb(const QString &newDbFileName, const QString &year)
Okopíruje zprávy z jedné databáze do druhé databáze podle roku dodání. Vstupem je cesta k cílové databázi a rok dodání zpráv. Vrací true, jestli se operace provedla úspěšně.
bool msgsInsertUpdateMessageCertBase64(qint64 dmId, const QByteArray &crtBase64)
Vloží nebo aktualizuje podepisující certifikát zprávy do databáze. Vstupem je Id zprávy a data certifikátu v base64. Vrací true, jestli se operace provedla úspěšně.
Operace, které nastavují interní příznaky u zpráv.
bool smsgdtSetWithin90DaysReceivedProcessState(enum MessageProcessState state)
bool smsgdtSetReceivedYearProcessState(const QString &year, enum MessageProcessState state)
bool setReceivedMessagesProcessState(enum MessageProcessState state)
bool smsgdtSetWithin90DaysReceivedLocallyRead(bool read = true)
bool smsgdtSetReceivedYearLocallyRead(const QString &year, bool read = true)
bool smsgdtSetAllReceivedLocallyRead(bool read = true)
Operace pro manipulaci s databází:
bool openDb(const QString &fileName, bool createMissing = true)
metoda otevře databázi. Vstupem je název souboru a příznak, jestli se má vytvořit nová prázdná. Vrací true, když se akce provede úspěšně.
bool copyDb(const QString &newFileName)
metoda překopíruje databázi souborů na jiné místo určené cestou v parametru. Vstupem je nová cesta. Vrací true, když se akce provede úspěšně.
Třídy, struktury, enums:
enum MessageType {
TYPE_RECEIVED = 1,
TYPE_SENT = 2
};
enum MsgVerificationResult {
MSG_NOT_PRESENT = 1,
MSG_SIG_OK = 2,
MSG_SIG_BAD = 3
};
class MsgId
class SoughtMsg
class RcvdEntry
class SntEntry
class AttachmentEntry
class ContactEntry
class FilenameEntry