Documentation de service Web / Catégories / Services des propriétés / Ajouter une propriété
Mise à jour le 28 juin 2021
Ce service Web crée une propriété pour un utilisateur spécifique de Portfolio Manager en fonction de l'information fournie dans la demande XML, et il établit toutes les autres permissions de partage nécessaires entre vous et l'utilisateur Portfolio Manager. Il retourne l'identifiant unique à la propriété nouvellement créée et un lien vers le service Web correspondant pour la récupérer.
22.0
POST
/account/(accountId)/property
Nom du champ | Valeur | Commentaires |
---|---|---|
Autorisation | Basic authentifiant | |
Type de contenu | application/xml |
Oui
Nom du paramètre | Description |
---|---|
accountId | Identifiant du compte auquel on doit ajouter la propriété |
Demande/réponse | Nom de schéma |
---|---|
Demande | propriété.xsd |
Réponse | réponse.xsd |
L'exemple suivant montre la création d'une nouvelle propriété appartenant à un compte dont l'identifiant correspond à 53434.
POST /compte/53434/propriété<?xml version="1.0" encoding="UTF-8"?> <property> <name>Broadway School</name> <primaryFunction>K-12 School</primaryFunction> <address address1="12321 Main Street" city="Arlington" postalCode="22201" state="VA" country="US"/> <yearBuilt>2000</yearBuilt> <constructionStatus>Existing</constructionStatus> <grossFloorArea temporary="false" units="Square Feet"> <value>10000</value> </grossFloorArea> <occupancyPercentage>80</occupancyPercentage> <isFederalProperty>false</isFederalProperty> <notes><![CDATA[Permit license > 5 years old.]]></notes> </property>
L'exemple suivant montre la création d'une nouvelle propriété appartenant à un compte dont l'identifiant correspond à 53434 et qui est situé au Canada. Pour les propriétés canadiennes uniquement, l'élément XML "isInstitutionalProperty" précise si la propriété est un bâtiment institutionnel ou commercial.
POST /compte/53434/propriété<?xml version="1.0" encoding="UTF-8"?> <property> <name>École de Broadway</name> <primaryFunction>école du préscolaire au secondaire</primaryFunction> <address address1="123 rue Main Street" city="Toronto" state="ON" postalCode="M5G1A1" country="CA"/> <yearBuilt>2000</yearBuilt> <constructionStatus>Existant</constructionStatus> <grossFloorArea temporary="false" units="Square Feet"> <value>10000</value> </grossFloorArea> <occupancyPercentage>80</occupancyPercentage> <isFederalProperty>faux</isFederalProperty> <notes><![CDATA[Permis de conduire > 5 ans.]]></notes> <isInstitutionalProperty>faux</isInstitutionalProperty> </property>
L'exemple suivant indique que la propriété a été créée avec succès. Il affiche aussi l'identifiant de la nouvelle propriété (5000036) et un lien Internet vers le service Web pour récupérer la propriété.
<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
<id>5000036</id>
<links>
<link httpMethod="GET" link="/property/5000036" linkDescription="This is the GET url for this Property."/>
</links>
</response>