1. Aptify Support
  2. Installing & Administering Aptify
  3. Administering Aptify
  4. Administering the Object Repository

Administering the Object Repository

Avatar
Madhuri Dange

The Aptify Object Repository is a central repository for all software components, reports, and other files that are used within the system. Aptify’s component-based software development approach offers a great deal of flexibility by allowing administrators to update software on the server that is automatically distributed to each client machine. The automatic distribution feature of Aptify is a key benefit that dramatically reduces the administrative overhead traditionally associated with supporting enterprise business applications.

The Object Repository in Aptify is managed through the Object Repository Administration application and its associated dashboard. The services included in this application allow the administrator to define object contexts, configure object types, and store or update files required by Aptify to run.

This topic is comprised of these sub-topics:

Administering Object Contexts

 

The Aptify Object Repository contains several sub-groupings of objects. Each of these subgroupings is an object context and represents a logical grouping of software components that are associated with specific users. Each Aptify user account is linked to one object context using the User Administration wizard. By supporting multiple object contexts, it is possible to tightly control the software distributed to each user.

Object contexts may be part of a hierarchy of contexts. If an object context has a parent context, the user's context is determined by first searching for packages and objects underneath the object context to which they are assigned, and next searching for packages and objects underneath the parent context if they are not found underneath the immediate context.

This topic contains the following sub-topics:

Creating a New Object Context

Follow these steps to create a new Object Context for the Object Repository:

  1. Open a new record from the Object Contexts service.
  2. Enter a Name and Description for the object context in the fields provided.
  3. If this object context is to be the default context for all users created within the system, select the Default Context option. If you have identified another context object in a user's record, that other object context will be referenced for that user instead of the default.
  4. If this object context is based on another object context, enter the parent context in the Parent field.
    • If an object does not exist underneath the current context, the system will search under the parent context for the object instead.
  5. Enter a Download Path.
    • This path identifies the directory for the packages within the context to use as a default location when files are obtained from the object repository. Any directory path may be entered by clicking on the folder icon and navigating to the desired directory. Or, you can use the <DefaultPath> keyword, described below. Certain keyword locations have been configured in Aptify to be used instead of entering a directory path. These keyword locations include:
      • <DefaultPath>: This is the default download path for repository objects. For Aptify 6.0, this defaults to C:\Program Files\Aptify 6.0.
      • <WindowsPath>: This indicates that files will be downloaded to the computer's Windows directory. This option is not currently supported.
      • <WindowsSystemPath>: This indicates that files will be downloaded to the computer's Windows system directory. This option is not currently supported.
      • <AptifyPath>: This indicates the location where the Aptify client was installed on the computer. This option is not currently supported.
      • <WindowsTempPath>: This path indicates that files will be downloaded to the computer's temp directory. This option is not currently supported.
      • <UserProfilePath>: This path is the current user's profile directory. This option is not currently supported.  
        Object Contexts Record
  6. Enter a Default Package. This field identifies the ID of an Object Packages record that is considered the default package for this context.
  7. Enter a Startup Package. This field identifies the ID of an Object Package that contains the objects that the system should retrieve each time Aptify is launched.
    • Generally, these are the objects that are required to use the client. Other objects that are not required should be associated with other packages; these objects are subsequently downloaded as needed.
    • For the Production context, this field identifies the standard Aptify Startup package.
  8. Save the Object Context record.


Setting the Default Object Context

The standard product ships with only one object context created: Production. If an organization requires multiple object contexts, the administrator must indicate which is the default. If a user is linked to a non-default object context, the system will look for objects in the object context identified on the user's record, not in the default object context.

To set the default object context to a different object context than the existing default:

  1. Open the current default Object Contexts record.
  2. Clear the Default Context option.
  3. Save and close the Object Contexts record.
  4. Open the Object Context that should be the default.
  5. Select the Default Context option.
  6. Save and close the Object Contexts record.

Creating Object Packages

 

 

Object packages allow the administrator to group objects of similar deployment requirements together. These objects can then be downloaded or used at designated times. For example, all the objects stored in the Startup object package are downloaded to the client machine every time Aptify is run if it is identified as the Startup Package on the Object Contexts record. Other object packages, such as CRM, store only those items that are downloaded to the client machine the first time they are needed. The objects then remain on the client machine for future use.

Aptify includes a standard group of object packages with the Production context object; these object packages include Startup, CRM, DataModules, ReportBrowser, Aptify Shell, Special Startup, ReportBrowserReports, WebBrowser, Setup, Help, WEB, Process Pipeline, Dashboards, and Application Server. See the Object Packages records for a brief description of each package. Additional object packages may be created by the administrator as they are needed by the organization.

New object packages can be created by the administrator to store any new objects necessary for organization-specific configuration of the system. Each object package created within Aptify is associated with one specific context object.

It is strongly recommended that any organization-specific configuration objects be stored in an organization-specific object package. This allows storage of all configured objects without the concern that an upgrade may later overwrite those stored objects. It is also worth noting that client specific objects in a standard package will also never be overwritten unless they overwrite a standard object (in other words, a client-specific object will not be overwritten unless it has the same name as a standard Aptify object).

 

Follow these steps to create a new Object Package:

  1. Open a new record from the Object Packages service.
  2. Enter a Name and Description for the object package in the fields provided.
  3. Enter the name of the Object Context with which this package should be associated.
  4. Enter the Download Path for all objects within this package.
    • This path identifies the directory for the objects within the package to use as a default location when files are obtained from the object repository. Any directory path may be entered by clicking on the folder icon and navigating to the desired directory. Certain keyword locations have been configured in Aptify to be used instead of entering an entire directory path. These keyword locations include:
      • <DefaultPath>: This is the default download path for repository objects. For Aptify 6.0, this defaults to C:\Program Files\Aptify 6.0.
      • <ObjectContextPath>: The path indicated in the Download Path field of the specified context object is used as the download location for all objects included in this package.
      • <WindowsPath>: This indicates that files will be downloaded to the computer's Windows directory. This option is not currently supported.
      • <WindowsSystemPath>: This indicates that files will be downloaded to the computer's Windows system directory. This option is not currently supported.
      • <AptifyExplorerPath>: This indicates the location where the Aptify client was installed on the computer. This option is not currently supported.
      • <WindowsTempPath>: This path indicates that files will be downloaded to the computer's temp directory. This option is not currently supported.
      • <UserProfilePath>: This path is the current user's profile directory. This option is not currently supported.
        Object Packages Record
  5. Select the Always Check For Object Updates option if you want the system to download an object each time it is requested during a single session.
    • When this option is cleared, the information for objects in this package is retrieved only once during a user session and the information is used throughout the session. When it is selected, each time the Object is requested, the Object's information is retrieved from the database.
    • You only need to enable this option if you expect that the objects in this package will change during a user's session. Otherwise, you should leave it cleared.  
  6. Save the Object Packages record.

