Problemen in bulk importeren

Importeer problemen in bulk als u tijdrovende handmatige gegevensinvoer moet vermijden of gegevens vanuit een ander systeem moet migreren.

U kunt ook meerdere problemen tegelijkertijd bijwerken met behulp van sessies in Bulkimporteerprogramma. Voor meer informatie raadpleegt u Bestaande problemen in bulk bijwerken.

Hoe het werkt

U opent een nieuwe sessie voor Bulkimporteerprogramma en downloadt de Excelsjabloon van de pagina Bulkimporteerprogramma in Launchpad. U bereidt gegevens voor in de sjabloon en uploadt de sjabloon vervolgens op de pagina Bulkimporteerprogramma.

Waar zijn de geüploade problemen?

Zodra u problemen hebt geüpload, zijn de gegevens beschikbaar in:

  • het tabblad Problemen
  • de app Probleemvolger
  • OrganizationName Projectrapport (het definitieve auditrapport)
  • alle downloadbare Problemen-rapporten

Voordat u begint

Voordat u problemen gaat importeren, moet u een project maken via het Bulkimporteerprogramma door het werkblad Projecten in te vullen of via de gebruikersinterface.

Opmerking

Met behulp van het Bulkimporteerprogramma maakt u veel Diligent One-resources in een enkele import. U kunt de werkbladen van alle vereiste bronnen invullen en ze allemaal in één keer importeren.

Workflow

Machtigingen

Alleen systeembeheerders kunnen Diligent One-resources in bulk uploaden vanuit het Bulkimporteerprogramma.

Nieuwe problemen in bulk uploaden

Opmerking

  • Interfacetermen zijn aanpasbaar, en velden en tabbladen zijn configureerbaar. In uw exemplaar van Diligent One zijn sommige termen, velden en tabbladen mogelijk anders.
  • Als een verplicht veld leeg wordt gelaten, verschijnt er een waarschuwingsbericht: dit veld is verplicht. Sommige aangepaste velden kunnen standaardwaarden hebben.

Een nieuwe sessie in Bulkimporteerprogramma openen en de Excelsjabloon downloaden

  1. Open Launchpad.

    Opmerking

    Als uw bedrijf meer dan één exemplaar gebruikt in Launchpad, zorg er dan voor dat het juiste exemplaar actief is.

  2. Selecteer Platform-instellingen > Organisatie.

    Als u Organisatie niet als een optie ziet, heeft het account dat u hebt gebruikt om u aan te melden, geen beheerdersbevoegdheden.

  3. Klik onder Bulkimporteerprogramma op de optie Bulkbronnen beheren.

    Een nieuwe sessie voor Bulkimporteerprogramma begint, met de sessie-ID toegevoegd aan de URL.

    Let op

    Begin altijd een nieuwe sessie om nieuwe bronnen toe te voegen, want anders verliest u mogelijk eerder geüploade gegevens.

    Opmerking

    U kunt eerdere sessies gebruiken om eerder geüploade gegevens bij te werken. Voor meer informatie raadpleegt u Bijwerkfunctionaliteit in het Bulkimporteerprogramma.

  4. Onder Bron selecteren, in het Brontype, selecteert u Alle bronnen.

  5. Klik op .xlsx-sjabloon downloaden.

    De Excelsjabloon wordt opgeslagen op uw lokale machine.

