Doclets en variabelen

Rapportpackages bestaan uit subcomponenten die doclets, verwijzingsdoclets, verwijzingsbestanden en aanvullende doclets worden genoemd. Daarnaast kunnen verwijzingsdoclets en verwijzingsbestanden als bron voor variabelen worden gebruikt.

  • Doclets

    Doclets (ook wel normale doclets genoemd) bevatten de inhoud die u nodig hebt voor het rapport dat u met een rapportpackage van Narrative Reporting maakt. Een rapportpackage kan bestaan uit een of meer doclets. Word-rapportpackages bevatten Word-doclets en PowerPoint-rapportpackages bevatten PowerPoint-doclets. Op PDF gebaseerde rapportpackages bevatten op Word en Excel gebaseerde doclets, samen met PDF-bestanden. Alleen de Word- en Excel-doclets kunnen echter worden samengesteld.

    Word- en PowerPoint-documenten die zijn opgeslagen in mappen in de bibliotheek van Narrative Reporting, kunnen aan rapportpackages worden toegevoegd als gekoppelde normale doclets. Een gekoppelde normale doclet onderhoudt een persistente koppeling met het bronbibliotheekdocument. Wanneer het bibliotheekdocument wordt bijgewerkt, worden in Narrative Reporting automatisch alle doclets bijgewerkt die aan het bibliotheekdocument zijn gekoppeld. Het docletbestand wordt in Narrative Reporting bijgewerkt totdat de docletkoppeling wordt gedeactiveerd.

    Doclets maken volledig deel uit van de rapportpackageworkflow, inclusief alle auteursfasen, controlefasen, aftekenen en rapportpublicatie.

  • Verwijzingsdoclets

    Verwijzingsdoclets kunnen worden gebruikt om inhoud in op te slaan, bijvoorbeeld benoemde bereiken uit een Excel-bestand, of diagrammen en grafieken die zijn gemaakt in Reports. Deze inhoud kan door een of meer doclets in een rapportpackage worden gebruikt.

    Op Excel gebaseerde verwijzingsdoclets zijn Excel-bestanden die dienen als ondersteunende bestanden met inhoud, zoals Oracle Smart View for Office-rasters of -formulieren, of statische Excel-inhoud, die u kunt registreren en vervolgens direct in op Word gebaseerde doclets insluiten. U geeft de insluitbare inhoud op met Namen beheren van Excel en vervolgens registreert u de benoemde bereiken in Smart View.

    Op Reports gebaseerde verwijzingsdoclets bestaan uit tabellen en diagrammen die zijn gemaakt en geregistreerd als beschikbare inhoud in de webinterface van Narrative Reporting.

    U kunt inhoud van deze twee soorten verwijzingsdoclets direct insluiten in op Word gebaseerde doclets. Met het insluiten worden de lay-out en het formaat van de inhoud behouden in de doeldoclet, net als in de bronverwijzingsdoclet.

    Zowel op Excel als op Reports gebaseerde verwijzingsdoclets kunnen in Word-rapportpackages worden opgenomen. Ingesloten inhoud wordt samengevoegd in het gecombineerde rapport en er kan een toelichting bij worden geplaatst tijdens de controlefase.

    In Smart View ondersteunen de op Excel gebaseerde verwijzingsdoclets het inhoudbeheer en de workflowfuncties van de auteursfase als volgt:

    • Verwijzingsdoclets kunnen worden uitgecheckt, gewijzigd, geladen, ingecheckt, ter goedkeuring verstuurd en goedgekeurd of afgewezen.

    • Op Word gebaseerde doclets kunnen worden uitgecheckt, gewijzigd, geladen, ingecheckt, ter goedkeuring verstuurd en goedgekeurd of afgewezen.

    • Ingesloten inhoud kan worden gesynchroniseerd met updates van benoemde bereiken in de verwijzingsdoclet.

    • Ingesloten inhoud kan worden vernieuwd.

    De workflow voor op Reports gebaseerde verwijzingsdoclets wordt beheerd in de webinterface van Narrative Reporting. Deze inhoudsmanagement- en workflowfuncties van de auteursfase worden echter als volgt ondersteund in Smart View:

    • Op Word gebaseerde doclets kunnen worden uitgecheckt, gewijzigd, geladen, ingecheckt, ter goedkeuring verstuurd en goedgekeurd of afgewezen.

    • Ingesloten inhoud kan worden gesynchroniseerd met updates van benoemde bereiken in de verwijzingsdoclet.

    • Ingesloten inhoud kan worden vernieuwd.

    Bij verwijzingsdoclets zelf kunnen geen toelichtingen worden geplaatst in de controle- of aftekeningsfase. In een doclet kunt u wel een toelichting plaatsen bij de ingesloten inhoud die afkomstig is van verwijzingsdoclets. De ingesloten inhoud is onderdeel van het definitieve gepubliceerde rapport.

  • Verwijzingsbestanden

    Verwijzingsbestanden zijn Excel-werkboeken die rapportinhoud bevatten die u kunt insluiten in een Word-doclet. Het verwijzingsbestand wordt niet aangegeven als onderdeel van het rapportpackage zoals dat met doclets, verwijzingsdoclets en aanvullende doclets gebeurt. Wel wordt dat verwijzingsbestand onderdeel van de eigenschappen van de doclet wanneer u inhoud uit een verwijzingsbestand in een Word-doclet insluit. Wanneer u de Word-doeldoclet uitcheckt, worden met Narrative Reporting wijzigingen bijgehouden die u aanbrengt in het verwijzingsbestand. Vervolgens kunt u de inhoud vernieuwen die u in de doel-Word-doclet hebt ingesloten.

    Bij verwijzingsbestanden zelf kunnen geen toelichtingen worden geplaatst in de controle- of aftekeningsfase. In een Word-doclet kunt u wel een toelichting plaatsen bij de ingesloten inhoud die afkomstig is van verwijzingsbestanden. De ingesloten inhoud is onderdeel van het definitieve gepubliceerde rapport.

  • Aanvullende doclets

    Aanvullende doclets zijn documenten die bijdragen aan de ontwikkeling van het algehele rapport, zoals bronbestanden en ondersteunende bestanden. Aanvullende doclets kunnen Office-bestandssoorten zijn, zoals Excel, Word of PowerPoint of niet-Office-bestandssoorten, zoals PDF, TXT of ZIP. Inhoud van aanvullende doclets wordt niet samengevoegd in het gecombineerde rapport.

    Aanvullende doclets van elk bestandssoort kunnen in zowel op Word gebaseerde als op PowerPoint gebaseerde rapportpackages worden opgenomen. Bijvoorbeeld: aanvullende Word-doclets kunnen worden opgenomen in Word- of PowerPoint-rapportpackages.

    In Smart View ondersteunen aanvullende doclets het inhoudbeheer en de workflowfuncties van de auteursfase als volgt:

    • Op Office gebaseerde aanvullende doclets kunnen worden uitgecheckt, gewijzigd, geladen, ingecheckt, ter goedkeuring verstuurd en goedgekeurd of afgewezen.

    • Voor aanvullende doclets van niet-Office-bestandssoorten wordt in Smart View aan toegewezen auteurs gemakkelijk toegang verleend om bestanden te downloaden en te bekijken. Alle andere interacties met de bestanden, zoals uitchecken, uploaden en inchecken, moeten worden uitgevoerd via de webinterface van Narrative Reporting.

    Bij aanvullende doclets van een willekeurig bestandssoort kan geen toelichting worden geplaatst in de controle- of aftekeningsfase en aanvullende doclets maken geen deel uit van het definitieve gepubliceerde rapport.

  • Variabelen

    Rapportpackagevariabelen bieden gecentraliseerd beheer van tekst, getallen, datums en gegevens die in meerdere doclets in een rapportpackage worden weergegeven. Met variabelen kunnen doclets ook naar elkaars inhoud verwijzen. Er kunnen bijvoorbeeld Excel-gegevens vanuit een verwijzingsdoclet in een Word-doclet worden ingevoegd.

    Er zijn twee soorten variabelen beschikbaar:

    • Statische variabelen maken gebruik van statische invoer die door de gebruiker is gedefinieerd, zoals datumlabels of een ingestelde waarde, en die in het hele rapportpackage kan worden gebruikt. Deze statische variabelen kunnen gemakkelijk worden bijgewerkt en de wijziging wordt in alle instances van de waarde van de variabele in de doclet doorgevoerd. Met behulp van statische variabelen kunnen gemeenschappelijke datums, getallen en tekst in de hele documentinhoud van het rapportpackage centraal worden onderhouden.

    • Verwijzingsvariabelen worden gemaakt door naar een andere doclet in het rapportpackage te verwijzen als de bron, en de waarde voor de variabele te selecteren, bijvoorbeeld de tekst in een Word-alinea of de waarde van een Excel-cel. Als het brondocument hierna wordt bijgewerkt, worden die wijzigingen automatisch doorgevoerd in de ingevoegde instances van de variabele in het rapportpackage. U kunt verwijzingsvariabelen gebruiken om Excel-celwaarden in te voegen in een alinea in een Word-doclet of om Excel-formules te maken voor de implementatie van "cross-footing"-regels voor een grotere nauwkeurigheid van de gegevens, of om richting-aanduidende woorden te maken voor de tekst van het rapport, zoals "stijging" of "daling".