Documentation de service Web / Catégories / Services des propriétés / Ajouter une propriété

Ajouter une propriété

Mise à jour le 28 juin 2021

Description

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.

Version

22.0

Méthode HTTP

POST

URL de la ressource

/account/(accountId)/property

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant
Type de contenu application/xml

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
accountId Identifiant du compte auquel on doit ajouter la propriété

Schémas XML

Demande/réponse Nom de schéma
Demande propriété.xsd
Réponse réponse.xsd

Exemples de demande

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>

Exemple de réponse

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>
ENVIRONNEMENT D'ESSAI