https://wiki-ext.aps.anl.gov/icms/api.php?action=feedcontributions&feedformat=atom&user=Stellent 2026-07-19T06:52:19Z User contributions MediaWiki 1.36.1 https://wiki-ext.aps.anl.gov/icms/index.php?title=Document_Automation&diff=89 2011-06-24T15:10:48Z

<p>Stellent: </p> <hr /> <div>==Overview==<br /> <br /> Document Automation allows the user to insert ICMS metadata, such as Content ID, in a Microsoft Word or Excel document. This feature leverages the &quot;Document Properties&quot; feature in Microsoft Office. When the document is checked in, the specified properties are replaced with the actual ICMS values.<br /> <br /> ==Examples==<br /> <br /> * Including the Content ID as part of a report lets everyone know that the document is in ICMS, how to find it, and how to reference it in other documents.<br /> <br /> * Including the ICMS revision number and revision status of a procedure helps a technician know if her printed copy is current.<br /> <br /> ==Adding ICMS metadata to an Office document==<br /> <br /> # '''Access the document's custom properties.'''<br /> ## Office 2010 (Windows): Click File &gt; Info (in left bar). On &quot;Properties&quot; in right half of screen, click drop-down menu and select &quot;Advanced Properties.&quot; Click the &quot;Custom&quot; tab.<br /> ## Office 2007 (Windows): Click the Office button, then select Prepare &gt; Properties. The Properties pane will appear. In that pane, select Document Properties &gt; Advanced Properties &gt; Custom tab.<br /> ## Office 2008 (Mac) and Office 2003 (Windows): Go to File &gt; Properties &gt; Custom.<br /> # '''Enter the name of the ICMS field you want to add to your document.''' <br /> ## See Word and Excel instructions below for supported fields.<br /> ## You must use the exact field names as indicated.<br /> # '''Click OK to close the Document Properties window.'''<br /> # (Word Only) '''Add the ICMS field code to the document.''' <br /> ##Place your cursor at the point in the document you want the ICMS field code to appear.<br /> ##Browse the Document Properties list:<br /> ###Word 2010 (Windows): Click on Insert &gt; Quick Parts &gt; Field. Under &quot;Categories&quot;, select &quot;Document Information.&quot; Under &quot;Field Names&quot;, select &quot;DocProperty.&quot;<br /> ###Word 2007 (Windows): Click on Insert &gt; Quick Parts &gt; Field. Select DocProperty.<br /> ###Word 2008 (Mac) and Word 2003 (Windows): Click on Insert &gt; Field. The Field Panel is displayed. Click on the Document Properties.<br /> ##Select the field property to be placed in your document. A placeholder value is inserted in your document. This value will be replaced with the actual value at check in time.<br /> # '''Save the document and check it into ICMS.'''<br /> <br /> ==Word==<br /> <br /> You may use any of the following document properties to insert the relevant ICMS value into a Word document. You should fill in the ''Name'' and ''Value'' fields, as shown below for each property you wish to include.<br /> <br /> {| border=&quot;1&quot; <br /> ! Name<br /> ! Value<br /> |- <br /> |ICMSContentID<br /> |APS_XXXXXXX<br /> |-<br /> |ICMSRevision<br /> |Rev<br /> |-<br /> |ICMSRevisionStatus<br /> |Status<br /> |-<br /> |ICMSContributor<br /> |Contributor<br /> |-<br /> |ICMSComments<br /> |Comments<br /> |-<br /> |ICMSDocumentDate<br /> |Doc Date<br /> |}<br /> <br /> <br /> <br /> ==Excel==<br /> <br /> Content ID and Revision number are the supported properties that can be added to Excel documents:<br /> <br /> * ICMSContentIDLoc<br /> * ICMSRevisionLoc<br /> <br /> these can be set to a specific cell value (i.e. A2) or ''footer''. If you enter ''footer'', the value(s) will be placed in the printer margins at the bottom of the page.<br /> <br /> You must also indicate which sheet in your workbook will contain these values. To do so, add the following document property:<br /> <br /> * ICMSSheetLoc<br /> <br /> this must be an integer that equates to a specific sheet (i.e. 1). If you want it to print the values on all sheets, set it to -1. If the property is not specified, it will print on the first sheet only.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Document_Automation&diff=88 2011-06-24T15:10:13Z

