Projects

Projects

A Project on the City Innovate platform offers a wide range of options for managing your document lifecycle, from a simple Document Builder stage to complex multi-stage builds. You will have the option of simply having a Document Builder stage, adding publication stages, evaluation stages, etc. The world is your oyster!

The quick video below will provide you insight on where to start creating your Project, and the overview thereafter will assist you in understanding more specific management options for your projects from creation to completion. Let's jump right in!



Creating a New Project

Steps for creating a new Project:
  1. Click "Add New Project"
  2. Select an appropriate workflow
  3. Designating an owner for the project (if not yourself)
  4. Input inclusion criteria (category, type, etc)
  5. Add collaborators as needed
  6. Click "Create Solicitation"
Project Creation

You will then be brought to the Project page of the newly created project. You can always find your project in the Project panel of the Projects page, shown below



Project Details Options

Selecting Attributes and Adding Collaborators

To create a new Project from scratch, go to the Projects page and click "Add New Project".  The system will then prompt you to give the Project a name and make selections for various attributes such as type, purchase class, etc. To learn more about document categories/types, refer to this article




Available attributes are dependent on how your organization has configured its categories and types. 

In the configuration screen for your new project, you will notice that you have automatically been assigned the role of Owner by default.  You can then invite Collaborators as Editors / Contributors / Reviewers / Viewers in the lower portion of the page




You will need to enter the names of any collaborators you want to invite. The name of the user should appear as you begin to type in each field. If you want to invite someone not currently in the system, click the 'Invite a New User' link. Enter the individual’s name and email in the pop-up window then click 'Create Invitation'.  The system will send an invitation email and automatically grant the new user the necessary permissions for the solicitation. When finished, click 'Create Solicitation'.

Completing the Questionnaire

Depending on the combination of attributes selected, you will be presented with a series of additional questions to help Solicitation Builder assemble the correct document templates and pre-populate them with key information. 


While some questions require an answer to continue, others will let you skip to the next question, or assign the question to another user.  To answer a question later, select “Skip for Now” or “Don’t Know?” to assign the question to another team member within your project. 


Editing Documents and Settings

Once you are done with the questionnaire, Solicitation Builder will create the project with an initial set of documents, which you will need to edit to reflect the specifics of your solicitation.  You might also need to answer additional questions to populate all of the documents with information.  To see a list of documents associated with a solicitation, select the solicitation from the Solicitations page then navigate to the Documents panel. 

Project Headers/Footers

Headers and Footers can help your reader navigate your documents. Headers and footers can contain information such as the project number, release date, name of the purchasing agency, page numbers, and anything else that might be helpful to readers.

Rules
Formatting Rules:
  1. The Header/Footer area fits 3 lines of text by default. If more than 3 lines of text are added to a header/footer, space will be allocated from the document’s body to accommodate the header text.
  2. Users can choose 1, 2, or 3 columns for headers/footers. Writing in 12pt size font, 1 column fits 82 characters per line; 2 columns fit 41 characters per line; and 3 columns fit 20 characters per line.
  3. You can choose font sizes size 6pt to size 36pt font.
  4. Header/Footer does not print on table of contents pages.
  5. After documents are exported to PDF, the variables $page_number and $total_pages are replaced with page numbers.

1. Create/Edit header/footer

  1. Open Project
  2. Go to the Header and Footer substage in the left hand menu
    1. Click Add New Header & Footer or Edit existing
    2. If New, name your Header & Footer
    3. Write and format
      1. Select how many columns you wish to use
      2. Input text or image contents into the available fields
    4. Click "Create Header & Footer " or "Save" if editing existing record
  3. Go to Documents in the left hand menu
    1. Find the 1st document you want to apply the header to, click Edit on its corresponding row to open Document Settings
    2. Select your Header & Footer Template and save
    3. Repeat for all documents in your list





2. Complete a missing question response


If you see text in your headers {{Missing Question Response}}, that means a question is awaiting your response. Go to your project's Questions, answer the corresponding question, then save. Your response will automatically apply to your document headers/footers.

See video demonstration:


Action Center

After you have created a new project, the action center on your solicitation details page will be in heavy use.   The   Action Center  is a list of clickable links and buttons. Let's discuss their functions below:

After you have created a new project, the action center on your details page will provide numerous options to Project Owners and Editors. The Action Center is a list of clickable links and buttons. Let's discuss their functions below:

  1. Export Solicitation PDF - Allows you to export the entirety, or portions, of your project to PDF; along with allowing you to change the Status of your record, if it has advanced beyond "in progress".
  2. Export Solicitation DOCS - Allows you to export the entirety, or portions, of your project to DOCX; along with allowing you to change the Status of your record, if it has advanced beyond "in progress".
  3. Edit Solicitation Details - Allows you to modify the title, category, type, and collaborators for your project
  4. Track changes for everyone - Applies Track Changes globally for the entire project, ensuring that all users have their additions and subtractions requiring approval from Project Owners or Editors.
  5. Accept all changes - Will accept all changes made outside of edits to sections.
  6. Resolve all comments - Will check off all comments in the project, effectively removing them from view and further engagement within the project.
  7. Save Current Version - Saves the current build of every section of your Project at that point in time, ensuring there is a snapshot of the current state; this is especially useful prior to a heavy session of accepting/rejecting tracked changes.
  8. Run Accessibility Check - will run ADA checks against the entirety of your project and supply feedback and recommended actions for resolving the accessibility issues encountered in your document's formatting.
  9. Create summary of changes - generates a document that harbors a link to compile all unaccepted tracked changes. This is especially useful to generate after rejecting tracked changes throughout your document, but prior to accepting tracked changes in full; as once changes are accepted they will not populate in the summary of changes document.
  10. Change Solicitation Status - Adjusts the status of your project to reflect advances from In Progress to: Under Review, Published, Addendum, Contracting, Completed, and Archived.

