ArasDeveloperTool 4.0.1

ArasDeveloperTool

Command Line Application for handling developer tasks in Aras Innovator

####Features

• How To Use
  • Setup an Aras connection (Setup)
  • Aras Info
  • Check Latest Updates (CheckLatestUpdates)
  • Check if Items are in packages (PackageChecker)
  • Backup/Restore Database (Database)
  • AMLRunner
  • ApplyMethod
  • RestoreMethod
  • CreatedItemTypesCount
• Release Notes

• Test Aras connection
• Check latest changes in Aras
• Check that everything is packaged, and package if needed.
• Run Amls from files
• Check Aras Database Info
• Backup and Restore Databases

How To Use

Download ArasDevTool and extract it to a folder. Open Cmd/Powershell/Windows Terminal and navigate to the folder and .

ArasDevTool.exe

Availible commands for: ArasDevTool
  AmlRunner
  ArasInfo
  BackupDB
  CheckLatestUpdates
  Dummy
  PackageChecker
  RestoreDB
  Setup
  TestConnection

Options:
  --help    Displays help for a command

Setup an Aras connection (Setup)

ArasDevTool.exe Setup

ArasDevTool.exe Setup -ext
#Extended setup: Configure Database for Backup/Restore

It is an option to explicity use a "Aras ConnectionString" in Aras Commands: E.g.

ArasDevTool.exe TestConnection --cs="http://localhost/Innovator;InnovatorSolutions;admin;innovator"
#Or
ArasDevTool.exe TestConnection --cs="http://localhost/Innovator;InnovatorSolutions;admin"
# To be promted for password

Aras Info

ArasDevTool.exe ArasInfo

Check Latest Updates (CheckLatestUpdates)

ArasDevTool.exe CheckLatestUpdates 

ArasDevTool.exe CheckLatestUpdates --help

Help for: CheckLatestUpdates
  Specify connection string: E.g.
   -cs="http://localhost/innovator;InnovatorSoluions;admin;innovator"
   -cs="http://localhost/innovator;InnovatorSoluions;admin"
  Or environment: E.g.
  -env dev
  Non specified is equivalent with '-env dev'

Options: -c
  (Number of items to show: "-c 20"

Check if Items are in packages (PackageChecker)

ArasDevTool.exe PackageChecker -prefix HC_

ArasDevTool.exe CheckLatestUpdates --help

Help for: PackageChecker
  Specify connection string: E.g.
   -cs="http://localhost/innovator;InnovatorSoluions;admin;innovator"
   -cs="http://localhost/innovator;InnovatorSoluions;admin"
  Or environment: E.g.
  -env dev
  Non specified is equivalent with '-env dev'

  Parameters:
    -prefix        Check Items with specific prefix. Example: "-prefix HC_"
  Options:
  --DryRun       Dont commit any changes.
  --Auto         Let it automatically select package for you.

Backup/Restore Database (Database)

If you have setup the extended setup database backup and restore is possible via

ArasDevTool.exe BackupDB 

ArasDevTool.exe RestoreDB

AMLRunner

Run AMLs from files

ArasDevTool.exe AMLRunner -mf \AMLRunner\AmlRunnerTest.mf

Example of manifest file running aml-files in the Pack1 and Pack2 directories. Where if the any aml fails in Pack2, execution will be stopped.

<?xml version="1.0" encoding="utf-8" ?>
<imports>
  <package  path="Pack1" />
  <package path="Pack2" stopOnError="TRUE" />
</imports>

Example Test1.xml in directory Pack1

<AMLS>
  <AML>
    <Item action="delete" type="Form" id="F596909BBC7746D99683DB1E759E582E">
    </Item>
  </AML>
   <AML>
    <Item action="delete" type="Field" id="53ADDFF20E5C43B7B51A5E4B818465E3">
    </Item>
  </AML>
</AMLS>

Or user the -file parameters to execute a single file of AML(s) like:

ArasDevTool.exe AMLRunner -file \AMLRunner\Pack1\Test1.xml

ApplyMethod

Run an ApplyMethod

ArasDevTool.exe ApplyMethod -name HC_Motd

Output

Executing ApplyMethod
SUCCESS:
    Message of the day
    Don't forget to unlock your items Finish your tasks Be good

RestoreMethod

'Restore' a specified Method to previous generation or a specified date" Prints out the method_code of the restored method. The restore locates a previous generation of the method and makes an edit with the content and 'comments'

ArasDevTool.exe RestoreMethod -name HC_Motd -toDate 2023-06-05T08:45
Executing RestoreMethod
SUCCESS:
    return this.getInnovator().newResult("Don't forget to unlock your items Finish your tasks Be good");

CreatedItemTypesCount

List number of instances created for each Item Type in Aras, ordered descending on highest number of instances.

Options: -month {yyyy-MM} #(default previous month) -count-display-threshold {int} #(default 5)

Example:

ArasDevTool.exe CreatedItemTypesCount

Output:

New Aras Connection: http://localhost/2023, 2023, root , 90
Executing CreatedItemTypesCount
790       Part
191       Express ECO
123       Document
85        Affected Item
85        Express ECO Affected Item
8         SavedSearch

Release Notes

See Release Notes