<p>Stellent: </p> <hr /> <div>==Overview==<br /> <br /> Document Automation allows the user to insert ICMS metadata, such as Content ID, in a Microsoft Word or Excel document. This feature leverages the &quot;Document Properties&quot; feature in Microsoft Office. When the document is checked in, the specified properties are replaced with the actual ICMS values.<br /> <br /> ==Examples==<br /> <br /> * Including the Content ID as part of a report lets everyone know that the document is in ICMS, how to find it, and how to reference it in other documents.<br /> <br /> * Including the ICMS revision number and revision status of a procedure helps a technician know if her printed copy is current.<br /> <br /> ==Adding ICMS metadata to an Office document==<br /> <br /> # '''Access the document's custom properties.'''<br /> ## Office 2010 (Windows): Click File &gt; Info (in left bar). On &quot;Properties&quot; in right half of screen, click drop-down menu and select &quot;Advanced Properties.&quot; Click the &quot;Custom&quot; tab.<br /> ## Office 2007 (Windows): Click the Office button, then select Prepare &gt; Properties. The Properties pane will appear. In that pane, select Document Properties &gt; Advanced Properties &gt; Custom tab.<br /> ## Office 2008 (Mac) and Office 2003 (Windows): Go to File &gt; Properties &gt; Custom.<br /> # '''Enter the name of the ICMS field you want to add to your document.''' <br /> ## See Word and Excel instructions below for supported fields.<br /> ## You must use the exact field names as indicated.<br /> # '''Click OK to close the Document Properties window.'''<br /> # (Word Only) '''Add the ICMS field code to the document.''' <br /> ##Place your cursor at the point in the document you want the ICMS field code to appear.<br /> ##Browse the Document Properties list:<br /> ###Word 2010 (Windows): Click on Insert &gt; Quick Parts &gt; Field. Under &quot;Categories&quot;, select &quot;Document Information.&quot; Under &quot;Field Names&quot;, select &quot;DocProperty.&quot;<br /> ###Word 2007 (Windows): Click on Insert &gt; Quick Parts &gt; Field. Select DocProperty.<br /> ###Word 2008 (Mac) and Word 2003 (Windows): Click on Insert &gt; Field. The Field Panel is displayed. Click on the Document Properties.<br /> ##Select the field property to be placed in your document. A placeholder value is inserted in your document. This value will be replaced with the actual value at check in time.<br /> # '''Save the document and check it into ICMS.'''<br /> <br /> ==Word==<br /> <br /> You may use any of the following document properties to insert the relevant ICMS value into a Word document. You should fill in the ''Name'' and ''Text'' fields, as shown below for each property you wish to include.<br /> <br /> {| border=&quot;1&quot; <br /> ! Name<br /> ! Value<br /> |- <br /> |ICMSContentID<br /> |APS_XXXXXXX<br /> |-<br /> |ICMSRevision<br /> |Rev<br /> |-<br /> |ICMSRevisionStatus<br /> |Status<br /> |-<br /> |ICMSContributor<br /> |Contributor<br /> |-<br /> |ICMSComments<br /> |Comments<br /> |-<br /> |ICMSDocumentDate<br /> |Doc Date<br /> |}<br /> <br /> <br /> <br /> ==Excel==<br /> <br /> Content ID and Revision number are the supported properties that can be added to Excel documents:<br /> <br /> * ICMSContentIDLoc<br /> * ICMSRevisionLoc<br /> <br /> these can be set to a specific cell value (i.e. A2) or ''footer''. If you enter ''footer'', the value(s) will be placed in the printer margins at the bottom of the page.<br /> <br /> You must also indicate which sheet in your workbook will contain these values. To do so, add the following document property:<br /> <br /> * ICMSSheetLoc<br /> <br /> this must be an integer that equates to a specific sheet (i.e. 1). If you want it to print the values on all sheets, set it to -1. If the property is not specified, it will print on the first sheet only.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=87 2011-05-25T18:47:15Z

<p>Stellent: </p> <hr /> <div>=General=<br /> *a Folio:<br /> **Is a container used to hold other documents. It's particularly well suited to sharing groups of documents with other users.<br /> **Is a document in ICMS of type Folio<br /> **Is edited via the ICMS Web interface. Javascript is required. <br /> **Can be Locked against further updates<br /> **Can be Rendered as PDF, Xml or a zip file<br /> <br /> *If you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at a listing of all the documents in a folio, as you would look at a table of contents for a book.<br /> **It is equally simple to look at the contents of all the documents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> =Folio Revisions=<br /> *Since Folios are stored as regular documents in the ICMS they can be revised.<br /> *To do this, when the folio is in edit mode select Actions &gt; 'Create snapshot'. This will bring up the new revision for the Folio in edit mode. Select Actions &gt; Save Changes to check in the new revision.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *Available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Content Basket to Folio=<br /> *The actions available to a content basket include publishing it to a folio. This does not destroy or empty your content basket. An Advanced Folio will be created.<br /> *Note that you can also bring that content basket into the Source Items list as you edit an Advanced Folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some things to know about some similar objects in ICMS. <br /> <br /> None of the three options below can match the ability of a Folio to generate a PDF/Zip file of all the member documents.<br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *There is nothing in ICMS which can give you a tree-like map of all documents which are directly or indirectly related to a document of interest.<br /> <br /> ==Folios vs Contribution Folders==<br /> *You can make a Contribution Folder yourself<br /> *Supports documents and folders for documents, like an Advanced Folio does.<br /> *Documents in a Contribution Folder inherit a lot of metadata from the Contribution Folder <br /> *Both have editing interface which are different from what is typical in ICMS. CFs can work via webdav, so you can drag and drop documents into a folder like any other file operation on your computer.<br /> *You can traverse a tree-like structure to see the hierarchy of the folder.<br /> *Like Folios, you will find that Contribution Folders have complicated and sometimes buggy behavior.<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *Library folders are integrated tighter into ICMS - if you wish to share a group of documents with all users, this may be a factor. Library folders are accessible on everyones home screen as well as through 'Browse Content &gt; Library Folders' in the web interface.<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **One can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *New revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=86 2011-05-25T18:41:01Z

