Enter your Organization Code, Username and Password. These will be provided to you by your...

Preview:

Citation preview

AmericanAmericanAgriculturalAgricultural

Services Inc.Services Inc.Fast Start TutorialFast Start Tutorial

™™iAdvantageiAdvantage

™™iAdvantageiAdvantageFast Start Tutorial - NotesFast Start Tutorial - Notes

This tutorial is intended to get you started quickly. For This tutorial is intended to get you started quickly. For additional details on functionality, please consult the User additional details on functionality, please consult the User Manual (download from www.amagsrv.com).Manual (download from www.amagsrv.com).

Remember to save each screen after entering data. (A green Remember to save each screen after entering data. (A green dialogue box will appear to confirm a successful save of data.)dialogue box will appear to confirm a successful save of data.)

Some of the following example screens will show functions Some of the following example screens will show functions reserved only for individuals with administrative permissions reserved only for individuals with administrative permissions on the system, e.g. some of the delete functions. Therefore, if on the system, e.g. some of the delete functions. Therefore, if you do not have administrative permissions, you may not see you do not have administrative permissions, you may not see these when utilizing the system.these when utilizing the system.

If additional information is required, please contact us using If additional information is required, please contact us using "Contact Us" at our website "www.amagsrv.com"."Contact Us" at our website "www.amagsrv.com".

™™iAdvantageiAdvantageWeb-Based Study ManagementWeb-Based Study Management

Project Management AssistanceProject Management AssistanceStudy Creation and Management of Study DataStudy Creation and Management of Study Data

Generation and Import of eFTN Generation and Import of eFTN (electronic Field Trial Notebook)(electronic Field Trial Notebook)

Electronic Field Data Definition and CollectionElectronic Field Data Definition and Collection

Document GeneratorDocument GeneratorUser Created & Defined Reporting and Query of User Created & Defined Reporting and Query of Study DataStudy Data

Accommodated Study TypesAccommodated Study Types

Crop Residue and DeclineCrop Residue and DeclineProcessing Fraction and VinificationProcessing Fraction and VinificationResidue Dissipation in Terrestrial, Aquatic and Residue Dissipation in Terrestrial, Aquatic and Forestry EnvironmentsForestry EnvironmentsField VolatilityField VolatilityField Rotation Crop and Irrigated CropField Rotation Crop and Irrigated CropTransferable Foliar ResidueTransferable Foliar ResidueWorker Exposure and Re-entryWorker Exposure and Re-entryGround and Surface WaterGround and Surface WaterPlant MetabolismPlant Metabolism

™™iAdvantageiAdvantage

Functionality UtilizationFunctionality Utilization

Study Protocols (Plans) CreationStudy Protocols (Plans) CreationStudy Creation and Study Data DefinitionStudy Creation and Study Data DefinitionField Data Definition and Field Notebooks Field Data Definition and Field Notebooks Creation, Export and ImportCreation, Export and ImportEvent Scheduling Event Scheduling Progress MonitoringProgress MonitoringStatus and Management ReportsStatus and Management ReportsStudy ReportsStudy ReportsAd-Hoc User QueriesAd-Hoc User Queries

™™iAdvantageiAdvantage

Individual BenefitsIndividual Benefits

Efficient Study ManagementEfficient Study ManagementPre-filled Resource Tables, Pull-down Menus, Field Pre-filled Resource Tables, Pull-down Menus, Field Data Import, Status Reports, etc.Data Import, Status Reports, etc.

Timely Progress MonitoringTimely Progress MonitoringCritical Event & Data TrackingCritical Event & Data TrackingQuick Electronic Report GenerationQuick Electronic Report Generation

Time And Effort Substantially ReducedTime And Effort Substantially ReducedYour Choice Of Report Format And Word Your Choice Of Report Format And Word Processing SoftwareProcessing Software

Allows For Remote Study ManagementAllows For Remote Study Management

™™iAdvantageiAdvantage

Corporate BenefitsCorporate Benefits

Ensure Product Registrations On Time Or EarlyEnsure Product Registrations On Time Or EarlyReduce Report Writing From Weeks To MinutesReduce Report Writing From Weeks To Minutes

Diminish Re-Work And Shorten Response Time Diminish Re-Work And Shorten Response Time To RegulatorsTo Regulators

Provide Quick Access To Critical DataProvide Quick Access To Critical Data

