Scripts migreren van AX naar Robots

Belangrijk
Ga alleen verder met het migreren van de scripts als u de vorige fase van de migratie hebt voltooid. Voor meer informatie raadpleegt u Robots-repository opnieuw aanmaken in uw AX-structuur.
Voor elk geautomatiseerd proces in AX dat u wilt recreëren in Robots, moet u de bijbehorende scripts migreren. U dient alle analytische scripts en eventuele subscripts of hulpscripts te migreren.
U kunt scripts niet rechtstreeks migreren van AX naar Robots. U moet de scripts exporteren van AX naar een tussenlocatie waar Analytics is geïnstalleerd, zoals uw eigen computer. Na het voltooien van eventueel noodzakelijk voorbereidend werk moet u de scripts toepassen (uploaden) van de tijdelijke locatie naar Robots.
Achterwaartse compatibiliteit van Robots
Over het algemeen is Robots ontworpen om zo compatibel mogelijk te zijn met eerdere versies van AX. De meeste AX-scripts werken in Robots zonder dat er aanpassingen nodig zijn.
Alle scripts die afhankelijk zijn van AX-specifiek ontwerp moeten worden aangepast. Bijvoorbeeld:
- scripts die toegang krijgen tot de operationele AX-database om taakplanningen of logboeken te lezen
- scripts die absolute paden naar serverbronnen bevatten die niet langer geldig zijn op de Robots Agent-server
Als u hulp nodig hebt bij het aanpassen van analytische scripts voor gebruik in Robots, neem dan contact op met Diligent Support.
Scripts uit AX exporteren
Om de migratie te starten, gebruikt u de optie Exporteren om scripts uit AX te exporteren. Scripts worden geëxporteerd in de analyse-app waarin ze zich bevinden. Elke geëxporteerde analyse-app wordt een afzonderlijk Analytics-project in de exportbestemming.
Deze procedure gaat ervan uit dat u uw eigen computer gebruikt als tussenliggend locatie.
- Maak een map op uw computer voor het opslaan van geëxporteerde scripts.
- Selecteer in de AX Server Explorer de analysetoepassing die de scripts bevat die u wilt exporteren.
U kunt Ctrl+klikken om meerdere analysetoepassingen in dezelfde bovenliggende map Analysetoepassingen te selecteren, of de bovenliggende map selecteren om alle analysetoepassingen in de map te exporteren.
- Selecteer Bestand > Exporteren.
- In het Exporteren-dialoogvenster, zorgt u ervoor dat beide opties niet geselecteerd zijn:
- Met de geëxporteerde bestand(en) werken?
- Gegevensbestanden exporteren samen met geselecteerde definities
- Klik op Bladeren, selecteer de map die u hebt gemaakt voor het opslaan van scripts en klik op OK.
- Klik op OK om de analyseapp of -apps te exporteren.
De scripts worden vanuit hun analysetoepassing geëxporteerd naar de opgegeven locatie. Elke analyse-app wordt omgezet in een Analytics-project.
- Herhaal het proces voor eventuele aanvullende scripts die u wilt migreren.
Gekoppelde analytische scripts
In tegenstelling tot AX ondersteunt Robots geen gekoppelde analytische scripts. Als u gekoppelde analytische scripts gebruikt in AX, exporteert u het hoofdanalytische script en past u het vervolgens toe op elke robot waarin het vereist is.
Verricht alle noodzakelijke voorbereidende werkzaamheden
Na de export vanuit AX zijn scripts klaar om in Robots te worden toegepast als:
- alle scripts die bij een geautomatiseerd proces horen, bevinden zich in één Analytics-project
- alle analytische scripts die sequentieel moeten worden uitgevoerd in een geautomatiseerd proces:
- een geschikt alfanumeriek naamgevingsschema gebruiken
- indien geïmplementeerd, een geschikt analysetype hebben
Analyseketens
In tegenstelling tot AX ondersteunt Robots geen analytische ketens. Als u analytische ketens gebruikt, moet u mogelijk voorbereidend werk verrichten voordat scripts klaar zijn om naar Robots te worden doorgevoerd. Voor meer informatie raadpleegt u Analytische ketens repliceren in Robots.
Scripts naar Robots uploaden (commit)
Zodra alle scripts die bij een geautomatiseerd proces horen zijn opgenomen in één Analytics-project en voorzien zijn van passende namen, kunt u de scripts toepassen op Robots.
Scripts vastleggen zorgt ervoor dat ze worden geüpload vanuit een lokale omgeving naar de cloudgebaseerde Robots-app. We gebruiken het woord "commit" in plaats van "uploaden" omdat elke keer dat u scripts naar dezelfde robot commit, u een nieuwe versie van de scripts in de scriptgeschiedenis maakt.
Raadpleeg ACL-scripts (uploaden) toepassen op Robots voor gedetailleerde informatie.
- Open het Analytics-project met de scripts die u wilt committing
- 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.
- 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.
- 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.
-
Voer een kort toepassingsbericht in waarmee de toegepaste scripts worden beschreven en klik op OK.
De scripts worden vastgelegd in de ontwikkelmodus van de robot.
- Klik in het dialoogvenster Toepassen van scripts geslaagd op de tweede link om de zojuist toegepaste scripts in de Robots-app te bekijken.
Het tabblad Scriptversies wordt geopend met de toegepaste versie van de scripts.
- Selecteer de scriptversie (vn).
Het zijpaneel Versiedetails wordt geopend. De namen van de afzonderlijke analytische scripts en hulpscripts worden vermeld onder Scriptversiewijzigingen.
- Klik in Analytics op OK om het dialoogvenster Scripts toepassen geslaagd te sluiten.
Analytische ketens repliceren in Robots
Opmerking
Dit gedeelte is alleen van toepassing als u analytische ketens in AX gebruikt.
In tegenstelling tot AX ondersteunt Robots momenteel niet het samenstellen van analytische scripts vanuit willekeurige locaties in de repository tot een analytische keten die sequentieel wordt uitgevoerd. Om opeenvolgende uitvoering van een reeks analytische scripts in Robots te implementeren, moet u twee dingen doen:
- één robot bevatten voor de analytische scripts en één taak maken om de scripts uit te voeren
- namen van scripts en type analyse gebruiken om een scriptvolgorde te maken

