In /atg/devtools/ create a local version of admins.xml:

  
    Your Content
    YourRepository
    
      

      
    
    
      


      
    
  

Thanks Russell!

Share on Facebook

For instance, you have an Item called Garage, and it has a List of Car RepositoryItems as a property named cars. If you are using a different type of collection, some of the following will need to be adjusted accordingly, but the overall approach is the same. A Car Item has a name and an option picture as properties. If you have a form to display and allow for editing of a Garage, including all of its cars, which is handled by a sub-class of a RepositoryFormHandler, you can edit values on both the Garage, as well as the Cars within cars, without much difficulty.

What gets tricky is if you need to access form submission values for properties on the Cars. For instance if you wanted to allow a user to delete a car by simply blanking it’s name, or if you wanted to automatically assign a picture based on the make and model in the name field. You can’t just access the submitted but un-updated values (say from within the preUpdateItem method) using simple nested getValueProperties. Here is what you can do:

First you need to get the List of cars. This is actually an instance of a RepositoryFormList.

RepositoryFormList carsFormList = (RepositoryFormList) getValueProperty("cars");

This is a subclass of ArrayList, and can be iterated through to get at each car’s incoming values. Remember we aren’t dealing with the actual RepositoryItems, that would be easy, this is what to do in order to grab the form submitted values destined for properties on these sub-Items in the preUpdateItem life-cycle phase. The contents of this ArrayList are RepositoryFormHashtables.

Iterator iter = carsFormList.iterator();
while (iter.hasNext()) {
RepositoryFormHashtable rfh = (RepositoryFormHashtable) iter.next();
....

The incoming property values are in this Hashtable, keyed by the property’s CAPITALIZED name:

String incomingName = (String) rfh.get("NAME");

Now that you have the name you can see if it’s blank and then delete the related car Item (hint: the repositoryId of the car Item this set of properties is destined for is in the Hashtable with the key of “REPOSITORYID”), or parse it and search for a normalized version, or find a related image automatically, or whatever else you wanted to do with it prior to the actual handleUpdate phase.

You can also get the RepositoryItem by calling:
RepositoryItem rfhitem = rfh.getRepositoryItem();

To be on the safe side your best bet is validate that and do something like this:

final RepositoryItem rfhitem = rfh.getRepositoryItem();
MutableRepositoryItem carItem = null;
if (rfhitem instanceof MutableRepositoryItem) {
carItem = (MutableRepositoryItem) rfhitem;
} else {
if (!(rfh.isEmpty() || ((rfh.size() == 1) && (rfh.get("REPOSITORYID") != null)))) {
try {
carItem = this.getRepository().getItemForUpdate(rfhitem.getRepositoryId(),
MyConstants.CAR_ITEM_DESCRIPTOR);
} catch (final RepositoryException e) {
if (isLoggingError()) {
logError(
"GarageFormHandler.handleUpdate: repository error while accessing an car.",
e);
}
}
}
}

Then you can access the existing car Item in order to delete it, or compare values to the incoming values, etc…

Share on Facebook

You can download it all here.

The example JSP takes in a query parameter userId and generates the XML for the user profile with that id. For instance, if you call:

http://alita.local:8840/test/test.jsp?userId=930003

you get this……

<user:user id="user930003" repositoryid="_003930003" xmlns:enc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:user="http://www.atg.com/ns/UserProfiles/user" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://www.atg.com/ns/UserProfiles/user UserProfiles+user.xsd ">
<user:user.securitystatus xsi:type="integer">0</user:user.securitystatus>
<user:user.scenarioinstances xsi:nil="true"></user:user.scenarioinstances>
<user:user.votecount xsi:nil="true"></user:user.votecount>
<user:user.firstname xsi:type="string"></user:user.firstname>
<user:user.gender xsi:type="string"></user:user.gender>
<user:user.emailstatus xsi:type="string"></user:user.emailstatus>
<user:user.dateofbirth xsi:type="date">1980-02-11</user:user.dateofbirth>
<user:user.markers xsi:nil="true"></user:user.markers>
<user:user.locale xsi:nil="true"></user:user.locale>
<user:user.lastactivity xsi:nil="true"></user:user.lastactivity>
<user:user.slotinstances xsi:nil="true"></user:user.slotinstances>
<user:user.lastname xsi:type="string"></user:user.lastname>
<user:user.description xsi:nil="true"></user:user.description>
<user:user.email xsi:nil="true"></user:user.email>
<user:user.autologin xsi:type="boolean">false</user:user.autologin>
<user:user.businessprocessmarkers xsi:nil="true"></user:user.businessprocessmarkers>
<user:user.middlename xsi:type="string"></user:user.middlename>
<user:user.password xsi:type="string"></user:user.password>
<user:user.receiveaffemail xsi:nil="true"></user:user.receiveaffemail>
<user:user.lastpasswordupdate xsi:type="timestamp">2007-08-06T20:13:46.0</user:user.lastpasswordupdate>
<user:user.generatedpassword xsi:type="boolean">false</user:user.generatedpassword>
<user:user.receivepcaemail xsi:nil="true"></user:user.receivepcaemail>
<user:user.receiveemail xsi:type="string"></user:user.receiveemail>
<user:user.registrationdate xsi:nil="true"></user:user.registrationdate>
<user:user.usertype xsi:nil="true"></user:user.usertype>
<user:user.previouspasswords xsi:nil="true"></user:user.previouspasswords>
<user:user.member xsi:type="boolean">false</user:user.member>
<user:user.login xsi:type="string"></user:user.login>
<user:user.mailings xsi:nil="true"></user:user.mailings>
<user:user.scenariovalues xsi:nil="true"></user:user.scenariovalues>
<user:user.nickname xsi:nil="true"></user:user.nickname>
<user:user.lastemailed xsi:nil="true"></user:user.lastemailed>
</user:user>

I may extend it to serve out collections of items (currently if you nest it in an RQLForEach or similar, you get the <?xml line once per item. It’s not much, but hey, this is my first ATG post:)

Devon

Share on Facebook