<p>Stellent: </p> <hr /> <div>=General=<br /> *a Folio:<br /> **Is a container used to hold other documents. It's particularly well suited to sharing groups of documents with other users.<br /> **Is a document in ICMS of type Folio<br /> **Is edited via the ICMS Web interface. Javascript is required. <br /> **Can be Locked against further updates<br /> **Can be Rendered as PDF, Xml or a zip file<br /> <br /> *If you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at a listing of all the documents in a folio, as you would look at a table of contents for a book.<br /> **It is equally simple to look at the contents of all the documents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *Available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Content Basket to Folio=<br /> *The actions available to a content basket include publishing it to a folio. This does not destroy or empty your content basket. An Advanced Folio will be created.<br /> *Note that you can also bring that content basket into the Source Items list as you edit an Advanced Folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some things to know about some similar objects in ICMS. <br /> <br /> None of the three options below can match the ability of a Folio to generate a PDF/Zip file of all the member documents.<br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *There is nothing in ICMS which can give you a tree-like map of all documents which are directly or indirectly related to a document of interest.<br /> <br /> ==Folios vs Contribution Folders==<br /> *You can make a Contribution Folder yourself<br /> *Supports documents and folders for documents, like an Advanced Folio does.<br /> *Documents in a Contribution Folder inherit a lot of metadata from the Contribution Folder <br /> *Both have editing interface which are different from what is typical in ICMS. CFs can work via webdav, so you can drag and drop documents into a folder like any other file operation on your computer.<br /> *You can traverse a tree-like structure to see the hierarchy of the folder.<br /> *Like Folios, you will find that Contribution Folders have complicated and sometimes buggy behavior.<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *Library folders are integrated tighter into ICMS - if you wish to share a group of documents with all users, this may be a factor. Library folders are accessible on everyones home screen as well as through 'Browse Content &gt; Library Folders' in the web interface.<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **One can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *New revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=85 2011-05-25T18:31:53Z

<p>Stellent: </p> <hr /> <div>=General=<br /> *a Folio:<br /> **Is a container used to hold other documents. It's particularly well suited to sharing groups of documents with other users.<br /> **Is a document in ICMS of type Folio<br /> **Is edited via the ICMS Web interface. Javascript is required. <br /> **Can be Locked against further updates<br /> **Can be Rendered as PDF, Xml or a zip file<br /> <br /> *If you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at a listing of all the documents in a folio, as you would look at a table of contents for a book.<br /> **It is equally simple to look at the contents of all the documents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *Available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some things to know about some similar objects in ICMS. <br /> <br /> None of the three options below can match the ability of a Folio to generate a PDF/Zip file of all the member documents.<br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *There is nothing in ICMS which can give you a tree-like map of all documents which are directly or indirectly related to a document of interest.<br /> <br /> ==Folios vs Contribution Folders==<br /> *You can make a Contribution Folder yourself<br /> *Supports documents and folders for documents, like an Advanced Folio does.<br /> *Documents in a Contribution Folder inherit a lot of metadata from the Contribution Folder <br /> *Both have editing interface which are different from what is typical in ICMS. CFs can work via webdav, so you can drag and drop documents into a folder like any other file operation on your computer.<br /> *You can traverse a tree-like structure to see the hierarchy of the folder.<br /> *Like Folios, you will find that Contribution Folders have complicated and sometimes buggy behavior.<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *Library folders are integrated tighter into ICMS - if you wish to share a group of documents with all users, this may be a factor. Library folders are accessible on everyones home screen as well as through 'Browse Content &gt; Library Folders' in the web interface.<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **One can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *New revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=84 2011-05-25T18:29:45Z

<p>Stellent: /* General */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a container used to hold other documents. It's particularly well suited to sharing groups of documents with other users.<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at a listing of all the documents in a folio, as you would look at a table of contents for a book.<br /> **It is equally simple to look at the contents of all the documents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some things to know about some similar objects in ICMS. <br /> <br /> None of the three options below can match the ability of a Folio to generate a PDF/Zip file of all the member documents.<br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *There is nothing in ICMS which can give you a tree-like map of all documents which are directly or indirectly related to a document of interest.<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *supports documents and folders for documents, like an Advanced Folio does.<br /> *documents in a Contribution Folder inherit a lot of metadata from the Contribution Folder <br /> *both have editing interface which are different from what is typical in ICMS. CFs can work via webdav, so you can drag and drop documents into a folder like any other file operation on your computer.<br /> *You can traverse a tree-like structure to see the hierarchy of the folder.<br /> *Like Folios, you will find that Contribution Folders have complicated and sometimes buggy behavior.<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *Library folders are integrated tighter into ICMS - if you wish to share a group of documents with all users, this may be a factor. Library folders are accessible on everyones home screen as well as through 'Browse Content &gt; Library Folders' in the web interface.<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=83 2011-05-25T18:28:14Z

<p>Stellent: /* General */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a container used to hold other documents. It's particularly well suited to sharing groups of documents with other users.<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some things to know about some similar objects in ICMS. <br /> <br /> None of the three options below can match the ability of a Folio to generate a PDF/Zip file of all the member documents.<br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *There is nothing in ICMS which can give you a tree-like map of all documents which are directly or indirectly related to a document of interest.<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *supports documents and folders for documents, like an Advanced Folio does.<br /> *documents in a Contribution Folder inherit a lot of metadata from the Contribution Folder <br /> *both have editing interface which are different from what is typical in ICMS. CFs can work via webdav, so you can drag and drop documents into a folder like any other file operation on your computer.<br /> *You can traverse a tree-like structure to see the hierarchy of the folder.<br /> *Like Folios, you will find that Contribution Folders have complicated and sometimes buggy behavior.<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *Library folders are integrated tighter into ICMS - if you wish to share a group of documents with all users, this may be a factor. Library folders are accessible on everyones home screen as well as through 'Browse Content &gt; Library Folders' in the web interface.<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=82 2011-05-25T18:27:18Z