Gegevens voorbereiden in de sjabloon

  1. Open de gedownloade sjabloon (HighBond_Template.xlsx) en ga naar het werkblad Problemen.
  2. Kopieer uw gegevens naar de sjabloon of voer ze in de sjabloon in. Voor hulp bij het invoeren van gegevens raadpleegt u Tips voor het voorbereiden van inhoud.
    Opmerking
    • Als u de Add-in voor Excel gebruikt, zorg er dan voor dat de optie ACL Add-In is uitgeschakeld voordat u de Excelsjabloon wijzigt. Raadpleeg Add-in voor Excel configureren om te lezen hoe dat moet.
    • Wijzig de naam van het werkblad of de velden niet. Deze zijn hoofdlettergevoelig en mogen niet worden gewijzigd.
    • Het maximale aantal rijen dat tegelijkertijd kan worden geüpload is 2000 (in alle werkbladen gecombineerd).
    VeldBeschrijving

    referenceId

    verplicht

    Geeft een unieke ID op voor de bron. Deze moet uniek zijn voor elke rij in het werkblad.

    Kan een combinatie van tekst en nummers bevatten en de maximale lengte is 255 tekens.

    Dit veld is de primaire sleutel voor elke rij in de sjabloon. U hebt deze sleutel nodig als u deze bron weer wilt bijwerken.

    Belangrijk

    U kunt referentie-ID's gebruiken om snel bronnen aan elkaar te koppelen. U kunt bijvoorbeeld een nieuw project maken en een nieuw doel gekoppeld aan dat project in dezelfde upload. Dit kunt u doen door een koppeling te maken tussen het project en het doel door de referenceId op te geven in het vereiste veld.

    Voor meer informatie over het koppelen van HighBond-resources in Bulkimporteerprogramma raadpleegt u Referentie-ID's gebruiken om bronnen te koppelen in Bulkimporteerprogramma.

    Opmerking

    Referentie-ID's zijn vereist wanneer u bronnen toevoegt of bijwerkt met behulp van het Bulkimporteerprogramma. Ze zijn niet beschikbaar wanneer u bronnen toevoegt/bijwerkt vanuit de gebruikersinterface van Diligent One.

    project-ID

    verplicht

    Geeft de ID op van het project waarin dit probleem moet worden geplaatst.

    Bijvoorbeeld:

    https://stark.projects.highbond.com/audits
    /90305/dashboard
    , waarbij 90305 de project-ID is.

    In dit veld kunt u ook de referentie-ID van een nieuw project opgeven die u hebt toegevoegd in de actuele sjabloon. Hiermee wordt het probleem gekoppeld aan het project wanneer u de sjabloon uploadt.

    Voor meer informatie over het koppelen van HighBond-resources in Bulkimporteerprogramma raadpleegt u Referentie-ID's gebruiken om bronnen te koppelen in Bulkimporteerprogramma.

    description

    verplicht

    Geeft de gedetailleerde beschrijving van het probleem aan.

    Tip

    Gebruik HTML-tags om tekst op te maken. Bijvoorbeeld: <b>, <i>, <ol>, <ul>.

    Voor informatie over problemen raadpleegt u Problemen beheren en correctie 

    eigenaar

    voorwaardelijk verplicht

    Geeft de naam of e-mail-ID aan van de persoon die verantwoordelijk is voor het probleem.

    U kunt het beste niet-Diligent One-gebruikers toevoegen in dit veld.

    Dit veld wordt verplicht als ownerUser leeg wordt gelaten.

    ownerUser

    voorwaardelijk verplicht

    Geeft de gebruikers-ID (UID) of e-mail-ID aan van de persoon die verantwoordelijk is voor het probleem.

    Lees hoe u de UID van een gebruiker ophaalt.

    U kunt geen niet-Diligent One-gebruikers toevoegen in dit veld.

    Dit veld wordt verplicht als owner leeg wordt gelaten.

    Let op: als u een ownerUser opgeeft, worden alle waarden die zijn opgegeven in het veld eigenaar overschreven.

    Opmerking

    Zorg ervoor dat de gebruiker die u wilt toevoegen aan dit veld al is toegewezen aan het respectievelijke project/raamwerk.

    Voor meer informatie over het toewijzen van gebruikersrollen raadpleegt u Gebruikersrollen toewijzen in projecten en raamwerken

    Deficiëntietype

    verplicht

    Geeft de classificatie van het probleem aan, bijvoorbeeld aanbevelingen van het management, belangrijke tekortkomingen, materiële zwakheid.

    De beschikbare opties zijn afhankelijk van het projecttype.

    aanbeveling

    Geeft een gedetailleerde beschrijving van de aanbevolen acties die moeten worden ondernomen op basis van het probleem.

    Titel

    Geeft de titel van het probleem aan.

    ernst

    Geeft de intensiteit van het probleem aan.

    De beschikbare opties zijn afhankelijk van het projecttype.

    gepubliceerd

    Geeft de zichtbaarheid van het probleem aan:

    • Waar: zichtbaar voor alle gebruikers.
    • Onwaar: verborgen voor gebruikers waaraan de rol Bijdragertester, Bijdragergebruiker, Supervisie-executive en Supervisiebeoordelaar is toegewezen.

    De standaardinstelling is False.

    identifiedAt

    Geeft het tijdstempel aan waarop het probleem is vastgesteld.

    De standaardinstelling is de actuele datum en tijd.

    reference

    Geeft de ID van het probleem aan.

    risico

    Bevat een gedetailleerde beschrijving van het risico of de impact die het probleem zal hebben.

    escalatie

    Geeft aan bij welke persoon, afdeling of organisatie het probleem moet worden voorgelegd.

    De beschikbare opties zijn afhankelijk van het projecttype.

    oorzaak

    Geeft een gedetailleerde beschrijving van de oorzaak van het probleem.

    effect

    Geeft een gedetailleerde beschrijving van de gevolgen die het probleem voor de organisatie zal hebben.

    Kostenimpact

    Geeft de geschatte of werkelijke geldelijke kosten aan die verband houden met het probleem.

    omvang

    Geeft aan in hoeverre het probleem invloed heeft op de organisatie.

    De beschikbare opties zijn afhankelijk van het projecttype.

    Samenvatting

    Geeft een overzicht van het probleem, waarin doorgaans informatie uit andere gerelateerde gebieden wordt samengevat, zoals risico/impact, oorzaak en gevolg.

    Eigenaar in de rol van executive

    Geeft de uitvoerende eigenaar van het probleem aan.

    Projecteigenaar

    Geeft de projecteigenaar van het probleem aan.

    gesloten

    Geeft de algemene status van het probleem aan:

    • Waar: gesloten.
    • Onwaar: open.

    De standaardinstelling is False.

    correctiestatus

    Geeft de correctiestatus van het probleem aan.

    De beschikbare opties zijn afhankelijk van het projecttype.

    correctieplan

    Geeft een gedetailleerde beschrijving van het correctieplan.

    Correctiedatum

    Geeft de deadline aan waarbinnen het probleem moet zijn opgelost.

    Datum moet de indeling JJJJ-MM-DD hebben.

    Werkelijke correctiedatum

    Geeft de datum aan waarop het probleem daadwerkelijk is gecorrigeerd.

    Datum moet de indeling JJJJ-MM-DD hebben.

    Deadlinedatum hertest

    Geeft de deadline aan waarbinnen het probleem opnieuw moet worden getest.

    Datum moet de indeling JJJJ-MM-DD hebben.

    Werkelijke datum hertest

    Geeft de werkelijke datum aan waarop het probleem opnieuw is getest.

    Datum moet de indeling JJJJ-MM-DD hebben.

    Overzicht van resultaten opnieuw testen

    Geeft een gedetailleerde beschrijving die aangeeft of het probleem daadwerkelijk is opgelost.

    position

    Geeft de waarde op die de volgorde bepaalt waarin het probleem wordt weergegeven.

    Tip

    Vul de waarden in opeenvolgende volgorde in zodat de bronnen na het importeren in dezelfde volgorde worden weergegeven.

    entiteiten

    Geeft entiteits-ID's aan van de entiteiten die zijn getagd in het probleem.

    U vindt de entiteits-ID in de URL wanneer u naar een entiteit navigeert.

    Bijvoorbeeld:

    https://stark.projects.highbond.com/
    auditable_entities/33055
    , waarbij 33055 de entiteits-ID is.

    U kunt meerdere ID's opgeven, gescheiden door komma's.

    In dit veld kunt u ook de referentie-ID van een nieuwe entiteit opgeven die u hebt toegevoegd in de actuele sjabloon. Hiermee wordt het probleem gekoppeld aan de entiteit wanneer u de sjabloon uploadt.

    Voor meer informatie over het koppelen van HighBond-resources in Bulkimporteerprogramma raadpleegt u Referentie-ID's gebruiken om bronnen te koppelen in Bulkimporteerprogramma.

    Voor meer informatie over entiteiten, raadpleegt u Entiteitstagging instellen.

    Doeltype

    Geeft het componenttype aan van de locatie waar dit probleem moet worden geplaatst.

    Het doeltype moet een van de volgende typen zijn:

    • projects
    • project_files
    • objectives
    • narratives
    • risks
    • controls
    • walkthroughs
    • control_test_plans
    • control_tests
    • walkthrough_summaries
    • project_plannings
    • project_results
    • risk_control_matrices
    • testing_rounds

    De standaardinstelling is projecten.

    Belangrijk

    Gebruik de exacte terminologie die hierboven vermeld is.

    Opmerking

    Gebruik alleen Engelse standaardwaarden voor dit veld. Aangepaste Engelse waarden en gelokaliseerde (niet-Engelse) waarden worden nog niet ondersteund in Bulkimporteerprogramma.

    Voor informatie over welke doel-ID u voor welke component moet gebruiken, raadpleegt u Doeltype en -ID voor projectcomponenten

    Doel-id

    verplicht

    Geeft de ID op van de bron waarin dit probleem moet worden geplaatst. De bron-ID vindt u in de URL.

    Bijvoorbeeld: 

    https://stark.projects.highbond.com/audits
    /90305/objectives/94778
    , waarbij 90305 de project-ID en 94778 de doel-ID is.

    In het veld targetId kunt u een van de volgende handelingen uitvoeren:

    • de project-ID opgeven als u het probleem onder het project wilt plaatsen (dit is dezelfde ID als die wordt vermeld in het veld projectId).

    • de component-ID opgeven (doel-ID in het bovenstaande voorbeeld) als u het probleem onder de component van een project wilt plaatsen. Let op: de project-ID moet worden vermeld in het veld projectId.

    Voor informatie over welke doel-ID u voor welke component moet gebruiken, raadpleegt u Doeltype en -ID voor projectcomponenten

    customAttributes_1_term - customAttributes_n_term

    Geeft aangepaste attribuutvelden 1 tot en met n aan.

    Standaard heeft de sjabloon één paar aangepaste attribuutterm en -waarde in de sjabloon. U kunt handmatig nog negen paren toevoegen, waardoor u in totaal tien paren krijgt.

    Volg voor het toevoegen dezelfde naamgevingsconventie met een teller, bijvoorbeeld: customAttributes_2_term, customAttributes_2_value, etc.

    De aangepaste attributen van een project, raamwerk en hun componenten worden gedefinieerd in het projecttype. Voor meer informatie over aangepaste attributen raadpleegt u Termen, velden en meldingen aanpassen.

    customAttributes_1_value - customAttributes_n_value

    Geeft aangepaste attribuutwaarden 1 tot en met n aan.

    Standaard heeft de sjabloon één paar aangepaste attribuutterm en -waarde in de sjabloon. U kunt handmatig nog negen paren toevoegen, waardoor u in totaal tien paren krijgt.

    Volg voor het toevoegen dezelfde naamgevingsconventie met een teller, bijvoorbeeld: customAttributes_2_term, customAttributes_2_value, etc.

    De aangepaste attributen van een project, raamwerk en hun componenten worden gedefinieerd in het projecttype. Voor meer informatie over aangepaste attributen raadpleegt u Termen, velden en meldingen aanpassen.

    Opmerking
    • Als een waarde begint met een vierkant haakje of een komma, puntkomma of regeleinde bevat, omsluit u de waarde met dubbele aanhalingstekens (" ").
      Bijvoorbeeld: "[2021]", "Eerste, tweede asset", "Dit is belangrijk; dit ook".
    • Voor een meerkeuzeveld kunt u meerdere waarden toevoegen door elke waarde met een komma te scheiden.
    • Zorg er voor een vervolgkeuzelijst of een meerkeuzeveld voor dat de waarden precies hetzelfde zijn zoals opgegeven in de opties.
  3. Sla de sjabloon op en sluit deze.

