add doc hint and test for InvalidValueException

That exception is thrown by the setValue() method if the given (fake)
value is not valid to set on the given field.