<p>Stellent: /* Folios vs Contribution Folders */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some things to know about some similar objects in ICMS. <br /> <br /> None of the three options below can match the ability of a Folio to generate a PDF/Zip file of all the member documents.<br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *There is nothing in ICMS which can give you a tree-like map of all documents which are directly or indirectly related to a document of interest.<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *supports documents and folders for documents, like an Advanced Folio does.<br /> *documents in a Contribution Folder inherit a lot of metadata from the Contribution Folder <br /> *both have editing interface which are different from what is typical in ICMS. CFs can work via webdav, so you can drag and drop documents into a folder like any other file operation on your computer.<br /> *You can traverse a tree-like structure to see the hierarchy of the folder.<br /> *Like Folios, you will find that Contribution Folders have complicated and sometimes buggy behavior.<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *Library folders are integrated tighter into ICMS - if you wish to share a group of documents with all users, this may be a factor. Library folders are accessible on everyones home screen as well as through 'Browse Content &gt; Library Folders' in the web interface.<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=81 2011-05-25T18:24:53Z

<p>Stellent: /* Deciding when to use a Folio */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some things to know about some similar objects in ICMS. <br /> <br /> None of the three options below can match the ability of a Folio to generate a PDF/Zip file of all the member documents.<br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *There is nothing in ICMS which can give you a tree-like map of all documents which are directly or indirectly related to a document of interest.<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *supports documents and folders for documents, like an Advanced Folio does.<br /> *documents in a Contribution Folder inherit a lot of metadata from the Contribution Folder <br /> *both have editing interface which are different from what is typical in ICMS. CFs can work via webdav, so you can drag and drop documents into a folder like any other file operation on your computer.<br /> *You can traverse a tree-like structure to see the hierarchy of the folder.<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *Library folders are integrated tighter into ICMS - if you wish to share a group of documents with all users, this may be a factor. Library folders are accessible on everyones home screen as well as through 'Browse Content &gt; Library Folders' in the web interface.<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=80 2011-05-25T18:21:31Z

<p>Stellent: /* Folios vs Contribution Folders */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some things to know about some similar objects in ICMS. <br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *RC doesn't allow you to print a PDF of all the member documents. <br /> *There is nothing in ICMS which can give you a tree-like map of all documents which are directly or indirectly related to a document of interest.<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata from the Contribution Folder <br /> *both have editing interface which are different from what is typical in ICMS. CFs can work via webdav, so you can drag and drop documents into a folder like any other file operation on your computer.<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=79 2011-05-25T18:18:51Z

<p>Stellent: /* Folios vs Related Content */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some things to know about some similar objects in ICMS. <br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *RC doesn't allow you to print a PDF of all the member documents. <br /> *There is nothing in ICMS which can give you a tree-like map of all documents which are directly or indirectly related to a document of interest.<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=78 2011-05-25T18:16:43Z

<p>Stellent: /* Deciding when to use a Folio */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some things to know about some similar objects in ICMS. <br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=77 2011-05-25T18:16:09Z

<p>Stellent: /* Deciding when to use a Folio */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> <br /> As you consider whether your needs are best addressed by a Folio, here are some factors to consider with some similar objects in ICMS. <br /> <br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=76 2011-05-25T18:14:56Z

<p>Stellent: /* Editing Advanced Folios */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=75 2011-05-25T18:14:41Z

<p>Stellent: /* Editing Folios */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> *If you are in edit mode for the folio there will be a header which reads &quot;Edit Simple Folio&quot; or &quot;Edit Advanced Folio&quot;, and there will be a green '+' and a red 'x' icon near the top left of the page. Those icons are used to add documents to and remove documents from the folio.<br /> <br /> ==Editing Advanced Folios==<br /> *To add a folder to an advanced folio, right click on the place you want to add it in the left panel and select 'Create Node'. You can name the node and give it a description in the upper right panel<br /> *To add an item to an advanced folio, either <br /> **Right click on the place you want to add it in the ;eft panel and select &quot;Insert Item by Search&quot; if it already exists in ICMS<br /> **Do the above, but select 'Insert Item By Checkin' and add it to ICMS as you add it to this Folio.<br /> **Do the above, but select 'Create Slot'. Then highlight one of the Source Items in the bottom right panel, right click on the newly created slot, and select &quot;Insert Selected Source Item&quot;<br /> **There is a last option, to insert Hypertext. This allows you to add a URL, with a label specified by you in HTML, to the Folio.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=74 2011-05-25T18:02:07Z