Tips voor het voorbereiden van inhoud

Het voorbereiden van inhoud omvat:

  • het kopiëren en plakken van uw brongegevens in de Excelsjabloon
  • het invoeren van gegevens, waar van toepassing, in de Excelsjabloon
  • het opslaan van de sjabloon ter voorbereiding op het in bulk uploaden

Referentie-ID's gebruiken om bronnen te koppelen in Bulkimporteerprogramma

Referentie-ID is een veld in de Excelsjabloon Bulkimporteerprogramma. Het is het eerste veld in alle werkbladen en is beschikbaar voor alle bronnen. Het is een unieke identificator voor elke record in het werkblad.

Met behulp van referentie-ID's  kunt u Diligent One-bronnen aan elkaar koppelen. U kunt bijvoorbeeld een project maken en een doel dat is gekoppeld aan het project in dezelfde import. Dit kunt u doen door de referenceId op te geven in het vereiste veld.

Doeltype en -ID voor projectcomponenten

De volgende sectie toont het doeltype en de -ID voor de respectievelijke projectcomponent.

Op basis van de component waarin u het probleem wilt plaatsen, gebruikt u het relevante doeltype en de doel-ID in de Excelsjabloon.

Gegevens uploaden

Voer een van de volgende handelingen uit:

  • Sleep de sjabloon naar het browservenster.
  • Klik op Kies vanaf uw computer en selecteer de bijgewerkte sjabloon op uw computer.

    Er kan slechts één Excelsjabloon tegelijkertijd worden geüpload (elk bestand wordt afzonderlijk gevalideerd).

  • Resultaat Een bericht over de uitkomst (gelukt of mislukt) wordt weergegeven, afhankelijk van de uitkomst van het proces, en de nieuwste sessie wordt bijgewerkt in de tabel Sessies.

