ACL-scripts (uploaden) toepassen op Robots

Er zijn twee methoden voor het toepassen, of uploaden, van ACL-scripts naar de Robots-app:

  • De scripts van Analytics toepassen op Robots

  • Robots gebruiken om ACL-scripts te uploaden

    Opmerking

    Deze methode van het gebruiken van Robots om ACL-scripts te uploaden is niet hetzelfde als het gebruiken van Robots om een eerste upload van ACL-scripts uit te voeren naar een nieuw gemaakte robot. Voor meer informatie raadpleegt u Scriptautomatisering toevoegen aan een robot.

Vergelijking van de methoden

Het eindresultaat van elke methode voor het toepassen van scripts is hetzelfde: een nieuwe versie van de scripts wordt gemaakt in de bestemmingsrobot. Deze verschillen bestaan echter tussen de methoden:

  • Syntaxisvalidatie Automatische syntaxisvalidatie wordt uitgevoerd wanneer u scripts van Analytics toepast. Er wordt geen validatie uitgevoerd wanneer u Robots gebruikt om scripts te uploaden.

  • Project-robot-koppeling Het Analytics-project dat de scripts bevat en de bestemmingsrobot worden automatisch gekoppeld wanneer u scripts van Analytics toepast. Er wordt geen koppeling uitgevoerd wanneer u Robots gebruikt om scripts te uploaden.

Syntaxisvalidatie en project-robot-koppeling zijn handige functies, dus de aanbevolen aanpak is om scripts toe te passen van Analytics naar Robots. U kunt vanuit Robots uploaden nadat een project-robot-koppeling is ingesteld, en voor kleine scriptupdates waar het omzeilen van syntaxisvalidatie een minder groot probleem is.

Hoe het toepassen van scripts werkt

Wanneer u scripts toepast op de Robots-app, worden alle scripts in het Analytics-project toegepast en worden ze samen 'een versie' in de bijbehorende ACL-robot. U kunt scripts van een project niet selectief toepassen. Voor meer informatie raadpleegt u Workflow ACL-scriptontwikkeling in Analytics en Robots.

Als u scripts wilt toepassen op Robots, moet u worden toegewezen aan de juiste rol in de Robots-app. Voor meer informatie raadpleegt u Machtigingen Robots-app.

Scripts van Analytics toepassen op Robots

Er bestaan verschillende mogelijkheden voor het toepassen, of uploaden, van scripts van Analytics naar een ACL-robot in de Robots-app.

De eenvoudigste manier om inzicht te krijgen in de verschillende mogelijkheden is een Analytics-project en een ACL-robot te beschouwen als twee containers die elk scripts bevatten en kunnen worden gekoppeld. Zodra ze zijn gekoppeld, kunt u opvolgende versies van scripts toepassen van het project op de robot.

Actie Resultaat na toepassen
Scripts toepassen op een nieuwe ACL-robot

Een nieuwe ACL-robot wordt gemaakt en die bevat versie 1 van de toegepaste scripts.
Scripts toepassen op een bestaande ACL-robot

De bestaande ACL-robot bevat de toegepaste scripts, met een versienummer die afhankelijk is van of de robot al scripts bevat.
Bewerkte scripts toepassen op een ACL-robot

Een nieuwe versie van de scripts wordt toegepast op de ACL-robot die is gekoppeld aan het project.
Scripts toepassen op een andere ACL-robot

De scripts worden toegepast op een nieuw gemaakte ACL-robot of op een bestaande ACL-robot.

De koppeling tussen het project en de vorige robot wordt verwijderd.

Scripts toepassen op een nieuwe ACL-robot