Project Stages

Administrators are the only users that can configure Workflows with Project Stages, which define the lifecycle of a Project.  When you create a new Project, you will have the option of selecting a workflow that best reflects your needs for the Project. Although an Admin will be responsible for creating workflows, some users will be able to choose an appropriate workflow when creating a new project. Types of Projects Stages include, but are not limited to:

  • Solicitation Builder
  • Publication
  • Evaluation
  • Application Builder
  • Project Oversight

Staff users can, however, manage Project Stages if needed in a Project that has already been created. We'll see how that is handled below in a section titled "How to Edit Project Stages".

Solicitation Builder Stage

From the left-hand navigation panel, you can quickly navigate to different parts of your Project. Most Projects in Document Builder will start with a Solicitation Builder initial stage:



The Action Center, on the right, is a list of clickable links and buttons where you can perform these ten actions (detailed in the above 'Action Center' section):
  1. Export Solicitation PDF 
  2. Export Solicitation DOCX
  3. Edit Solicitation Details
  4. Track changes for everyone
  5. Accept all changes
  6. Resolve all comments
  7. Save Current Version
  8. Run Accessibility Check
  9. Create summary of changes
  10. Change Solicitation Status
You'll also notice a list of team members with access to the solicitation and their designated roles as well as information pertaining to the solicitation like purchasing class, etc.

Guest Viewers, Reviewers, and Contributors will not have access to the Action Center. 

Publication Stage



The publication stage allows you to publicly publish the details of your project and begin accepting application submissions. When you publish the project, the system will generate a unique url for you to share with your respondents. If you started with the document builder stage, you will have the option of creating form fields within your documents for the respondents to respond to and later evaluate.

Administrators and Project Owners will receive an email each time there is a new submission to a project.

Evaluation Stage



This stage allows your team to collaboratively evaluate and score the submissions from the publication stage.
Users will receive an email each time they are assigned a new submission to evaluate.

Project Oversight Stage



This stage is used to build define milestones and collaborate directly with your respondents. How and if you use this stage will vary dependent on your needs.

Application Builder Stage


This stage is used for creating projects with the intent to publish and accept application submissions, typically for RFI or Market Research purposes; these projects do not hinge upon a Document Builder project stage and need to be configured freshly each time they are created.

How to edit project stages

Open the project and edit the project settings from the Project Stages panel.



From the Stage panel you can delete a stage, edit a stage, and add a new stage.



You can also rearrange stages by dragging and dropping them in the desired order.



Permissions for Project Stages

Team Administrators have the permissions to fully manage their teams when using Document Builder which include the various project stages. The first step is inviting the person to your organization as explained above. A user will not have a role within a project until they create or get invited to one. A user may have different roles for different projects. Let's go into detail below:

  1. Owners =  Can view, edit and delete all items within solicitation including archiving the solicitation itself.
  2. Editors = Can view, edit and delete all items within solicitation. Cannot archive solicitation.
  3. Guest Contributor = View-only permissions; Can edit sections only when a document's permissions are updated to allow GC's. Can request to unlock any documents or sections.
  4. Reviewer = Can comment and make tracked changes on all document sections in a solicitation.
  5. Guest Viewer = View-only permissions; cannot make comments, track changes, or author new content.

Project Roles are assigned when you create them within a new solicitation. After a solicitation is created, roles can be changed by Administrators, Owners and Editors by selecting  'Edit Solicitation Details' in the action center.



Here's a video on how to granularly control permissions for other project stages beyond the Solicitation Builder stage (please note the video has no audio)



The list of people that populate as a contributor will only be those who have been invited to your organization. If you have not already, please invite new team members and have them set up an account. 

Procurement Staff have the permissions to fully manage their teams when using Document Builder which include the various project stages only for projects that they create. Team Administrators can designate procurement officers to the role of Owner to any project at any time.

Downloading Individual Documents

All users can download documents from Document Builder at any time.  To download a document:
  1. Open the project
  2. Open the document you want to download
  3. In the top right corner above the document, click 'Download Draft PDF'.
  4. The system will create a PDF and download it to your web browser's default location.


Exporting Entire Projects

Administrators, Owners / Editors can export projects. This feature allows users to:
  1. Create and download zip folders of documents
  2. Options to download all or specific documents
  3. Choose the purpose of your export: draft, published, addendum, or contracting


