Why use this feature?

Often it is useful to share a codeframe between coding projects in codeit. Perhaps you want to re-use a codeframe rather than create one from scratch or maybe you want to share codeit's Machine Learning from one project to another.
There are a number of ways to do this, which are covered elsewhere in this help guide.


This page details the steps you need to follow in the specific case where you are sharing a codeframe with a project that is linked to an Askia survey.   


What's different about Askia surveys?

When you use the "Link Data" feature in codeit to link to an Askia survey, codeit requires that the target question you're coding into is already created in Askia. This usually involves creating a closed-end question containing a single "dummy" response. This dummy response is removed by the coder and new codes are added during the coding process.
When we want to share a codeframe the process is very similar, but requires that we "share existing items" rather than building up a new codeframe from scratch. The following steps explain how to do this. 


Prerequisites

The steps below assume you have the following in place before starting: 

  1. A source project containing a codeframe you want to share. The source project can be linked to an Askia survey, or it can be a standalone project.
  2. A new project, linked to an Askia survey, into which you want to share the codeframe from the source project


How to share codeframes in an Askia data link project

  1. Use "Block Coding" to open the coding task that you want to share a the codeframe with.
    You should see the codeframe as it is defined currently in Askia, usually containing a single "dummy" response:


  2.  Delete the dummy response, or any responses that the codeframe contains.
    Tip: If you have a large number of items in your codeframe, you can use "Edit Mode" to bulk delete items.

  3. Once the codeframe is empty, click the "Add Existing" button.

  4. From the "Add Existing Items" dialog, search for the source project you want to share from.
    Locate the codeframe you want to share and click the "Share" link

  5. Click "Confirm" on the "Share Codeframe" dialog that appears.

After these steps are complete, the two projects will share the same codeframe.
Changes to the codeframe in either project will therefore appear in the other project.
Changes to the codeframe will also be synchronised back to the respective Askia survey when the "Data Sync" button is clicked for a project in Codeit.


A note on library codeframes

If you have a codeframe that you regularly share between projects, you may want to consider adding the codeframe to your companies "Codeframe Library" this is a cleaner way to make sure that codeframes are marked out for reuse and are easily discoverable by your users.