Skip to content

GitLab

Datovka
Datovka

messages db

Last edited by Martin Straka
Page history 
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