Sessies in Bulkimporteerprogramma

Een sessie in het Bulkimporteerprogramma is een reeks gebruikersinteracties om HighBond-bronnen te importeren. Elke gebruikerssessie wordt vastgelegd in de tabel Sessies.

De tabel Sessies bevat de volgende informatie.

Veldnaam

Beschrijving

Websessies

Toont de lijst met websessies.

Een websessie verwijst naar een sessie die wordt voltooid met behulp van de gebruikersinterface van het Bulkimporteerprogramma. Een nieuwe sessie begint elke keer dat u de pagina Bulkimporteerprogramma opent.

API-sessies

Toont de lijst met API-sessies.

Een API-sessie verwijst naar een sessie die wordt voltooid met behulp van een API-platform, zoals Postman etc.

Vernieuwen

Hiermee wordt de pagina Sessies opnieuw geladen.

Sessie-ID

Sessie-identificator.

In Websessies kunt u op de sessie-ID klikken om naar een specifieke sessie te gaan, en wordt de sessie-ID toegevoegd aan de URL.

Bijvoorbeeld: https://stark.bulkimporter.highbond.com/import/bcc1e04e-4cd3-46d2-a8be-0b9083baccdc, waarbij
bcc1e04e-4cd3-46d2-a8be-0b9083baccdc de sessie-ID is.

