Page Comparison

...

By default, users and groups that exist on the source server are packed when packing an entity. However, there may be cases when unpacking users on the target server may not be appropriate, especially when the entities are created in a development environment and then unpacked on a production server. With this in mind, the entity packing process includes the ability for a a user to specify which users and groups to include in a packed entity. In addition, an administrator can also select which sub-type entities to pack (with or without the sub-type's parent entity) and whether or not to pack the sub-type entity's associated users, groups and sub-types which can greatly reduce the amount of time necessary to pack a particular entity.

...

1. Launch the Entity Packer from the Entities service.
   • The Pack Entities icon appears in the service toolbar or view toolbar for the Entities service.
     
     
2. Browse to the network location where you want to save the packed entities in the Packing Directory drop-down. 
   • Click Create Dir if you want to create a new sub-folder in a selected network location.
     
     
3. Modify the packing options, as necessary.
   • When the Pack Dependent Entities option is selected, the wizard packs the selected entities and all other entities that are dependent upon the selected entities and the entities that are dependent upon those dependencies.
   1. • This ensures that all of the necessary entities are packed so that your selected entities will function properly on a new system. However, note that this can be time-consuming if the selected entities have a large number of dependencies (and if those dependencies have their own dependencies).
      • In order to reduce the amount of time it takes to pack a particular entity, you can copy an existing, dependent packed entities directly into the destination folder. (assuming that you have made no changes to the entity since it was originally packed).
        
        
   • When Pack Dependent Database Objects option is selected, the wizard packs all of the entity's non-generated database objects, including stored procedures (listed under the Stored Proc. tab), the entity's Base View, and all database objects listed under the entity's DB Objects tab.
     
     
   
   
   
4. Select Next.
5. Select the Pack column for each entity that you want to include in the entity pack.
   • By default, all entities listed in the view from which you launched the wizard are selected.
   • Click Check All to select all of the entities for packing.
   • Click Uncheck All to remove the selection from all selected entities. Clears the Pack Form Templates and Pack Process Flows columns check boxes.
     
     
6. For all of the entities that you want to pack, select or clear the Pack Form Templates and Pack Process Flows columns check boxes, as necessary.
   • When the Pack Form Templates check box is selected for a particular entity, the wizard packs all non-generated form templates associated with the entity.
   1. • Note that the wizard does not pack generated forms since the target system will generate them automatically during the unpacking process.
        
      • If the wizard packs any form templates, it adds this information to a FormTemplates.recpak sub-folder in the entity's entpak folder. The recpak folder is a data pack folder that contains record information for the form template and its associated records (such as Form Template Parts records). See Data Packing and Unpacking for information on the contents of the recpak folder.
        
        
   • When the Pack Process Flows box is selected for a particular entity, the wizard packs any Event Handlers and corresponding Process Flows associated with the entity.
   1. • If the wizard packs any Event Handlers and Process Flows, it adds this information to an EventHandlers.recpak sub-folder in the entity's entpak folder. The recpak folder is a data pack folder that contains record information for the event handler and its associated records (including the corresponding Process Flow). See Using the Data Packing and Unpacking Wizards for information on the contents of the recpak folder. 
        
        
7. Select Next.
8. Specify which Users records, Groups records and sub-type entities to include in the pack.
   • Selecting the All Users options packs all Users records associated with the selected entities and/or sub-types.
   • Selecting the All Groups option packs all Groups records associated with the selected entities and/or sub-types.
   • Selecting the All Sub Types option packs all sub-type entities associated with selected entities.
     
     
   
9. Click Finish to pack the selected entities (and the dependent entities and/or database objects, as applicable).
   • The Entity Packer wizard includes a status bar at the bottom of the dialog (as shown below) to visibly display the progression of the packing process. Once the wizard is complete, a message displays that the process is complete.
     
     
     
     

...

Entity Pack Structure

Each top-level entity pack (.entpak) folder contains the following sub-folder(s) and files:

• DBObjects folder: If you select Pack Dependent Database Objects, the wizard stores any non-generated database objects associated with the entity in this folder.
  
  
• FormTemplates.recpak folder: If you select Pack Form Templates, the wizard stores the entity's non-generated form templates and related records in this folder (which is a data pack, see Using the Data Packing and Unpacking Wizards).
  
  
• EventHandlers.recpak folder: If you select Pack Process Flows, the wizard stores any Event Handlers linked to the entity and their associated Process Flows in this folder (which is a data pack, see Using the Data Packing and Unpacking Wizards).
  
  
• LinkedFieldData.recpak folder: All relevant records associated with this entity (such as the Groups and Users who have been granted permissions on the entity's Security tab) are stored in this folder (which is a data pack, see Using the Data Packing and Unpacking Wizards).
  
  
• Objects folder: This folder stores any Object Repository Objects associated with this entity.
  
  
• Subtype entpak folder(s): If the entity has one or more sub-types, each sub-type has its own entity pack (entpak) sub-folder.
  
  
• ENTITY.APT file: This file stores information about the entity in XML format. The unpacker wizard uses the information in this file to install the entity on the target server.