Tweet roundup from Arbortext user meeting Oct 2010: Todd Hicks, an ACL tool to find and replace attributes
Earlier today, the Arbortext User Group had their monthly meeting. The guest today was Todd Hicks from Wolters Kluwer with us. He’s going to talk about a tool he built at the request of his users. His users want to do less work and they’re always asking him, “hey, can you make it do this?” Well, today, we saw one of the many things you can do if you have Arbortext in your tool chest.
In case you missed it, you can watch the video recording or browse through the live tweet stream from the event captured below. If you want to know more about the kinds of tools Todd and his team have built on the Arbortext platform, you might want to listen to Todd’s interview.
Here’s a snippet from the PTC Express newsletter. Generally, we post code to the Adepters Code Archive. However, it’s a fairly straight-forward process to add a button to Arbortext Digital Media Publisher (DMP), if you know what you’re doing. Hopefully this will help you get started customizing DMP. In March, the Arbortext PTC/User group did a focus on DMP and what you can do with it. DMP is part of the Arbortext Publishing Engine. If you don’t already know DMP, you should get to know it: DMP assembles documents and multimedia files for publication. In addition, DMP provides capabilities for distributing updates to your digital media via the web.
Here’s a snippet from the PTC Express newsletter. You never know how well something will get saved and archived, so we’ve reproduced it here. Generally, we post code to the Adepters Code Archive. However, this article went out from the PTC Express news letter and it’s getting some attention in places that don’t really understand the impact or how to present the information as the code that it is. So, we’ll join the club, improve the article, and continue adding value to the community at large.
Let us present:
Creating an Update Button in Arbortext Digital Media Publisher (DMP)
It’s a fairly straight-forward process to add a button to Arbortext Digital Media Publisher (DMP). This is a gentle introduction to getting started with customizing DMP. In March, the Arbortext User group meeting was all about DMP. There’s some amazing things that you can do with it. The full application is customizable.
DMP is part of the Arbortext Publishing Engine. If you don’t already know DMP, you should get to know it: DMP assembles documents and multimedia files for publication. Out of the box, DMP provides capabilities for distributing updates to your digital media via the web.
This article describes how to create an update button that your customers can select and that will initiate a download all of the updated pages on your website and store them locally for later offline viewing.
Creating the button that performs this functionality is not completely intuitive. Here’s what you need to do to create the “Update” button with DMP.
First: Configure the dmp.properties File
To make certain that the button will work properly once it is placed into the DMP image, set the following options in dmp.properties file to enable update pack generation:
# updateStatus: how the update should be proceeded. There are three possible values
# 0: Disable update, no update is generated (but update button and
# configuration is available in Consumer).
# 1: Manual update: Consumer user can update content by clicking
# the update button
# 2: At launch: Consumer will check for update each time the application
# is starting
# 3: Auto update: Consumer will update at scheduled time. updateSchedule
# property must be set.
# updateFrom: the version that the update is based on. The version must
# be older than the version of the current project. This
# property uses the same format as the "version" property
# defined above, e.g. 1.0, 2.0.1, etc. It is an error if
# the version is the same or newer than the current version.
updateFrom = 1.0
# The url pointing to the folder that contains update
# manifest file. It can be a remote URL or local directory.
# For a remote URL, it should always starts with "http" or "https".
# For a local directory, if a relative path is specified, it is relative
# to $CONSUMER_INSTALL_DIR/project/WEB-INF. For example, if updateUrl is
# set to "../_updateFolder", it indicates
updateUrl = updatepack
# Whether Consumer user is able to configure update properties.
# true: show update configuration page in Consumer
# false: don’t show configuration page
# Note: update configuration page will not show even if this value is set
# to true if
# 1. Consumer is not installed, or
# 2. Web deployment and the request is not from localhost
updateConfigurable = true
# The schedule to run update. This property value is required only if
# updateStatus is set to "3". The updateSchedule has the format of
# UpdateType: d (daily), w (weekly), m (monthly)
# DayOfMonth: 1-31
# DayOfWeek: 1-7
# HourOfDay: 0-23
# For example, to run update at 3am every day, the updateSchedule should
# look like: updateSchedule = d:0:0:2
# To run update at 3am every Friday: updateSchedule=w:0:5:2
# To run update at 3am the fifth day of each month at 3am:
Second: Check other properties in the dmp.properties File
Make certain the following property values do not change between the base release and all updates. Changes to these values will cause updates not be properly recognized.
Third: Create the Button
To create an “Update” button in DMP, follow these steps:
Create a new “Welcome” page by opening up your text editor and placing the following template code at the top:
Under the <div> tag, place the content you want displayed to your users as the first page of your DMP image. For example:
<p>The DMP Help Center itself is an application of DMP. You can search
the documentation using the search controls on the upper-left side of
the window. The Help Center also provides an index to the HTML and PDF
documentation. (To view the PDF documentation, you must have Adobe
Acrobat Reader installed and correctly configured on your system.).</p>
Directly under this new content, add the following code:
Run the dmp.bat file. You should see your button displayed. When you click this button, DMP will check for updates.
You should see that the content shows “current” because an update pack has not yet been generated.
Create and deploy the updates pack.Click the update button again. You will notice a series of steps being performed by your image followed with a completion status.Your content is now up-to-date. Practice adjusting the duration of the updates by opening the dmp.properties and setting the updateSchedule to different codes. The default code is:
Setting the update to Schedule as described above will set the update to run on the fifth day of each month at 3am.
The update button will work in both standalone mode and Web application mode.