Pas de scripts voor de eerste keer toe op de Robots-app om een nieuwe ACL-robot te maken die de toegepaste scripts bevat.

  1. Open op uw computer het Analytics-project dat de scripts bevat.

  2. Selecteer in het Analytics-hoofdmenu Bestand > Scripts toepassen.

    Als een foutmelding wordt weergegeven, is er mogelijk een probleem met de analysekop of de scriptsyntaxis, in een of meer van de scripts in het project.

    Voor meer informatie raadpleegt u Workflow ACL-scriptontwikkeling in Analytics en Robots.

  3. Indien nodig dubbelklikt u in het dialoogvenster Bestemming selecteren op de juiste Diligent One-instantie.

    De Robot-verzameling wordt weergegeven met een lijst van bestaande robots.

  4. Typ een robotnaam in het veld Nieuwe robot en klik op Maken.

    De robot wordt gemaakt en een robot-ID wordt automatisch gegenereerd.

    Het Analytics-project dat de scripts bevat, en de nieuwe robot, zijn nu gekoppeld zodat u voor opvolgende toepassingen de robot niet handmatig hoeft te zoeken.

    Opmerking

    Gebruik de volgende tekens nergens in de robotnaam: '$', '€'.

  5. Voer een kort toepassingsbericht in waarmee de toegepaste scripts worden beschreven en klik op OK.

    Versie 1 van de scripts wordt toegepast op de nieuw gemaakte robot. De scripts bestaan op dit punt alleen in de ontwikkelingsmodus.

  6. Optioneel. Klik in het dialoogvenster Toepassen van scripts gelukt op een van de links om de nieuw gemaakte robot of de toegepaste scripts te inspecteren.
  7. Klik op OK om het dialoogvenster te sluiten.

Scripts toepassen op een bestaande ACL-robot

Pas scripts toe op een ACL-robot die al bestaat om de robot in te vullen. De bestaande robot kan al scripts bevatten, of kan leeg zijn.

Opmerking

Gebruik deze methode als het project nog niet is gekoppeld aan een robot. Als het project al is gekoppeld aan een robot, raadpleegt u Scripts toepassen op een andere ACL-robot.

  1. Open op uw computer het Analytics-project dat de scripts bevat.

  2. Selecteer in het Analytics-hoofdmenu Bestand > Scripts toepassen.

    Als een foutmelding wordt weergegeven, is er mogelijk een probleem met de analysekop of de scriptsyntaxis, in een of meer van de scripts in het project.

    Voor meer informatie raadpleegt u Workflow ACL-scriptontwikkeling in Analytics en Robots.

  3. Indien nodig dubbelklikt u in het dialoogvenster Bestemming selecteren op de juiste Diligent One-instantie.

    De Robot-verzameling wordt weergegeven met een lijst van bestaande robots.

  4. Selecteer in de lijst met robots de robot waarop u de scripts wilt toepassen en klik op OK.

    Het Analytics-project dat de scripts bevat, en de bestaande robot, zijn nu gekoppeld zodat u voor opvolgende toepassingen de robot niet handmatig hoeft te zoeken.

  5. Voer een kort toepassingsbericht in waarmee de toegepaste scripts worden beschreven en klik op OK.

    De scripts worden toegepast op de bestaande robot. Het versienummer van de scripts is afhankelijk van of de robot al scripts bevat, of dat deze voorheen leeg was.

    De scripts bestaan op dit punt alleen in de ontwikkelingsmodus.

  6. Optioneel. Klik in het dialoogvenster Toepassen van scripts gelukt op een van de links om de bestaande robot of de toegepaste scripts te inspecteren.
  7. Klik op OK om het dialoogvenster te sluiten.

Bewerkte scripts toepassen op een ACL-robot

Pas bewerkte scripts toe om een nieuwe versie van de scripts te maken in de gekoppelde ACL-robot.

Er zijn twee methoden voor het bewerken van scripts voordat u ze toepast. U kunt de scripts bewerken in het gekoppelde project, of u kunt de scripts downloaden van Robots naar een nieuw Analytics-project en de scripts bewerken in het nieuwe project.

Opmerking

Het wordt aanbevolen om de scripts te downloaden van Robots voordat u begint met bewerken. U kunt ervan uitgaan dat de gedownloade scripts niet zijn gewijzigd, in tegenstelling tot scripts die lokaal zijn opgeslagen.

