{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"ca461b31-292d-41c4-bd25-9e712a5a3088"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"bfcc02ad-8dc2-4d99-a925-0bb8b5d15e07"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"Manifests are PDF files that can be downloaded or printed after specimen collection, distribution, or shipment. It gives detailed information about the specimens and processing activities performed on them. The manifests can be configured based on protocol/distribution/project needs either at each individual level or system level. ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Types of Manifest","type":"text"}]},{"type":"paragraph","content":[{"text":"The three types of manifest supported in OpenSpecimen are:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Specimen Collection Manifest","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Order or Distribution Manifest","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Request Manifest","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Specimen Collection Manifest","type":"text"}]},{"type":"paragraph","content":[{"text":"Since the processing techniques vary, generating protocol-specific manifests should be possible. It can contain any data related to specimen, visit, or participant - including custom fields.","type":"text"}]},{"type":"paragraph","content":[{"text":"A clinic coordinator who has reading access to the visit can download a “Specimen Collection Manifest” from the participant’s visit page. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Default Specimen Manifest PDF","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":40.0},"content":[{"type":"media","attrs":{"width":742,"id":"a17d9b57-b51c-4cac-bd65-99afb6b2e02b","collection":"contentId-1978171447","type":"file","height":695}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Distribution or Order Manifest","type":"text"}]},{"type":"paragraph","content":[{"text":"It is possible to configure the distribution manifests either at the distribution or system level. The order manifest can be downloaded from the Order overview page. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Request Manifest","type":"text"}]},{"type":"paragraph","content":[{"text":"Similarly, it is possible to configure the request manifest either at the project or system level. The request manifest can be downloaded from the request overview page.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Before you start working on the manifest, Please make sure that HTML file format is accepted by OpenSpecimen for import. If this is not true, you will receive an error while uploading the manifest template as shown below:","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":80.0},"content":[{"type":"media","attrs":{"width":1675,"id":"564f51e3-ad18-41b5-8117-cb279e47937b","collection":"contentId-1978171447","type":"file","height":315}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Steps to add the HTML file format","type":"text"}]},{"type":"expand","attrs":{"title":"Steps to add the HTML file format to the 'Allowed File Type’ list"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to Homepage → Setting → Search '‘Allowed File Type.’","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on property ‘Allowed File Types' → Add '","type":"text"},{"text":"html’","type":"text","marks":[{"type":"strong"}]},{"text":" in the list separated by a comma → Update","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1381,"id":"c4ead576-0540-4820-bf11-f78d56c611fb","collection":"contentId-1978171447","type":"file","height":521}}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1840,"id":"3e69d7cc-114c-4f3e-9c8a-e19124f5b994","collection":"contentId-1978171447","type":"file","height":383}}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Manifest HTML Templates","type":"text"}]},{"type":"paragraph","content":[{"text":"Manifest HTML Templates are customizable HTML files that are uploaded into the OpenSpecimen at the system or protocol/distribution/project level to generate a custom Manifest PDF. Based on your requirement you can add or remove fields, modify the specimen table, generate barcode/QR code, style and add texts, etc","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Export Manifest Template","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also export the manifest template from the system setting as well as individual protocol/distribution/project level.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Steps to export the default Manifest template","type":"text"}]},{"type":"expand","attrs":{"title":"Export default manifest template"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After OpenSpecimen v8.2, you can directly export the default template for each manifest type from the system's setting.","type":"text"}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to Homepage → Setting → Search 'Manifest.’","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the link to download the manifest template of your choice.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1666,"id":"6e0e3f63-a709-4957-94df-1537f51b27a7","collection":"contentId-1978171447","type":"file","height":436}}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Before v8.2, the default manifest templates were shipped with the application and were not available for export from the system’s setting. For such cases, you can download and use the below default templates as per your need.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Default Specimen Collection manifest","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"a4999aca-84b2-4a15-9bf5-0ff0458a6740","collection":"contentId-1978171447","type":"file"}}]},{"type":"paragraph","content":[{"text":"Distribution or Oder manifest","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"8c548788-9c8c-4df3-8802-6c24f42f4cf4","collection":"contentId-1978171447","type":"file"}}]},{"type":"paragraph","content":[{"text":"Request manifest","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"44125bc4-8b07-4236-9f33-bf483d715183","collection":"contentId-1978171447","type":"file"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Steps to export protocol/distribution/project specific template","type":"text"}]},{"type":"expand","attrs":{"title":"Export manifest template at protocol/distribution/request level"},"content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"When no manifest is configured at any of the above levels you will get the following error message while downloading the template:","type":"text"}]},{"type":"paragraph","content":[{"text":"[{\"code\":\"MANIFEST_NOT_FOUND\",\"message\":\"Manifest template is not configured.\"}]","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph","content":[{"text":"Export specimen manifest template at the protocol level","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Collection Protocol → Choose the CP of your choice → View CP Details","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the CP overview page, click on the “More” → Export Specimens Manifest.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"CP Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":1605,"id":"310ef8a0-2709-47c0-bb64-9ccc64bc06b8","collection":"contentId-1978171447","type":"file","height":669}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Export order manifest template at the distribution level","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Distribution→ Choose the DP of your choice ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the DP overview page, click on the “Manifest” → Download Template.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"DP Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1856,"id":"a7757c54-6d52-4cc3-9d90-23a7b8c8a73f","collection":"contentId-1978171447","type":"file","height":555}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Export request manifest template at the project level","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Project → Choose the Project of your choice ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the Project overview page, click on the “Manifest Template” → Export.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Project Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1842,"id":"435dde75-04da-4873-b0c9-df4f500c5df9","collection":"contentId-1978171447","type":"file","height":419}}]},{"type":"paragraph"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Import Manifest Template","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also import the manifest template at the system setting as well as individual protocol/distribution/project level. At the system level, the template will be applicable across all the protocols/distributions/projects available in OpenSpecimen whereas at the protocol/distribution/project level it will be specific to them. The manifest template at the individual level overwrites the system level configuration.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Steps to import Manifest Template at system","type":"text"}]},{"type":"expand","attrs":{"title":"Import manifest template at system level"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to Homepage → Setting → Search 'Manifest.’","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the link to any property of your choice (for example ","type":"text"},{"text":"Specimens Collection Manifest.","type":"text","marks":[{"type":"strong"}]},{"text":") → Choose the file from your desktop → Update","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1477,"id":"97f3c39b-fa81-4334-afe3-ba66056ae11d","collection":"contentId-1978171447","type":"file","height":430}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Steps to import protocol/distribution/project specific template","type":"text"}]},{"type":"expand","attrs":{"title":"Import manifest template at protocol/distribution/request level"},"content":[{"type":"paragraph","content":[{"text":"Import Specimen Manifest Template at the protocol level","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Collection Protocol → Choose the CP of your choice → View CP Details","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the CP overview page, click on the “More” → Import Specimens Manifest → Choose the file from your desktop → Import","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"CP Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1581,"id":"fba87c6a-d39b-4caa-9788-fd785b50e6c3","collection":"contentId-1978171447","type":"file","height":658}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Import order manifest at the distribution level","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Distribution→ Choose the DP of your choice ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the DP overview page, click on the “Manifest” → Import Template → Choose the file from your desktop → Upload","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"DP Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1834,"id":"4b41af88-a310-4fab-9506-3e58e233f805","collection":"contentId-1978171447","type":"file","height":570}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Import request manifest at the project level","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Project → Choose the Project of your choice ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the Project overview page, click on the “Manifest Template” → Import → Choose the file from your desktop → Import","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Project Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1454,"id":"afd0fbbf-68e8-4fee-a62f-750445eaf4d1","collection":"contentId-1978171447","type":"file","height":309}}]},{"type":"paragraph"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Downloading Manifest PDF","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Steps to download manifest pdf for a visit/order/request","type":"text"}]},{"type":"expand","attrs":{"title":"Download manifest pdf from a visit/order/request"},"content":[{"type":"paragraph","content":[{"text":"Download specimen collection Manifest PDF for a visit","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Collection Protocol → Choose the Participant of your choice → Choose the visit (occured) of your choice.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the Visit overview page, click on 'Specimens Manifest'.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Visit Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":952,"id":"81402627-45d1-4686-ba83-e90e5a91f192","collection":"contentId-1978171447","type":"file","height":560}}]},{"type":"paragraph","content":[{"text":"Default specimen collection manifest PDF","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":742,"id":"a17d9b57-b51c-4cac-bd65-99afb6b2e02b","collection":"contentId-1978171447","type":"file","height":695}}]},{"type":"paragraph","content":[{"text":"Download order manifest PDF","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Orders → Choose the order of your choice.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the Order overview page, click on 'Manifest'.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Order Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1464,"id":"c28dec5c-6cc2-4e7b-88b5-11bcc2657090","collection":"contentId-1978171447","type":"file","height":344}}]},{"type":"paragraph","content":[{"text":"Default order manifest PDF","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":618,"id":"b3c007e9-b7c9-456f-a9aa-5f8a46fa2b51","collection":"contentId-1978171447","type":"file","height":542}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Download request manifest PDF","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Project → View Requests → Choose the request of your choice","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the Request overview page, click on 'Manifest'","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Request Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1482,"id":"a6279ce9-a7f5-401e-aee6-813572b02def","collection":"contentId-1978171447","type":"file","height":362}}]},{"type":"paragraph","content":[{"text":"Default request manifest PDF","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":606,"id":"ebe748a9-1273-40a8-a696-c7c91a8d6f63","collection":"contentId-1978171447","type":"file","height":694}}]},{"type":"paragraph"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Customizing Manifest Template","type":"text"}]},{"type":"paragraph","content":[{"text":"Based on your requirement you can add or remove fields, modify the specimen table, generate barcode/QR code, style and add texts, etc","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Before configuring the manifest, it is good to have a backup file of the working manifest template. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The system-level template will be used when no template is configured at the CP level.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Add default fields on the specimen table","type":"text"}]},{"type":"expand","attrs":{"title":"Steps to configure the manifest template"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the default manifest template file of your choice (for example visit.html) from the system setting as shown above.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the template in the editor of choice.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the specimen table, add additional fields of your choice (for example “Lineage”) as shown below in the script, and save it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Follow the above steps to import the manifest template either at the system or individual level and download the manifest PDF for the same.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Script to add specimen lineage field on the specimen table","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"....\n....\n

Specimens

\n\n \n \n \n \n \n \n \n \n \n \n \n \n\n \n #foreach ($spmn in $allSpecimens)\n \n \n \n \n \n \n \n \n \n #end\n \n

Label	Parent	Type	Lineage	Quantity	Processing Date	Location
\n #if ($spmn.label)\n $spmn.label\n #end\n	\n #if ($spmn.parentLabel)\n $spmn.parentLabel\n #end\n	$spmn.type	\n #if ($spmn.lineage)\n $spmn.lineage\n #end\n	\n #if ($spmn.status == 'Collected')\n #if ($spmn.availableQty)\n $spmn.availableQty\n $spmn.getQuantityUnit()\n #end\n #elseif ($spmn.status == 'Pending' \|\| !$spmn.status)\n #if ($spmn.initialQty)\n $spmn.initialQty\n $spmn.getQuantityUnit()\n #end\n #end\n	\n #if ($spmn.lineage == 'New' and $spmn.collectionEvent.time)\n $dateFmt.format($spmn.collectionEvent.time)\n #elseif ($spmn.createdOn)\n $dateFmt.format($spmn.createdOn)\n #end\n	\n #if ($spmn.storageLocation.name)\n $spmn.storageLocation.name\n #if ($spmn.storageLocation.mode == 'TWO_D')\n ($spmn.storageLocation.positionY, $spmn.storageLocation.positionX)\n #elseif ($spmn.storageLocation.mode == 'LINEAR')\n ($spmn.storageLocation.position)\n #end\n #end\n

Specimens

\n\n \n \n \n \n \n \n \n \n \n \n \n \n\n \n #foreach ($spmn in $allSpecimens)\n \n \n \n \n \n \n \n \n \n #end\n \n

Label	Parent	Type	Use Spcimen for Research	Quantity	Processing Date	Location
\n #if ($spmn.label)\n $spmn.label\n #end\n	\n #if ($spmn.parentLabel)\n $spmn.parentLabel\n #end\n	$spmn.type	\n #if ($spmn.extensionDetail.attrsMap.use_specimen_for_research)\n $spmn.extensionDetail.attrsMap.use_specimen_for_research\n #end\n	\n #if ($spmn.status == 'Collected')\n #if ($spmn.availableQty)\n $spmn.availableQty\n $spmn.getQuantityUnit()\n #end\n #elseif ($spmn.status == 'Pending' \|\| !$spmn.status)\n #if ($spmn.initialQty)\n $spmn.initialQty\n $spmn.getQuantityUnit()\n #end\n #end\n	\n #if ($spmn.lineage == 'New' and $spmn.collectionEvent.time)\n $dateFmt.format($spmn.collectionEvent.time)\n #elseif ($spmn.createdOn)\n $dateFmt.format($spmn.createdOn)\n #end\n	\n #if ($spmn.storageLocation.name)\n $spmn.storageLocation.name\n #if ($spmn.storageLocation.mode == 'TWO_D')\n ($spmn.storageLocation.positionY, $spmn.storageLocation.positionX)\n #elseif ($spmn.storageLocation.mode == 'LINEAR')\n ($spmn.storageLocation.position)\n #end\n #end\n

\n....\n....","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Manifest PDF View","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":620,"id":"ac824c8f-aee3-49c8-802c-dfdf616b2276","collection":"contentId-1978171447","type":"file","height":726}}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"827fe8ce-466b-4f63-8f13-a16538e71a28","collection":"contentId-1978171447","type":"file"}},{"type":"media","attrs":{"id":"3464de77-9310-48b7-b4bd-0a99e499e208","collection":"contentId-1978171447","type":"file"}}]},{"type":"paragraph"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Delete Manifest Template","type":"text"}]},{"type":"paragraph","content":[{"text":"You can only delete the protocol/distribution/project specific template from their respective level. You cannot delete the default manifest template attached to the system’s setting.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Steps to delete protocol/distribution/project specific template","type":"text"}]},{"type":"expand","attrs":{"title":"Delete manifest template at protocol/distribution/request level"},"content":[{"type":"paragraph","content":[{"text":"Delete Specimen Manifest Template at the protocol level","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Collection Protocol → Choose the CP of your choice → View CP Details","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the CP overview page, click on the “More” → Delete Specimens Manifest","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"CP Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1656,"id":"560fb4a5-9a23-4a16-931b-ea9f001e1b75","collection":"contentId-1978171447","type":"file","height":636}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Delete order manifest at the distribution level","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Distribution→ Choose the DP of your choice ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the DP overview page, click on the “Manifest” → Delete Template","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"DP Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1847,"id":"dc4bf635-8a0d-41b5-8d2f-41ed3580abcb","collection":"contentId-1978171447","type":"file","height":595}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Delete request manifest at the project level","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Homepage → Project → Choose the Project of your choice ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the Project overview page, click on the “Manifest Template” → Delete","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Project Overview Page","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1840,"id":"731c952f-c8a3-4c61-9b21-436147cfb1b4","collection":"contentId-1978171447","type":"file","height":385}}]},{"type":"paragraph"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Supported Fields","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Specimen manifest","type":"text"}]},{"type":"paragraph","content":[{"text":"Specimen Manifest Supported Fields","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.google.com/spreadsheets/d/1yzEDCO4uwpSHOO1lcPpouNQH-SmaL_hPsV0QZVuEaMs/edit?usp=sharing"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Order manifest","type":"text"}]},{"type":"paragraph","content":[{"text":"Order Manifest Supported Fields","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.google.com/spreadsheets/d/1ErDzIN62RH7ZdaloIRQd28ZGxu-SblSRsrcVp5L0fE4/edit?usp=sharing"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"FAQ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1. Would it be possible to escape all special characters within a text at once? ","type":"text"}]},{"type":"paragraph","content":[{"text":"Ans: From OpenSpecimen v10.x, special characters are skilled automatically in default manifest templates. However, for earlier versions, you can use CDATA.to avoid the overhead of escaping each special character","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"expand","attrs":{"title":"Example Code"},"content":[{"type":"codeBlock","content":[{"text":"

Processing Notes:

,<,>=,<=]]>

","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2. Does the Order manifest support specimen custom or participant registration fields?","type":"text"}]},{"type":"paragraph","content":[{"text":"No. Order manifest doesn’t support specimen custom or participant registration fields such as (External Suj ID).","type":"text"}]},{"type":"paragraph","content":[{"text":"We suggest using the order report option where the user attaches a custom query with required fields to your Distribution protocol and generates a report for orders under it. ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openspecimen.atlassian.net/wiki/spaces/CAT/pages/1492680746/Additional+Distribution+Features#Report"}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3. Would it be possible to page break or start a new page? ","type":"text"}]},{"type":"paragraph","content":[{"text":"Ans: Yes. Please add the following HTML wherever you want a page break or a new page should be started.","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"

","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"expand","attrs":{"title":"Complete Code"},"content":[{"type":"codeBlock","content":[{"text":"#foreach ($spmn in $allSpecimens)\n

\n #if ($visit.extensionDetail.attrsMap.service_request && $spmn.lineage == 'New' && $spmn.collectionEvent.time && ($spmn.label.startsWith(\"P1\") || $spmn.label.startsWith(\"P6\")))\n \n First Name\n : \n \n \n Last Name\n : \n \n \n MRN\n : \n \n \n Date of Birth\n : $dateOnlyFmt.format($cpr.participant.birthDate)\n \n \n Participant ID\n : \n \n \n PI Name\n : \n \n \n PI Email\n : \n \n #foreach ($request in $visit.extensionDetail.attrsMap.service_request)\n #if (($spmn.label.startsWith(\"P1\") && $request.service_requested == 'DNA Extraction') || ($spmn.label.startsWith(\"P6\") && $request.service_requested == 'PBMC Processing'))\n \n Service Requested\n : \n \n \n Number of tubes\n : \n \n \n Volume in each tube\n : \n \n \n Collection Date\n : \n \n #if ($request.comments)\n \n Comments\n : \n \n #end\n #end\n #end\t\n \n ----------------------------------------------------------------------------------\n ----------------------------------------- \n \t\t\t\t\n #end\n #end","type":"text"}]}]},{"type":"paragraph"},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"3d724a86-59b9-45ef-a674-aef03eb972d6","collection":"contentId-1978171447","type":"file"}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"4. Is it possible to sort the specimen table in order manifest based on the ascending order of PPID? ","type":"text"}]},{"type":"paragraph","content":[{"text":"Ans: Yes. You need to implement the sorting function directly within the HTML template as shown below (before the start of tag).","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"#set($numItems = $items.size())\n#set($range = $numItems - 1)\n#foreach ($i in [0..$range])\n #set($subRange = $range - $i - 1)\n #if ($subRange >= 0)\n #foreach ($j in [0..$subRange])\n #if ($items.get($j).specimen.ppid.compareTo($items.get($j + 1).specimen.ppid) > 0)\n #set ($temp = $items[$j])\n #set ($items[$j] = $items[$j + 1])\n #set ($items[$j + 1] = $temp)\n #end\n #end\n #end\n#end","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"5. Is it possible to sort the specimen table in order manifest based on the descending order of PPID? ","type":"text"}]},{"type":"paragraph","content":[{"text":"Ans: Yes. You need to implement the sorting function directly within the HTML template as shown below (before the start of tag).","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"#set($numItems = $items.size())\n#set($range = $numItems - 1)\n#foreach ($i in [0..$range])\n #set($subRange = $range - $i - 1)\n #if ($subRange >= 0)\n #foreach ($j in [0..$subRange])\n #if ($items.get($j).specimen.ppid.compareTo($items.get($j + 1).specimen.ppid) < 0)\n #set ($temp = $items[$j])\n #set ($items[$j] = $items[$j + 1])\n #set ($items[$j + 1] = $temp)\n #end\n #end\n #end\n#end","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"6. Is it possible to add a calculated date field in a manifest? ","type":"text"}]},{"type":"paragraph","content":[{"text":"Ans: Yes, you can add a calculated date field based on other date fields. For example, adding a 'Process By' field as ","type":"text"},{"text":"Collection Date + 5 Days (432000000 miliseconds).","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"There are three methods to achieve this. Expand for syntax.","type":"text"}]},{"type":"expand","attrs":{"title":"Syntax to add calculated date field "},"content":[{"type":"paragraph","content":[{"text":"Syntax 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"coffeescript"},"content":[{"text":"\n #if ($item.specimen.collectionDate)\n #set ($collDate = $item.specimen.collectionDate)\n #set ($processBy = $collDate.getTime() + 432000000)\n #set ($calendar = $dateFmt.getCalendar().class.getInstance())\n #set ($ignore = $calendar.setTimeInMillis($processBy))\n $dateFmt.format($calendar.getTime())\n #end\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"coffeescript"},"content":[{"text":"\n #if ($item.specimen.collectionDate)\n #set ($collDate = $item.specimen.collectionDate)\n #set ($processBy = $collDate.getTime() + 432000000)\n $dateFmt.format($collDate.class.from($collDate.toInstant().class.ofEpochMilli($processBy))) \n #end\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax 3:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"coffeescript"},"content":[{"text":"\n #if ($item.specimen.collectionDate)\n #set ($collDate = $item.specimen.collectionDate)\n $dateFmt.format($collDate.class.from($collDate.toInstant().plusMillis(432000000))) \n #end\n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Example PDF","type":"text"}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"dc627f11-340a-4309-b507-2c9b41eef7cb","collection":"contentId-1978171447","type":"file"}}]},{"type":"paragraph","content":[{"text":"Example Template","type":"text"}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"52db727f-9661-44f0-8927-a6885910cce8","collection":"contentId-1978171447","type":"file"}}]}]},{"type":"paragraph"},{"type":"paragraph"}],"version":1}