Enhance Competitive AbilitiesEnhance Competitive AbilitiesOthers Already Enjoy The Benefits Of This SystemOthers Already Enjoy The Benefits Of This System

™™iAdvantageiAdvantage

Corporate BenefitsCorporate Benefits

Globalize OperationsGlobalize OperationsLink All Your Facilities And Laboratory Contractors On A Link All Your Facilities And Laboratory Contractors On A Single Web-Based SystemSingle Web-Based System

Save MoneySave MoneyVirtually Eliminate All Your Paper And Associated CostsVirtually Eliminate All Your Paper And Associated Costs

Up To 80% Study Management Productivity IncreaseUp To 80% Study Management Productivity Increase

Reduce Or Eliminate In-House Regulatory/GLP Software Reduce Or Eliminate In-House Regulatory/GLP Software Development CostsDevelopment Costs

™™iAdvantageiAdvantage

™™iAdvantageiAdvantageWeb-Based Study ManagementWeb-Based Study Management

Project Management AssistanceProject Management AssistanceStudy Creation and Management of Study DataStudy Creation and Management of Study Data

Enter your Organization Code, Username and Password. These will be provided to you by your iAdvantage Administrator. Note that these entries are case sensitive.

Click on Project Manager

Make sure that “Add a New Project…” appears in the Find a Project box.

Fill in your Project Code and Description.

Use the pull down menu to define the Project Contact and Sponsor. If the entries you want do not exist in the pull down menu, click on New and create these - see next screen shots.

Make sure that “Add a New Company…” appears in the Find a Company box.

Fill in all the fields.

Click on Save New Company and wait for the green box indicating that data was saved successfully.

Click on the “X” at the top right corner to exit this screen and go back to the main project screen.

Make sure that “Add a New Person…” appears in the Find a Company box.

Fill in all the fields.

Click on Save New Person and wait for the green box indicating that data was saved successfully.

Click on the “X” at the top right corner to exit this screen and go back to the main project screen.

Once you have completed all the fields to your satisfaction, click on Save New Project.

Click on Add a New Study...

Make sure “Add a New Study…” appears in the Find a Study box.

Fill in all the fields.(You will have to scroll down on this screen.)

Click on Save New Study and wait for the green dialogue box to ensure that your data was saved successfully.

Next click on the Substances tab.Note - to complete entry of study data you click on the tabs in sequence from left to right I.e. General,Substances, Trials, etc. - see following screen shots.

Use the pull down menus to find and add test and other substances. If you do not find your formulation or other substance then add them by clicking on Active Ingredients Manager, Formulations Manager and Other Substance Manager in turn - see next screen shots.

From the Substances tab, clicking on Active Ingredients Manager gets you to this screen.To add an active ingredient, make sure that “Add a New Active Ingredient…” appears in the Find an Active Ingredient box.

Fill in all the fields.Click on Save New Active Ingredient and wait for the green dialogue box to confirm your data was saved.Then click on Return to Study Study 01 to get back to the Substances tab screen.

From the Substances tab, clicking on Formulations Manager gets you to this screen.To add a formulation, make sure that “Add a New Formulation…” appears in the Find a Formulation box.

Fill in all the fields.Click on Save New Formulation and wait for the green dialogue box to confirm your data was saved.Then click on the Ingredients tab.

Fill in all the fields.Click on Save Ingredients and wait for the green dialogue box to confirm your data was saved.Click on the Lot Numbers tab to fill in lot information,Or click on Return to Study Study 01 to get back to the Substances tab screen.

Fill in all the fields.Click on Save Lot Numbers and wait for the green dialogue box to confirm your data was saved.Click on Return to Study Study 01 to get back to the Substances tab screen.

From the Substances tab, clicking on Other Substance Manager gets you to this screen.To add an other substance, make sure that “Add a New Substance…” appears in the Find a Substance box.

Fill in all the fields.Click on Save New Substance and wait for the green dialogue box to confirm your data was saved.Click on the Lot Numbers tab to fill in lot information,Or click on Return to Study Study 01 to get back to the Substances tab screen.

Fill in all the fields.Click on Save Lot Numbers and wait for the green dialogue box to confirm your data was saved.Click on Return to Study Study 01 to get back to the Substances tab screen.

Click on the AI Of Interest.Click on Save Test Substances and wait for the green dialogue box to confirm your data was saved.Click on Save Other Substances and wait for the green dialogue box.Then click on the Trials tab.

