General Web Services Integration Questions After I apply for access to the web services LIVE environment as a data exchange provider, will my customers also need to apply for LIVE access for their individual accounts? Are there web services that can help me find out why my property is not receiving a score? Can I use the same account to run web services in both the test environment and LIVE environment?
Can my current Portfolio Manager data be copied into the test web services account for testing purposes? Can the data in my test web services account be rolled over into my live Portfolio Manager account? Can you provide the live production URL? Do the Portfolio Manager web services accept any language other than English? Do you have any estimated maximum time for REST responses? Do you have a suggested timeout length? How can I create a space revision history for my property, building, or property use using web services? The API only allows one value for gross floor area. How do I display ENERGY STAR metrics in my software? More... Account Web Services A customer list is available through the “GET /customer/list ”service, but could customer lists be made available as a downloadable report through the web services GUI tab in the new Portfolio Manager? After I apply for access to the web services LIVE environment as a data exchange provider, will my customers also need to apply for LIVE access for their individual accounts? Can you explain the customer account creation process in the web services? Could you explain the difference between “account” services and “customer” services? How do you delete a customer in the test environment? I am trying to add customField to a connection request. How do I do this? I can't seem to get the /mapping/customer/(espCustID) method working properly. Why? I get an error when trying to submit data for custom fields. How do I set up and simulate a customer submission of data for custom fields? In the previous web services (ABS 2.5), it was possible to create a building and mark the owner as a NEW PM user. Is this feature available in the new REST-based services? The only service that will currently allow a user to obtain a customer’s Portfolio Manager user name is “GET /customer/(customerId)”. Could a customer’s user name be included in “GET /customer/list” and/or “GET /connect/account/pending/list,” which appear to only include the customer’s numerical accountID? More... Connection/Share Web Services Am I able to exchange data with a property after it has been transferred to a new property data administrator (PDA) account? How can I determine my access level to a property? How do I connect with the new account when a property that was shared with me is transferred? How do I set up a connection with my customers in Portfolio Manager to enable us to share and exchange data? I don’t see a Portfolio Manager login username (espCustID) when retrieving my pending customer account list. How do I map this customer to my existing espCustId? I get an error when trying to submit data for custom fields. How do I set up and simulate a customer submission of data for custom fields? I get an error when trying to use POST /invite/account/(dxAccountId). How do I simulate a connection request from a customer? I have shared my property with a data exchange provider, and now I am unable to share the property with other data exchange providers. Why is this? If I share a data center meter directly, without sharing the property, how do I know which data center the meter belongs to? Is it possible for a user, once connected, to unshare their account, in addition to the property and meter levels? If so, then how will web service provider be notified? More... Property Web Services Are there web services that can help me find out why my property is not receiving a score? Can a building be associated with another building as a "sibling" not as parent-child? For federal properties, there are additional attributes required, including Agency ID and Federal Real Property ID. What are these IDs, and how can I obtain them? How are the current ‘uniqueBuildingIdentifier’ fields being converted in the new system? How do I know which unique identifier will hold the "otherFederalPropertyId" value? How do we associate multiple property uses to a property? How is the “CustomFieldList” defined and used? Are these similar to the current custom data fields? Is there a list of all Portfolio Manager data validations not represented in the XML schemas? What does the “occupancyPercentage” field in the property.xsd represent? How do I calculate occupancy percentage? What is the “constructionStatus” field in the property.xsd for? More... Building Web Services Am I required to create buildings within a property? Are there web services that can help me find out why my property is not receiving a score? Can a building be associated with another building as a "sibling" not as parent-child? How are buildings different from property uses (propertyUse)? Property Use Web Services Can I delete a Property Use Detail? How do I update property use details? How do property use default values work? How do we associate multiple property uses to a property? How do you create a data center meter on a data center property use? I am having trouble with the "singleStore" value in the property use schemas. Is this value required and what are the options? If I share a data center meter directly, without sharing the property, how do I know which data center the meter belongs to? My property use is displaying attributes that I did not submit. What happened? Some property uses, like a K-12 school, have the attributes PercentCooled and PercentHeated. The data type for these attributes seems to have changed from a number to a string. How was this handled in the upgrade? The parking.xsd schema indicates that required fields for parking seem to have changed. There is a new data field for “Supplemental Heating,” and the current field “Weekly Hours of Access” seems to have been dropped. Can you confirm if these fields are or are not needed for parking spaces in the upgraded Portfolio Manager? More... Meter Web Services Can multiple custom fields be created at once using the customFieldList attribute? How do I replace or retire a meter using the API? Should I use the delete method to de-associate the meter? How do the new meter services handle the following meter types: district chilled water, electric, steam, and other? How do we perform a “replace range” for meter consumption in the new web services? How do you create a data center meter on a data center property use? How is the “CustomFieldList” defined and used? Are these similar to the current custom data fields? How is the meter 'firstBillDate' determined? If I create a meter on a property using /property/(propertyId)/meter, do I need to explicitly associate it to the property again? What is the purpose of /association/property/(propertyId)/meter? Is it possible to associate a single meter to multiple properties? Is there a list of valid Property Use- Meter types? More... Reporting Web Services Are “change from baseline” metrics included in the current reporting services? Are Heating Degree Days (HDD) and Cooling Degree Days (CDD) available via web services? What method will be used to retrieve that information? Are there web services that can help me find out why my property is not receiving a score? Do reporting services provide a breakdown of site energy use by type, as is currently available on the Statement of Energy Performance? Does Portfolio Manager provide ENERGY STAR scores for Canadian buildings? Our customers would like ENERGY STAR scores for each of their buildings. What do we do with property uses that aren't eligible for scores? The metrics sourceIntensityScore50 and sourceIntensityScore75 have been removed from the Web Services Reporting API section. Will these metrics be replaced? There's a distinction between buildings (properties) and a campus of buildings (associating a property to another property). In the new Portfolio Manager, properties are eligible for ENERGY STAR scores. Are campuses (i.e., aggregates of properties) also eligible for scores? When I generate metrics for a parent property (campus), are the meters from associated sub-properties (buildings) automatically included in calculations? If not, how can I include the sub-properties? Target Finder Web Services Are there web services available for Target Finder? How do I use the new design functionality to retrieve design metrics?