Als u tijdens een enkele sessie voor het schrijven van scripts de enige persoon bent die aan de scripts werkt, is het normaal gesproken veilig om iteratieve versies van de scripts direct vanuit het project toe te passen zonder te downloaden tussen iteraties.

De scripts downloaden van Robots

Voer dit gedeelte van de procedure uit als u wilt werken met scripts die in Robots staan, in plaats van scripts die al op uw lokale computer staan.

  1. Selecteer vanaf de startpagina van Launchpad (www.highbond.com) de Robots-app om deze te openen.

    Als u zich reeds in Diligent One bevindt, kunt u het navigatiemenu aan de linkerkant gebruiken om naar de Robots-app te switchen.

  2. Selecteer ACL Robots in het dashboard in Robots.
  3. Navigeer naar de robot die de scripts bevat die u wilt downloaden en selecteer de robot om deze te openen.

  4. Klik in de rechterbovenhoek van de robot op Productie of Ontwikkeling om de te gebruiken modus te selecteren.

    Voor meer informatie raadpleegt u Ontwikkelingsmodus en productiemodus in Robots.

  5. Voer een van de volgende handelingen uit:

    • De momenteel geactiveerde scriptversie downloaden

      Klik in de productiemodus op Robot downloaden.

    • Download de meest recente versie van het ontwikkelingsscript

      Klik in de ontwikkelingsmodus op Robot downloaden.

    • Een eerdere scriptversie downloaden

      1. Selecteer in de ontwikkelingsmodus het tabblad Scriptversies.

      2. Selecteer in de lijst Scriptversies de versie die u wilt downloaden.

      3. Klik in het deelvenster Versiedetails op Downloaden.

    De scripts worden gedownload naar de standaardmap Downloads op uw computer. De scripts bevinden zich in een nieuw gemaakt Analytics-project met dezelfde naam als de robot waarvan u hebt gedownload. Het project en de robot worden automatisch gekoppeld.

    Opmerking

    De robot is nu gekoppeld aan twee projecten: het project dat zojuist is gemaakt door het downloaden en het project dat eerder is gebruikt om de scripts toe te passen. Er kan één robot worden gekoppeld aan meerdere projecten.

  6. Optioneel. Verplaats het project met de gedownloade scripts als u er in een andere map aan wilt werken.

De scripts bewerken in Analytics en ze toepassen

  1. Open op uw computer het Analytics-project dat de scripts bevat.

  2. Bewerk de scripts en sla uw wijzigingen op.

    Opmerking

    U kunt indien nodig ook scripts toevoegen of verwijderen.

  3. Selecteer in het Analytics-hoofdmenu Bestand > Scripts toepassen.

    Als een foutmelding wordt weergegeven, is er mogelijk een probleem met de analysekop of de scriptsyntaxis, in een of meer van de scripts in het project.

    Voor meer informatie raadpleegt u Workflow ACL-scriptontwikkeling in Analytics en Robots.

  4. Voer een kort toepassingsbericht in waarmee de wijziging aan de toegepaste scripts worden beschreven en klik op OK.

    De scripts worden toegepast op de gekoppelde robot waar ze worden opgeslagen als een nieuwe versie. Bestaande versies van de scripts in de robots worden niet overschreven.

    Als een foutmelding wordt weergegeven dat de gekoppelde robot niet is gevonden, controleer dan of de robot bestaat in Robots, en dat u met uw rol scripts mag toepassen.

  5. Optioneel. Klik in het dialoogvenster Toepassen van scripts gelukt op een van de links om de robot of de nieuwe versie van de scripts te inspecteren.
  6. Klik op OK om het dialoogvenster te sluiten.

Scripts toepassen op een andere ACL-robot

Pas scripts toe op een andere ACL-robot om een versie van de scripts toe te voegen aan de robot, en om de robot gekoppeld aan het project te wijzigen. De scripts kunnen worden bewerkt of de bewerkingen kunnen ongedaan worden gemaakt.

