Como você limpa um valor de campo com entity_metadata_wrapper ()?

Suponha que eu tenha uma entidade com um campo field_fooe queira limpar o valor desse campo.

O que devo passar $wrapper->set()?

Eu tentei NULLe array()ambos produzem uma mensagem de erro.

O problema é que você deve definir um valor vazio que seja compatível com o tipo de dados do seu campo. Caso contrário, você receberá uma exceção. Passar NULLou array()quando uma sequência é esperada gerará um erro.

Outro aspecto a ter em mente é que os dados transmitidos também dependerão se o seu campo for um valor único, um campo com vários valores ou um campo com várias propriedades.

Se o seu campo for um valor único (e, portanto, o wrapper do campo for uma instância do EntityValueWrapper ), você deverá atribuir a ele um valor vazio compatível com o tipo de dados em questão . Por exemplo, os dois métodos a seguir são equivalentes:

$wrapper->title = '';
$wrapper->title->set('');

No entanto, os três exemplos a seguir gerarão uma exceção, porque os tipos de dados não são compatíveis com o titlecampo:

$wrapper->title->set();
$wrapper->title->set(NULL);
$wrapper->title->set(array());

Se o seu campo for um campo com várias propriedades (por exemplo, um campo de texto formatado, que definiu a valuee a formatpropriedade) e, portanto, uma instância do EntityStructureWrapper , array()ou NULLserá o valor vazio correto. Então você pode fazer o seguinte:

$wrapper->field_formatted_text = array();
$wrapper->field_formatted_text = NULL;

Mas, nesse caso, passar uma string vazia teria gerado um erro. Observe que você poderia optar por deixar a valuepropriedade vazia . Nesse caso, uma sequência é o tipo de dados correto:

$wrapper->field_formatted_text->value = '';

Finalmente, se o campo é um campo multi-valor (e, assim, o seu invólucro é um exemplo de EntityListWrapper ), em seguida, arrayou NULLsão os valores de correcção vazios, e as três linhas seguintes são equivalentes:

$wrapper->field_example_multiple->set();
$wrapper->field_example_multiple = array();
$wrapper->field_example_multiple = NULL;

Nota: Chamar o clearmétodo nos wrappers não é equivalente a configurar o campo para um valor vazio. Quando o campo é definido como um valor vazio, ele chama EntityMetadataWrapper :: updateParent no wrapper pai do campo. Isso garante, entre outras coisas, que o setter callbackdefinido por hook_entity_property_info seja chamado. Ligar clearnão faz isso.

Além de outras respostas e comentários, se o campo for múltiplo e obrigatório, conforme observado anteriormente, você não poderá usar

$wrapper->field_example_multiple->set()

$wrapper->field_example_multiple->set(NULL)

nem mesmo $wrapper->field_example_multiple->set(array()),

mas, em vez disso, você pode usar o seguinte se quiser limpar o campo de todos os seus valores:

$wrapper->field_example_multiple->set(array(NULL));

De fato, isso funciona se o campo de valores múltiplos está ou não definido como 'obrigatório' e, portanto, recomendo sempre usá-lo, para garantir que seu código seja robusto.

(Obviamente, se o campo for 'obrigatório', você talvez não deva limpá-lo completamente, mas seu código pode estar fazendo isso como uma etapa preliminar para excluir a entidade inteira ou algo semelhante, portanto, há momentos em que pode apenas seja legítimo.)

Parece que as complexidades listadas nos outros comentários são relevantes apenas para um campo obrigatório. Se o campo não for obrigatório, isso deve ser bastante simples:

$wrapper->field_foo = NULL;

Você pode usar o wrapper para verificar as propriedades do campo:

$properties = $wrapper->getPropertyInfo();
$field_required = !empty($properties['field_foo']['required']);

Dependendo do contexto, você também pode obter as propriedades de um campo usando:

$wrapper->getPropertyInfo('field_foo');

Outra solução para esse problema pode ser EntityMetadataWrapper::clear

$entity_wrapper->field->clear()