Plum DEV Documentation
plumdevguide:filerepo

Using the File Repository

The file repository within Plum DEV can be used to locally store audio files and application files (vxml, grxml, jsgf, js, xml). For example, in a case where network latency could produce a perceptible lag in the dialogue a caller hears, you could use the file repository to store large audio files. Please note that there is a 10MB limit for the file repository for your DEV account.

To access the file repository, click “Applications” to bring up the drop-down menu for application options and click on “File Repository”.

Audio Files

To add an audio file to your file repository, click on “Add File”.

For “Select File:”, click on the “Browse…” button.

Select an audio file and click on the “Save” button to save your audio file to the file repository.

Please note that the audio file must conform with the audio specifications detailed here, or the audio file will fail to upload.

Once you've uploaded an audio file, there are 3 actions available for the audio file. The “Play” icon allows you to play your audio file. The “Link” icon allows you to copy the full link location of the audio file if you wish to reference it in a remote (external) application. The “Delete” icon allows you to delete your audio file.

Please note that any audio files stored in the file repository can be accessed via relative reference for files within the file repository. For example, if you have an application file in your home directory and wanted to reference an audio file named “welcome.wav” within a folder named “audiofiles” in your home directory, you could reference it with the following VoiceXML code:

<audio src=“audiofiles/welcome.wav”/>

However, please note that if you are referencing the audio file within a scratchpad, you would need to reference the full URL.

Application Files

In addition to being able to add audio files to your file repository, you can also add application files to your file repository. The types of application files you can add are: vxml, grxml, jsgf, js, xml. This allows you to save application code and grammar files locally if you're worried about network latency when fetching your application scripts.

To add a file to your file repository, click on “Add File”.

Next, enter a file name and select the file type for your application file.

Click on the “Save” button to create the file. From here, a text editor window should open that will allow you to enter your application code.

Once you've entered your code, you can click on the “Save” button to save your file.

From there, you should see your saved application file within the file repository.

Alternatively, you can also select an application file that you already have and save it to your file repository.

Once you've uploaded an application file, there are 3 actions available for the application file. The “Edit” icon allows you to edit your application file. The “Link” icon allows you to copy the full link location of the application file if you wish to reference it in a remote (external) application. The “Delete” icon allows you to delete your application file.

Please note that any application files stored in the file repository can be accessed via relative reference for files within the file repository. For example, if you have application code in your home directory and wanted to reference a grammar file named “alphanum.grxml” within a folder named “grammarfiles” in your home directory, you could reference it with the following VoiceXML code:

<grammar src=“grammarfiles/alphanum.grxml”/>

However, please note that if you are referencing the file within a scratchpad, you would need to reference the full URL.

Adding a Folder

To add a folder to your file repository, click on “Add Folder”.

Next, enter a name for your folder and click on the “Save” button.

From there, you should be able to add files to your created folder within the file repository.

Once you've created a folder, there are 2 actions available for the folder. The “Edit” icon allows you to rename your folder. The “Delete” icon allows you to delete your folder.

Downloading a Zip File

To download a zip file of all the files within your entire file repository, click on “Download Zip” in your home directory.

From there, you can save a copy of all the files in your file repository in a zip file.

Please note that if you wish to only download a subset of your file repository, you can go to one of your folders and clicking on “Download Zip” will just download the contents of that folder.