This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilBiblFieldFactory:

Collaboration diagram for ilBiblFieldFactory:

Public Member Functions

__construct (protected \ilBiblTypeInterface $type)

ilBiblFieldFactory constructor. More...

getType ()

getFieldByTypeAndIdentifier (int $type, string $identifier)

Parameters

int $type MUST be ilBiblTypeFactoryInterface::DATA_TYPE_RIS or ilBiblTypeFactoryInterface::DATA_TYPE_BIBTEX

Exceptions

ilException if a wrong $type is passed or field is not found More...

findOrCreateFieldByTypeAndIdentifier (int $type, string $identifier)

Parameters

int $type MUST be ilBiblTypeFactoryInterface::DATA_TYPE_RIS or ilBiblTypeFactoryInterface::DATA_TYPE_BIBTEX

Exceptions

ilException if a wrong $type is passed More...

getAvailableFieldsForObjId (int $obj_id)

@inheritDoc More...

filterAllFieldsForType (ilBiblTypeInterface $type, ?ilBiblTableQueryInfoInterface $queryInfo=null)

@inheritDoc More...

filterAllFieldsForTypeAsArray (ilBiblTypeInterface $type, ?ilBiblTableQueryInfoInterface $queryInfo=null)

@inheritDoc More...

findOrCreateFieldOfAttribute (ilBiblAttributeInterface $attribute)

@inheritDoc More...

forcePosition (ilBiblFieldInterface $field)

@inheritDoc More...

Public Member Functions inherited from ilBiblFieldFactoryInterface

getFieldByTypeAndIdentifier (int $type, string $identifier)

findOrCreateFieldByTypeAndIdentifier (int $type, string $identifier)

getAvailableFieldsForObjId (int $obj_id)

filterAllFieldsForType (ilBiblTypeInterface $type, ?ilBiblTableQueryInfoInterface $queryInfo=null)

filterAllFieldsForTypeAsArray (ilBiblTypeInterface $type, ?ilBiblTableQueryInfoInterface $queryInfo=null)

getType ()

findById (int $id)

findOrCreateFieldOfAttribute (ilBiblAttributeInterface $attribute)

forcePosition (ilBiblFieldInterface $field)

Private Member Functions
	getNextFreePosition (ilBiblFieldInterface $field)

	getARInstance (int $type, string $identifier)

	getCollectionForFilter (ilBiblTypeInterface $type, ?ilBiblTableQueryInfoInterface $queryInfo=null)

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Class ilBiblFieldFactory

Author: Fabian Schmid fs@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Definition at line 24 of file class.ilBiblFieldFactory.php.

Constructor & Destructor Documentation

◆ __construct()

ilBiblFieldFactory::__construct ( protected \ilBiblTypeInterface $type )

ilBiblFieldFactory constructor.

Definition at line 29 of file class.ilBiblFieldFactory.php.

30 {

31 }

Member Function Documentation

◆ filterAllFieldsForType()

ilBiblFieldFactory::filterAllFieldsForType	(	ilBiblTypeInterface	$type,
		?ilBiblTableQueryInfoInterface	$queryInfo = `null`
	)

@inheritDoc

Implements ilBiblFieldFactoryInterface.

Definition at line 124 of file class.ilBiblFieldFactory.php.

                                                                                                                       : array
    {
        return $this->getCollectionForFilter($type, $queryInfo)->get();
    }

References getCollectionForFilter().

Here is the call graph for this function:

◆ filterAllFieldsForTypeAsArray()

ilBiblFieldFactory::filterAllFieldsForTypeAsArray	(	ilBiblTypeInterface	$type,
		?ilBiblTableQueryInfoInterface	$queryInfo = `null`
	)

@inheritDoc

Implements ilBiblFieldFactoryInterface.

Definition at line 133 of file class.ilBiblFieldFactory.php.

                                                                                                                              : array
    {
        return $this->getCollectionForFilter($type, $queryInfo)->getArray();
    }

References getCollectionForFilter().

Here is the call graph for this function:

◆ findOrCreateFieldByTypeAndIdentifier()

ilBiblFieldFactory::findOrCreateFieldByTypeAndIdentifier	(	int	$type,
		string	$identifier
	)

Parameters

int $type MUST be ilBiblTypeFactoryInterface::DATA_TYPE_RIS or ilBiblTypeFactoryInterface::DATA_TYPE_BIBTEX

