Develop and deploy a custom page

You can replace any aspx page on the website with a custom page. When a user opens a page in Citizen Access, Citizen Access checks whether there exists a custom aspx file for the page. If there is, the custom page displays to the user. Otherwise, the original page displays.

To develop and deploy a custom page

  1. Decide which page to replace.

  2. Get the .aspx file of the page with these steps:

    1. Right-click on the original page in Citizen Access.

    2. Select Properties in the menu and get the address (URL) of the page. This includes the .aspx file name and also the directory for accessing the file.

      Example: https://$ACA web site$/Cap/caphome.aspx.

      The Cap sub folder stores the caphome.aspx file.

    3. Get the .aspx file from the corresponding web server directory.

  3. Develop a custom .aspx file with the same name. You can customize the interface of the original .aspx file in the custom page.

  4. Save the custom .aspx file with these steps:

    1. Go to the folder where you installed Citizen Access, create a customization folder and then an <agency name> folder in the customization folder.

      Example: If the customization folder name is Customization, the <agency name> folder locates at [ACA Application]\Customization\<agency name>.

    2. If the customization folder name is Customization, you can skip this step. Otherwise, open the web.config file under the Citizen Access website root folder, and add a "CustomizationDirectory" key in the <appSettings> section with the value being the actual customization folder name.

      Example: MyCustomization

      <appSettings> …… <add key="CustomizationDirectory" value="MyCustomization"/> …… </appSettings>

    3. If the .aspx file of the original page locates in a sub folder, you shall further create a sub folder in the <agency name> folder for storing the custom page. The new sub folder name shall be the same as the sub folder that contains the original page.

      Example: Because Cap is the sub folder that stores the original caphome.aspx file, the sub folder to store the custom page shall be [ACA Application]\Customization\<agency name>\Cap.

    4. Save the custom .aspx file in the newly-created folder.

      Example: If the file path of the original caphome.aspx file is:

      D:\ACAProject\aca_trunk_new\Web\Cap

      After you create a custom file with the same name, you must store the custom file at the following location (assuming the agency name is Test_Agency):

      D:\ACAProject\aca_trunk_new\Web\Customization\Test_Agency\Cap