Delen via

Gegevensproxy met inktanalyse

Zoals vermeld in Overzicht van inktanalyse, onderhoudt de inktanalysetechnologie intern een documentmodel op basis van een structuur om analyseresultaten en relaties te bevatten. Als uw toepassing al een bestaand documentarchief heeft dat anders is, moet u gebruikmaken van de inktanalysefuncties die zijn ontworpen om gegevens te proxyn tussen verschillende documentmodellen.

Typen gegevensproxy

Met de functies van de gegevensproxy kan uw toepassing het volgende doen:

  • Integreer analyseresultatengegevens terug in een bestaand documentmodel.
  • Communiceer vorige resultaten (of status) terug naar de InkAnalyzer-.
  • Communiceer niet-inktstatus in de InkAnalyzer-.
  • Communiceer alleen de minimale set gegevens (zowel de vorige als de niet-inktstatus) die nodig is om de analysebewerking te voltooien.
  • Werk het interne documentmodel van de toepassing eenvoudig bij met analyseresultaten.

Er zijn twee basismethoden voor inktanalysegegevensproxy. De verschillen liggen in de details van wanneer en hoe de synchronisatie tussen de documentmodellen plaatsvindt. Voor de eerste benadering, synchrone update, is het wijzigen van het documentmodel voor inktanalyse vereist wanneer er wijzigingen optreden in het toepassingsdocument. Voor de tweede benadering, bijwerken op aanvraag, moeten alleen de gegevens die worden beïnvloed door wijzigingen in het documentmodel van de toepassing worden doorgegeven aan de InkAnalyzer-. Dat wil gezegd, alleen de gegevens voor de onderdelen van het Documentmodel Inktanalyse die zich in hetzelfde gebied bevinden als wijzigingen in het toepassingsdocument, moeten worden doorgegeven aan de InkAnalyzer- zoals deze nodig zijn.

Synchrone update

Voor de synchrone updatemethode is het wijzigen (maken en verwijderen) van knooppunten in de InkAnalyzer verzameling van ContextNode--objecten vereist wanneer deze zich in het toepassingsdocument voordoen. Telkens wanneer een tekstwoord wordt toegevoegd aan de toepassing, wordt er bijvoorbeeld een bijbehorende TextWord- gestijld ContextNode- gemaakt in de InkAnalyzer-. Als de locatie van het tekstwoord op de pagina verandert, wordt de locatie van de bijbehorende ContextNode tegelijkertijd bijgewerkt. Deze methode is minder efficiënt in termen van computingresources dan de on-demand methode, omdat elke documentwijziging een update naar de InkAnalyzer-omvat, zelfs als de wijziging niet van invloed is op de geanalyseerde inkt.

Het volgende voorbeeld is bedoeld om te laten zien hoe synchrone update werkt. Stel dat een toepassing een bestaand documentmodel heeft. Wanneer de eindgebruiker een wijziging aanbrengt in het document, zoals het toevoegen van nieuwe tekst, wordt de wijziging als volgt verwerkt:

  1. De eindgebruiker maakt de nieuwe gegevens.
  2. De toepassing bepaalt hoe de gegevens moeten worden verwerkt, opgeslagen en weergegeven.
  3. Voor praktische doeleinden worden de volgende stappen gelijktijdig uitgevoerd.
    1. De toepassing plaatst de gegevens in het documentmodel.
    2. De toepassing maakt een InkAnalyzer- en werkt deze bij. Dit zorgt er tegelijkertijd voor dat de InkAnalyzer- altijd de meest recente informatie heeft.
    3. De toepassing roept BackgroundAnalyze- aan op de InkAnalyzer- om te beginnen met analyseren.
  4. Er wordt een reeks gebeurtenissen geactiveerd als de wijziging inkt omvat en de InkAnalyzer- nieuwe resultaten bepaalt. Er wordt één gebeurtenis geactiveerd voor elke wijziging die is aangebracht in de verzameling van ContextNode objecten in de InkAnalyzer-. Deze gebeurtenissen omvatten ContextNodeCreated, ContextNodeDeleting, ContextNodeMovingToPosition, ContextNodePropertiesUpdated, ContextNodeLinkAdding, ContextNodeLinkDeletingen ContextNodeReparenting. De toepassing verwerkt deze gebeurtenissen om de resultaten van de analysebewerking zo nodig weer door te geven aan het documentmodel.
  5. De toepassing werkt de indeling van het document bij en haalt de nieuwe gegevens op uit het documentmodel.
  6. De nieuwe gegevens worden teruggezet naar de eindgebruiker.

Update op aanvraag

Voor de benadering op aanvraag moeten alleen de gegevens worden doorgegeven voor die ContextNode objecten die zich in de gebieden bevinden die worden geanalyseerd. De benodigde ContextNode objecten worden geëxtraheerd uit het documentmodel van de toepassing net nadat de analysebewerking is aangeroepen, en nogmaals vlak voordat de resultaten worden afgestemd. Hoewel het ingewikkelder is om te implementeren dan synchrone updates, levert deze aanpak betere prestatieresultaten op.

Overzicht van inkanalyse

InkAnalyzer Class (C++)

Microsoft.Ink.InkAnalyzer

Microsoft.Ink.ContextNode