Ce este?

Poți crea acum reguli de validare pentru proprietăți prin API public.

De ce este important?

Această actualizare le facilitează administratorilor și dezvoltatorilor asigurarea faptului că datele care ajung în HubSpot sunt consistente și corecte.

Cum funcționează?

Pentru a crea sau actualiza o regulă de validare specifică pentru o proprietate:

• Fă o cerere PUT către
  crm/v3/property-validations/{objectTypeId}/{propertyName}/rule-type/{ruleType}
  cu configurația regulii în corpul cererii.
• Aceasta va înlocui orice regulă existentă de același tip sau va adăuga o regulă nouă dacă nu există una. Corpul cererii trebuie să includă ruleArguments (un array de string-uri) și, opțional, shouldApplyNormalization (un boolean care indică dacă inputul trebuie normalizat înainte de validare).
• Exemplu:
  Pentru a seta o regulă ALPHANUMERIC care permite doar caractere numerice pentru proprietatea de deal Order ID:
  Fă o cerere PUT către
  crm/v3/property-validations/0-3/order_id/rule-type/ALPHANUMERIC
  cu următorul corp al cererii:

{

"ruleArguments": [

"NUMERIC_ONLY"

],

"shouldApplyNormalization": false

}

Aceasta va crea sau actualiza regula ALPHANUMERIC pentru proprietatea order_id, păstrând orice alte reguli de validare existente.

Pentru a vizualiza o regulă de validare specifică pentru o proprietate:

• Fă o cerere GET către
  crm/v3/property-validations/{objectTypeId}/{propertyName}/rule-type/{ruleType}.
• Aceasta returnează configurația pentru un singur tip de regulă, dacă există pentru proprietatea respectivă.
• Răspunsul include ruleType, ruleArguments și câmpul opțional shouldApplyNormalization, care indică dacă valorile introduse trebuie normalizate înainte de validare.
• Exemplu:
  Pentru a vizualiza regula MIN_LENGTH pentru proprietatea de deal Order ID:
  Fă o cerere GET către
  crm/v3/property-validations/0-3/order_id/rule-type/MIN_LENGTH.
  
  • În răspuns, regula impune ca proprietatea să aibă cel puțin un caracter:

{

"ruleType": "MIN_LENGTH",

"ruleArguments": [

"1"

],

"shouldApplyNormalization": false

}

Cine îl primește?

Toate hub-urile și nivelurile.