Administering Object Repository Objects

 

 

All of the files used by Aptify are defined as objects within the Object Repository. Each object stores information about a particular file, including the object type, the method of accessing the object, the download path, and the name of the file.

This topic contains information on the following sub-topics:

Creating a New Object Type

 

 

There are generally two situations where a new object type is created:

  • To allow the easy grouping and categorization of files that are stored on the server.
  • To group specific files that need to be registered in a different way than other files in the other object types.

Follow these steps to create a new object type:

  1. Open a new record from the Object Types service.
  2. Enter a Name and Description for the new Object Types record.
  3. Select the Auto Register option if you need to register the file with Windows using the command specified in the RegCmd field.
  4. In the RegCmd field, enter the Windows command necessary to correctly register the file of this object type (for example, Gacutil.exe adds a shared assembly to the .NET Global Assembly Cache).
  5. Enter the Default Access Method for the objects of this object type (i.e., DBBlob).

     Object Types Record
  6. Save and close the Object Types record.

Creating Object Repository Objects

 

 

Object Repository Objects records the store information about objects used in Aptify. This includes the object type, access method, where the object is to be downloaded, the object's current version, and date when the object was last updated. Object Repository Object records are used for all types of objects, including text files and .NET assemblies.

The system automatically adds information about the file, such as the date the file was last updated, the version number of the file, and the size of the file in bytes, to the appropriate fields on the Object Repository Objects record. These fields should not be updated manually.

There are two ways to create new Object Repository Objects records:

Creating Objects from the Object Repository Objects Service

Perform the following steps to create objects from the Object Repository Objects service:

  1. Open a new Object Repository Objects record from the Object Repository Objects service.
  2. Enter a Name and Description for the new object.
  3. Enter the name of the Object Package where the object will be stored in the Package field.
  4. Enter the Object Type and Object Access Method.
    • If you enter the Object Type before the Object Access Method, the system automatically sets the method based on the default access method defined for the object type selected. 
  5. Enter the Download Path for the object.
    • This path identifies the directory where the object is stored when it is retrieved from the object repository. Any directory path may be entered by clicking on the folder icon and navigating to the desired directory. Certain keyword locations have been configured in Aptify to be used instead of entering an entire directory path. These keyword locations include:
      • <DefaultPath>: This is the default download path for repository objects. For Aptify 6.0, this defaults to C:\Program Files\Aptify 6.0.
      • <PackagePath>: This keyword location indicates that the download path for the specified object package will be used.
      • <ObjectContextPath>: The path indicated in the Download Path field of the context object specified for the object package selected.
      • <WindowsPath>: This indicates that files will be downloaded to the computer's Windows directory. This option is not currently supported.
      • <WindowsSystemPath>: This indicates that files will be downloaded to the computer's Windows system directory. This option is not currently supported.
      • <AptifyExplorerPath>: This indicates the location where the Aptify client was installed on the computer. This option is not currently supported.
      • <WindowsTempPath>: This path indicates that files will be downloaded to the computer's temp directory. This option is not currently supported.
      • <UserProfilePath>: This path is the current user's profile directory. This option is not currently supported. 
  6. Click the page button to the right of the Local Filename field. This displays the Select File dialog box, which is used to locate the file to be stored in the object repository. Navigate to the location of the file, select it and click Open.  
    Object Repository Objects Record
  7. Save the Object Repository Objects record.


Creating Objects from a Repository Object Field in a Record

If a record has a field that uses the Repository Object extended type, the repository icon appears to the right of the field (as shown in the figure below).

Repository Object Field Example
Clicking this button opens the Select Object Repository Object dialog, as shown in the figure below. You use this dialog to locate the repository object that you want to link to this field. You can also use this dialog to add new objects to the repository, as necessary.

Select Object Repository Object Dialog

Follow these steps to use the Select Object Repository Object dialog to add a new object:

  1. Click a field's Object Repository icon to open the Select Object Repository Object dialog.
  2. Double-click the Context where you want to store the object.
  3. Double-click the Package in that Context where you want to store the object.
  4. Double-click the Object Type for the object. See About the Object Types for more information.
  5. Click the New button to open an Open dialog.
     Select Object Repository Object Dialog
  6. Browse to the object's location on the local computer or network, select the file, and click Open.
    • The system adds the specified file to the repository and automatically creates an Object Repository Objects record. 
  7. If you want to populate the field from which you launched the dialog with this new object, select the object within the dialog and click OK.
    • This automatically populates the Repository Object field on the record in the following format: Package Name.Object Name.

Specifying Related Object Repository Objects

 

 

Certain objects may be related to other objects within the Aptify Object Repository. This relationship indicates that the related objects are required, so that when the parent object repository object is retrieved, all related objects are retrieved as well. This relationship can be configured by using the Object Repository Related Objects tab of the Object Repository Objects record, as described below:

  1. Click the Related Objects tab of an Object Repository Objects record.
  2. Open a new Object Repository Related Objects sub-type record.

    Object Repository Related Objects Record
  3. Enter the name of the object that is related to the current object in the Related Object field.
  4. Click OK to save the related object link.
  5. Save the Object Repository Objects record.
  6. Repeat steps 1 through 4 to configure additional links between the objects.
    • Alternatively, you can select the OK and New option in Step 3 to save the current record and open a new Object Repository Related Objects record in one step.  
      Related Objects Tab

Updating Object Repository Objects

 

Occasionally a file required by one of the objects included in the Object Repository must be updated. This could be due to a new version from the manufacturer or changes required by the organization to existing configurations. The Object Repository Objects record allows new versions of the files to be pushed to the object repository. The most recent date and version for that file is updated automatically once this record is saved.