<p>Stellent: </p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's actually XML. The Javascript interface interprets that and gives you a viewing/editing web page.<br /> <br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *Created via Content Management &gt; New Folio &gt; Simple Folio<br /> *The Viewing/Editing interface has one panel with a row for each content item<br /> <br /> =Advanced Folios=<br /> *Holds documents and containers for documents, so it's a multilevel hierarchical structure.<br /> *Can be created from a template<br /> *Has an interface with a right panel (showing the tree structure for the folio) and a left panel (showing document metadata and source items).<br /> ==Source Items==<br /> *The idea with source items is that you are given a way to gather a number of documents and keep them in one area of the screen while you build the folio in another area of the screen.<br /> *The user can switch between the items you search for and your current content basket (as seen at My Content Server &gt; My Baskets).<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=73 2011-05-25T17:52:38Z

<p>Stellent: /* What Document Metadata is Saved in the Folio? */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's XML.<br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **documents are frozen at the revision they are at when they are added to a folio. Books are also a printed snapshot of the data, or chapters, as they looked at the time of publishing<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, a document is added to a Folio, then any of the above metadata fields are changed independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *How to Create<br /> <br /> =Advanced Folios=<br /> *Rules and Limitations<br /> *How to Create<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=72 2011-05-25T17:52:05Z

<p>Stellent: /* What is saved in the folio when a document is added? */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's XML.<br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **documents are frozen at the revision they are at when they are added to a folio. Books are also a printed snapshot of the data, or chapters, as they looked at the time of publishing<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What Document Metadata is Saved in the Folio?=<br /> <br /> When a document is added to a folio, the folio keeps a record of some of that documents metadata fields.<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> Be warned that Folios have some rough edges. One of them is that, if add a document to a Folio, then change any of the above metadata fields independently, those changes will not be reflected in the Folio.<br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *How to Create<br /> <br /> =Advanced Folios=<br /> *Rules and Limitations<br /> *How to Create<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=71 2011-05-25T17:43:46Z

<p>Stellent: /* General */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> **is edited via the ICMS Web interface. Javascript is required. <br /> **can be Locked against further updates<br /> **can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's XML.<br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **documents are frozen at the revision they are at when they are added to a folio. Books are also a printed snapshot of the data, or chapters, as they looked at the time of publishing<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What is saved in the folio when a document is added?=<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> <br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *How to Create<br /> <br /> =Advanced Folios=<br /> *Rules and Limitations<br /> *How to Create<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=70 2011-05-25T17:43:23Z

<p>Stellent: /* General */</p> <hr /> <div>=General=<br /> *a Folio:<br /> **is a document in ICMS of type Folio<br /> *is edited via the ICMS Web interface. Javascript is required. <br /> *Can be Locked against further updates<br /> *Can be Rendered as PDF, Xml or a zip file<br /> <br /> *if you look at the actual native file for a folio it's XML.<br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **documents are frozen at the revision they are at when they are added to a folio. Books are also a printed snapshot of the data, or chapters, as they looked at the time of publishing<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> <br /> =What is saved in the folio when a document is added?=<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> <br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *How to Create<br /> <br /> =Advanced Folios=<br /> *Rules and Limitations<br /> *How to Create<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=69 2011-05-25T17:41:54Z

<p>Stellent: </p> <hr /> <div>=General=<br /> *are a document in ICMS of type Folio<br /> *are edited via the ICMS Web interface. Javascript is required. <br /> *if you look at the actual native file for a folio it's XML.<br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **documents are frozen at the revision they are at when they are added to a folio. Books are also a printed snapshot of the data, or chapters, as they looked at the time of publishing<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> *Can be Locked<br /> *Can be Rendered as PDF, Xml or a zip file<br /> <br /> <br /> =What is saved in the folio when a document is added?=<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> <br /> <br /> =Simple Folios=<br /> *Only holds documents<br /> *How to Create<br /> <br /> =Advanced Folios=<br /> *Rules and Limitations<br /> *How to Create<br /> <br /> =Folio Templates=<br /> *ICMS admins need to get involved to make a Folio Template<br /> *available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> *To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> *The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> *Folios have an edit view and a display view. <br /> *Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> *You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> *After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> <br /> =Folio Subscriptions=<br /> *You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> *If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> *A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> *The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> *Folios may not behave the way you expect or desire them to with respect to workflow.<br /> *Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> *A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> *Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> **If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> ==Folios vs Related Content==<br /> *RC is a parent-child relationship that can be nested arbitrarily deep<br /> *RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> *you can make a Contribution Folder yourself<br /> *documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> *always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> *ICMS admins need to get involved to make a Library Folder<br /> *always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> **one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> **Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> **When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> **Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> **As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=68 2011-05-25T17:39:59Z

