Difference between revisions of "Org.eclipse.higgins.js.pds.client API usage example"

Revision as of 21:01, 19 September 2011

{{#eclipseproject:technology.higgins|eclipse_custom_style.css}}

Initial State

Contexts

NYTimes template

The template context http://azigo.com/sys/templates/nytimes.com contains (among other things) the following mapping rules:

 :NYTimesPerson
     a       owl:Class ;
     rdfs:subClassOf <http://www.eclipse.org/higgins/ontologies/2010/6/higgins#Person> ;
     map:nameRule
             [ a       map:roleSameAs ;
               map:equivalentAttribute
                       fp:givenName ;
               map:predicate :bFirstName ;
               map:role <http://www.eclipse.org/higgins/ontologies/2010/6/persona#Buyer>
             ] ;
     map:telephoneRule
             [ a       map:roleSameAs ;
               map:equivalentAttribute
                       fp:phone ;
               map:predicate :phone ;
               map:role <http://www.eclipse.org/higgins/ontologies/2010/6/persona#Ecommerce>
             ] .

call getAttributes() 1st time

Call

Example call to .pds.client.getAttributes (domain, audience, attributes[], where[], future)

• atts[0] := (http://nytimes#phone, false, nil) // a phone number
• atts[1] := (http://nytimes#bFirstName, false, nil) // "billing first name"
• getAttributes ("nytimes.com", nil, atts, nil, nil)

Execution

• call getConnectionContext()
  • result: http://azigo.com/ptrevithick/nytimes.com)
• call findRoles()
  • result:
    • ((p:eCommerce, (nytimes.com#bFirstName, nil, nil))
    • (p:Buyer, (nytimes.com#phone, nil, nil)))
• call sortByRole()
  • result:
    • ((p:eCommerce, (nytimes.com#bFirstName, nil, nil))
    • (p:Buyer, (nytimes.com#phone, nil, nil)))
• Try to pull attributes from #me person in the nytimes.com
  • result: no result: the nytimes.com context doesn't yet exist
• Try to pull attributes from #me person in root context
  • call findPersonByRole()
  • result: nil (no persons found that match role)
  • result: no attribute/values found

call setAttributes() 1st time

Call

Example call to .pds.client.setAttributes (domain, attributes[])

• atts[0] := (http://nytimes#phone, false, nil) // a phone number
• atts[1] := (http://nytimes#bFirstName, false, nil) // "billing first name"
• setAttributes ("nytimes.com", atts[])

Execution

• context := getConnectionContext ()
  • result: context := http://azigo.com/ptrevithick/nytimes.com
• template := getConnectionTemplate
  • result: template := http://azigo.com/sys/template/nytimes.com
• Loop(0): p=(http://nytimes.com#bFirstName, "Alice")
  • class := getNamespace(http://nytimes.com#bFirstName)
    • result: class := http://nytimes.com
  • att := getLocalAtt (http://nytimes.com#bFirstName)
    • result: att := "bFirstName"
  • rule := getRule (http://azigo.com/sys/template/nytimes.com, http://nytimes.com, "bFirstName")
    • result: rule :=