# Creating Job Scripts

```{image} /img/jobprocessor/jobs/powerjobs_ise.png
:align: right
:width: 450px
```

## Choose PowerShell IDE

To get started with creating a custom job, open the PowerShell IDE or editor of choice. The _powerJobs Processor ISE_ shortcut in the start menu can also be used which already opens one of our [](</jobprocessor/jobs/sample_jobs>).

## Prepare PowerShell environment

During development it can be useful to be able to start the whole script or parts of it without having to run it on the job processor.\
To achieve this, some important steps - which are [performed automatically in the Job Processor](</jobprocessor/jobs/setup_job>) - must be carried out manually:

A connection to Vault must be established with the *Open-VaultConnection* cmdlet so that the variables `$vault`, `$vaultConnection` and `$vaultExplorerUtil` variables available.

Now a test file or any other Vault entity can be retrieved and assigned to a variable just like the [Setup_job.ps1](<jobprocessor/jobs/setup_job:setup_job.ps1>) would do in the Job Processor.\
For example set the `$file` variable to the first _.idw_ file that is found in Vault:

```powershell
$file = Get-VaultFile -Properties @{'File Extension'='idw'} #Search for a Drawing file
```

Any modules placed in the [powerJobs modules directory](<jobprocessor/jobs:modules>) are typically [auto-imported](<https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_preference_variables#psmoduleautoloadingpreference>) as soon as the powerJobs module is used.\
To make them available immediately, you can also manually import them by calling `Import-Module powerJobs`.

The variable `$workingDirectory` holds the path to a temporary directory (located in *C:\\Temp\\powerJobs Processor\\...*) where e.g. Vault files can be downloaded or file exports will be generated.\
All the files which are created in this directory during the development phase, will be automatically cleaned up at the next job execution.\
Alternatively, they can be removed at any time using the [Clean-Up](</jobprocessor/code_reference/cmdlets/clean-up>) cmdlet.

```powershell
Clean-Up -folder $workingDirectory
```

## Choose from Sample Jobs

Our standard delivery comes with a couple of [](</jobprocessor/jobs/sample_jobs>) that can be used as templates for new jobs.\
Choose one of those job scripts and place a copy of the script in the _%ALLUSERSPROFILE%\\coolOrange\\powerJobs\\Jobs_ directory.\
Give your new Job a meaningful name in the format _YourCompanyName.SomeJobName.ps1_.

If you prefer to do customizations, for example some sample jobs don't allow all supported formats, the new script can be extend by adding the desired extensions like _iam_, _ipt_ or _ipn_:

```powershell
if( @("idw","dwg","iam","ipt","ipn") -notcontains $file._Extension ) {
	Write-Host "Files with extension: '$($file._Extension)' are not supported"
	return
}
```

An other example would be to changed the name of the exported target file.

In this example the according filename variable is extended with the revision number of the Vault source file:

```powershell
$pdfFileName = "$($file._Name)_$($file._Revision).pdf"
```

## Start from Scratch

Create a new script file with a meaningful name in the IDE and place it in _%ALLUSERSPROFILE%\\coolOrange\\powerJobs\\Jobs_ with the file extension _.ps1_.\
In this example we are going to download the file, open it in the Inventor application and export it as PDF.

## Download the file from Vault

We will use the [](<inv:powervault#code_reference/commandlets/save-vaultfile>) cmdlet to download the file to our working directory.

```powershell
$downloadedFiles = Save-VaultFile -File $file.'Full Path' -DownloadDirectory $workingDirectory
```

## Open the file in Inventor

After downloading the file we will use the [open-document](</jobprocessor/code_reference/cmdlets/open-document>) cmdlet to open the file in Inventor.

```powershell
$file = $downloadedFiles | select -First 1
Open-Document -LocalFile $file.LocalPath -Application 'Inventor'
```

## Exporting the file

Now we can export the document as PDF, using the [export-document](</jobprocessor/code_reference/cmdlets/export-document>) cmdlet.

```powershell
$pdfFileName = "$($file._Name).pdf"
Export-Document -Format 'PDF' -To "$workingDirectory/$pdfFileName"
```

## Closing the opened file

Finally we close the file using the [](</jobprocessor/code_reference/cmdlets/close-document>) cmdlet.

```powershell
Close-Document
```

To run the job on the job processor see the [Registered Jobs](<jobprocessor/jobs:registered job types>) section and [Queueing custom jobs](<job_configuration:queueing jobs>).\
If values in the job regularly change, it is also possible to declare [settings](<jobprocessor/jobs:job settings>) in the job that can be easily modified in the [powerJobs Settings Dialog](<job_configuration:powerjobs settings dialog>) user interface.