To export a Project:
  1. Open your Project
  2. In the Action Center, click 'Export Solicitation PDF'
  3. On the export page, fill in the desired details then click 'Create Export'
  4. You will be taken back to your project dashboard with a blue banner that hyperlinks to your Exports for the Project, where you will find all exported records numbered and dated. You can download a zip file or the master document file of your chosen export.
Please be advised that exporting a solicitation WILL NOT  jeopardize or corrupt the project.
You can delete exports in the Export panel, however this process is not reversible. 

Export Checklist

Here is a list of recommended steps to ensure your documents are complete with no or minimal errors.
  1. Check for document completeness-
    1. Export draft, or view sections in DB
    2. Read all documents and sections
    3. Identify and fix any formatting 
    4. Mark sections and documents as “complete” to guard them from further edits
  2. Check for ADA compliance
    1. Run ADA compliance check
    2. Fix any flagged issues if needed
  3. Complete tasks
    1. Mark off completed tasks
    2. Follow-up on any outstanding tasks
  4. Final quality assurance
    1. Export 2nd draft
    2. Review for completeness
  5. Export Final Version
  6. Complete!

Project and Solicitation Status Definitions

Project Status Definitions

Project status is a high-level overview of where your Project is in its lifecycle. Changing it will affect which tab your project appears in on the Project Dashboard: Active, Completed, or Archived.


In order to modify the Project Status, click on the Edit button on the far right of the Project's row (encircled in green in the above screenshot)

Once you have entered the Edit view for Project status, you will have 3 options to select from to adjust the Status of your project (detailed below)


  1. Active: Project is currently being worked on by your team, progressing through its paces/lifecycle and requiring regular access. All new projects are set to the status Active.
  2. Complete: Project has gone through its lifecycle, and is highly unlikely to be returned to for any additional work. This will move the project to the Completed Projects tab on the Projects page.
  3. Archived: Project has gone through it's lifecycle, and has been determined to no longer need additional work. This will move the project to Archived Projects tab and exclude the project from Analytics.

Video: How to change your project status


  1. Go to the projects page and find your project
  2. Click “Edit”
  3. Select a status from the drop down menu
  4. Click "Update Project" to save

Solicitation Status Definitions

Solicitation Status differs from Project Status, in that it is a detailed reflection of the specific phase your project is currently at. This allows you to more granularly depict which phase of an Active project you are currently working through.


For any projects that have a Solicitation Builder workflow, there are 7 statuses you can set your solicitation to: In Progress, Under Review, Published, Addendum, Contracting, Completed, and Archived. 

  • All new projects are set to the status In Progress.
  • When you reach a milestone after In Progress, you can set the status that represents the next phase you're starting.
  • After you sign a contract with a bidder or vendor, you can change the status to Completed

If you cancel or pause a project for any reason, you can change the status to Archived. This will exclude the project from Analytics. We highly recommend adjusting the Project Status to Archived should you adjust the Solicitation Status to this.
Video: How to change your solicitation status



  1. Open your Solicitation Builder Project, which lands you on the Solicitation Details page
  2. Select a status from the drop down menu encircled in the screenshot below
  3. Select the new status


Archiving Projects

You can manage solicitations that are no longer active by archiving them. Archiving a solicitation adds a project to the Archived Solicitations list and removes it from the solicitation details page. Admins /Owners have the permissions to archive and restore solicitations. Editors can archive the project it has access to and any documents within that project.

Project Archiving

To archive a Project:
  • Open the project
  • Change the status to Archived
  • Return to the Project Dashboard
  • From the "Active" tab, find the project and select Archive on the far right of the row it's located on

To access and restore archived projects:
  1. Go to the Projects page
  2. Click the Archived Projects Tab
  3. Here you will see a list of all solicitations that were archived.
  4. Click Edit alongside a project, and under Status select "Active"
  5. This will return the project to the Active tab on your projects page


    • Related Articles

    • Account Roles and Project Roles

      Accounts and Account Roles Accounts connect people to the platform. Each person who will be accessing the platform should have 1 account. Account Roles determine a person's access to pages of the platform, as well as permissions to carry out actions. ...
    • How to invite new users

      To invite new users to your organization, under the ‘Organization’ dropdown select ‘Organization Members’. On the Organization Members page, click ‘Invite a New Team Member’. Fill in the new team member’s details (the email field is mandatory to ...
    • Tasks

      City Innovate helps teams keep track of progress for projects through the use of tasks. Creating and assigning tasks can be help organizations manage the many teams and projects in an efficient and streamlined way. Below we will walk-through the ...
    • Importing and Exporting Documents and Projects

      Importing/Converting Word (DOCX) and other Files You can convert uploaded Word files (DOCX) to Document Builder templates or docs for your project(s), as well as import other files as attachments. There are 2 features available depending on the type ...
    • Release Notes

      Our platform is updated on a regular basis to add new features and improvements based on learnings and feedback from our users. This support article describes what's new for each product release, with the newest release notes listed at the top. The ...