Variáveis de modelo de orçamento
Os modelos de orçamento personalizados podem acessar os dados de orçamento e alguns objetos associados diretamente dos modelos. Os dados disponíveis dependem dos dados que você tem em seu CRM, além dos dados adicionados ao próprio orçamento.
Ao desenvolver um modelo de orçamento, você pode usar dados simulados fornecidos pela HubSpot para preencher o modelo, o que pode ajudar na visualização do modelo. Na pasta @hubspot
, acesse a pasta cms-quotes-theme
. Na pasta de modelos
, exiba os modelos basic.html
, modern.html
ou original.html
. Esses modelos contêm o seguinte bloco de código na parte superior:
Os dados falsos são primeiro importados do arquivo mock_data.html
e definido como a variável QUOTE
para usar os dados encontrados em template_data
, se disponível. A variável QUOTE
também é usada para preencher as outras variáveis desta lista, como ASSOCIATED_OBJECTS
, para tornar o acesso a esses dados mais sucinto. No entanto, você pode estruturar seus dados de forma diferente, dependendo das suas preferências.
No código acima, você notará que template_data
também é usado para definir a variável QUOTE
principal. template_data
é um objeto contendo todos os dados reais para o orçamento e negociação na página. Se esse objeto não for encontrado no modelo, o HubSpot carregará os dados mock_data.html
.
A grande maioria dos dados pode ser acessada diretamente através do objeto template_data
. Você pode usar {{ template_data|pprint }}
em seu modelo para ver o objeto completo fornecido.
Variável | Type | Description |
---|---|---|
template_data
| dict | Um dicionário contendo o orçamento, quote.associated_objects e dicionários totais. |
As informações específicas para este orçamento individual.
Variável | Type | Description |
---|---|---|
template_data.quote
| dict | Dicionário contendo todos os dados para o orçamento em si. |
template_data.quote.associated_objects.deal.hs_object_id
| Integer | ID do negócio |
template_data.quote.hubspot_owner_id
| Integer | ID de proprietário do negócio |
template_data.quote.hs_all_owner_ids
| integer or array of integers | IDs de proprietário do negócio |
template_data.quote.hs_created_by_user_id
| Integer | Usuário que criou o orçamento. |
template_data.quote.hs_lastmodifieddate
| datetime | Data em que o orçamento foi modificado pela última vez. Em formato de tempo. |
template_data.quote.hubspot_owner_assigneddate
| datetime | Data em que o orçamento foi atribuído a um proprietário. Em formato de tempo. |
template_data.quote.hs_createdate
| datetime | Data e hora em que o orçamento foi criado. Em formato de tempo. |
template_data.quote.hs_expiration_date
| datetime | Data em que o orçamento expira. Em formato de tempo. |
template_data.quote.hs_title
| String | Título do orçamento |
template_data.quote.hs_template_type
| String | "CUSTOMIZABLE_QUOTE_TEMPLATE" |
template_data.quote.hs_slug
| String | Slug de URL para página da web de orçamento. |
template_data.quote.hs_proposal_template_path
| String | Caminho do sistema de arquivos do desenvolvedor para o modelo. (inclui extensão de arquivo) |
template_data.quote.hs_quote_amount
| String | Valor em dinheiro |
template_data.quote.hs_currency
| String | Moeda em que está o valor do orçamento em código de moeda ISO 4217 de 3 caracteres. |
template_data.quote.hs_language
| String | Código do idioma |
template_data.quote.hs_locale
| String | Cópia local |
template_data.quote.hs_terms
| String | Texto dos termos fornecido pelo criador do orçamento |
template_data.quote.hs_sender_firstname
| String | Nome da pessoa que envia o orçamento. |
template_data.quote.hs_sender_company_name
| String | Nome da empresa da pessoa que envia o orçamento |
template_data.quote.hs_sender_company_image_url
| String | Logotipo da empresa para a pessoa que envia o orçamento. |
template_data.quote.hs_status
| String | Status do orçamento. |
template_data.quote.hs_primary_color
| string/hex color code | "#425b76" |
template_data.quote.hs_quote_number
| String | Número de ID de orçamento exclusivo. |
template_data.quote.hs_payment_enabled
| boolean | Use para testar se os campos de pagamento precisam ser exibidos. |
template_data.quote.hs_esign_enabled
| boolean | Use para testar se os campos de assinatura eletrônica precisam ser exibidos. |
Não consegue encontrar uma variável que você está procurando?
Há mais variáveis que você pode acessar dentro de template_data
. Use |pprint
para visualizá-las. Além disso, algumas variáveis nas associações de orçamento podem estar disponíveis apenas com base no orçamento/negócio.
Nós faremos a iteração nesta documentação para mostrar e explicar mais dos dados aos quais você tem acesso. Além da bela impressão, você pode visualizar o arquivo de dados simulados dentro do cms-quote-theme, para ver o que está disponível e a estrutura na qual ele vem.
Em um modelo de orçamento, você pode acessar dados de registros associados a um orçamento, como negócios ou empresas, usando associated_objects
.
Por exemplo, você pode adicionar o logotipo do registro da empresa associada do destinatário do orçamento a um orçamento usando o seguinte código:
Observação: apenas os logotipos definidos manualmente aparecerão. Os logotipos detectados automaticamente não aparecerão para impedir que os não intencionais apareçam no modelo de orçamento.
O código acima primeiro define uma variável que pesquisa o logotipo da empresa associada ao orçamento. Usando uma declaração if
, o modelo exibe esse logotipo, se disponível. Se nenhum logotipo foi definido manualmente para a empresa, nenhum logotipo será exibido.
Os dados de objetos personalizados podem ser exibidos ou usados em um orçamento de maneiras diferentes. Como a estrutura de cada objeto personalizado pode variar, você precisará obter propriedades específicas com base em como estruturou seu objeto personalizado.
O template_data
do orçamento por padrão tem objetos associados personalizados. Por exemplo, objetos personalizados associados a negócios estão incluídos.
Para acessá-los, você pode usar o seguinte código:
Observação: como os objetos personalizados são exclusivos para cada conta, os dados falsos não incluem um objeto personalizado de exemplo. Isso significa que, na visualização do modelo no gerenciador de design, você pode ver um erro ou os dados de objeto personalizados simplesmente não serão exibidos. Em vez disso, você precisará visualizar o modelo com seus dados reais de CRM, o que pode ser feito criando um orçamento a partir do modelo.
Você pode acessar cada tipo de objeto personalizado anexando seu ID de tipo de objeto personalizado formatado com sublinhados. Por exemplo:template_data.quote.associated_objects.deal.associated_objects.custom_objects._2_2193031
Você também pode procurar um objeto personalizado usando a função crm_associations()
e as funções crm_objects()
.
Por exemplo, se você quiser procurar um objeto personalizado associado a um negócio, poderá passar dados de template_data
:
Agradecemos pelos seus comentários. Eles são muito importantes para nós.