Exceptions

ilException if a wrong $type is passed

Implements ilBiblFieldFactoryInterface.

Definition at line 79 of file class.ilBiblFieldFactory.php.

                                                                                       : ilBiblFieldInterface
    {
        $inst = $this->getARInstance($type, $identifier);
        if ($inst === null) {
            $inst = new ilBiblField();
            $inst->setIdentifier($identifier);
            $inst->setDataType($type);
            $inst->setIsStandardField($this->getType()->isStandardField($identifier));
            $inst->create();
        }
        $inst->setDataType($type);
        $inst->setIdentifier($identifier);
        $inst->setIsStandardField($this->getType()->isStandardField($identifier));
        $inst->update();
 
        return $inst;
    }

References getARInstance(), and getType().

Referenced by getAvailableFieldsForObjId().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findOrCreateFieldOfAttribute()

ilBiblFieldFactory::findOrCreateFieldOfAttribute ( ilBiblAttributeInterface $attribute )

@inheritDoc

Implements ilBiblFieldFactoryInterface.

Definition at line 142 of file class.ilBiblFieldFactory.php.

                                                                                     : ilBiblFieldInterface
    {
        $field = ilBiblField::where(['identifier' => $attribute->getName()])->first();
        if ($field === null) {
            $field = new ilBiblField();
            $field->setIdentifier($attribute->getName());
            $field->setDataType($this->type->getId());
            $field->setIsStandardField($this->type->isStandardField($attribute->getName()));
            $field->create();
        } else {
            $field->setDataType($this->type->getId());
            $field->update();
        }
 
        return $field;
    }

References ilBiblAttributeInterface\getName(), and ActiveRecord\where().

Here is the call graph for this function:

◆ forcePosition()

ilBiblFieldFactory::forcePosition ( ilBiblFieldInterface $field )

@inheritDoc

Implements ilBiblFieldFactoryInterface.

Definition at line 163 of file class.ilBiblFieldFactory.php.

                                                              : int
    {
        global $DIC;
        $tablename = ilBiblField::TABLE_NAME;
        $q = "UPDATE {$tablename} SET position = position + 1 WHERE data_type = %s AND position >= %s;";
        $DIC->database()->manipulateF(
            $q,
            ['integer', 'integer'],
            [
                $field->getDataType(),
                $field->getPosition(),
            ]
        );
        $field->store();
        $DIC->database()->query("SET @i=0");
        $DIC->database()->manipulateF(
            "UPDATE {$tablename} SET position = (@i := @i + 1) WHERE data_type = %s ORDER BY position",
            ['integer'],
            [
                $field->getDataType(),
            ]
        );
 
        return (int) $field->getPosition();
    }

References $DIC, $q, ilBiblFieldInterface\getDataType(), ilBiblFieldInterface\getPosition(), ilBiblFieldInterface\store(), and ilBiblField\TABLE_NAME.

Here is the call graph for this function:

◆ getARInstance()

ilBiblFieldFactory::getARInstance	(	int	$type,
		string	$identifier
	)

private

Definition at line 209 of file class.ilBiblFieldFactory.php.

                                                                 : ?\ilBiblField
    {
        return ilBiblField::where(["identifier" => $identifier, "data_type" => $type])->first();
    }

References ActiveRecord\where().

Referenced by findOrCreateFieldByTypeAndIdentifier(), and getFieldByTypeAndIdentifier().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAvailableFieldsForObjId()

ilBiblFieldFactory::getAvailableFieldsForObjId ( int $obj_id )

@inheritDoc

Implements ilBiblFieldFactoryInterface.

Definition at line 101 of file class.ilBiblFieldFactory.php.

                                                           : array
    {
        global $DIC;
        $sql
            = "SELECT DISTINCT(il_bibl_attribute.name), il_bibl_data.file_type FROM il_bibl_data
                                        JOIN il_bibl_entry ON il_bibl_entry.data_id = il_bibl_data.id
                                        JOIN il_bibl_attribute ON il_bibl_attribute.entry_id = il_bibl_entry.id
                                WHERE il_bibl_data.id = %s;";
 
        $result = $DIC->database()->queryF($sql, ['integer'], [$obj_id]);
 
        $data = [];
        while ($d = $DIC->database()->fetchObject($result)) {
            $data[] = $this->findOrCreateFieldByTypeAndIdentifier($d->file_type, $d->name);
        }
 
        return $data;
    }