Follow these steps to update an object:

  1. Open the Object Repository Objects record for the file to be updated.
  2. Click the page button to the right of the Local Filename field. This displays the Select File dialog box, which is used to locate the file to be stored in the object repository.
  3. Find the newest version of the file and click Open to close the Select File dialog box. The Local Filename field populates with the local path directory where the file is located.
  4. Save the Object Repository Objects record.
    • When the record saves, the Updated field refreshes to the current date and time, and the Internal Version field increases by 1 to indicate that the file version has been updated. 

  5. Save and close the Object Repository Objects record.

    After updating an object, you can download the new version to your client using the Object Repository dashboard. See Downloading an Object or Object Package Using the Dashboard. Alternatively, you can close and relaunch the Aptify Desktop client. The next time the system uses the object, it should download the new version.

Updating Object Repository Objects with the Command Line Tool

 

 

Aptify supports the ability to update and add new assemblies to the Object Repository using the command line tool. The AptifyObjectRepositoryCmdUtility utility makes it possible for a developer or administrator to automate Object Repository Object creation and updates. For example, a post build task could be added to a Visual Studio project that executes AptifyObjectRepositoryCmdUtility to automatically update the assembly in the Object Repository after a successful compile.

Follow these steps to update an object with the Command Line Tool:

  1. Locate the Aptify Object Repository Utility.
    • Located in the Utilities > AptifyObjectRepositoryUtility of Aptify 6.0. 
  2. Copy the utility's folder to the database server.
  3. Open a Command Prompt, make sure to right-click and select Run as Administrator to launch the prompt.
    • On Windows Server 2008, the Run as Administrator option bypasses the server's User Access Control (UAC) while running the utility. 
  4. In the Command window, run the AptifyObjectRepositryCmdUtility,exe (with full path to the executable) specifying the necessary command line arguments:
    • /Server=[Aptify Database Server]
      Use this argument to specify the Aptify database server. Note that rather than use this command line argument, you can add the Aptify.Framework.LoginServices.AptifyLogin.Server key to the AptifyObjRepSyn­chronizer.exe.config file. 
    • /UserID=[Untrusted User Name]
      If connecting as an untrusted user, such as sa, use this argument to specify that user. There is no command line argument to specify a trusted user account. Instead, set the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to true in the AptifyObjRepSynchronizer.exe.config file to use a trusted login. 
    • /Password=[password]
      If you specified an untrusted user using the /user argument, specify the password for that untrusted user. Note that the password will appear in plain text. There is no command line argument to specify a trusted user account. Instead, set the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to true in the AptifyObjRepSynchronizer.exe.config file to use a trusted login. 
    • /EntityDB=[Database used to store Aptify's Entities Entity]
      Typically, this database is APTIFY, which is already set in AptifyObjRepSynchronizer by default. Therefore, you do not need to use this command unless you have installed Aptify to a database other than APTIFY. 
    • /UserDB=[Database used to store user metadata]
      Typically, this database is APTIFY, which is already set in AptifyObjRepSynchronizer by default. Therefore, you do not need to use this command unless you have installed Aptify to a database other than APTIFY. 
    • /File=[Name of the file to be created or updated]
      Use this argument to specify the name of the specific .dll or Object Repository Object you are intending to create or update. 
    • /ObjectName=[Name given to the object that is created/updated]
      Use this argument to specify the name of the object. 
    • /PackageName=[Package given to object that is created/updated]
      Use this argument to specify the Package where this object is stored. 
    • /Update=[Update is used to specify if the utility will create or update the object]
      When set to False, this command is used to instruct the utility to create a new Object Repository Object. When set to True, the utility will update an existing object. 
    • /ObjectType=[Object Type given to the object that is created/updated]
      Use this argument to specify the file type of this object. 
    • /Description=[Description given to the object that is created/updated]
      Below are examples:

      • To update an existing object: 

        C:\AptifyObjectRepositoryCmdUtility.exe /Server:TESTSERVER1 /UserID: SA/Password:Password123 /ENTITYDB:APTIFY/USERDB:APTIFY/File:C:\UpdatedObjectName.dll /ObjectName:Name of Object /PackageName: CRM /Update:True 

      • To create a new object:

        C:AptifyObjectRepositoryCmdUtility.exe /Server:TESTSERVER1 /UserID: SA/Password:Password123 /ENTITYDB:APTIFY/USERDB:APTIFY/File:C:\NewObject.dll /ObjectName: Name of New Object/PackageName: CRM/Update:False /ObjectType:.NET Assembly (Private Deployment) /Description:New Aptify Object.

        You will receive a confirmation once the utility has successfully created/updated the Objects Repository Object.

  5. To verify the object was uploaded correctly, launch Aptify and open the Object Repository Objects service.
  6. Locate the object specified in the previous step and verify that the object has been created/updated appropriately.

About the Object Access Methods

 

 

Objects can be accessed through different methods. These methods indicate how the object is retrieved and how it is stored within the database. Different access methods are necessary for different types of objects. For example, the standard installation of Aptify is delivered with three object access methods already defined. These are:

  • DBChunks: Objects are stored in chunks within the database using the Database Chunking method. This object access method is currently not supported at this time.
  • HTTP: The object is retrieved using hypertext transfer protocol. This object access method is currently not supported at this time.
  • DBBlob: The object is stored in the database as a BLOB (Binary Large Object).

See  About the Object Access Methods Form for more information.

About the Object Types

 

 

Object types allow the grouping of data objects in easy-to-understand relationships. For example, all Crystal Reports files are associated with the CrystalRPT object type.

Some object types require that a special system command be run after the file is downloaded to the client computer. For example, the only file type stored in the .NET Assembly (GAC) type are shared assemblies that are deployed to the Global Assembly Cache. After a file of this type is downloaded, Aptify runs the Gacutil.exe program to add the shared assembly to the .NET GAC.

Downloading an Object or Object Package Using the Dashboard

 

 

In general, Aptify automatically downloads files as needed from the Object Repository. However, if you updated a file in the repository and wants to download a new copy (or if you want to test that a new object downloads properly), you can use the dashboard to manually download the file to the local computer. You can also download an entire object package without having to download individual objects.

Follow these steps to download an object or object package to the local computer's Aptify program files folder:

  1. Select the entry for the object or object package that you want to download in the dashboard's right-hand window.
    • To download a particular object, select the object in the dashboard's right-hand window.
    • To download all objects associated with a particular package, select the Object Package associated with the objects you want to download from the tree view in the left windowpane.
    • Right-click the object or object package and select Download from the pop-up menu.

      Downloading an ObjectDownloading an Object Package

 You can refresh the dashboard contents by right clicking an entry in the Object Repository tree and selecting Refresh from the pop-up menu.

 

Keeping the Object Repository Synchronized

 

 

The Object Repository Synchronizer utility is used to keep the objects in the Object Cache folder of Aptify synchronized with the objects in the Object Repository. This utility is typically run when the automatic download of objects from the repository is turned off (for example, in an e-Business environment or the Aptify Application Server) and there were subsequent changes to any of the objects in the repository. The utility can be run through a user-friendly wizard or can be run asynchronously without requiring any user interaction.

Disabling automatic downloads from the Object Repository is particularly important web servers, because the download causes the site to recompile. In other multi-user environments, automatic downloads are disabled is to prevent the locking of files that occurs during a download. In this scenario, a separate process is required to shut down all instances of the application, synchronize the appropriate files, and restart or make the application available again. Disabling the automatic download will save some cycles and bandwidth.

 

This topic describes how to run the utility and how to automate it to run automatically on a pre-defined schedule.

Running the Object Repository Synchronizer

 

 

Perform the following steps to run the Object Repository Synchronizer Utility:

 

The Object Repository Synchronizer should be run after hours to ensure that current activities in the Aptify environment are not disrupted.

 

  1. Locate the Object Repository Utility.
    • You can generally find the latest version of the utility included in the Utilities folder of the most recent Aptify release or service pack.
    • Contact Aptify Technical Support if you cannot locate this file.
  2. Copy the utility's folder to the computer that contains the Object Cache that you want to synchronize (for example, if you want to update an e-Business bin folder, you should copy the utility to the web server).
    • Be sure to retain the folder structure of the Object Repository Synchronizer utility, as shown below (the exe file, a config file and the bin directory).

  3. Double-click AptifyObjRepSynchronizer.exe to launch the utility.
  4. In the Login screen, enter the name of the Aptify database server in the Server field and specify the login credentials for a user in Aptify (such as sa or your trusted user account, if suitable).
  5. In the Welcome screen, use the ellipsis (...) button to the right of the Object Cache Folder field to browse to the Aptify folder (typically, this is C:\Program Files\Aptify 5.0).
    • Note that the default path is the current folder from which you are running the application, so you need to modify this to point to the appropriate location.


       
  6. Select a Repository User from the drop-down list (such as sa or your trusted user account).
    • Assuming that all of your users default to the same Object Context, you can specify any user of Aptify for this step. 
  7. Select the Synchronize All Objects option to download all objects from the repository.
    • The tool also supports the option to Select Objects for Synchronization. When you choose this option, the tool displays the list of all objects available for download and lets you choose the ones you want to synchronize.
    • This tool also supports specifying a list of objects to download through the Specify a Sync Repository Object Record option. An administrator can create a list (or multiple lists) of objects to download (or not download) through the Sync Repository Objects service, which can be selected from the Object Name drop-down list. See Creating a List of Objects to Download for more information.



  8. Click Next to continue.
  9. In the Synchronize screen, review the summary information and click Finish to synchronize all of the objects.
    • Depending on the number of objects, this process may take several minutes.



  10. Click OK when prompted that the process is complete (this closes the tool).

Automating the Synchronization Process

 

 

This topic describes how to create a batch file and a Windows Scheduled Task that will automatically run the Object Repository Synchronizer utility on a specified schedule.

When you run AptifyObjRepSynchronizer.exe, a dialog opens that walks you through the process for downloading objects. However, the Object Repository Synchronizer also supports a series command line arguments. Specifying a series of arguments on a command line suppresses the dialog and runs the tool in the background. The command line arguments are as follows (and shown below):


Synchronizer Command Line Arguments

  • /? or /Help: Displays the help screen shown above.
  • /Server=[Aptify Database Server]: Use this argument to specify the Aptify database server. Note that rather than use this command line argument, you can add the Aptify.Framework.LoginServices.AptifyLogin.Server key to the AptifyObjRepSynchronizer.exe.config file.
  • /EntitiesDB=[Database used to store Aptify's Entities Entity]: Typically, this database is APTIFY, which is already set in AptifyObjRepSynchronizer by default. Therefore, you do not need to use this command unless you have installed Aptify to a database other than APTIFY.
  • /UsersDB=[Database used to store user metadata]: Typically, this database is APTIFY, which is already set in AptifyObjRepSynchronizer by default. Therefore, you do not need to use this command unless you have installed Aptify to a database other than APTIFY.
  • /User=[Untrusted User Name]: If connecting as an untrusted user, such as sa, use this argument to specify that user. There is no command line argument to specify a trusted user account. Instead, set the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to true in the AptifyObjRepSynchronizer.exe.config file to use a trusted login.
  • /pwd=[password]: If you specified an untrusted user using the /user -argument, specify the password for that untrusted user. Note that the password will appear in plain text. There is no command line argument to specify a trusted user account. Instead, set the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to true in the AptifyObjRepSynchronizer.exe.config file to use a trusted login.
  • /CacheFolder=["Aptify Folder Location"]: The path for the Object Cache folder, for example, in an e-Business environment, C:\inetpub\wwwroot\ebusiness\bin. When using this argument, enclose the path in quotation marks.
  • /RepositoryUserID=[ID of User]: Use this argument to specify the ID of the user for whom the synchronization utility runs. (This is the equivalent to the Repository User selection you would make in the tool's user interface.)
  • /s: This argument suppresses the synchronizer's user interface.
  • /c: This argument, specifies the Sync Repository Objects record that contains the collection of objects to download (or not download). With this option, only the objects within the Sync Repository Objects record that are marked as Downloadable will be downloaded. See Creating a List of Objects to Download for more details.

By using the command line arguments listed above and modifying the AptifyObjRepSynchronizer.exe.config file, you can create a batch file and a Windows Scheduled Task that automatically stops any applicable services, runs the synchronization utility, and restarts the services on a pre-determined schedule without requiring user intervention.

 

 When specifying multiple command line arguments, separate each argument with a space.

Example: Automating the Synchronization Process for an e-Business Web Server

The procedure below describes how to create a scheduled task on an e-Business web server to automate the execution of the synchronizer using a trusted user account (the user specified in the Scheduled Task).

  1. Log in to the web server using a Windows account that is an administrative user on the computer (i.e., the user is in the computer's Administrators group).
  2. Identify the location of the Object Repository Synchronization Utility on the computer. See Running the Object Repository Synchronizer.
  3. Open the AptifyObjRepSynchronizer.exe.config file with Notepad.
  4. Locate the Aptify.Framework.LoginServices.AptifyLogin.Trusted key and change the value from false to true.
    • With this setting, the synchronizer uses the trusted user account for the Windows domain user specified in the Scheduled Task. This eliminates the need to use the /User and /pwd command line arguments. 
  5. Add the following line above the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to connect to your organization's Aptify database server only:

    <add key="Aptify.Framework.LoginServices.AptifyLogin.Server" value="[Enter Your Database Name]"/>

    Modifying Synchronizer Config File 
    • This eliminates the need to use the /Server command line argument.  
       
  6. Save and close AptifyObjRepSynchronizer.exe.config.
  7. Create a batch file that performs these steps:

    • Stops any applicable services using the NET STOP "[service name]" command as required by your network. However, do not stop the Aptify Object Repository Service, since the Synchronizer uses this service.

      You do not need to stop and restart Microsoft IIS. IIS 6.0 and higher recognizes the updates automatically and cycles any new components into use.

    • Run the synchronization utility for a specified repository user in silent mode with this command: "[file path]\AptifyObjRepSynchronizer.exe" /s /CacheFolder="[Location of Aptify Files]" /RepositoryUserID=[UserID]

      For example:
      "C:\Synchronizer\AptifyObjRepSynchronizer.exe" /s /CacheFolder=-"C:\Inetpub\wwwroot\ebusiness\bin" /RepositoryUserID=24
       
    • In general, specify the same user that you would select if you were to run the tool manually. Be sure to include the quotation marks as specified.
    • Note that if you configured AptifyObjRepSynchronizer.exe.config to specify a server and a trusted user, you only need to specify the /s, /CacheFolder, and /RepositoryUserID command line arguments.
    • Start any services that you stopped using the NET START "[service name]" command. 
  8. Click Start > Control Panel > Scheduled Tasks > Add Scheduled Task to open the Scheduled Task Wizard.
  9. Click Next at the Welcome screen to continue.
  10. In the Click the program you want to run screen, click the Browse button, locate the batch file you created (such as synchronize.bat), and double-click it.

    Configure Task Frequency
     
  11. Select the frequency for the task and click Next.  
  12. Complete the task's schedule information and click Next. Note: To prevent any disruption of website activity, you should run the Object Repository Synchronizer after hours or at a time when the site is not available.
  13. Enter the user name and password for the trusted administrative user who will run this task, and click Next.
    • Typically, this is the e-Business user, which is responsible for running the e-Business site.  

      Configure Task User Information
       
  14. Click Finish to create the Scheduled Task. The Scheduled Task will execute at the interval you specified and run your batch file.

Creating a List of Objects to Download

 

 

In Aptify, an administrator can create a list (or multiple lists) of objects to download (or not download) to be used by the command line version of the Object Repository Synchronization Utility. In addition, a user can use this list when running the utility through the wizard, eliminating the need for an administrator to hand pick objects through the Select Objects for Synchronization option (when not selecting all objects) to download each time the utility is run.

Follow the steps below to create a list of objects to download when using the Object Repository Synchronization Utility:

  1. Open a new record from the Sync Repository Objects service.
    • The Sync Repository Objects server is located in the Object Repository application. 
  2. On the General tab, enter a name for the collection of objects in the Name field.  

    Sync Repository Objects - General Tab
     
  3. Select the Sync Repository Object Files tab.
  4. Right-click in the gray area and select New from the pop-up menu.
    • A new Sync Repository Object Files form appears. 
  5. Enter the name of the object to be added to the list of objects in the Object ID field.
  6. Clear the Downloadable option if you do not want the object to be downloaded.
    • By default, the Downloadable option is selected, and the object will be downloaded.
    • If an object is already downloaded in the Object Cache Folder that is specified when running the synchronization utility, selecting the Downloadable option will overwrite the object in the Object Cache Folder.
    • If an object is already downloaded in the Object Cache Folder that is specified when running the synchronization utility, clearing the Downloadable option does not remove the object from the Cache Folder (must be done manually).  

      Sync Repository Object Files Record
  7. Click OK to save the object file information.
  8. Repeat steps 4 through 7 to configure additional object files to include in the synchronization list.
    • Alternatively, you can select the OK and New option in Step 8 to save the current record and open a new Sync Repository Object Files record.  

      Sync Repository Objects - Sync Repository Object Files
  9. Save and close the Sync Repository Objects record.

Once the list of objects has been created, an administrator can specify which objects should be updated (not updated) in the Object Cache directory from the latest objects stored in the database's object repository through the command line version of the Object Repository Synchronization Utility. See Automating the Synchronization Process for more details.

An administrator can also specify the list of objects when running the utility through the wizard by selecting the Specify a Sync Repository Objects Record option on the welcome screen. See Running the Object Repository Synchronizer for more details.

About the Object Repository

 

 

The Object Repository stores all of the files required by an Aptify system. Computers that have the Aptify Desktop client installed automatically download the necessary Object Repository files the first time the application is run. The server also automatically distributes new and updated repository files to clients as necessary.

Clients use the Aptify Object Repository Service to manage downloads from the Object Repository to a client computer's Aptify program files folder. The Aptify Object Repository Service is a Windows service that starts automatically after the Aptify Client application is installed and each time the client computer restarts.

The Aptify Object Repository Service runs under the Local System so users do not need elevated permissions to download Aptify objects. When using the Object Repository service, administrators can configure a user as a Windows Restricted user (that is, a member of Windows's Users Group) while maintaining the ability to automatically push updated files to the client's computer.

Note that this service requires the following default Windows permissions to function correctly:

  • The Local System must have the necessary default registry permissions to update ODBC information and to register components:
      HKEY_CURRENT_USER\SOFTWARE\ODBC\ODBC.INI (Read, Create, Edit permissions)
      HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI (Read, Create, Edit permissions)
      HKEY_CLASSES_ROOT (Query Value, Set Value, Create Subkey, Enumerate -Subkeys, Notify, Write Dac, Read Control)
  • The user needs the default permissions to the Windows Temp directory (typically C:\WINNT\TEMP or C:\WINDOWS\TEMP), namely Traverse Folder / Execute File, Create Files / Write Data, and Create Folders / Append Data.

About the Object Repository Structure

Aptify designed the Object Repository so that an organization can control which objects are downloaded to a specific user's computer, depending on the user's access requirements. To implement this approach, the Object Repository uses the following structure to provide users with a specific set of system objects:

  • An administrator associates each user with one of the available Object Contexts.
  • Each Object Context contains one or more Object Packages.
  • Each Object Package contains one or more Object Repository Objects.
  • Each Object Repository Object is assigned one of the available Object Types.
    • Standard Object Types include .NET Assemblies, ActiveX Controls, COM-based DLLs, Text files, and Image files.
    • To implement new functionality within Aptify, an organization adds objects -created by a developer to the Object Repository for distribution. 
  • The system automatically detects class information for .NET assemblies and COM objects that are added to the repository.
    • Object Repository Classes track information about .NET and COM classes that belong to Object Repository Objects, including licensing information associated with the class. When an object is created that is a COM object or .NET assembly, an Object Repository Classes record is created for each class included within the object.

When a user logs in to Aptify, the Object Repository service retrieves all of the startup objects associated with the user's assigned Object Context (and any related parent Object Context(s)). Additional objects are downloaded automatically as needed. Note that the standard Aptify installation includes one Object Context, named Production.

About the Object Repository Classes

 

 

Object Repository Classes track information about .NET and COM classes that belong to object repository objects, including licensing information associated with the class. When an object is created that is a COM object or .NET assembly, the system automatically detects the classes included within the object and adds Object Repository Classes records as necessary.

Object Repository Classes Record
The system automatically creates Object Repository Classes records. These records are used by other parts of the system to set licenses when dynamically loading controls. Note that an object's associated classes are listed under the object's Classes tab. See About the Object Repository Classes Form.

Using the Object Repository Dashboard

 

 

The simplest way to navigate the object repository is through the Object Repository dashboard. The user can access all objects in the repository from the dashboard.

Object Repository Dashboard

  • To access the dashboard, select the Object Repository Administration application from the Ribbon, Navigation Bar, or Folder List. The Object Repository dashboard will appear.
  • A hierarchy tree appears in the left window pane. This tree lists the contexts and packages available in the Object Repository.
    • Expanding the Object Repository node displays the available Object Contexts in the tree view. Aptify includes the Production context by default.
    • Expanding an Object Context, such as the Production node, displays the context's corresponding Object Packages in the tree view.
    • Right-clicking items in the tree displays a context menu with the options listed:
      • For the Object Repository node (top-level), the right-click menu displays the following options: 
        • Open new Object Contexts record
        • Refresh Object Contexts data
           
      • For an Object Context, the right-click menu displays the following options: 
        • Open new Object Packages record
        • Open the selected Object Contexts record
        • Delete the selected Object Contexts record
        • Refresh Object Packages data
           
      • For an Object Package, the right-click menu displays the following options: 
        • Open new Object Repository Objects record
        • Open the selected Object Packages record
        • Delete the selected Object Packages record
        • Download all objects associated with the selected Object Package to the client computer
        • Refresh Objects data
           
  • Records related to the selected item in the tree appear in the right window pane.
    • When the Object Repository node is selected, the system's Object Contexts appear in the right window pane.
    • When an Object Context is selected in the tree, the Object Packages associated with the selected context appear in the right window pane.
    • When an Object Package is selected in the tree, the Object Repository Objects contained in that package appear in the right window pane.
    • Double-clicking an item in the right window pane opens its corresponding record.
    • Right-clicking items in the right window pane displays a context menu with the following options:
      • For an Object Context, the right-click menu displays the following options: 
        • Open new Object Contexts record
        • Open the selected Object Contexts record
        • Delete the selected Object Contexts record
        • Refresh Object Contexts data
        .
      • For an Object Package, the right-click menu displays the following options: 
        • Open new Object Packages Objects record
        • Open the selected Object Packages record
        • Delete the selected Object Packages record
        • Download all objects associated with the selected Object Package to the client computer
        • Refresh Object Package data
      • For an Object Repository Object, the right-click menu displays the following options:
        • Open new Object Repository Objects record
        • Open the selected Object Repository Objects record
        • Delete the selected Object Repository Objects record
        • Download the file associated with the selected Object Repository Objects record to the client computer
        • Refresh Objects data

Downloading an Object or Object Package Using the Dashboard

 

 

In general, Aptify automatically downloads files as needed from the Object Repository. However, if you updated a file in the repository and wants to download a new copy (or if you want to test that a new object downloads properly), you can use the dashboard to manually download the file to the local computer. You can also download an entire object package without having to download individual objects.

Follow these steps to download an object or object package to the local computer's Aptify program files folder:

  1. Select the entry for the object or object package that you want to download in the dashboard's right-hand window.
    • To download a particular object, select the object in the dashboard's right-hand window.
    • To download all objects associated with a particular package, select the Object Package associated with the objects you want to download from the tree view in the left windowpane.
    • Right-click the object or object package and select Download from the pop-up menu.

      Downloading an ObjectDownloading an Object Package

 You can refresh the dashboard contents by right clicking an entry in the Object Repository tree and selecting Refresh from the pop-up menu.

 

Keeping the Object Repository Synchronized

 

 

The Object Repository Synchronizer utility is used to keep the objects in the Object Cache folder of Aptify synchronized with the objects in the Object Repository. This utility is typically run when the automatic download of objects from the repository is turned off (for example, in an e-Business environment or the Aptify Application Server) and there were subsequent changes to any of the objects in the repository. The utility can be run through a user-friendly wizard or can be run asynchronously without requiring any user interaction.

Disabling automatic downloads from the Object Repository is particularly important web servers, because the download causes the site to recompile. In other multi-user environments, automatic downloads are disabled is to prevent the locking of files that occurs during a download. In this scenario, a separate process is required to shut down all instances of the application, synchronize the appropriate files, and restart or make the application available again. Disabling the automatic download will save some cycles and bandwidth.

 

This topic describes how to run the utility and how to automate it to run automatically on a pre-defined schedule.

Running the Object Repository Synchronizer

 

 

Perform the following steps to run the Object Repository Synchronizer Utility:

 

The Object Repository Synchronizer should be run after hours to ensure that current activities in the Aptify environment are not disrupted.

 

  1. Locate the Object Repository Utility.
    • You can generally find the latest version of the utility included in the Utilities folder of the most recent Aptify release or service pack.
    • Contact Aptify Technical Support if you cannot locate this file.
  2. Copy the utility's folder to the computer that contains the Object Cache that you want to synchronize (for example, if you want to update an e-Business bin folder, you should copy the utility to the web server).
    • Be sure to retain the folder structure of the Object Repository Synchronizer utility, as shown below (the exe file, a config file and the bin directory).

  3. Double-click AptifyObjRepSynchronizer.exe to launch the utility.
  4. In the Login screen, enter the name of the Aptify database server in the Server field and specify the login credentials for a user in Aptify (such as sa or your trusted user account, if suitable).
  5. In the Welcome screen, use the ellipsis (...) button to the right of the Object Cache Folder field to browse to the Aptify folder (typically, this is C:\Program Files\Aptify 5.0).
    • Note that the default path is the current folder from which you are running the application, so you need to modify this to point to the appropriate location.


       
  6. Select a Repository User from the drop-down list (such as sa or your trusted user account).
    • Assuming that all of your users default to the same Object Context, you can specify any user of Aptify for this step. 
  7. Select the Synchronize All Objects option to download all objects from the repository.
    • The tool also supports the option to Select Objects for Synchronization. When you choose this option, the tool displays the list of all objects available for download and lets you choose the ones you want to synchronize.
    • This tool also supports specifying a list of objects to download through the Specify a Sync Repository Object Record option. An administrator can create a list (or multiple lists) of objects to download (or not download) through the Sync Repository Objects service, which can be selected from the Object Name drop-down list. See Creating a List of Objects to Download for more information.



  8. Click Next to continue.
  9. In the Synchronize screen, review the summary information and click Finish to synchronize all of the objects.
    • Depending on the number of objects, this process may take several minutes.



  10. Click OK when prompted that the process is complete (this closes the tool).

Automating the Synchronization Process

 

 

This topic describes how to create a batch file and a Windows Scheduled Task that will automatically run the Object Repository Synchronizer utility on a specified schedule.

When you run AptifyObjRepSynchronizer.exe, a dialog opens that walks you through the process for downloading objects. However, the Object Repository Synchronizer also supports a series command line arguments. Specifying a series of arguments on a command line suppresses the dialog and runs the tool in the background. The command line arguments are as follows (and shown below):


Synchronizer Command Line Arguments

  • /? or /Help: Displays the help screen shown above.
  • /Server=[Aptify Database Server]: Use this argument to specify the Aptify database server. Note that rather than use this command line argument, you can add the Aptify.Framework.LoginServices.AptifyLogin.Server key to the AptifyObjRepSynchronizer.exe.config file.
  • /EntitiesDB=[Database used to store Aptify's Entities Entity]: Typically, this database is APTIFY, which is already set in AptifyObjRepSynchronizer by default. Therefore, you do not need to use this command unless you have installed Aptify to a database other than APTIFY.
  • /UsersDB=[Database used to store user metadata]: Typically, this database is APTIFY, which is already set in AptifyObjRepSynchronizer by default. Therefore, you do not need to use this command unless you have installed Aptify to a database other than APTIFY.
  • /User=[Untrusted User Name]: If connecting as an untrusted user, such as sa, use this argument to specify that user. There is no command line argument to specify a trusted user account. Instead, set the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to true in the AptifyObjRepSynchronizer.exe.config file to use a trusted login.
  • /pwd=[password]: If you specified an untrusted user using the /user -argument, specify the password for that untrusted user. Note that the password will appear in plain text. There is no command line argument to specify a trusted user account. Instead, set the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to true in the AptifyObjRepSynchronizer.exe.config file to use a trusted login.
  • /CacheFolder=["Aptify Folder Location"]: The path for the Object Cache folder, for example, in an e-Business environment, C:\inetpub\wwwroot\ebusiness\bin. When using this argument, enclose the path in quotation marks.
  • /RepositoryUserID=[ID of User]: Use this argument to specify the ID of the user for whom the synchronization utility runs. (This is the equivalent to the Repository User selection you would make in the tool's user interface.)
  • /s: This argument suppresses the synchronizer's user interface.
  • /c: This argument, specifies the Sync Repository Objects record that contains the collection of objects to download (or not download). With this option, only the objects within the Sync Repository Objects record that are marked as Downloadable will be downloaded. See Creating a List of Objects to Download for more details.

By using the command line arguments listed above and modifying the AptifyObjRepSynchronizer.exe.config file, you can create a batch file and a Windows Scheduled Task that automatically stops any applicable services, runs the synchronization utility, and restarts the services on a pre-determined schedule without requiring user intervention.

 

 When specifying multiple command line arguments, separate each argument with a space.

Example: Automating the Synchronization Process for an e-Business Web Server

The procedure below describes how to create a scheduled task on an e-Business web server to automate the execution of the synchronizer using a trusted user account (the user specified in the Scheduled Task).

  1. Log in to the web server using a Windows account that is an administrative user on the computer (i.e., the user is in the computer's Administrators group).
  2. Identify the location of the Object Repository Synchronization Utility on the computer. See Running the Object Repository Synchronizer.
  3. Open the AptifyObjRepSynchronizer.exe.config file with Notepad.
  4. Locate the Aptify.Framework.LoginServices.AptifyLogin.Trusted key and change the value from false to true.
    • With this setting, the synchronizer uses the trusted user account for the Windows domain user specified in the Scheduled Task. This eliminates the need to use the /User and /pwd command line arguments. 
  5. Add the following line above the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to connect to your organization's Aptify database server only:

    <add key="Aptify.Framework.LoginServices.AptifyLogin.Server" value="[Enter Your Database Name]"/>

    Modifying Synchronizer Config File 
    • This eliminates the need to use the /Server command line argument.  
       
  6. Save and close AptifyObjRepSynchronizer.exe.config.
  7. Create a batch file that performs these steps:

    • Stops any applicable services using the NET STOP "[service name]" command as required by your network. However, do not stop the Aptify Object Repository Service, since the Synchronizer uses this service.

      You do not need to stop and restart Microsoft IIS. IIS 6.0 and higher recognizes the updates automatically and cycles any new components into use.

    • Run the synchronization utility for a specified repository user in silent mode with this command: "[file path]\AptifyObjRepSynchronizer.exe" /s /CacheFolder="[Location of Aptify Files]" /RepositoryUserID=[UserID]

      For example:
      "C:\Synchronizer\AptifyObjRepSynchronizer.exe" /s /CacheFolder=-"C:\Inetpub\wwwroot\ebusiness\bin" /RepositoryUserID=24
       
    • In general, specify the same user that you would select if you were to run the tool manually. Be sure to include the quotation marks as specified.
    • Note that if you configured AptifyObjRepSynchronizer.exe.config to specify a server and a trusted user, you only need to specify the /s, /CacheFolder, and /RepositoryUserID command line arguments.
    • Start any services that you stopped using the NET START "[service name]" command. 
  8. Click Start > Control Panel > Scheduled Tasks > Add Scheduled Task to open the Scheduled Task Wizard.
  9. Click Next at the Welcome screen to continue.
  10. In the Click the program you want to run screen, click the Browse button, locate the batch file you created (such as synchronize.bat), and double-click it.

    Configure Task Frequency
     
  11. Select the frequency for the task and click Next.  
  12. Complete the task's schedule information and click Next. Note: To prevent any disruption of website activity, you should run the Object Repository Synchronizer after hours or at a time when the site is not available.
  13. Enter the user name and password for the trusted administrative user who will run this task, and click Next.
    • Typically, this is the e-Business user, which is responsible for running the e-Business site.  

      Configure Task User Information
       
  14. Click Finish to create the Scheduled Task. The Scheduled Task will execute at the interval you specified and run your batch file.

Creating a List of Objects to Download

 

 

In Aptify, an administrator can create a list (or multiple lists) of objects to download (or not download) to be used by the command line version of the Object Repository Synchronization Utility. In addition, a user can use this list when running the utility through the wizard, eliminating the need for an administrator to hand pick objects through the Select Objects for Synchronization option (when not selecting all objects) to download each time the utility is run.

Follow the steps below to create a list of objects to download when using the Object Repository Synchronization Utility:

  1. Open a new record from the Sync Repository Objects service.
    • The Sync Repository Objects server is located in the Object Repository application. 
  2. On the General tab, enter a name for the collection of objects in the Name field.  

    Sync Repository Objects - General Tab
     
  3. Select the Sync Repository Object Files tab.
  4. Right-click in the gray area and select New from the pop-up menu.
    • A new Sync Repository Object Files form appears. 
  5. Enter the name of the object to be added to the list of objects in the Object ID field.
  6. Clear the Downloadable option if you do not want the object to be downloaded.
    • By default, the Downloadable option is selected, and the object will be downloaded.
    • If an object is already downloaded in the Object Cache Folder that is specified when running the synchronization utility, selecting the Downloadable option will overwrite the object in the Object Cache Folder.
    • If an object is already downloaded in the Object Cache Folder that is specified when running the synchronization utility, clearing the Downloadable option does not remove the object from the Cache Folder (must be done manually).  

      Sync Repository Object Files Record
  7. Click OK to save the object file information.
  8. Repeat steps 4 through 7 to configure additional object files to include in the synchronization list.
    • Alternatively, you can select the OK and New option in Step 8 to save the current record and open a new Sync Repository Object Files record.  

      Sync Repository Objects - Sync Repository Object Files
  9. Save and close the Sync Repository Objects record.

Once the list of objects has been created, an administrator can specify which objects should be updated (not updated) in the Object Cache directory from the latest objects stored in the database's object repository through the command line version of the Object Repository Synchronization Utility. See Automating the Synchronization Process for more details.

An administrator can also specify the list of objects when running the utility through the wizard by selecting the Specify a Sync Repository Objects Record option on the welcome screen. See Running the Object Repository Synchronizer for more details.

About the Object Repository

 

 

The Object Repository stores all of the files required by an Aptify system. Computers that have the Aptify Desktop client installed automatically download the necessary Object Repository files the first time the application is run. The server also automatically distributes new and updated repository files to clients as necessary.

Clients use the Aptify Object Repository Service to manage downloads from the Object Repository to a client computer's Aptify program files folder. The Aptify Object Repository Service is a Windows service that starts automatically after the Aptify Client application is installed and each time the client computer restarts.

The Aptify Object Repository Service runs under the Local System so users do not need elevated permissions to download Aptify objects. When using the Object Repository service, administrators can configure a user as a Windows Restricted user (that is, a member of Windows's Users Group) while maintaining the ability to automatically push updated files to the client's computer.

Note that this service requires the following default Windows permissions to function correctly:

  • The Local System must have the necessary default registry permissions to update ODBC information and to register components:
      HKEY_CURRENT_USER\SOFTWARE\ODBC\ODBC.INI (Read, Create, Edit permissions)
      HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI (Read, Create, Edit permissions)
      HKEY_CLASSES_ROOT (Query Value, Set Value, Create Subkey, Enumerate -Subkeys, Notify, Write Dac, Read Control)
  • The user needs the default permissions to the Windows Temp directory (typically C:\WINNT\TEMP or C:\WINDOWS\TEMP), namely Traverse Folder / Execute File, Create Files / Write Data, and Create Folders / Append Data.

About the Object Repository Structure

Aptify designed the Object Repository so that an organization can control which objects are downloaded to a specific user's computer, depending on the user's access requirements. To implement this approach, the Object Repository uses the following structure to provide users with a specific set of system objects:

  • An administrator associates each user with one of the available Object Contexts.
  • Each Object Context contains one or more Object Packages.
  • Each Object Package contains one or more Object Repository Objects.
  • Each Object Repository Object is assigned one of the available Object Types.
    • Standard Object Types include .NET Assemblies, ActiveX Controls, COM-based DLLs, Text files, and Image files.
    • To implement new functionality within Aptify, an organization adds objects -created by a developer to the Object Repository for distribution. 
  • The system automatically detects class information for .NET assemblies and COM objects that are added to the repository.
    • Object Repository Classes track information about .NET and COM classes that belong to Object Repository Objects, including licensing information associated with the class. When an object is created that is a COM object or .NET assembly, an Object Repository Classes record is created for each class included within the object.

When a user logs in to Aptify, the Object Repository service retrieves all of the startup objects associated with the user's assigned Object Context (and any related parent Object Context(s)). Additional objects are downloaded automatically as needed. Note that the standard Aptify installation includes one Object Context, named Production.

About the Object Repository Classes

 

 

Object Repository Classes track information about .NET and COM classes that belong to object repository objects, including licensing information associated with the class. When an object is created that is a COM object or .NET assembly, the system automatically detects the classes included within the object and adds Object Repository Classes records as necessary.

Object Repository Classes Record
The system automatically creates Object Repository Classes records. These records are used by other parts of the system to set licenses when dynamically loading controls. Note that an object's associated classes are listed under the object's Classes tab. See About the Object Repository Classes Form.

 

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.

Articles in this section