<p>Stellent: </p> <hr /> <div>=General=<br /> *are a document in ICMS of type Folio<br /> *are edited via the ICMS Web interface. Javascript is required. <br /> *if you look at the actual native file for a folio it's XML.<br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **documents are frozen at the revision they are at when they are added to a folio. Books are also a printed snapshot of the data, or chapters, as they looked at the time of publishing<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> *Can be Locked<br /> *Can be Rendered as PDF, Xml or a zip file<br /> <br /> <br /> =What is saved in the folio when a document is added?=<br /> *title<br /> *last modified date<br /> *content id<br /> *name<br /> *create date<br /> *author<br /> *doc type<br /> *native file format (text, excel, word etc.)<br /> *a couple of urls and ids referring to the content for that item<br /> <br /> <br /> <br /> =Simple Folios=<br /> - Only holds documents<br /> - How to Create<br /> <br /> =Advanced Folios=<br /> - Rules and Limitations<br /> - How to Create<br /> <br /> =Folio Templates=<br /> - ICMS admins need to get involved to make a Folio Template<br /> - available for Advanced Folios only<br /> <br /> =Generating PDFs from Folios=<br /> - To print a folio, open up the folio in edit or view mode. In the upper right select Renderers &gt; Download PDF rendition. There are also options to create a Zip File of the component documents or an XML rendition of the contents of the folio. <br /> - The XML rendition will be of limited use to most Users - it just has information on the metadata of the component documents for the folio.<br /> <br /> =Editing Folios=<br /> - Folios have an edit view and a display view. <br /> - Some areas of the ICMS give you the web viewable link of the folio available on the search results page and the the folios content info page) will bring you to the folio in view mode. Others like the Folio Icon on the search results page for a folio bring you into edit mode for the folio. <br /> - You are able to toggle between these two states by means of the Actions dropdown on the Edit or View page for the folio<br /> - After you are in edit mode for a folio and changes are made to the folio, you must save your changes before going to view mode. Actually, your changes are lost if you go anywhere else but the edit folio page or the popup search dialog it provides you with for adding new documents.<br /> <br /> =Folio Subscriptions=<br /> - You can subscribe to a folio. This will cause the ICMS to send you emails whenever documents within the folio change. <br /> - If you have created a folio and wish for it to change as new revisions of its constituent documents are checked in, we recommend that you create a Folio Subscription for that Folio, then update it as you are alerted to changes in its documents.<br /> - A folio is subscribed to by going to the Content Info page for that folio and selecting Content Actions &gt; Subscribe. You are presented with four non-exclusive options for the subscription and must press the 'subscribe' link before the action is complete. <br /> - The folios you have subscribed to are accessed from My Content Server &gt; My Subscriptions.<br /> <br /> <br /> =Workflow and Folios=<br /> - Folios may not behave the way you expect or desire them to with respect to workflow.<br /> - Workflow approval applies to the folio document only, not to any of the component documents.<br /> <br /> =Security and Folios=<br /> - A folio has its own metadata. That includes the Security Group and Secure To fields. <br /> - Users who have permission to browse a folio are allowed to see a couple of metadata items related to all documents in that folio. <br /> - If a User does not have permissions to access a component document of the folio he will get an error as he tries to access the content of that document. <br /> <br /> =Deciding when to use a Folio=<br /> ==Folios vs Related Content==<br /> - RC is a parent-child relationship that can be nested arbitrarily deep<br /> - RC is just a little bit of metadata attached to each document. There is no 'Related Content' document that is stored in ICMS for a relation<br /> - always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Contribution Folders==<br /> - you can make a Contribution Folder yourself<br /> - documents in a Contribution Folder inherit a lot of metadata of the folder itself <br /> - always uses the most current revision of any document in the folder<br /> <br /> ==Folios vs Library Folders==<br /> - ICMS admins need to get involved to make a Library Folder<br /> - always uses the most current revision of any document in the folder<br /> <br /> =Known issues with Folios=<br /> *Multiselect Problems<br /> - one can click on a single item, shift-click to select a series of contiguous items but CANNOT option/command click to select discontiguous items.<br /> *Insert Selected Source does not preserve HTML in the title<br /> *Search window layout is not optimal<br /> - Checkbox is at the bottom, next button is at the top.<br /> *Document Search Truncates Titles<br /> - When searching for Scheduling &amp; Planning Meetings documents and adding to a folio, Barb noticed that the titles were truncated (they have dates at the end which were excluded.) Going to the folio first and searching within that interface worked fine.<br /> *new revision causes Folio to get stuck in ArgonneEntry<br /> - Not sure of the cause, but some folio edits are getting stuck in the ArgonneEntry parent workflow, requiring an admin to approve them through.<br /> *Browser quirks<br /> - As Folios are largely written in Javascript, a language which runs in the Users computer browser, we have encountered situations where the layout or behavior may be affected by the operating system and browser. It's not an optimal solution but when you encounter a problem with a folio, try to do the same thing from another browser. It's often the shortest past to a solution and frequently the best we can recommend as tech support for this product.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Folios&diff=67 2011-05-25T17:37:12Z

<p>Stellent: Created page with &quot;=General= *are a document in ICMS of type Folio *are edited via the ICMS Web interface. Javascript is required. *if you look at the actual native file for a folio it's XML. *I...&quot;</p> <hr /> <div>=General=<br /> *are a document in ICMS of type Folio<br /> *are edited via the ICMS Web interface. Javascript is required. <br /> *if you look at the actual native file for a folio it's XML.<br /> *It helps to think of a Folio as a real book. <br /> **It's a grouping of documents, like chapters in a book.<br /> **documents are frozen at the revision they are at when they are added to a folio. Books are also a printed snapshot of the data, or chapters, as they looked at the time of publishing<br /> **It is easy to look at all the contents in a folio. You can export a folio to PDF, this combines all the member documents just as a book is a seamless combination of all the chapters<br /> *Can be Locked<br /> *Can be Rendered as PDF, Xml or a zip file</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Integrated_Content_Management_System_(ICMS)&diff=66 2011-05-25T17:35:50Z