Click on Add a New Trial.

Make sure that “Add a New Trial…” appears in the Find a Trial box.

Fill in all the fields.Click on Save New Trial and wait for the green dialogue box to confirm your data was saved.(Note - you do not have to go to the other tabs on this screen at this time. Data for the other tabs will be filled in automatically from data entry on other screens.)

Click on Add a New Trial for each new trial you wish to add.Next click on the Treatments tab.

Click on the Define tab to define your treatments.

After you fill in data for each treatment click on Add Treatment.When you have defined all your treatments, click on the Assign tab.

Click on the treatments you wish to assign to each trial.Then click on Assign Treatments and you will automatically be brought to the screen for the Summary tab.

Verify your treatment information.Next click on the Samples tab.

Click on Sample Number Generator.

Fill in your subplot.Note - this is a mandatory entry field. See the User Manual for more information. If no subplot definition exists (as in this case), you must add an entry such as “N/A” or “-” or “.” or one of your own choice.

Click on Add after you define each subplot.(Only one entry is required if no subplots are defined.)Click on Next>>.

Assign your previously defined treatments to each subplot.Click Next>>.(If no subplots are defined, all treatments should be ticked.)

Recommended sample types will be automatically defined by iAdvantage.Highlight the sample types you wish to remove and click on Remove.Type in sample types you wish to add and click on Add.Click on Next>>.

Assign your previously defined sample types to each subplot.Click Next>>.(If no subplots are defined, all sample types should be ticked.)

Click on Add after you define each rep.Click on Next>>.

Assign your previously defined sample types to each rep.Click Next>>.

Type in sampling events you wish to add and click on Add.Click on Next>>.

Assign your previously defined sample types to each sampling event.Click Next>>.

Assign your previously defined treatments to each rep.Click Next>>.

Assign your previously defined treatments to each sample type.Click Next>>.

Each line corresponds to a sample definition and will receive a unique sample number.Verify and edit this list as required. (For illustration, 2 samples are removed - see next screen.)

Once you are satisfied with the list (you have the sample definitions you want and they are in the proper order for numbering), click Next>>.

Fill in the information to number your samples as you require.Click Finish and you will be automatically brought to the next screen.

Verify your sample list. If it is not correct, you can click on Sample Number Generator to start over.Otherwise, click on the Summary tab.

Enter any pertinent dates and click on Save Study Dates.Note - Application and Sampling Start and Complete dates will be automatically filled in from your electronic Field Trial Notebooks (eFTN) when you import them.Click on the Labs tab.

Define the labs available to this study and click on Save Study Labs.If the appropriate labs do not appear, click on the General tab and then click on New under Test Facility to enter the required labs. Then, click on this tab to define available labs.Click the General tab.

™™iAdvantageiAdvantageWeb-Based Study ManagementWeb-Based Study Management

Generation and Import of eFTN Generation and Import of eFTN (electronic Field Trial Notebook)(electronic Field Trial Notebook)

Electronic Field Data Definition and CollectionElectronic Field Data Definition and Collection

To create and generate your eFTNs (electronic Field Trial Notebooks), click on the Notebook Generator in the Study Wizards box.

Fill in the required fields.Click on Save General Info and wait for the green confirmation box.Next, click on the Send To tab.

Fill in all applicable fields.Click on Save Send To and wait for the green confirmation box.Next, click on the Sampling Forms tab.

Click on the type of samples you are collecting in this study.Click on Save Sample Pages and wait for the green confirmation box.Next, click on the Remote Notebooks tab.

For each eFTN you wish to generate, click on Generate.This will automatically bring you to the next screen.

Make sure Save this file to disk is ticked and click on OK.

Choose where you want to save the eFTN on your computer and click Save.Note - the default location is your computer’s Desktop.

Once you have saved the eFTN on your computer you may view the eFTN using Advantage FTM (Field Trial Manager). Or you may attach the eFTN in an e-mail to send the eFTN to the PFI corresponding to the eFTN.Note - Advantage FTM will let you view the eFTN in the same manner as the PFI will view the eFTN. Advantage FTM is software provided, at no cost, to the PFI and to you. Since it resides separately on you computer, it will be provided to you on a self-install CD. For a list of Advantage FTM users, please go to our website at www.amagsrv.com.

