Acessando Campos
Se você usou um dos métodos acima, agora temos um registro de bean. Este bean representa o registro que recuperamos. Podemos acessar os campos desse registro simplesmente acessando propriedades no bean como qualquer outro objeto PHP. Da mesma forma, podemos usar o acesso à propriedade para definir os valores dos beans. Alguns exemplos são os seguintes:
//Get the Name field on account bean
$accountBean->name;
//Get the Meeting start date
$meetingBean->date_start;
//Get a custom field on a case
$caseBean->third_party_code_c;
//Set the name of a case
$caseBean->name = 'New Case name';
//Set the billing address post code of an account
$accountBean->billing_address_postalcode = '12345';
Quando são feitas alterações em uma instância de bean, elas não são imediatamente persistidas. Podemos salvar as alterações no banco de dados com uma chamada para o método save
do bean. Da mesma forma, uma chamada para save
em um registro totalmente novo adicionará esse registro ao banco de dados:
//Get the Name field on account bean
$accountBean->name = 'New account name';
//Set the billing address post code of an account
$accountBean->billing_address_postalcode = '12345';
//Save both changes.
$accountBean->save();
//Create a new case (see the BeanFactory section)
$caseBean = BeanFactory::newBean('Cases');
//Give it a name and save
$caseBean->name = 'New Case name';
$caseBean->save();
A decisão de salvar ou atualizar um bean é decidida verificando o campo de id
do bean. Se o id
for definido, o HelloCloud tentará executar uma atualização. Se não houver um id
, um será gerado e um novo registro será inserido no banco de dados. Se, por algum motivo, você forneceu um id
, mas o registro é novo (talvez em um script de importação personalizado), é possível definir new_with_id
como true no bean para informar ao HelloCloud que esse registro é novo.