Add Report Content

Once you have filled out the relevant information in the Metadata and Search Engine Optimization tabs, click the Content tab to add all section titles, text, data visualizations, seasonal calendar, figures, endnotes, etc. 

The directions to build your report will vary if you need to add a translation or upload a PDF:

Add a Translation

For most reports, adding a translation will include copying and pasting the translated content into the Key Messages Multi, Section Title, and Section Content blocks. For reports on Afghanistan where you need to upload a PDF of the report translated into Pashto or Dari, follow the separate guidance included on this page.

1. Find the original language report that was published in the CMS using the Moderation Dashboard or the Content search page.

2. Click on the report title to go to the report webpage.

3. Select the Translate tab under the report header. 

4. Select the Add button for the relevant language under the Operations column. 

5. From the Edit screen, replace the original language Title with the translated title.

6. On the Content tab, replace the text from the original language report with the translated text in each block by selecting the Edit button on the right side of each block. Update the block types as follows:

   1. Data Visualizations: Update Alt Text to the translated language, then select Generate URL. Other text included with the visualization will update automatically.

   2. Key Messages: Replace all text.

   3. Section Titles: Replace all text.

   4. Section Content: Replace all text. Ensure subtitles remain tagged with the appropriate heading styles.

   5. Report Images: Replace Title Text, Caption, and Source Title as applicable. Remove the Image files from the report by selecting the X in the upper right hand corner of the preview image. Upload the new files using translated Alt Text and selecting the relevant Language option.

   6. Endnotes: Replace all text.

7. On the Search Engine Optimization tab, replace the original language SEO description with a translation. 

8. Select Save and Preview (this translation).

9. Review and publish.

Upload a PDF

These steps should only be followed when posting an M&T report, Alert, FAOB, Targeted Analysis, Special Report, Southern Africa Seasonal Monitor or Weather Hazards. When uploading a PDF for a Pashto or Dari translation of an Afghanistan report, refer to the guidance here.

1. Ensure your final PDF has been fully 508-ed and run through CommonLook. 

2. Create a new report and complete the selections on the Metadata tab.

3. Click on the Media tab.

4. Under the PDF Version section click the Add media button.

5. Click Choose File > select the final report PDF from your document library > Open.

6. Check that the selection under Language matches the report language. Otherwise, select the correct language from the drop-down menu and click Save.

7. For Alerts, Special and Targeted Analysis reports, add Section Titles, Section Content, Images or Visualizations. 

8. Review and publish.

Reference the table below to understand which report type should be built in the CMS and those that will, for now, require a PDF-upload. 

The Early Warning Team’s Sr. FSAs are responsible for building Seasonal Monitors for East Africa, LAC, and Somalia until full handover to the Science Team. 

Content blocks

Within the Content section, each piece of content will be entered into a content block. Options are:

Basic report building instructions

Use the links in this list or in the left hand menu for more details on each step.

1. Add an AFI map visualization if needed.

2. Add Key Messages.

3. Add a Section Title.

4. Add Section Content.

   1. Begin to copy the text under the section title.

   2. STOP copying text when any of the following occur:

      1. You reach a section title (this will end this section and the section title should go into a new content block)

      2. You need to add a figure (this will end this section and the figure should go into a new content block)

      3. You reach the end of the report (congrats!)

   3. Paste that copied text into the Section Content block and adjust formatting as needed.

5. Add the next content block.

   1. If you stopped copying text because you came to a section title, add a Section Title block and return to step 3.

   2. If you stopped copying text because you need to add a figure, add a Report Image or Data Visualization block and return to step 4.

6. Repeat steps 3-5 as needed until you’ve copied over all of the report text.

7. Add an HFA map visualization if needed.

8. Add an Automatic Citation block. The system will automatically add the recommended citation to your report according to the report language.

9. Preview your report, including the PDF, and tweak formatting as needed.

   1. Report formatting

   2. Troubleshooting

10. Review and publish your report.

Break up text into multiple Section Content blocks to place images as close to their reference as possible. For most images, the best placement will be either right before or right after the paragraph where the figure is referenced. An image might need to placed a few paragraphs from its reference in order to balance web and PDF formatting.

Adjusting the order of Report Content blocks

As you continue to build the report and add more report content blocks, you may need to adjust their order; particularly paying special attention to the order of data visualizations and report figures. The order of the content blocks affects how report section titles, text, data visualizations, and report figures are displayed on the webpage and their placement in the web-generated PDF.

To reorder Report Content blocks, use the 6-dot icon to the left of each content block to drag them in the desired order.

Copying and pasting text from Microsoft Word 

1. Please have your reports open in the Microsoft Word Desktop Application. Avoid editing or copying text in your report from the SharePoint link through your browser.

2. To paste text copied from Microsoft Word to the relevant fields in the CMS, select Ctrl+V or use the right-click paste function.

3. Formatting should be copied over correctly. However, you should do a quick check for:

   1. Text alignment: All text should be left aligned and not justified. You can change the alignment by selecting text and then clicking the Align Left button.

   2. Text that is incorrectly hyperlinked: To fix, copy the affected text again in Word, and paste into the CMS content field using CTRL+SHIFT+V on Windows (Cmd+Shift+V on Mac). As this method removes all links, it should only be used when text appears incorrectly hyperlinked in the CMS.

4. To undo any actions, select Ctrl+Z or use the undo button on the right side of the editor ribbon.

Saving your report

It is good practice to periodically save your report as the CMS will not automatically save your content. If you are concerned about losing your work or have an unstable internet connection, you should save your report often.

To save your work, click Save and Edit.

• The first time the report is saved, you will need to reselect the Content tab to continue adding more content.

• After the first save, you can click the Save and Edit button to save the report without navigating away from the Content tab. The content block you are working on will stay expanded so you can save without losing your place.

To preview your report, click Save and Preview. To return to the report builder from a preview, click Edit.

Previous: Create a New ReportaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaNext: Add an AFI Map