Page Comparison

...

In the code above, the ServiceRequestsContext object contains information about the request, including the ControllerName, cookies, Headers, httpmethod, query parameters, AuthenticatedContext, and service parameters.  Service parameters are non-literal values that are defined in route. miscProperties are used in the Authorization plugin to put the results of parsing into dictionary and provide the result to the service request. The ServiceResponse object provides information about response content. 

1.  Build the Class to generate a compiled assembly for the new controller.
2.  In Aptify, add the compiled assembly as an object in the Aptify Object Repository.
3.  Create a new .Net Class Plug Ins record to identify the object repository location, assembly name, and class name for the new controller.
   
   Image Modified 
    
4.  Open a new record in the Controllers service (found in the Web Services application) and complete the information on the General tab:

...

1. •   Name: Name of the controller
   •   dot Net Class Plugin: This links to the .Net Class Plug In record you created above for the new controller.
     
     Image Modified 
     

...

1. •  
2. Click the Controller Routes tab and identify at least one route definition. The Controller routes defines the URI format for how to access controller endpoint.You can add multiple controller routes. The system stores the following information for each route:

...

1. •  Name: Name of Controller Route
   •  Route Regular Expression: The Controllers entity plugin generates the Route Regular Expression automatically. You do not need to set this value manually.
   •  Route Help Text: This field lets you add summary information about the controller and parameters it expects from the endpoint. These are standard .NET /// comments. Once set, these comments will be displayed automatically in help pages.
     
     Image Modified 
      
2. Click the Controller Routes Path Parts tab and define the parts that Aptify will use to build the route’s URI. You can specify the following information for each path part:

...

1. •  Type: Data type of the parameter, such as String or int.
   •  Value: This field identifies the part value or a variable that can be added to the URI. For example in the example below, ParamDemo is a part value which is included in the route regular expression, but param1 is a variable value which will be replaced by string variable in the URl.
   •  Is Literal: If checked, then the route regular expression will include the value as written in the URI. If unchecked, then this identifies a variable who value can change.
   •  Is Optional: This check box identifies if the part is optional for the URI.
     
     Image Modified 
      
2. Click the Controller Routes Http Methods tab and specify the appropriate HTTP Methods for the route. You can select any standard http method from the seven available types: DELETE, GET, HEAD, OPTIONS, POST, PUT and TRACE.
3. Save and close the Controllers record.
4. Open a new record in the Controller Configurations service (also found in the Web Services application) and complete the information on the General tab:  
   
   •  Name:

...

1. •  Enter a name for the Controller Configuration.
   •  Controller:

...

1. •  Enter the Controllers record you created above.

...

1. •  Authorization

...

1. •  Plugin:

...

1. •  If required, select an authorization plugin to provide authorization with this controller.
   •  Caching Policy:  Select the Caching Policy for the controller,

...

1. • either Nocaching (not cached)

...

1. • or YearCaching, which is a timecache policy.
   •  Require Authentication:

...

1. •  If checked, then the controller requires a valid authentication token when called. If unchecked, then the controller can be called without any credentials.
   •  Allow Anonymous:

...

1. •  If checked, anonymous users can access the endpoint.
     
     Image Modified 
    
2. Save and close the Controller Configurations record.
3.  Add the Controller Configuration you just created to a Controller Configuration Collection, which is another service in the Web Services application. You can use a collection to group together controllers with common settings. By default, Aptify includes one collection (the Aptify Web Collection).

...

1. •   You can define a caching policy and authorization plugin at the collection level. However, any value you specified on the Controller Configuration record will override the collection’s settings for that particular controller.
   •   If you create your own collection, you need to add it to a Service Application in Aptify metadata.
     
     Image Modified

You can now call your endpoint from Aptify SOA. Here are the settings that would be used for the sample controller shown in the example above.

...