/**
* Insert an element set and its elements into the database.
*
* @package Omeka\Function\Db\ElementSet
* @uses Builder_ElementSet
* @param string|array $elementSetMetadata Element set information.
* <code>
* [(string) element set name]
* // OR
* array(
* 'name' => [(string) element set name, required, unique],
* 'description' => [(string) element set description, optional],
* 'record_type' => [(string) record type name, optional]
* );
* </code>
* @param array $elements An array containing element data. Follows one of more
* of the following formats:
* <ol>
* <li>An array containing element metadata</li>
* <li>A string of the element name</li>
* </ol>
* <code>
* array(
* array(
* 'name' => [(string) name, required],
* 'description' => [(string) description, optional],
* ),
* [(string) element name]
* );
* </code>
* @return ElementSet
*/
function insert_element_set($elementSetMetadata = array(), array $elements = array())
{
$builder = new Builder_ElementSet(get_db());
$builder->setRecordMetadata($elementSetMetadata);
$builder->setElements($elements);
return $builder->build();
}
/**
* Insert an element set and its elements into the database.
*
* @package Omeka\Function\Db\ElementSet
* @uses Builder_ElementSet
* @param string|array $elementSetMetadata Element set information.
* <code>
* [(string) element set name]
* // OR
* array(
* 'name' => [(string) element set name, required, unique],
* 'description' => [(string) element set description, optional],
* 'record_type' => [(string) record type name, optional]
* );
* </code>
* @param array $elements An array containing element data. Follows one of more
* of the following formats:
* <ol>
* <li>An array containing element metadata</li>
* <li>A string of the element name</li>
* </ol>
* <code>
* array(
* array(
* 'name' => [(string) name, required],
* 'description' => [(string) description, optional],
* ),
* [(string) element name]
* );
* </code>
* @return ElementSet
*/
function insert_element_set($elementSetMetadata = array(), array $elements = array())
{
// Set the element set name if a string is provided.
if (is_string($elementSetMetadata)) {
$elementSetMetadata = array('name' => $elementSetMetadata);
}
$builder = new Builder_ElementSet(get_db());
$builder->setRecordMetadata($elementSetMetadata);
$builder->setElements($elements);
return $builder->build();
}
