AgileApps Support Wiki Pre Release

Difference between revisions of "Overwrite Previous Package"

From AgileApps Support Wiki
imported>Evelyn
m
 
imported>Aeric
 
(27 intermediate revisions by the same user not shown)
Line 1: Line 1:
The ''Overwrite Previous Package'' option provides Publishers a choice to '''Merge''' or '''Overwrite''' packages. The Merge/Overwrite choice is applied when a Subscriber installs a package.


{{tenantfeatures|}}
==About the "Overwrite" Option==
In general, the ''Overwrite Previous Package'' option means that:
:* Previously installed items are deleted, if the container they are in is included in the package. (Otherwise, they are not deleted.)
:* Previously installed Email templates and Quick Text items are updated, if the object is included in the package. (Otherwise, they are not updated.)


For example, suppose that a package contains an object that defines two Web Forms, and that a subscriber installed that package. Further suppose that the publisher deletes those web forms, and creates a new package containing that object. When the subscriber installs the new package, the Web Forms are deleted from the subscriber's system is the package was created with the Overwrite option. Otherwise, they remain.


==Working with the "Overwrite" Option==
{{:Option:Overwrite Previous Package}}
When enabled by the service provider, a package publisher has two additional options when creating a package:
:;Merge: Previously-installed items created when an earlier version was installed are ''not'' deleted.
:: They remain on the subscriber's system, even if they were deleted by the publisher.
:;Overwrite: Items in the previous package that were deleted by the packager are removed from the subscriber's system,
::with the exception of these items, which remain on the subscriber's system unless and until they are manually deleted:


;Considerations:
::* Applications (if previously added as a result of a [[Package Dependency]]
*If the [[Package]] is Unlocked, this option is not available
::* Classes         
*If the [[Package]] is Locked, the ''Overwrite Previous Package'' option becomes available, and can be enabled from [[Manage Tenant Capabilities]]
::* Global Picklists
*When the Overwrite Previous Package option is enabled, these options become available as part of package configuration:
::* Global Template Variables
:;Merge:During installation by a subscriber, the new Package items are merged with the subscribers' existing database (previous package)
::* Roles           
:;Overwrite:During installation by a subscriber, the new Package items overwrite the subscribers' existing database (previous package)
::* Teams           
::*If the subscriber has created new items/platform elements, they are not affected (unless there is a naming conflict, in which case, the published package will overwrite the subscriber-created items)
::* Web Services
 
:''Learn more:'' [[Package Items#How Package Items are Applied]]<noinclude>
 
[[Category:Tenant Capabilities]]
</noinclude>

Latest revision as of 23:02, 5 August 2015

About the "Overwrite" Option

In general, the Overwrite Previous Package option means that:

  • Previously installed items are deleted, if the container they are in is included in the package. (Otherwise, they are not deleted.)
  • Previously installed Email templates and Quick Text items are updated, if the object is included in the package. (Otherwise, they are not updated.)

For example, suppose that a package contains an object that defines two Web Forms, and that a subscriber installed that package. Further suppose that the publisher deletes those web forms, and creates a new package containing that object. When the subscriber installs the new package, the Web Forms are deleted from the subscriber's system is the package was created with the Overwrite option. Otherwise, they remain.

Working with the "Overwrite" Option

Lock-tiny.gif

When enabled by the service provider, a package publisher has two additional options when creating a package:

Merge
Previously-installed items created when an earlier version was installed are not deleted.
They remain on the subscriber's system, even if they were deleted by the publisher.
Overwrite
Items in the previous package that were deleted by the packager are removed from the subscriber's system,
with the exception of these items, which remain on the subscriber's system unless and until they are manually deleted:
  • Applications (if previously added as a result of a Package Dependency
  • Classes
  • Global Picklists
  • Global Template Variables
  • Roles
  • Teams
  • Web Services
Learn more: Package Items#How Package Items are Applied