<p>Stellent: </p> <hr /> <div>==News &amp; Notes==<br /> * [[ICMS Maintenance, April 27, 2011]]<br /> * [[ICMS System Upgrade, January 2, 2010]]<br /> <br /> ==User Guide==<br /> # [[Quick Start Guide]]<br /> # [[Security]]<br /> # [[Searching For Documents]]<br /> # [[Workflow]]<br /> # [[Contribution Guidelines]]<br /> # [[Document Automation]]<br /> # [[Folios]]<br /> # [[Tips and Tricks]]<br /> # [[Known Issues]]<br /> # Advanced Usage (SOAP services)</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Document_Automation&diff=65 2011-05-04T15:14:32Z

<p>Stellent: /* Excel */</p> <hr /> <div>==Overview==<br /> <br /> Document Automation allows the user to insert ICMS metadata, such as Content ID, in a Microsoft Word or Excel document. This feature leverages the &quot;Document Properties&quot; feature in Microsoft Office. When the document is checked in, the specified properties are replaced with the actual ICMS values.<br /> <br /> ==Examples==<br /> <br /> * Including the Content ID as part of a report lets everyone know that the document is in ICMS, how to find it, and how to reference it in other documents.<br /> <br /> * Including the ICMS revision number and revision status of a procedure helps a technician know if her printed copy is current.<br /> <br /> ==Adding ICMS metadata to an Office document==<br /> <br /> # '''Access the document's custom properties.'''<br /> ## Office 2010 (Windows): Click File &gt; Info (in left bar). On &quot;Properties&quot; in right half of screen, click drop-down menu and select &quot;Advanced Properties.&quot; Click the &quot;Custom&quot; tab.<br /> ## Office 2007 (Windows): Click the Office button, then select Prepare &gt; Properties. The Properties pane will appear. In that pane, select Document Properties &gt; Advanced Properties &gt; Custom tab.<br /> ## Office 2008 (Mac) and Office 2003 (Windows): Go to File &gt; Properties &gt; Custom.<br /> # '''Enter the name of the ICMS field you want to add to your document.''' <br /> ## See Word and Excel instructions below for supported fields.<br /> ## You must use the exact field names as indicated.<br /> # '''Click OK to close the Document Properties window.'''<br /> # (Word Only) '''Add the ICMS field code to the document.''' <br /> ##Place your cursor at the point in the document you want the ICMS field code to appear.<br /> ##Browse the Document Properties list:<br /> ###Word 2010 (Windows): Click on Insert &gt; Quick Parts &gt; Field. Under &quot;Categories&quot;, select &quot;Document Information.&quot; Under &quot;Field Names&quot;, select &quot;DocProperty.&quot;<br /> ###Word 2007 (Windows): Click on Insert &gt; Quick Parts &gt; Field. Select DocProperty.<br /> ###Word 2008 (Mac) and Word 2003 (Windows): Click on Insert &gt; Field. The Field Panel is displayed. Click on the Document Properties.<br /> ##Select the field property to be placed in your document. A placeholder value is inserted in your document. This value will be replaced with the actual value at check in time.<br /> # '''Save the document and check it into ICMS.'''<br /> <br /> ==Word==<br /> <br /> You may use any of the following document properties to insert the relevant ICMS value into a Word document.<br /> <br /> * ICMSContentID<br /> * ICMSRevision<br /> * ICMSRevisionStatus<br /> * ICMSContributor<br /> * ICMSComments<br /> * ICMSDocumentDate<br /> <br /> ==Excel==<br /> <br /> Content ID and Revision number are the supported properties that can be added to Excel documents:<br /> <br /> * ICMSContentIDLoc<br /> * ICMSRevisionLoc<br /> <br /> these can be set to a specific cell value (i.e. A2) or ''footer''. If you enter ''footer'', the value(s) will be placed in the printer margins at the bottom of the page.<br /> <br /> You must also indicate which sheet in your workbook will contain these values. To do so, add the following document property:<br /> <br /> * ICMSSheetLoc<br /> <br /> this must be an integer that equates to a specific sheet (i.e. 1). If you want it to print the values on all sheets, set it to -1. If the property is not specified, it will print on the first sheet only.</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=ICMS_Maintenance,_April_27,_2011&diff=64 2011-04-27T13:17:09Z

<p>Stellent: </p> <hr /> <div>==Changelog==<br /> <br /> '''Bugfix''': prevent some occasions where a Native File could become corrupted when an Alternate File is specified. (NativeFileUpdater 2.1.2)<br /> <br /> '''Enhancement''': add ICMS User Guide link and lightbox overlay to interface. (ArgonneMDD)<br /> <br /> '''Patches''': load Oracle update p6907073_1013 (2/8/11 build 93). <br /> <br /> Components updated:<br /> * CS10gR35CoreUpdate<br /> * ConfigMigrationUtility<br /> * ContentFolios<br /> * DBSearchContainsOpSupport<br /> * ExtendedUserAttributes<br /> * FCKEditor<br /> * FileStoreProvider<br /> * FormEditor<br /> * LinkManager8<br /> * WsdlGenerator<br /> * YUI<br /> <br /> Extras:<br /> * DynamicConverter<br /> * Folders_g<br /> * OracleCaseInsensitiveSearch<br /> * PDFWatermark</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=ICMS_Maintenance,_April_27,_2011&diff=63 2011-04-27T13:17:00Z

