The qptool refresh
command refreshes places and PlaceTypes. By default, the command runs daily at 4 AM to refresh all child places on the server, but not PlaceTypes. You can run qptool refresh
from the server console or through the Working with Templates
A place manager can control whether qptool
refreshes a place.
If the place manager allows it, membership of a place can be passed to a PlaceType when the PlaceType is created. That membership is then passed to new places created from the PlaceType. For example, if Annie is a member of Sales
with Author access, she can automatically become an Author in Sales PlaceType
created from it, and in West Coast Sales
created from Sales PlaceType
Changes to members and membership are not inherited during a refresh, however. For example, if the manager of Sales
changes Annie's access to Reader, Annie still has Author access to Sales PlaceType
and West Coast Sales
after they are refreshed.
When a new room is inherited, membership to the room is not inherited, but instead is determined by the room's parent room in the place. For example, to continue the preceding example, assume that the manager of Sales
adds a new room called Finances
and gives only herself access to read sensitive information in it. When Sales PlaceType
and then West Coast Sales
are refreshed, West Coast Sales
inherits the room Finances
but all West Coast Sales
members with Reader access or above to Sales
can read Finances
unless the West Coast Sales
manager restricts the access.
Levels of refresh
There are two levels of refresh available for a place: basic refresh (the default level) or replace. With basic refresh, elements originating from a PlaceType but modified directly in a place are not affected by the refresh. For example, basic refresh does not affect changes a place manager makes to the Welcome page.
A replace occurs only when you use qptool refresh
command with the -r argument. Use replace with extreme caution because it causes all elements in a place that originated from a PlaceType to be updated, even elements modified directly in the place.
Neither basic refresh nor replace modifies elements that were created directly in a place rather than originating from a PlaceType.
Because changes to a PlaceType are never made directly in a PlaceType but instead can occur only through a refresh, it makes no difference which level of refresh you use to refresh PlaceTypes.
How basic refresh affects the elements in places
If you do a basic refresh of a child place with its PlaceType, and there are no changes in the PlaceType, the refresh causes no change in the child place. If there are changes in the PlaceType, the child place does not inherit an element change or deletion from the PlaceType if the element was also changed or deleted directly in the child place.
How replace affects the elements in places
If you replace a place with its PlaceType -- using qptool refresh -r
-- changes made to elements directly in the place that originated in the PlaceType are lost. For this reason you should use replace with extreme caution.
Parent topic: Refreshing places and PlaceTypes