/**
* Sets selected options of this custom field.
*
* @param kyCustomFieldOption[] $options List of options.
* @return kyCustomFieldMultiSelect
*/
public function setSelectedOptions($options)
{
//make sure it's array
if (!is_array($options)) {
if ($options === null) {
$options = array();
} else {
$options = array($options);
}
}
//check for proper class and eliminate duplicates
$options_ids = array();
$this->options = array();
foreach ($options as $option) {
$option = ky_assure_object($option, 'kyCustomFieldOption');
if ($option !== null && !in_array($option->getId(), $options_ids)) {
$this->options[] = $option;
$options_ids[] = $option->getId();
}
}
//update raw value
$option_values = array();
foreach ($this->options as $field_option) {
$option_values[] = $field_option->getValue();
}
$this->raw_value = implode(self::VALUES_SEPARATOR, $option_values);
}
/**
* Sets the field selected option.
*
* @param kyCustomFieldOption $option Child (linked) field option.
* @return kyCustomFieldLinkedSelect
*/
public function setSelectedOption($option)
{
$this->option = ky_assure_object($option, 'kyCustomFieldOption');
if ($this->option !== null) {
$parent_option = $this->getOption($this->option->getParentOptionId());
$this->raw_value = implode(self::PARENT_CHILD_SEPARATOR, array($parent_option->getValue(), $this->option->getValue()));
} else {
$this->raw_value = null;
}
return $this;
}
/**
* Sets the field selected option.
*
* @param kyCustomFieldOption $option Field option.
* @return kyCustomFieldWithOptions
*/
public function setSelectedOption($option)
{
$this->option = ky_assure_object($option, 'kyCustomFieldOption');
$this->raw_value = $this->option !== null ? $this->option->getValue() : null;
return $this;
}
/**
* Sets staff user, owner of this ticket.
*
* @param kyStaff $owner_staff Staff user.
* @return kyTicket
*/
public function setOwnerStaff($owner_staff)
{
$this->owner_staff = ky_assure_object($owner_staff, 'kyStaff');
$this->owner_staff_id = $this->owner_staff !== null ? $this->owner_staff->getId() : null;
return $this;
}
/**
* Sets staff group for the staff user.
*
* @param kyStaffGroup $staff_group Staff group object.
* @return kyStaff
*/
public function setStaffGroup($staff_group)
{
$this->staff_group = ky_assure_object($staff_group, 'kyStaffGroup');
$this->staff_group_id = $this->staff_group !== null ? $staff_group->getId() : null;
return $this;
}
/**
* Sets user organization assigned to the user.
*
* @param kyUserOrganization $user_organization User organization.
* @return kyUser
*/
public function setUserOrganization(kyUserOrganization $user_organization)
{
$this->user_organization = ky_assure_object($user_organization, 'kyUserOrganization');
$this->user_organization_id = $this->user_organization !== null ? $this->user_organization->getId() : null;
return $this;
}
/**
* Sets staff user, the editor of this news item update.
*
* @param kyStaff $staff Staff user.
* @return kyNewsItem
*/
public function setEditedStaff($staff)
{
$this->edited_staff = ky_assure_object($staff, 'kyStaff');
$this->edited_staff_id = $this->edited_staff !== null ? $this->edited_staff->getId() : null;
return $this;
}
/**
* Sets parent department for this department.
*
* @param kyDepartment $parent_department Department object that will be the parent for this department.
* @return kyDepartment
*/
public function setParentDepartment($parent_department)
{
$this->parent_department = ky_assure_object($parent_department, 'kyDepartment');
$this->parent_department_id = $this->parent_department !== null ? $this->parent_department->getId() : null;
return $this;
}
/**
* Sets the parent comment (comment that this comment is a reply to).
*
* @param kyCommentBase $parent_comment Parent comment (comment that this comment is a reply to).
* @return $this
*/
public function setParentComment($parent_comment)
{
$this->parent_comment = ky_assure_object($parent_comment, get_class($this));
$this->parent_comment_id = $this->parent_comment !== null ? $this->parent_comment->getId() : null;
return $this;
}
/**
* Sets staff user, the creator of this knowledgebase article.
*
* @param kyStaff $staff Staff user.
* @return kyKnowledgebaseArticle
*/
public function setStaff($creator)
{
$this->creator = ky_assure_object($creator, 'kyStaff');
$this->creator_id = $this->creator !== null ? $this->creator->getId() : null;
return $this;
}
/**
* Sets staff user, the creator of this post.
*
* @param kyStaff $staff Staff user.
* @return kyTicketPost
*/
public function setStaff($staff)
{
$this->staff = ky_assure_object($staff, 'kyStaff');
$this->staff_id = $this->staff !== null ? $this->staff->getId() : null;
$this->creator = $this->staff !== null ? self::CREATOR_STAFF : null;
$this->user_id = null;
$this->user = null;
return $this;
}
/**
* Sets staff user that creates the time track.
*
* @param kyStaff $creator_staff Staff user that creates the time track.
* @return kyTicketTimeTrack
*/
public function setCreatorStaff($creator_staff)
{
$this->creator_staff = ky_assure_object($creator_staff, 'kyStaff');
$this->creator_staff_id = $this->creator_staff !== null ? $this->creator_staff->getId() : null;
$this->creator_staff_name = $this->creator_staff !== null ? $this->creator_staff->getFullName() : null;
return $this;
}
/**
* Sets the ticket post this attachment will be attached to.
*
* Automatically sets the ticket.
*
* @param kyTicketPost $ticket_post Ticket post.
*/
public function setTicketPost($ticket_post)
{
$this->ticket_post = ky_assure_object($ticket_post, 'kyTicketPost');
$this->ticket_post_id = $this->ticket_post !== null ? $this->ticket_post->getId() : null;
$this->ticket = $this->ticket_post !== null ? $this->ticket_post->getTicket() : null;
$this->ticket_id = $this->ticket !== null ? $this->ticket->getId() : null;
}
/**
* Sets news item.
*
* @param kyNewsItem $news_item News item.
* @return kyNewsComment
*/
public function setNewsItem($news_item)
{
$this->news_item = ky_assure_object($news_item, 'kyNewsItem');
$this->news_item_id = $this->news_item !== null ? $this->news_item->getId() : null;
return $this;
}
/**
* Sets KnowledgebaseArticle.
*
* @param kyKnowledgebaseArticle $kbarticle kbarticle item.
* @return kyKnowledgebaseComment
*/
public function setKbarticle($kbarticle)
{
$this->kbarticle = ky_assure_object($kbarticle, 'kyKnowledgebaseArticle');
$this->kbarticle_id = $this->kbarticle !== null ? $this->kbarticle->getId() : null;
return $this;
}
/**
* Sets the troubleshooterstep item
*
* @param int $troubleshooterstep_item
*
* @return $this
*/
public function setTroubleshooterStep($troubleshooterstep_item)
{
$this->troubleshooterstep_item = ky_assure_object($troubleshooterstep_item, 'kyTroubleshooterStep');
$this->troubleshooterstep_item_id = $this->troubleshooterstep_item !== null ? $this->troubleshooterstep_item->getId() : null;
return $this;
}
