Class DDLRecordSetServiceUtil
java.lang.Object
com.liferay.dynamic.data.lists.service.DDLRecordSetServiceUtil
Provides the remote service utility for DDLRecordSet. This utility wraps
com.liferay.dynamic.data.lists.service.impl.DDLRecordSetServiceImpl
and is an
access point for service operations in application layer code running on a
remote server. Methods of this service are expected to have security checks
based on the propagated JAAS credentials because this service can be
accessed remotely.- See Also:
- Generated:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic DDLRecordSet
addRecordSet
(long groupId, long ddmStructureId, String recordSetKey, Map<Locale, String> nameMap, Map<Locale, String> descriptionMap, int minDisplayRows, int scope, com.liferay.portal.kernel.service.ServiceContext serviceContext) Adds a record set referencing the DDM structure.static void
deleteRecordSet
(long recordSetId) Deletes a record set and its resources.static DDLRecordSet
fetchRecordSet
(long recordSetId) Returns a record set with the ID.static String
Returns the OSGi service identifier.static DDLRecordSet
getRecordSet
(long recordSetId) Returns a record set with the ID.static List<DDLRecordSet>
getRecordSets
(long[] groupIds) Returns all the record sets matching the groups, filtered by the user'sVIEW
permission.static DDLRecordSetService
static List<DDLRecordSet>
search
(long companyId, long groupId, String keywords, int scope, int start, int end, com.liferay.portal.kernel.util.OrderByComparator<DDLRecordSet> orderByComparator) Returns a range of all record sets matching the parameters, filtered by the user'sVIEW
permission.static List<DDLRecordSet>
search
(long companyId, long groupId, String name, String description, int scope, boolean andOperator, int start, int end, com.liferay.portal.kernel.util.OrderByComparator<DDLRecordSet> orderByComparator) Returns an ordered range of record sets, filtered by the user'sVIEW
permission.static int
searchCount
(long companyId, long groupId, String keywords, int scope) Returns the number of record sets matching the parameters, filtered by the user'sVIEW
permission.static int
searchCount
(long companyId, long groupId, String name, String description, int scope, boolean andOperator) Returns the number of all record sets matching the parameters, filtered by the user'sVIEW
permission.static DDLRecordSet
updateMinDisplayRows
(long recordSetId, int minDisplayRows, com.liferay.portal.kernel.service.ServiceContext serviceContext) Updates the number of minimum rows to display for the record set.static DDLRecordSet
updateRecordSet
(long groupId, long ddmStructureId, String recordSetKey, Map<Locale, String> nameMap, Map<Locale, String> descriptionMap, int minDisplayRows, com.liferay.portal.kernel.service.ServiceContext serviceContext) Updates the DDM structure, name, description, and minimum number of display rows for the record set matching the group ID and record set key.static DDLRecordSet
updateRecordSet
(long recordSetId, long ddmStructureId, Map<Locale, String> nameMap, Map<Locale, String> descriptionMap, int minDisplayRows, com.liferay.portal.kernel.service.ServiceContext serviceContext) Updates the DDM structure, name, description, and minimum number of display rows for the record set matching the record set ID.static DDLRecordSet
updateRecordSet
(long recordSetId, com.liferay.dynamic.data.mapping.storage.DDMFormValues settingsDDMFormValues) Updates the the record set's settings.
-
Constructor Details
-
DDLRecordSetServiceUtil
public DDLRecordSetServiceUtil()
-
-
Method Details
-
addRecordSet
public static DDLRecordSet addRecordSet(long groupId, long ddmStructureId, String recordSetKey, Map<Locale, String> nameMap, Map<Locale, throws com.liferay.portal.kernel.exception.PortalExceptionString> descriptionMap, int minDisplayRows, int scope, com.liferay.portal.kernel.service.ServiceContext serviceContext) Adds a record set referencing the DDM structure.- Parameters:
groupId
- the primary key of the record set's groupddmStructureId
- the primary key of the record set's DDM structurerecordSetKey
- the mnemonic primary key of the record set. Ifnull
, the record set key will be autogenerated.nameMap
- the record set's locales and localized namesdescriptionMap
- the record set's locales and localized descriptionsminDisplayRows
- the record set's minimum number of rows to be displayed in spreadsheet viewscope
- the record set's scope, used to scope the record set's data. For more information searchDDLRecordSetConstants
in thedynamic.data.lists.api
module for constants starting with the "SCOPE_" prefix.serviceContext
- serviceContext the service context to be applied. This can set the UUID, guest permissions, and group permissions for the record set.- Returns:
- the record set
- Throws:
com.liferay.portal.kernel.exception.PortalException
- if a portal exception occurred
-
deleteRecordSet
public static void deleteRecordSet(long recordSetId) throws com.liferay.portal.kernel.exception.PortalException Deletes a record set and its resources.- Parameters:
recordSetId
- the primary key of the record set- Throws:
com.liferay.portal.kernel.exception.PortalException
- if a portal exception occurred
-
fetchRecordSet
public static DDLRecordSet fetchRecordSet(long recordSetId) throws com.liferay.portal.kernel.exception.PortalException Returns a record set with the ID.- Parameters:
recordSetId
- the primary key of the record set- Returns:
- the record set with the ID or
null
if the matching record set is not found - Throws:
com.liferay.portal.kernel.exception.PortalException
- if a portal exception occurred
-
getOSGiServiceIdentifier
Returns the OSGi service identifier.- Returns:
- the OSGi service identifier
-
getRecordSet
public static DDLRecordSet getRecordSet(long recordSetId) throws com.liferay.portal.kernel.exception.PortalException Returns a record set with the ID.- Parameters:
recordSetId
- the primary key of the record set- Returns:
- the record set with the ID
- Throws:
com.liferay.portal.kernel.exception.PortalException
- if a matching record set could not be found or if the user did not have the required permission to access the record set
-
getRecordSets
Returns all the record sets matching the groups, filtered by the user'sVIEW
permission.- Parameters:
groupIds
- the primary keys of the record set's groups- Returns:
- the matching record sets
-
search
public static List<DDLRecordSet> search(long companyId, long groupId, String keywords, int scope, int start, int end, com.liferay.portal.kernel.util.OrderByComparator<DDLRecordSet> orderByComparator) Returns a range of all record sets matching the parameters, filtered by the user'sVIEW
permission. The keywords parameter is used for matching String values to the record set's name or description.Useful when paginating results. Returns a maximum of
end - start
instances.start
andend
are not primary keys, they are indexes in the result set. Thus,0
refers to the first result in the set. Setting bothstart
andend
toQueryUtil.ALL_POS
will return the full result set.- Parameters:
companyId
- the primary key of the record set's companygroupId
- the primary key of the record set's groupkeywords
- the keywords (space separated), which my occur in the record set name or description (optionallynull
). If the keywords value is notnull
, the search uses the OR operator in connecting query criteria; otherwise it uses the AND operator.scope
- the record set's scope. Constant used to scope the record set's data. For more information search thedynamic.data.lists.api
module'sDDLRecordSetConstants
class for constants prefixed with "SCOPE_".start
- the lower bound of the range of record sets to returnend
- the upper bound of the range of record sets to return (not inclusive)orderByComparator
- the comparator to order the record sets- Returns:
- the range of matching record sets ordered by the comparator
-
search
public static List<DDLRecordSet> search(long companyId, long groupId, String name, String description, int scope, boolean andOperator, int start, int end, com.liferay.portal.kernel.util.OrderByComparator<DDLRecordSet> orderByComparator) Returns an ordered range of record sets, filtered by the user'sVIEW
permission. Company ID and group ID must be matched. If the and operator is set totrue
, only record sets with a matching name, description, and scope are returned. If the and operator is set tofalse
, only one parameter of name, description, and scope is needed to return matching record sets.Useful when paginating results. Returns a maximum of
end - start
instances.start
andend
are not primary keys, they are indexes in the result set. Thus,0
refers to the first result in the set. Setting bothstart
andend
toQueryUtil.ALL_POS
will return the full result set.- Parameters:
companyId
- the primary key of the record set's companygroupId
- the primary key of the record set's groupname
- the name keywords (space separated, optionallynull
)description
- the description keywords (space separated, optionallynull
)scope
- the record set's scope. Constant used to scope the record set's data. For more information search thedynamic.data.lists.api
module'sDDLRecordSetConstants
class for constants prefixed with "SCOPE_".andOperator
- whether every field must match its value or keywords, or just one field must match. Company and group must match their values.start
- the lower bound of the range of record sets to returnend
- the upper bound of the range of record sets to return (not inclusive)orderByComparator
- the comparator to order the record sets- Returns:
- the range of matching record sets ordered by the comparator
-
searchCount
Returns the number of record sets matching the parameters, filtered by the user'sVIEW
permission. The keywords parameter is used for matching record set names or descriptions.- Parameters:
companyId
- the primary key of the record set's companygroupId
- the primary key of the record set's group.keywords
- the keywords (space separated) to look for and match in the record set name or description (optionallynull
). If the keywords value is notnull
, the OR operator is used in connecting query criteria; otherwise it uses the AND operator.scope
- the record set's scope. A constant used to scope the record set's data. For more information search thedynamic.data.lists.api
module'sDDLRecordSetConstants
class for constants prefixed with "SCOPE_".- Returns:
- the number of matching record sets
-
searchCount
public static int searchCount(long companyId, long groupId, String name, String description, int scope, boolean andOperator) Returns the number of all record sets matching the parameters, filtered by the user'sVIEW
permission. If the and operator is set totrue
, only record sets with a matching name, description, and scope are counted. If the and operator is set tofalse
, only one parameter of name, description, and scope is needed to count matching record sets.- Parameters:
companyId
- the primary key of the record set's companygroupId
- the primary key of the record set's groupname
- the name keywords (space separated). This can benull
.description
- the description keywords (space separated). Can benull
.scope
- the record set's scope. A constant used to scope the record set's data. For more information search thedynamic.data.lists.api
module'sDDLRecordSetConstants
class for constants prefixed with "SCOPE_".andOperator
- whether every field must match its value or keywords, or just one field must match. Company and group must match their values.- Returns:
- the number of matching record sets
-
updateMinDisplayRows
public static DDLRecordSet updateMinDisplayRows(long recordSetId, int minDisplayRows, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws com.liferay.portal.kernel.exception.PortalException Updates the number of minimum rows to display for the record set. Useful when the record set is being displayed in spreadsheet.- Parameters:
recordSetId
- the primary key of the record setminDisplayRows
- the record set's minimum number of rows to be displayed in spreadsheet viewserviceContext
- the service context to be applied. This can set the record set modified date.- Returns:
- the record set
- Throws:
com.liferay.portal.kernel.exception.PortalException
- if a portal exception occurred
-
updateRecordSet
public static DDLRecordSet updateRecordSet(long recordSetId, com.liferay.dynamic.data.mapping.storage.DDMFormValues settingsDDMFormValues) throws com.liferay.portal.kernel.exception.PortalException Updates the the record set's settings.- Parameters:
recordSetId
- the primary key of the record setsettingsDDMFormValues
- the record set's settings. For more information seeDDMFormValues
in thedynamic.data.mapping.api
module.- Returns:
- the record set
- Throws:
com.liferay.portal.kernel.exception.PortalException
- if a portal exception occurred
-
updateRecordSet
public static DDLRecordSet updateRecordSet(long recordSetId, long ddmStructureId, Map<Locale, String> nameMap, Map<Locale, throws com.liferay.portal.kernel.exception.PortalExceptionString> descriptionMap, int minDisplayRows, com.liferay.portal.kernel.service.ServiceContext serviceContext) Updates the DDM structure, name, description, and minimum number of display rows for the record set matching the record set ID.- Parameters:
recordSetId
- the primary key of the record setddmStructureId
- the primary key of the record set's DDM structurenameMap
- the record set's locales and localized namesdescriptionMap
- the record set's locales and localized descriptionsminDisplayRows
- the record set's minimum number of rows to be displayed in spreadsheet view.serviceContext
- the service context to be applied. Can set the record set modified date.- Returns:
- the record set
- Throws:
com.liferay.portal.kernel.exception.PortalException
- if a portal exception occurred
-
updateRecordSet
public static DDLRecordSet updateRecordSet(long groupId, long ddmStructureId, String recordSetKey, Map<Locale, String> nameMap, Map<Locale, throws com.liferay.portal.kernel.exception.PortalExceptionString> descriptionMap, int minDisplayRows, com.liferay.portal.kernel.service.ServiceContext serviceContext) Updates the DDM structure, name, description, and minimum number of display rows for the record set matching the group ID and record set key.- Parameters:
groupId
- the primary key of the record set's groupddmStructureId
- the primary key of the record set's DDM structurerecordSetKey
- the record set's mnemonic primary keynameMap
- the record set's locales and localized namesdescriptionMap
- the record set's locales and localized descriptionsminDisplayRows
- the record set's minimum number of rows to be displayed in spreadsheet viewserviceContext
- the service context to be applied. This can set the record set modified date.- Returns:
- the record set
- Throws:
com.liferay.portal.kernel.exception.PortalException
- if a portal exception occurred
-
getService
-