To import an eFTN sent to you from a PFI, first go to the Trials tab of the study that contains the eFTN.Click on Edit corresponding to the eFTN you wish to import.

In the Notebooks box, click on Browse.

Define the location, on your computer, of the eFTN you wish to import.Click on Open.

In the Notebooks box, you will now see the path defining the location on your computer of the eFTN you wish to import.Click on Import.

Wait until you receive the above message confirming that your notebook was imported successfully.Click on the word “here” as indicated.

Note - In the Notebooks box, you will now see the date and time of the last import of this eFTN.

™™iAdvantageiAdvantageWeb-Based Study ManagementWeb-Based Study Management

Document GeneratorDocument GeneratorUser Created & Defined Reporting and User Created & Defined Reporting and Query of Study DataQuery of Study Data

Click on Document Generator

Click on First Time Setup

Make sure “Save this program to disk” is always ticked.

Click OK.

The default save location (recommended) for DocGenInstaller.exe is your Desktop. However, you can save it in any location on your computer, as you wish.

Click Save.

Minimize this screen.

Go to where you saved DocGenInstallet.exe on your computer and double click on it

Make sure the Installation Folder box reads “C:\Program Files\iAdvantage Document Generator”.

Click Finish.

If you are asked if it is OK to create the folder iAdvantage Document Generator, click OK.

Get back to (maximize) this screen from your task bar.

Click on Template/Table Generation.

You should now see a Document Generator box with Variables and Tables folders.

Tick Keep window on top. This should make it easier for you to use this window.

You can search for Project, Study and Trial Variables by typing in Variable names into the Find box or you can just click on the folders to find the Variables.

Hint - The (F1), (F2), etc. designations correspond to form numbers in the eFTN.

The example in this tutorial shows the creation of a reporting template from an existing word processing document. However, you can create any template you wish, from scratch, by typing your prose into a blank document and clicking and dragging variable or table names as you will see later.

However, the file type for the template must always be “.rtf”. In our example, the template file name is “DocGen Example 1.rtf”.

So open up an existing document you wish to use as a template. Save it as an “.rtf” file or just create a new blank “.rtf” document.

The concept behind creating a template from an existing document is to replace blocks of text with the corresponding variable designation for that text. For example, we wish to replace “Study 01” with the variable “Study No”. The concept for creating a new template is to place variables into your template that will report on the information you want in your document.

First define the block of text that you want to replace with a variable. Then find that variable in the Variables list.

Next, delete the block of text you want to replace.

Left click, hold and drag the variable to the spot in your document where you deleted the corresponding text.

Note - The variable will appear in your document with ** at the beginning and end of the variable name.

Next we will replace the highlighted block of text with the variable Study Title.

As before, delete the text and left click, hold and drag the variable Study Title to the place in your document where your text was.

Continue to replace other blocks of text with corresponding variables.

Now we will deal with a DocGen feature know as Text Variable.

In the case where a variable has multiple values in a study and you wish those values to be reported not as a table but as text within a paragraph, you can create a text variable to do so. Text variables will always report multiple values as “a,b,c,d, and e”.

In our case we want to report out Trial Regions as part of a paragraph.

First, in your DocGen window, right click on the Tables folder. Then left click on New and choose Folder.

Type in your New Folder Name and click OK.

Your new folder will now appear under the Tables folder. In this case the folder is DocGen Examples.

Now, right click on the new folder you just created. Then left click on New and choose Table.

You will now see a Table Properties screen.

Even though this is the same screen used to create tables to report table format data in your document, it is also used to create text variables.

In the Table Name box, type in the name of your text string variable. In this case it is “Trial Regions”.

Drag and drop the variable, (or use the >> button,) you wish to use as a text string expression into the box labeled Used in this table. In this case it is “Trial Region”.

Tick the Create as Text String box.

Click OK.

You will now see your text string variable under the folder you created. In this case you see the variable Trial Regions under the folder DocGen Examples.

Highlight and delete the text you wish to replace with your text variable.

Insert your text variable where you deleted the corresponding text. In this case, the variable **STRTrial Regions**, has been inserted.

Note - When you insert a string variable into your document, the “STR” prefix will always be added to the front of your variable name.

Now we wish to create a table to pull data in table format into our document. In this case, we wish to create a table to pull data corresponding to the above table for Test Location information.

First, right click on the new folder you just created. Then left click on New and choose Table.

