IlinkTrail

IlinkTrail is a Windows/DOS tool I created to automate Intralink tasks like:

  • create or delete a workspace
  • checkout objects
  • modifying revisions
  • export objects
  • promoting demoting objects
  • run a purge script

How to use it

The tool must be run from a DOS prompt and is configured via commandline options.

  1. Download it and put it in a folder which is in your path variable (e.g. c:\WINDOWS).
  2. Configure your system according to the specs below.
  3. Open a DOS prompt (Start -> Run -> CMD) and run the script.
    start it first with ilinktrail -h to get the help.

It's not an easy tool to use and was developed for my own use with the option to share it with other Intralink administrators.
If you're keen on automating Intralink tasks this is one of the tools which can help you with it.

The program creates, compiles and runs scripting files to locate objects in Pro/INTRALINK and to perform actions on the objects found. You can use wildcards for the objects you wish to locate. You can use the script also to perform specific Workspace tasks. By default it uses the INTRALINK user and default password for this user. All defaults can be configured with commandline options.

Examples

  • IlinkTrail -h
    Show the help screen.
  • IlinkTrail -delete -create -ws Test
    Delete and create Workspace Test
  • IlinkTrail -compact
    Compact local.ddb file
  • IlinkTrail -graphics -user guest -passwd NONE -create -ws LibParts -dep none -inc drw -inc ins -folder *Library* -c din*912*
    Run in graphics mode and login as guest without password. Create Workspace LibParts and checkout all din*912* objects in any folder with Library in the name including all instances and drawings with the dependency set to none.
  • IlinkTrail -purge MechEng
    Run the purge script called MechEng.
    Intralink 3.x cannot run reports on multiple selections. With IlinkTrail you can. An example of running the script multiple times:
  1. IlinkTrail -folder "Root Folder/Library/Fasteners" *
    Run this script to get a listing of all objects in specified folder or
  2. IlinkTrail din912*.prt
    Run this script to find all din912 parts.
    and then run:
  3. IlinkTrail -whereused -i Default
    Create where used reports for each object found in input file (by choosing Default you're using search-result report from previsou run).
    Unfortunately the trailfile mechanism of Intralink will crash when it gets out of sequence in no-graphics mode. So each time a report is empty (e.g. nowhere used) the program will crash. IlinkTrail will just pick it up from there and do the rest.

Configuration

  1. Set the environment variable PDM_LDB_PATH to the desired path to your .proi folder.
    e.g. set PDM_LDB_PATH=c:\users\guest\intralink
  2. Your Pro/INTRALINK startup script needs to be edited to support this tool by preventing returning to the DOS prompt before Intralink finishes:
    Edit the Pro/INTRALINK command and replace :

    start /B %prodir%\%mc%\jre\bin\javaw -Xmx256m -Xss8m -jar %PRO_DIRECTORY%\java\lib\Intralink.jar -l %luknfeel% %intralinkparams% >> "%logfile%"

    by

    "%prodir%\%mc%\jre\bin\javaw" -Xmx256m -Xss8m -jar %PRO_DIRECTORY%\java\lib\Intralink.jar -l %luknfeel% %intralinkparams% >> "%logfile%"

    See also:     http://www.ptc.com/cs/tan/117004.htm

Download

You are free to use this tool without any charge, but also without any guarantees (see the help for the disclaimer). Please contact me and tell me what you think of it and to report bugs.

History

  • 20060822: v0.44 Fixed -inc options.
  • 20060821: v0.43 Added -update option.
  • 20060814: v0.42 Added -dupfrom and -dupto options. Added -fold* options to create folder.
    Added -folmod option. Added -filter option.
  • 20060721: v0.41 Also creating where_used reports (with NOWHEREUSED in it) if objects where not found.
  • 20060721: v0.40 Fixed single field input files.
    Fixed multiple report outputs with -i option.
    Specifically: IlinkTrail will restart itself to process the remainder.
  • 20060720: v0.39 -i option now recognizes and can use Intralink output files.
    Empty reports are now recognized and conflicting object is reported.
  • 20060719: v0.38 Fixed table display bug.
  • 20060712: v0.37 Added -whereused, -allrev and -allver options.
  • 20060711: v0.36 Added -time option.
  • 20060710: v0.35 Added Table Configuration also to Locate window.
  • 20060703: v0.34 Added info to help.
  • 20060615: v0.33 Added -bom option. Added hint for TAN 117004 to "classfile can't be created" error.
  • 20060324: v0.32 Added -rellev option. Fixed true or false settings for -generic and -instance options.
  • 20060323: v0.31 Internal Fico change.
  • 20060323: v0.30 -mem option can now handle names up to 500 chars.
  • 20060317: v0.29 Fixed -mem option (removed -mem ass, now type it yourself -mem AsStored).
  • 20060224: v0.28 Added -pexport, -pimport and -pdate options.
  • 20060220: v0.27 Fixed -after and -before options.
  • 20060209: v0.26 Added -nonum option
  • 20060130: v0.25 Loadpoint option is now used.
  • 20060125: v0.24 Now supports ilink start commands longer than 11 chars. Cosmetic changes: -f -> -folder (-f is now enough). -c -> -checkout (-c still works).
  • 20060116: v0.22 Creating PDM_LDB_PATH folder structure if it doesn't exist yet.
  • 20060113: v0.21 Added -generic, -instance, -html and -common options. Fixed crash when .proi does not exist yet.
  • 20060111: v0.20 Added BaseLine support
  • 20060111: v0.19 Can now handle very large workspaces.
  • 20051103: v0.18 Fixed running in long workspace names
  • 20051020: v0.17 First released version