Opmerking

Sessie-ID's van zowel de web- als API-sessies zien er hetzelfde uit. Zorg ervoor dat u de ID's niet onderling uitwisselt om fouten te voorkomen.

Datum

Toont de datum en tijd van de sessie. U kunt de datum in oplopende of aflopende volgorde sorteren.

Geüpload door

Toont de naam van de gebruiker.

Status

Toont de status van de upload, of deze gelukt is of niet.

U kunt op de status klikken om de details van de voltooide import te bekijken.

Bestandsnaam

Toont de naam van de geüploade sjabloon/het geüploade foutenlogboek. Bijvoorbeeld: HighBond_Template.xlsx, ErrorLog.xlsx.

Sjabloon U kunt op de sjabloon klikken en deze downloaden om eerder geüploade gegevens te corrigeren.

Foutenlogboek Een foutenlogboek wordt gegenereerd wanneer een upload mislukt. U kunt het foutenlogboek controleren om de fouten te corrigeren en de sjabloon opnieuw te uploaden.

Opmerking
  • De sjabloon en het foutlogboek kunnen tot 18 maanden vanaf de uploaddatum worden gedownload.
  • De koppeling om de sjabloon te downloaden is vanaf 13 mei 2022 beschikbaar voor de Bulkimporteerprogrammasessies. U kunt de sjabloon niet downloaden voor sessies eerder dan deze datum.

Bestaande problemen in bulk bijwerken

U kunt meerdere items tegelijkertijd bijwerken in Bulkimporteerprogramma met behulp van sessies.

Opmerking

U kunt alleen bronnen bijwerken die u hebt geüpload met behulp van het Bulkimporteerprogramma.

Probleemoplossing

U kunt het foutenlogboek vanuit de Sessies-tabel downloaden en controleren. Krijg inzicht in veelvoorkomende fouten bij het in bulk uploaden en lees hoe u fouten kunt oplossen.

De volgende tabel bevat een lijst met mogelijke fouten die kunnen optreden bij het uploaden van de sjabloon.

Fout Oplossing(en)
Het geüploade bestand bevat mogelijk meer dan 2000 rijen (in alle werkbladen gecombineerd). Verwijder de extra rijen uit de sjabloon en upload opnieuw.
Verplichte velden kunnen leeg zijn of ontbreken in het geüploade bestand. Zorg ervoor dat alle verplichte velden (gemarkeerd met rode en oranje kolomnamen in de sjabloon) ingevuld zijn.
Opmerking

Als u geen gegevens verstrekt in de verplichte velden, wordt de rij niet verwerkt.

Gegevensindeling is mogelijk onjuist.

Zorg ervoor dat gegevens in tekstvelden geldig zijn en de maximale veldlengte niet overschrijden: 255 tekens.

Rich text-velden hebben geen tekenlimiet.

Gegevenswaarden zijn mogelijk ongeldig of komen mogelijk niet overeen met de vervolgkeuzelijstwaarden.

Bijvoorbeeld: de waarde voor de velden received en sendRecurrentNotifications in het blad Aanvragen moet True of False zijn.

Ongeldige velden in de sjabloon.
  • Voeg geen nieuwe velden toe aan de sjabloon.
  • Verwijder geen velden uit de sjabloon.
Sjabloon heeft mogelijk niet de verwachte indeling.

Zorg ervoor dat de bestandsindeling .xlsx is.

Ongeldige werkbladnamen.

Wijzig de naam van het werkblad niet.

Sessie is mogelijk verlopen.

Vernieuw de pagina en probeer opnieuw te uploaden.

Sessie-ID is mogelijk ongeldig. Zorg ervoor dat u een websessie-ID gebruikt.