Sla de analysescripts op in één robot
De analytische scripts bevatten die u opeenvolgend wilt uitvoeren in één robot.
Om de scripts in één robot op te nemen, moet u eerst alle gerelateerde scripts in één Analytics-project onderbrengen. U brengt de scripts als één bundel, genaamd een scriptversie, over van het Analytics-project naar de robot.
Zodra de scripts in één robot zijn ondergebracht, maakt u één taak om de reeks analytische scripts uit te voeren.
Scripts die bij elkaar horen onderbrengen in één Analytics-project
Als de scripts die bij één geautomatiseerd proces horen, zijn verdeeld over twee of meer Analytics-projecten, moet u de scripts in één project samenvoegen voordat u ze naar Robots commit. Deze situatie zou zich kunnen voordoen als analysescripts deel uitmaakten van een analytische keten in AX.
- Open het Analytics-project dat u wilt gebruiken om alle scripts te bevatten die bij een geautomatiseerd proces horen.
- In het tabblad Overzicht van de Navigator, klikt u met de rechtermuisknop op de projectnaam bovenaan de structuurweergave en selecteert u Kopiëren uit een ander project > Script.
- In het dialoogvenster Projectbestand zoeken gaat u naar het Analytics-project waaruit u het script of de scripts wilt kopiëren, selecteert u het en klikt u op Openen.
- In het dialoogvenster Importeren voert u een van de volgende stappen uit om een of meer scripts toe te voegen aan de lijst Naar project_name:
- Dubbelklik op een script.
- Ctrl+klik op meerdere scripts en klik vervolgens op de knop met de pijl naar rechts.
- Klik op Alles toevoegen om alle scripts toe te voegen.
- Klik op OK om het script of de scripts naar het bestemmingsproject te kopiëren.
Als er al een script met dezelfde naam in het project bestaat, krijgt het gekopieerde script een oplopend numeriek achtervoegsel.
- Herhaal dit proces voor eventuele scripts in andere projecten die in het bestemmingsproject moeten worden opgenomen.
Gebruik scriptnamen en het type analyse om een scriptvolgorde te maken
Scriptnamen
Analytische scripts worden alfanumeriek gesorteerd op naam in een robottaak en worden in die volgorde uitgevoerd. Geef de analytische scripts daarom namen die de gewenste uitvoeringsvolgorde creëren.
Bijvoorbeeld: het eerste script in de volgorde zou het voorvoegsel A_01 kunnen gebruiken, het tweede script A_02 of B_01, enzovoort. Een systeem van voorvoegsels maakt het later invoegen van extra scripts eenvoudiger. Hulp- of subscripts zijn niet onderworpen aan de vereiste van sequentiële naamgeving.
Opmerking
U kunt scripts in Robots niet hernoemen, dus zorg ervoor dat alle scripts correct zijn benoemd in Analytics voordat u ze naar Robots commit.
Analysetype
Als extra hulpmiddel voor de volgordebepaling kunt u optioneel een type specificeren voor analytische scripts. Het specificeren van een type groepeert de scripts in afzonderlijke gebieden binnen een taak. De gebieden zijn als volgt gerangschikt en worden in deze volgorde uitgevoerd:
- Importeren
- Voorbereiding.
- Analyse
Binnen elk gebied worden de scripts alfanumeriek gesorteerd. Ongeacht de scriptnaam voert een taak alle scripts in een gebied uit voordat er naar het volgende gebied wordt overgegaan.
Voor meer informatie, zie ANALYTIC-tag.
Analysebestanden hernoemen om een uitvoeringsvolgorde te creëren
Als u wilt dat twee of meer analysegegevensscripts in een specifieke volgorde worden uitgevoerd, moeten ze zodanig worden benoemd dat de gewenste uitvoeringsvolgorde ontstaat. Voor meer informatie raadpleegt u Analytische ketens repliceren in Robots.
Opmerking
De naam van het analysescript die in de analyseheader is opgegeven, is de naam die in Robots wordt gebruikt. De naam van het script op het tabblad Overzicht van de Navigator wordt niet gebruikt.
- Open in Analytics het analysescript dat u wilt hernoemen.
- In de //ANALYTIC-tag in de kop van de analyse werkt u de naam van de analyse bij en klikt u op Het geopende project opslaan
.
Voor meer informatie, zie ANALYTIC-tag.
- Herhaal het proces voor alle analytische scripts die hernoemd moeten worden.
Specificeer een analysetype om analysescripts te groeperen
Als u analytische scripts wilt groeperen in afzonderlijke Import-, Voorbereidings- en Analysegebieden in een taak, moet u voor elk script een bijbehorend analytisch type opgeven. Het groeperen van analysescripts biedt een extra optie voor het maken van een scriptvolgorde, maar het is niet verplicht. Voor meer informatie raadpleegt u Analytische ketens repliceren in Robots.
- Open in Analytics het analytische script waarvoor u een type wilt opgeven.
- In de //ANALYTIC-tag in de kop van de analyse werkt u de naam van de analyse bij en klikt u op Het geopende project opslaan
.
Voor meer informatie, zie ANALYTIC-tag.
- Herhaal het proces voor alle analytische scripts waarvoor een analytisch type vereist is.
Wat gebeurt er nu?
Als u de scripts voor een of meer geautomatiseerde processen hebt gemigreerd, kunt u beginnen met het migreren van gegevens: Gegevens migreren van AX naar Robots.