References Vendor\Package\$d, $data, $DIC, and findOrCreateFieldByTypeAndIdentifier().

Here is the call graph for this function:

◆ getCollectionForFilter()

ilBiblFieldFactory::getCollectionForFilter	(	ilBiblTypeInterface	$type,
		?ilBiblTableQueryInfoInterface	$queryInfo = `null`
	)

private

Definition at line 215 of file class.ilBiblFieldFactory.php.

                                                                                                                        : \ActiveRecordList
    {
        $collection = ilBiblField::getCollection();
 
        $collection->where(['data_type' => $type->getId()]);
 
        if ($queryInfo !== null) {
            $sorting_column = $queryInfo->getSortingColumn() !== '' && $queryInfo->getSortingColumn() !== '0' ? $queryInfo->getSortingColumn() : null;
            $offset = $queryInfo->getOffset();
            $sorting_direction = $queryInfo->getSortingDirection();
            $limit = $queryInfo->getLimit();
            if ($sorting_column) {
                $collection->orderBy($sorting_column, $sorting_direction);
            }
            $collection->limit($offset, $limit);
 
            foreach ($queryInfo->getFilters() as $queryFilter) {
                $collection->where([$queryFilter->getFieldName() => $queryFilter->getFieldValue()], $queryFilter->getOperator());
            }
        }
 
        return $collection;
    }

References ActiveRecord\getCollection(), and ilBiblTypeInterface\getId().

Referenced by filterAllFieldsForType(), and filterAllFieldsForTypeAsArray().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFieldByTypeAndIdentifier()

ilBiblFieldFactory::getFieldByTypeAndIdentifier	(	int	$type,
		string	$identifier
	)

Parameters

int $type MUST be ilBiblTypeFactoryInterface::DATA_TYPE_RIS or ilBiblTypeFactoryInterface::DATA_TYPE_BIBTEX

Exceptions

ilException if a wrong $type is passed or field is not found

@noinspection PhpIncompatibleReturnTypeInspection

Implements ilBiblFieldFactoryInterface.

Definition at line 64 of file class.ilBiblFieldFactory.php.

                                                                              : ilBiblFieldInterface
    {
        $inst = $this->getARInstance($type, $identifier);
        if ($inst === null) {
            throw new ilException("bibliografic identifier {$identifier} not found");
        }
 
        return $inst;
    }

References getARInstance().

Here is the call graph for this function:

◆ getNextFreePosition()

ilBiblFieldFactory::getNextFreePosition ( ilBiblFieldInterface $field )

private

Parameters

ilBiblFieldInterface $field

Returns: int

Definition at line 197 of file class.ilBiblFieldFactory.php.

                                                                     : int
    {
        global $DIC;
        $tablename = ilBiblField::TABLE_NAME;
        $q = "SELECT MAX(position) + 1 as next_position FROM {$tablename} WHERE data_type = %s;";
        $res = $DIC->database()->queryF($q, ['integer'], [$field->getDataType()]);
        $data = $DIC->database()->fetchObject($res);
 
        return (int) $data->next_position;
    }

References $data, $DIC, $q, $res, ilBiblFieldInterface\getDataType(), and ilBiblField\TABLE_NAME.

Here is the call graph for this function:

◆ getType()

ilBiblFieldFactory::getType ( )

Implements ilBiblFieldFactoryInterface.

Definition at line 37 of file class.ilBiblFieldFactory.php.

                             : ilBiblTypeInterface
    {
        return $this->type;
    }

Referenced by findOrCreateFieldByTypeAndIdentifier().

Here is the caller graph for this function:

The documentation for this class was generated from the following file:

components/ILIAS/Bibliographic/classes/Field/class.ilBiblFieldFactory.php

Public Member Functions

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ filterAllFieldsForType()

◆ filterAllFieldsForTypeAsArray()

◆ findOrCreateFieldByTypeAndIdentifier()

◆ findOrCreateFieldOfAttribute()

◆ forcePosition()

◆ getARInstance()

◆ getAvailableFieldsForObjId()

◆ getCollectionForFilter()

◆ getFieldByTypeAndIdentifier()

◆ getNextFreePosition()

◆ getType()