Howto:Annual calender in V8
This information applies to Version 8
The Boolean object in the PBX version 8 has no annual calendar function, which will be a function implemented in version 9. This small XML allows a, confessed not very comfortable and flexible, work-around for those who can’t live without that function.
The basic idea is that a, typically outside, call is answered by this XML. You can enter the non-office days (let’s call them holidays) and office days (workdays). For both situations the XML is able to:
- play an announcement
- transfer the call to an extension
- terminate the call
It is possible to just terminate the call or just transfer the call without any announcement or just play an announcement and then terminate the call. So each combination is possible independently for each “branch” (holidays and workdays).
The behaviour depends on the files in the directory where the XML is running and no XML code has to be modified.
This XML can also be combined with the weekly calendar of the PBX. How is described in the configuration section.
Just copy the contens of package provided in the download section in a directory of you CF. Then create a VM object in the PBX and insert in the Path-Field the path to the Holy.xml (like “http://xxx.yy.zz.uu/drive/cf0/test/holy.xml”).
Now configure your PBX so that incoming calls points to that number.
If you want an announcement, create a voice-file called “Hday.g711a” for the holidays and “Wday.g711a” for the workday announcement. If the XML is called it will check the day and then if such a file is present; if yes it will be played, if not it will be skipped to the next option.
Please note that the announcement should be in “G711a” format. How to create the announcements you will find in the relative articles in this wiki.
The extension where the call is transferred after the previous option is defined in a text file called “hday.txt” for the holidays and “wday.txt” for the workdays. In the text file (which you can simple create with the text editor) write the extension, so for example “32” if that should be the target of the call.
Please note that the actual XML allowed only a call transfer to existing user, so no WQ or dummy user or similar.
Now you have to define the holidays. For each day you must create a file named ddmm.txt, where dd=day and mm=month. The file itself could be empty (file length 0), the simplest way is again using an editor and just save empty text files with the right name.
Please note that the format must be fixed, so for day 4 and month 3 the file name must be 0403.txt.
To give you an idea in the download you find also a file called 1103.text and a sample file hday.text containing the extension 24.
If you want to combine the Boolean object (the weekly calendar) with this XML you have to observe some rules. The basic problem is that the call which is transferred from a XML will not follow a CFW but rings on the destination even when this extension has activated a call forward. So we must configure it in another way. Configure your PBX that the call in the out-of–office period of the Boolean calendar follows an independent tree. So the Boolean object should activate a call forward on the XML in the out-of-office period. Done this the call in that period (during the night) follows the CFW (and goes typically to a WQ with an announcement “sorry, we are closed…”). In the office period the XML will transfer the call to the day extension (with or without previous announcement) or, during holidays, playing the alternative message (and transfer to the night user or similar if required).
By the way: the XML hat some remarks, so it should be not difficult to understand or modify it….
- Download the complete file package of scripts and files described in this article.