General questions about userautomation stsadm commands

Hi,

I am about to start testing the user automation stsadm commands offered by the most recent version of ExCM.

I want to make sure that if I specify a particular SITE in the URL paramater to a to any of the userautomation commands that notification messages will only be sent to those users registered for that particular site.

Also, once I copy the FBA's web app web.config file to 'C:\Program Files\Common Files\microsoft shared\Web Server Extensions\12\BIN\OWSTimer.exe.config", do I need to make any edits to the OWSTimer.exe.config file, and will I need to restart the Windows SharePoint Timer Service before I see it in the SharePoint Central Admin Timer Job Status?

Also do you have any other advice when using this functionality?

Thanks, in advance,

Alyssa

Have more questions? Submit a request

5 Comments

  • 0
    Avatar
    David Fisher

    When you setup a User Automation Job all users in the membership provider will be effected. The Site URL property is only used as a lose association to your Web Application.

    Regarding your OWSTimer.exe.config file. Theoretically a copy of your web.config file will work but your configuration file will contain a lot of unnecessary configuration elements. You can find a relatively simple configuration file sample from the link below. The only required elements are the <connectionStrings /> and the <membership /> tags. You will want to copy these tags from your web.config file. The <authentication /> and <authorization /> section are not needed in our OWSTimer.exe.cofig file.

    (Sql Membership Provider : Example Section)
    http://msdn.microsoft.com/en-us/library/system.web.security.sqlmembershipprovider.aspx

    You will also need to restart your Windows SharePoint Timer Service to apply the changes. The last piece of advice I would give is to setup the User Automation Job to run every 2-5 minutes until you get everything working. Once it is working you can change the schedule to a longer interval like once a day.

    User Automation activities are logged to the SharePoint ULS logs. You should see start, stop, error and other notifications in the log file. You can find the User Automation error messages by searching for the application key 'ExCM.UserAutomationEngine'.

  • 0
    Avatar
    David Fisher

    So far, everything is working well on my test sytem, thanks to the information you provided.

    I am down to the finishing touches, which is the email notification messages.  I am trying to get the site name or URL to which the user was originally invited and for which he or she registered into the subject of the email notification.  The format I want is similar to the invitations sent to users to register for the site.  For invitations the subject looks like, "You have been invited to register for access to the '{Zone.Invitation.Url}{Site.ServerRelativeUrl}' site".

    How can I get the actual site name for which the user originally registered into the subject of the notification email that is sent by the userautomation timer job?

    I tried to use the {Url.'Zone'} token.  I substituted Zone for the zone name listed in the SharePoint Central Admin Authentication Providers page.  In my case I changed it to Url.'Extranet'.  All that was displayed in the email was = {Url.'Zone'} even though I had changed (and saved) it to {Url.'Extranet'}.

    Thanks again.

     

    Alyssa

  • 0
    Avatar
    David Fisher

    To add the site name you can just use the {Site.Title} token. Regarding the {Zone.*.*} token. The only zone tokens available are {Zone.Invitation.*} or {Zone.Current.*}. You can find the mail message documentation at the link below. You will find a list of all the tokens and sample data at the bottom of the page.

    (Configuring site messages)
    http://help.sharepointsolutions.com/products/excm/Configuration_Emails.html

    Jeremy Luerkens
    Manager, Software Production
    SharePoint Solutions
  • 0
    Avatar
    David Fisher

    Hi Jeremy,

    I think perhaps I made my last post too convoluted.  I am just focusing on the stsadm userautomation commands, specifically getting the site title in the subject or body of the email for which ExCM sends out emails on the different events:

    AccountApproachingExpiration
    AccountExpiration
    PasswordApproachingExpiration
    PasswordExpiration

    We have a number of extranet sites and users.  They all hang off the web application of extranet.mycompany.com in the extranet zone.  Each of the users registers for a particular subsite.  I would like to have the subsite title in any of the email notifications to the extranet user so that he or she can click on it directly to update their password or login to the site.  The user may or may not know their subsite.

    The {Url} token shows whatever I entered as the URL to the stsadm userautomation-createjob and not the actual site name to which the user is registered.  I am still having trouble getting the {Url.'Zone'} token to display correctly.

    At least in my interpretation of the documentation you specified (http://help.sharepointsolutions.com/products/excm/Configuration_Emails.html), these tokens are when you invite users to register for a particular site, and after they register.  It seems, at least in how the documentation is written, that these tokens are not for when you are trying to configure the email messages when using the ststadm userautomation-setnotification command.

    In any case, I tried to do as you suggested and added the {site.title} token to a customized message that I created using the template in "C:\Program Files\SharePoint Solutions\Extranet Collaboration Manager\Configuration\notification_PasswordExpiration.xml".  I then used the stsadm userautomation-setnotification command to change the path to my customized message which has the tokens specified in http://help.sharepointsolutions.com/products/excm/webframe.html?User_Automation_SetNotification.html.  The {site.title} token was not resolved when I received the email notification of the password expired event.

    Is there anyway in which to get the actual site title (not the URL that I specified on the userautomation-createjob command) for which the user is registered to show in the notification emails?

    I hope this post clarifies things.  I apologize if what I had written previously was misleading.  (I also feel like I'm missing something.)

    Thanks again.

    Alyssa
  • 0
    Avatar
    David Fisher

    Unfortunately the User Automation command is not tied to any site or sub-site. The only URL data available is at the web application level. You can find the list of tokens from the link below. I did a quick review and found an error with the {Url.'Zone'} token. It appears the last bracket is omitted. Therefore you can use this token without the last bracket like {Url.Extranet or just hard-code the URL for the given zone. We'll add this to our issues list and correct it in a future release.

    (User Automation Notification Messages)
    http://help.sharepointsolutions.com/products/excm/User_Automation_SetNotification.html

    Jeremy Luerkens
    Manager, Software Production
    SharePoint Solutions
Please sign in to leave a comment.