Workgroups and Projects: Overview of Methods

Workgroups and projects in Bitrix24 help organize team collaboration. In groups, you can:

• distribute tasks among participants, set deadlines, and track progress

• exchange documents, store, and collaboratively edit files

• discuss tasks in chats, leave comments, and hold online meetings

Quick navigation: all methods and events

User documentation: Workgroups and Projects in Bitrix24

What Distinguishes a Group from a ProjectWhat Distinguishes a Group from a Project

A project is a group with enhanced capabilities. Its main distinction from a group is the ability to set deadlines. The algorithm for creating a group and a project is identical: in both cases, use the method sonet_group.create. For a project, specify additional parameters:

• PROJECT — indicates that the created object is a project

• PROJECT_DATE_START — the project's start date

• PROJECT_DATE_FINISH — the project's end date

Connection of Workgroups and Projects with Other ObjectsConnection of Workgroups and Projects with Other Objects

Users. Collaborate on tasks within workgroups and projects. To manage workgroup participants, use the sonet_group.user.* method group: add and remove users, assign roles and permissions.

Tasks. Needed to distribute responsibilities among workgroup participants, track completion, and control deadlines. Create and update tasks using the tasks.task.* method group.

Drive. A storage linked to a specific group or project containing materials needed for work. To manage storages, use the disk.storage.* method group.

Universal Lists. Structured lists of items within workgroups. Needed to create registries or data storages, sort and filter information, and automate accounting. Create, update, and delete universal lists using the lists.lists.* method group.

News Feed. Publish messages for group participants using the log.blogpost.add method.

How to Get StartedHow to Get Started

1. Create a group or project using the sonet_group.create method.
2. Retrieve the group identifier using the socialnetwork.api.workgroup.list or sonet_group.get method.
3. Add participants using the sonet_group.user.* methods.
4. Connect related tools: tasks, Drive, universal lists, or News Feed messages.
5. To track group creation, update, and deletion, subscribe to events.

Widgets for Workgroups and ProjectsWidgets for Workgroups and Projects

Add your items to menus to enhance the functionality of workgroups and projects:

• Workgroup menu item SONET_GROUP_DETAIL_TAB

• Workgroup extensions menu item SONET_GROUP_TOOLBAR

• Button in the workgroup automation rules designer SONET_GROUP_ROBOT_DESIGNER_TOOLBAR

Specify the widget embedding code in the PLACEMENT parameter of the method placement.bind. How to choose a placement and what the handler receives is described in the overview of placements.

Specialized Workgroups: Scrum and FlowSpecialized Workgroups: Scrum and Flow

Scrum in Bitrix24. A tool for organizing team collaboration using the Scrum methodology. It allows breaking projects into sprints — short iterations during which the team completes a specific volume of tasks.

Flow in Bitrix24. A tool for organizing team collaboration. It allows gathering tasks in one place and quickly distributing them among performers.

Scrum and Flow are implemented based on workgroups.

To create a Scrum, use the method creating a new group. To make a group a Scrum, fill in the SCRUM_MASTER_ID field.

To link a Flow to a group, use the identifier groupId. To obtain the identifier, use the method creating a new group or the method getting a list of groups.

Overview of Methods and EventsOverview of Methods and Events

Scope: sonet

Who can execute the methods: any user