<p>Stellent: /* Changelog */</p> <hr /> <div>==Changelog==<br /> <br /> '''Bugfix''': prevent some occasions where a Native File could become corrupted when an Alternate File is specified. (NativeFileUpdater 2.1.2)<br /> <br /> ''Enhancement'': add ICMS User Guide link and lightbox overlay to interface. (ArgonneMDD)<br /> <br /> '''Patches''': load Oracle update p6907073_1013 (2/8/11 build 93). <br /> <br /> Components updated:<br /> * CS10gR35CoreUpdate<br /> * ConfigMigrationUtility<br /> * ContentFolios<br /> * DBSearchContainsOpSupport<br /> * ExtendedUserAttributes<br /> * FCKEditor<br /> * FileStoreProvider<br /> * FormEditor<br /> * LinkManager8<br /> * WsdlGenerator<br /> * YUI<br /> <br /> Extras:<br /> * DynamicConverter<br /> * Folders_g<br /> * OracleCaseInsensitiveSearch<br /> * PDFWatermark</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=ICMS_Maintenance,_April_27,_2011&diff=62 2011-04-27T13:16:27Z

<p>Stellent: Created page with &quot;==Changelog== Bugfix: prevent some occasions where a Native File could become corrupted when an Alternate File is specified. (NativeFileUpdater 2.1.2) Enhancement: add ICMS Use...&quot;</p> <hr /> <div>==Changelog==<br /> <br /> Bugfix: prevent some occasions where a Native File could become corrupted when an Alternate File is specified. (NativeFileUpdater 2.1.2)<br /> <br /> Enhancement: add ICMS User Guide link and lightbox overlay to interface. (ArgonneMDD)<br /> <br /> Patches: load Oracle update p6907073_1013 (2/8/11 build 93). <br /> <br /> Components updated:<br /> * CS10gR35CoreUpdate<br /> * ConfigMigrationUtility<br /> * ContentFolios<br /> * DBSearchContainsOpSupport<br /> * ExtendedUserAttributes<br /> * FCKEditor<br /> * FileStoreProvider<br /> * FormEditor<br /> * LinkManager8<br /> * WsdlGenerator<br /> * YUI<br /> <br /> Extras:<br /> * DynamicConverter<br /> * Folders_g<br /> * OracleCaseInsensitiveSearch<br /> * PDFWatermark</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Integrated_Content_Management_System_(ICMS)&diff=61 2011-04-27T13:07:56Z

<p>Stellent: /* News &amp; Notes */</p> <hr /> <div>==News &amp; Notes==<br /> * [[ICMS Maintenance, April 27, 2011]]<br /> * [[ICMS System Upgrade, January 2, 2010]]<br /> <br /> ==User Guide==<br /> # [[Quick Start Guide]]<br /> # [[Security]]<br /> # [[Searching For Documents]]<br /> # [[Workflow]]<br /> # [[Contribution Guidelines]]<br /> # [[Document Automation]]<br /> # Folios<br /> # [[Tips and Tricks]]<br /> # [[Known Issues]]<br /> # Advanced Usage (SOAP services)</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=Integrated_Content_Management_System_(ICMS)&diff=60 2011-04-27T13:07:46Z

<p>Stellent: /* News &amp; Notes */</p> <hr /> <div>==News &amp; Notes==<br /> [[ICMS Maintenance, April 27, 2011]]<br /> [[ICMS System Upgrade, January 2, 2010]]<br /> <br /> ==User Guide==<br /> # [[Quick Start Guide]]<br /> # [[Security]]<br /> # [[Searching For Documents]]<br /> # [[Workflow]]<br /> # [[Contribution Guidelines]]<br /> # [[Document Automation]]<br /> # Folios<br /> # [[Tips and Tricks]]<br /> # [[Known Issues]]<br /> # Advanced Usage (SOAP services)</div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Workflow_search_results.png&diff=59 2011-04-18T21:26:07Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Workflow_search_link.png&diff=58 2011-04-18T21:25:56Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Workflow_review.png&diff=57 2011-04-18T21:25:46Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Workflow_info.png&diff=56 2011-04-18T21:25:36Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Workflow_history.png&diff=55 2011-04-18T21:25:24Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Workflow_content_items.png&diff=54 2011-04-18T21:25:11Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Wf_review_left_panel.png&diff=53 2011-04-18T21:25:03Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:User_profile_accounts.png&diff=52 2011-04-18T21:24:53Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Tqs_list.png&diff=51 2011-04-18T21:24:42Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Tqs_dropdown.png&diff=50 2011-04-18T21:24:33Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Simple_checkin.png&diff=49 2011-04-18T21:24:23Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Security_group_dropdown.png&diff=48 2011-04-18T21:24:11Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Search_within.png&diff=47 2011-04-18T21:24:00Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Search_profile_dropdown.png&diff=46 2011-04-18T21:23:51Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Search_post_dropdown.png&diff=45 2011-04-18T21:23:41Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Search_expanded_querybuilder_dropdown.png&diff=44 2011-04-18T21:23:31Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Save_search.png&diff=43 2011-04-18T21:23:21Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Save_change_view.png&diff=42 2011-04-18T21:23:10Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Quick-search.png&diff=41 2011-04-18T21:22:59Z

<p>Stellent: </p> <hr /> <div></div>

Stellent https://wiki-ext.aps.anl.gov/icms/index.php?title=File:Quick-search-targets.png&diff=40 2011-04-18T21:22:45Z

<p>Stellent: </p> <hr /> <div></div>

Stellent