In the Table Name box, type in the name of your table. In this case it is “Test Locations”.

Drag and drop the variables, (or use the >> button,) you wish to pull information into your corresponding table columns into the box labeled Used in this table. In this case the variables are “Trial No, Trial Region, Trial Location, PFI Name and PFI Company”.

Use the Up and Down buttons to order the variables into the column order you desire.

Next, click on the Table Format button and you will see the Table Format Properties dialogue box.

Adjust the column widths for the table you wish to create by placing your cursor over each line separating the variables, left click and hold and drag the line, left or right, until the desired column width is reached.

Click on OK in the Table Format Properties box.

Click OK in the Table Properties box.

You should now see the table you created under the folder you created. In this case we see the table Test Locations under the folder DocGen Examples.

Next, in your document, delete the table you wish to replace.

Drag and drop your new table name into your document where you deleted the original table.

Note - When your insert a table from DocGen into a document the prefix “TBL” will always be added to the table name. In this case it is **TBLTest Locations**.

We have now completed our template. Variables corresponding to blocks of text have been placed into the template. Text string variables and tables have been created in DocGen and inserted into our template.

Now save your template on your local computer as an “.rtf” format file. In our case, we have saved our template as “DocGen Example 1.rtf” on the desktop of our local computer.

Now we must save the text string variables and tables we created in DocGen and upload them to the iAdvantage server to be used in the query corresponding to our template (which we will also upload later).

Click on the X in the upper right corner of the Document Generator window.

Click on Copy/Upload Template/Table.

Click on Browse next to the New Tables/Text Strings File (.ADZ)

Locate the Variables.adz file. It should be on your local computer under your C: drive, under your Program Files folder, in a folder called iAdvantage Document Generator.

Click on the file Variables.adz and then click on Open in the Choose file window.

You should see the path corresponding to the location of your Variables.adz file in the New Tables/Text Strings File(.ADZ) window.

Click on Upload Variables.

Wait until the variables are imported successfully and click on the word “here”.

Next we have to upload our template to iAdvantage.

Click on Copy/Upload Template/Table.

Click on Browse next to the Template file(.RTF).

Locate your template file. In our case it is on the desktop of our local computer and it is called DocGen Example 1.rtf.

Click on your template file and then click on Open in the Choose file window.

You should see the path corresponding to the location of your template file in the Template file(.RTF) window.

Click on Save Template.

Wait until your template is uploaded successfully and click on the word “here”.

Now we want to generate a report document on a given study using our template.

Click on Document Generation.

Choose the corresponding Project, Study and Trial for your report. (Since our template pulls data across all trials for the given study we have chosen Use All Trials...).

Click on your template.

Click on Generate Document.

Make sure Save this file to disk is ticked.

Click on OK.

Choose the location where you wish to save your document download.

In our case, we are going to save to the Desktop of our local computer.

Change the document name as you wish.

Note - If you add a file extension of “.rtf” the file you save can be easily opened by your word processing software. (Hint - If you have MS Word you can add “.doc” for word to open it easily.)

Click on Save.

Go to the location where you have saved your document download.

Double click on the icon.

And voila!. You have your document report with the information in the format you wanted.

In the event you wish to download a template from iAdvantage, click on the template you wish to download.

Click on Download Template.

You will see the template displayed within your Browser window.

Save the template from your Browser to your local computer.

Note - It is recommended that you save the template with a name different than the original name of the template. There are two reasons for this;

- It will prevent the accidental overwriting of the original template that you may have on your local computer.

- If you make changes to the template and upload it to iAdvantage, it will be treated by iAdvantage as a new template and iAdvantage will ask for a different filename.

In this case DocGen Example 1.rtf has been changed to DocGen Example 2.rtf.

Note - One final caution is that the template is displayed in your Browser. If you close out of this screen using the X in the upper right corner, you will be closing your Browser and will find yourself completely out of iAdvantage. You will then be required to login again.

To exit this screen use the Back arrow on your Browser.

Using the Back arrow on your Browser will get you back to this screen.

You can now continue to work in iAdvantage as you wish.

Thank You for following this tutorial!

If you have questions or comments, please contact us at www.amagsrv.com using the Contact Us facility.

AmericanAmericanAgriculturalAgricultural

Services Inc.Services Inc.

Thank You!Thank You!

™™iAdvantageiAdvantage

Recommended