Planfix API project.add / Create a project: Difference between revisions

From Planfix
Jump to: navigation, search
No edit summary
No edit summary
Line 84: Line 84:
|endDate ||DateTime || ||only used if hasEndDate parameter is true
|endDate ||DateTime || ||only used if hasEndDate parameter is true
|-
|-
|group || || ||project group identifier
|group || || ||not required
|-
|-
|group.id || int || not required ||  
|group.id || int || project group identifier||  
|-
|-
|parent|| || ||parent project identifier
|parent|| || || not required
|-
|-
|parent.id || int || project auditors ||  
|parent.id || int || parent project identifier ||  
|-
|-
|auditors || || project managers ||not required
|auditors || || project auditors ||not required
|-
|-
|auditors.id || int || project manager identifier ||  
|auditors.id || int || project auditor identifier ||  
|-
|-
|managers || || project default assignees ||not required
|managers || || project managers ||not required
|-
|-
|managers.id || int || default project assignee identifier ||  
|managers.id || int || project manager identifier ||  
|-
|-
|workers || || project custom field values ||
|assignees || || project default assignees ||
|-
|-
|workers.id || int || project custom field identifier ||  
|assignees.id || int || default project assignee identifier ||  
|-
|-
|customData|| ||project custom field value||
|customData|| ||project custom field values||
|-
|-
|customData.customValue.id|| ||идентификатор пользовательского поля проекта||
|customData.customValue.id|| ||project custom field identifier||
|-
|-
|customData.customValue.value|| ||project custom field value|| (for task set, employee list, and directory entry set field types, separate identifiers with commas in square brackets)
|customData.customValue.value|| ||project custom field value|| (for task set, employee list, and directory entry set field types, separate identifiers with commas in square brackets)

Revision as of 09:39, 1 July 2022

Requests to create projects look as follows:

<?xml version="1.0" encoding="UTF-8"?>
<request method="project.add">
  <account></account>
  <sid></sid>
  <project>
    <title></title>
    <description></description>
    <owner>
      <id></id>
    </owner>
    <client>
      <id></id>
    </client>
    <status></status>
    <hidden></hidden>
    <hasEndDate></hasEndDate>
    <endDate></endDate>
    <group>
      <id></id>
    </group>
    <parent>
      <id></id>
    </parent>
    <auditors>
      <id></id>
      <id></id>
      <!-- ... -->
    </auditors>
    <managers>
      <id></id>
      <id></id>
      <!-- ... -->
    </managers>
    <workers>
      <id></id>
      <id></id>
      <!-- ... -->
    </workers>
    <customData>
      <customValue>
        <id></id>
        <value></value>
      </customValue>
      <!-- ... -->
    </customData>
  </project>
  <signature></signature>
</request>

If you don't pass a creator or set id=0, the user of the current session will be used as the creator. Counterparty is not a required parameter. Regular users (not contacts) are able to call this function.

Name Type Value Notes
sid string(32) session key created as a result of passing authentication Authentication
title string Project name
description string Description of the project set by the user
owner This field is not required. In this case, the creator will be the user who is making the request (determined by sid)
owner.id int dentifier of the user who will be the project creator. value 0 (zero) allowed. In this case, the creator will be the user who is making the request (determined by sid)
client not required
client.id int counterparty identifier value 0 (zero) allowed.
status enum status of the project being created for a list of valid values for this field, see the project statuses section статусы проектов
hidden bool hidden
hasEndDate bool whether or not there is an end date
endDate DateTime only used if hasEndDate parameter is true
group not required
group.id int project group identifier
parent not required
parent.id int parent project identifier
auditors project auditors not required
auditors.id int project auditor identifier
managers project managers not required
managers.id int project manager identifier
assignees project default assignees
assignees.id int default project assignee identifier
customData project custom field values
customData.customValue.id project custom field identifier
customData.customValue.value project custom field value (for task set, employee list, and directory entry set field types, separate identifiers with commas in square brackets)