Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ServiceDescription

GetResourceProperty

Usage:
HTTP_Resource_Manager_Services('GetDatabaseItemGetResourceProperty', TableName, SelfURL, KeyID, ColumnNames, ItemArrayLabelURLEndpoint, PropertyName)

Comments:
Gets Returns the value of the resource item from a database table. The format will be HAL+JSON.indicated resource property for the indicated URL endpoint.

Returns:
A database row in HAL+JSON formatSee comments.

SetResourceProperty


Usage:
HTTP_Resource_Manager_Services('GetDatabaseItemsSetResourceProperty', FilterURLEndpoint, TableName, SelfURL, ColumnNames, ItemArrayLabelPropertyName, PropertyValue)

Comments:
Gets the resource items from a database table. The format will be HAL+JSONSets (or updates) the value of the indicated resource property for the indicated URL endpoint.

Returns:
Database rows in HAL+JSON format.N/A

GetResourceChildren


Usage:
HTTP_Resource_Manager_Services('DeleteDatabaseItemGetResourceChildren', TableNameURLEndpoint, KeyIDChildType)

Comments:
Deletes the resource item from a database tableReturns an @FM delimited list of URL endpoints matching the indicated child type that are children to the indicated URL endpoint.

Returns:
N/ASee comments.

GetResourceSignature

Usage:
HTTP_Resource_Manager_Services('PutDatabaseItemGetResourceSignature', TableName, SelfURL, KeyID, AllowedColumnNamesURLEndpoint, Method)

Comments:
Creates a new or updates a specific resource item in the database table. To conform to the requirements of the PUT method, the entire resource will be replaced with the content being passed in, even if only a few properties (e.g., database columns) are being updated. Thus, it is assumed that both changed and unchanged properties will be passed into the request body.Returns the API calling signature for the indicated URL endpoint. This is used by the RunWebAPI service (a member of HTTP_Services) when calling the Web API module.

Returns:
See comments.Returns:
N/A

GetEndpointResourceKeyID


Usage:
HTTP_Resource_Manager_Services('PostDatabaseItemGetEndpointResourceKeyID', TableNameURLEndpoint, SelfURL, AllowedColumnNamesAllowNew)

Comments:
Creates a new resource item in the database table. To conform to the requirements of the POST method, the Key ID will be created automatically by the server and the entire resource will be created with the content being passed inReturns the resource Key ID for the indicated URL endpoint. If AllowNew is true, a URL endpoint will be returned that best matches the available endpoints but it will not be cached.

Returns:
N/ASee comments.

GetResource

Usage:
HTTP_Resource_Manager_Services('PatchDatabaseItemGetResource', TableName, SelfURL, KeyID, AllowedColumnNamesURLEndpoint)

Comments:
Updates a specific resource item in the database table. To conform to the requirements of the PATCH method, only specific properties (e.g., database columns) of the resource will be updated. All properties not identified will be left alone.Returns an array of resource property names and values for the indicated URL endpoint.

Returns:
See comments.Returns:
N/A

SetResource


Usage:
HTTP_Resource_Manager_Services('GetColumnNamesSetResource', TableNameURLEndpoint, ColumnNamesPropertyArray)

Comments:
Gets the column names from the dictionary of the table provided that will be used to create the resource. If the ColumnNames argument is used then this service will validate the list as valid columns. In either case, the following rules will be applied:

  • Regardless of the case used to in the ColumnNames argument it will be upper cased to match against the dictionary names correctly.
  • All column names will be returned in lower case.
  • All column names bound to a Key ID of part 0 (i.e., the entire key) will be removed.
  • All non-master column names will be removed to avoid duplicates.
  • SRP FrameWorks audit column names (MODIFIED_BY, MODIFIED_DATE, and MODIFIED_TIME) will be removed.

Updates the array of resource property names and values for the indicated URL endpoint. Note, this replaces the existing property names and values. Other services should be used to update an existing array and then call this service when the array is updated. The PropertyArray must have at least one property name and value.

Returns:
N/AReturns:
An @FM delimited list of database column names.

IsValidEndpoint


Usage:
HTTP_Resource_Manager_Services('GetColumnValuesIsValidEndpoint', TableName, ColumnNames, ItemIDURLEndpoint)

Comments:
Returns a Boolean flag indicating if the indicated URL endpoint exists.

Returns:
See commentsGets the column values from the database row from the provided table and ID that will be used to create the resource. This is returned as an @FM delimited list of values.Returns:
An @FM delimited list of database column values for a specific Key ID.

GetResourceList

Usage:
HTTP_Resource_Manager_Services('GetMVGroupNamesGetResourceList', TableName, ColumnNames)

Comments:
Gets the MV group names for the dictionary columns passed in. Note: the ColumnNames argument should be the same list that was returned from the GetColumnNames service. This will return an @FM delimited list of MV group names. Thus, for non-multivalue fields, the values will be empty. The MV group names will be returned in lower case. Gets the column values from the database row from the provided table and ID that will be used to create the resource. This is returned as an @FM delimited list of values.Returns the resource list for the current application.

Returns:
See commentsReturns:
An @FM delimited list of MV group names.

Params

The proper use of the generic arguments are defined in the definition of each service above.

...