Er bestaan twee mogelijkheden wanneer u scripts toepast op een andere robot:

  • scripts toepassen op een nieuwe robot
  • scripts toepassen op een bestaande robot

  1. Open op uw computer het Analytics-project dat de scripts bevat.

  2. Selecteer in het Analytics-hoofdmenu Bestand > Scripts toepassen als.

    Als een foutmelding wordt weergegeven, is er mogelijk een probleem met de analysekop of de scriptsyntaxis, in een of meer van de scripts in het project.

    Voor meer informatie raadpleegt u Workflow ACL-scriptontwikkeling in Analytics en Robots.

  3. Indien nodig gaat u in het dialoogvenster Bestemming selecteren naar de juiste Diligent One-instantie.

    De Robot-verzameling wordt weergegeven met een lijst van bestaande robots.

  4. Voer een van de volgende handelingen uit:
    • Scripts toepassen op een nieuwe robot Typ een robotnaam in het veld Nieuwe robot en klik op Maken.

      De robot wordt gemaakt en een robot-ID wordt automatisch gegenereerd. Het Analytics-project dat de scripts bevat, en de nieuwe robot, zijn nu gekoppeld.

      Opmerking

      Gebruik de volgende tekens nergens in de robotnaam: '$', '€'.

    • Scripts toepassen op een bestaande robot In de lijst met robots selecteert u de robot waarop u de scripts wilt toepassen en klik op OK.

      Het Analytics-project dat de scripts bevat, en de bestaande robot, zijn nu gekoppeld.

    De koppeling tussen het project en de vorige robot wordt verwijderd.

  5. Voer een kort toepassingsbericht in waarmee de toegepaste scripts worden beschreven en klik op OK.

    De scripts worden toegepast op de nieuw gemaakte of de bestaande robot. Het versienummer van de scripts is afhankelijk van of de robot al scripts bevat, of dat deze voorheen leeg was.

    De scripts bestaan op dit punt alleen in de ontwikkelingsmodus.

  6. Optioneel. Klik in het dialoogvenster Toepassen van scripts gelukt op een van de links om de nieuw gemaakte en de bestaande robot of de toegepaste scripts te inspecteren.
  7. Klik op OK om het dialoogvenster te sluiten.

Robots gebruiken om ACL-scripts te uploaden

U kunt Robots gebruiken om ACL-scripts te uploaden zonder Analytics te hoeven openen. Deze methode voor het uploaden van scripts omzeilt syntaxisvalidatie, dus u moet deze alleen gebruiken voor het uploaden van kleine scriptupdates van eerder gevalideerde scripts.

Opmerking

Deze methode is niet beschikbaar voor een eerste upload van ACL-scripts naar een nieuw gemaakte robot.

  1. Selecteer vanaf de startpagina van Launchpad (www.highbond.com) de Robots-app om deze te openen.

    Als u zich reeds in Diligent One bevindt, kunt u het navigatiemenu aan de linkerkant gebruiken om naar de Robots-app te switchen.

  2. Selecteer ACL Robots in het dashboard in Robots.

  3. Klik op een ACL-robot om deze te openen.

  4. Klik in de rechterbovenhoek van de robot op Ontwikkeling om te schakelen naar de ontwikkelingsmodus.

  5. Klik op het tabblad Scriptversies op Uploaden.

  6. Doe het volgende in het dialoogvenster dat wordt weergegeven:

    1. Klik op kiezen van uw computer en ga naar het Analytics-project dat de scripts bevat.

    2. Selecteer het project en klik op Openen.

      U kunt een Analytics-project ook naar het gebied Geüpload script slepen.

  7. Voer een Toepassingsbericht in en klik op Uploaden en toepassen.

    De scripts worden naar de robot geüpload en er wordt een nieuwe scriptversie gemaakt bovenaan de lijst Scriptversies.