als_get_products.cgi

Top  Previous  Next

Description

The als_get_products.cgi interface will retrieve all Product  and information  about those products i.e.( Vendor, Category, Location ) available to in your system based on if the products that are active and web enabled.

 

To search products see als_get_product_search.cgi

 

This method is Content Management Enabled.

 

Additional Product Discussion

 

A Note about Products: By default AL-Desk products are defined to not be available to the AL-Desk Web Portal. This is done by design to allow AL-Desk administrators to have full control over what products will be shown on the web site. Products must be tagged as being available to the web portal interface.

 

Example Usage             http://127.0.0.1/als_get_products.cgi

 

Inputs

Parameter

Description

Required

Example

Data Type

Location

Location Code to limit the result set to a specific location

 

See also als_get_locations.cgi for Location Codes

 

Optional

location=5

Integer

Category

Category Code to limit the result set to a specific category

 

See also als_get_categories.cgi for Category Codes

 

Optional

category=2

Integer

Vendor

Vendor to limit the result set to a specific location

 

See also als_get_vendors.cgi for Vendor Codes

 

 

Optional

vendor=4

Integer

Product

Product Code to limit the result to a specific product

 

Option

product=1

Integer

includedesc

Includes Expanded Description Information.

 

Optional

includedesc=true

Boolean

content=true

Includes Content Management Information

Optional

content=true

Boolean

nodefaultcontent

To limit content to NOT include product default content

 

Optional

nodefaultcontent=true

Boolean

productsearch

Searches product Name for match

Optional

productsearch=golf

String

descriptionsearch

Searches product Description for match

Optional

descriptionsearch=golf

String

categorygroup

CategoryGroup code to limit the reusult to a specific category group

Optional

categorygroup=1

Integer

contentname

allows the content Manager to be invoked to manage Content Product Lists.

 

Optional

contentname=topten

String

inactive

Used only if you are writing a product management system  that maintains products via a web interface and need to handle products tagged as inactive. Note this may include products not marked to be handled via a web interface.

 

Optional

inactive=true

Boolean

 

 

Returned Fields

#

Field Name

Description

Data Type

1

Code

AL-Desk Associated Code

Integer

2

Name

Name of the Product

String

3

Vendor

AL-Desk Associated Code

Integer

4

VendorName

Name of the Vendor

String

5

Location

AL-Desk Associated Code

Integer

6

LocationName

Name of the Location

String

7

Category

Product Category AL-Desk Associated Code

Integer

8

CategoryName

Name of the Category

String

9

WebJPGLocation

Product Picture. Location path

String

10

Description

Product Description if

includedesc=true is invoked

String

11

Voucher Notes

Voucher Notes included  if

includedesc=true is invoked

String

 

XML Example

<?xml version="1.0" encoding="utf-8" ?>

- <root>

- <products>

<row code="1" vendor="1" vendorname="Blue Hawaiian Helicopters" category="7" categoryname="Helicopter Tours" location="3" locationname="Maui" name="Hana/Haleakala- A Star" webjpglocation="http://www.alstracker.dnsalias.com/aldesk/images/test.jpg" />

</products>

</root>

 

with includedesc

 

http://www.alstracker.dnsalias.com/aldesk/als_get_products.cgi?product=1&includedesc=true

 

<?xml version="1.0" encoding="utf-8" ?>

- <root>

- <products>

<row code="1" vendor="1" vendorname="Blue Hawaiian Helicopters" category="7" location="3" locationname="Maui" name="Hana/Haleakala- A Star" description="45 min flight - Haleakala Crater, Seven Pools, Hana, Rainforest, Waterfalls! Wear Dark Colored Shirt and sunglasses. Check in at heliport 30 mins prior to flight." webjpglocation="http://www.alstracker.dnsalias.com/aldesk/images/test.jpg" vouchernotes="Wear Dark Colored Shirt and sunglasses. Check in at heliport 30 mins prior to flight" categoryname="Helicopter Tours" />

</products>

</root>