usajobs / atp-support Goto Github PK

@abudz19 is working on TFS ticket 35415

Need to update the help text under the PIV sign in area to be more helpful

Something along the lines of:

Have you registered your PIV?
You will need your Agency Talent Portal email and password to associate your PIV card with your account. Login with just your PIV and PIN number after registering.

link to atp: http://agencyportal.usajobs.gov/

Fixes from @dalenard21:

• The "?" in the "Forgot password" link, should not be part of the link. Only the words should be underlined/linked.
• After the "Need to create an account?", add an "r" to "you" in and add an "i" to "adminstrator" in "Contact you agency administrator". It should read "Contact your agency administrator..."

Talk to Dwayne on how this works today. Is there a way to edit it from the default?

I need to set up the same build process we have for the Help Center which checks for broken links and HTML lint. I'd like to get spelling in as well.

Use a consistent sign out page that is similar to Core but with different content.

• Copy design system sign out pages
• Update text "thanks for using USAJOBS Agency Talent Portal"
• Point links to correct locations
• Update design system with new layout
• Create new path - nest under Layouts/Agency Talent Portal/Session/

Our current cards in a campaign board view are styled for more of a general applicant, with a resume, job experience, etc. Intern applicants are pulling from a different pool of info, figure out the best way to display it.

To display

• Name
• Education (school, major)
• Language(s)
• Preferred location(s) - (opportunity order preference)
• GPA (?)
• Last time contacted
• Trash can icon
• ... (what else?)

Questions

• Will the algorithm produce a "score" for the fit of each candidate? Is it worth displaying that value to better highlight top candidates? (probably not an option after sprint planning discussion on 11/29)

As a bureau chief managing applicants to my internship I need a way to:

• Know who has been assigned to me (list named "Assigned")
• Indicate who I want to talk to (list named "Interviewing")
• Indicate who I talked to (list named "Interviewed")
• Indicate who I've extended an offer to (list named "Offer out")
• Indicate who has accepted an offer (list named "Accepted")

Our current view of a campaign board includes some information that isn't currently in line with internship hiring and/or our release plan over the next 16 weeks.

Updates to make to mock up

• Remove Add a list button, we're going to have set lists for the first version.
• Remove ... list options from pipeline columns (columns won't be editable)
• Remove job seeker links at bottom of columns

It was requested that we make the language around the PIV log in more clear, as users may not understand that they need to use email and password when they first register the cert with their card.

From the TFS ticket:

When clicking on the PIV icon:
If the user selects a PIV certificate that is not registered to an account, they will then be prompted to associate the certificate with an account.
If the certificate has already been associated with an account, the user will be prompted for a PIN.
If the certificate has not been associated with an account, the user can then register the selected certificate with their account by providing their email address and password (as is done now).

Mock deviations:
"First time signing in?" is changed to "Need to register your PIV?"
The PIV language is changed from "Register your PIV card by first signing in with your email and password." to "Register your PIV card and associate it with your account."
All references to "USAJOBS account" are changed to "USAJOBS recruiter account"

Entered on 10/20/2017 at 10:39:30 EDT (GMT-0400) by [email protected]:
I like the Playbook and I think it is a good tool. I have one small thing
that I think you need to add! On the first screen I think you need to add
a date. For example maybe you could say: Last updated on 00/00/0000.
That way I would know if some changes were made.

Regards,

Michael L. Argerbright
Economic Systems Inc. (EconSys)
www.econsys.com http://www.econsys.com/

Basis for rating - Section C of DEOH

• Add a link to the DEOH for basis of rating.
• Consideration Order is not required, it’s optional - discourage users from adding it.
• Types of rating – if using category rating, they need to tell you what the rating is and define those – agencies can call their categories anything they want as long as they define it.
• Show “Category Rating” as an example.
• Show a numeric example under basis
• Change “Describes the type of rating you’ll use to categorize each applicant." It’s up to each agency to define what the categories are and to define them. Check with your boss if you don’t know what they are.
• Conditions of employment reminder should be standard and added to every JOA.
• Remove Rating procedure
• Type of assessment – need to describe what the assessment is and at what point in the process they need to submit this – this can all be covered in the “Basis for rating” section.

We received feedback that the USAJOBs sign in helper text does not make it clear that it's for ATP, so folks could mistakenly end up using their job seeker login credentials when they see "USAJOBS users" instead. It was requested that the messaging here be changed so as to avoid this.

As a hiring bureau chief with the State Dept. I need to be able to see a student's application to the unpaid internship and VSFS programs. This includes but is not limited to:

• All application data
• Transcript (for GPA verification)
• Contact information

I also need to be able to contact the student to schedule an interview and talk about the position.

This mock-up is likely outdated but, this is the view in question:
https://opm.invisionapp.com/d/main/#/console/11044040/233737397/preview

Notes from duplicate card by @dreeeeewwwww

Opening a link from a campaign card will direct to a show page with profile information for the candidate.

To do

• Some way to see what campaign this candidate is attached to.
• Some way to navigate back to the campaign board.
• Some way to see the current status of the candidate (new, to contact, to interview, hired, rejected, etc).
• Some way to update the status of the candidate (?).

TFS Ticket 30640
BA - Jon Woody

Request: We need some wording for the body of the 404 page for ATP. We will be using the standardized 404 page design words that are in the design system. However for the “Head back… Go to… Begin Your…” we need to update it for ATP.

• Add a new field to the SIF called Agency External Contact URL which will provide Agencies the ability to provide a URL as their external contact method. This field is only to be used for online ticketing systems, and should not be used for general URLs
• Update the agency contact information section to display a third address line on the JOA (Address fields 4 and 5 have been removed from the data dictionary)
• Make minor updates to the new user flow in USAJOBS
• Make Video display updates in the JOA improving the display on mobile and larger screen devices

We've decided that these issues should go into Footprints so we can track responses.

OPM has a tool that steps through the hiring model:
https://www.opm.gov/policy-data-oversight/human-capital-management/hiring-reform/hiring-process-analysis-tool/validate-the-need-against-the-workforce-staffing-and-recruiting-plans/

It's a bit hard to find so linking from the playbook would potentially be helpful.

@humancompanion

Here's the latest version of the 'agency communication' for the login.gov launch. Please update in the playbook.
Agency-communication-login.gov_v7_20171120.docx

As a bureau chief selecting students for the unpaid internship program I need to have an organized workflow for managing applicants.

This will be achieved with a predefined set of lists in a Campaign in ATP.

• Define the required "states" (lists)
• Depict a campaign pre-populated with lists.

This is the view in question**:
https://opm.invisionapp.com/d/main/#/console/10296658/329193724/preview

The MVP of this may be just a document that informs the State HQ folks how to set up their campaigns in ATP. A stretch goal would be us pre-populating the DB on their behalf.

(**Publicly viewable invision link: https://opm.invisionapp.com/share/WYOESMSPNK5#/329193724_projects_Homepage)

I've already started in on this but, there are a few remaining tasks that I wanted to enumerate here:

• Setup repo so that npm deploy works properly
• Add form styling
• Add JS for hiding contact form

Probably more tasks once we wireframe the front page.

Determine how campaign boards can be shared with other community members via email

Sharing options

• via email
• will send campaign board to member of community

Here are the notes from the UIS call. I need to get these onto a page.

• SIF Updates
o Major Duties - This array changes from 10 to 20 entries, and changes from 75 characters for each entry to 250 characters for each entry.
o Conditions of employment - This Array changes from 10 to 20 entries, and changes from 5,000 characters for each entry to 250 characters for each entry.
• Code List API updates
o Corrected the Geoloc, PostalCode, and CountrySubdivision API to display the Geoloc code for countries instead of the abbreviation.
o This matches the flat xml files that were on the old Schemas site.
o Included in the 6.7 deploy.

• (REMINDER) Six month SIF implementation period
o We will provide TAS’es a communication to confirm the start date.
o We will send a list of all JOA fields, and which ones are required/not required as well as any of the changes that are required.

Double check that all new fields introduced in 6.6 or about to be introduced in 6.7 are present in the playbook and use the appropriate name from our Data Dictionary.

@starrchen and I hit a couple snags setting this up on localhost, write a few quick lines of setup help to get others up and running more quickly.

We've got the Mission critical code in the new fields list and we have content from Peter & Tess, we now just need it in the playbook.

We've added a distinct video field to the JOA. We need to let folks know about this in the playbook. I need to figure out which section this is attached to, if any.

Note that there is a bug here where an empty video drawer shows up for the field on mobile even when there is no content. It's currently on the backlog. We could mention that we know about it and plan to fix it....soon.

Restrictions:

• you HAVE to be logged out to reset your password.

"Applicant Review" (tbd) added to top nav for ATP users that are part of specific DoS Unpaid Int or VSFS comms. Link directs to index of assigned opportunities.

NAV **

• Pick an icon
• Icon has a tooltip/id "Applicant Review" (tbd)
• Icon/id text takes user to index for applicants

**This probably doesn't have to be a new icon/nav element. "Applicant Review" could live in the existing user dropdown menu

Reference

https://opm.invisionapp.com/d/main#/console/14696610/313393134/preview

Similar list style as the above view

Email template selection is fairly rough at the moment. An applicant reviewer should be able to easily see what template they are selecting and, upon selection, see a preview of that template/message.

• Email template(s) should be displayed as a thumbnail.
• An email template thumbnail displays template title.
• Selecting a template displays a preview in the message modal.
• Upon selection template thumbnail is highlighted.
• Message preview is not editable.
• Same process applies to messaging a group and an individual.

Current mockup for template selection:

Step 1: https://opm.invisionapp.com/share/Q8OESMCYS5P#/336393862_Internship-Board-Message_Group
Step 2: https://opm.invisionapp.com/share/Q8OESMCYS5P#/336755995_Internship-Board-Message_Group-Template_Selected

To get the ball rolling with dev, we are initially going to allow only hardcoded templates. Obviously there are cases where an applicant reviewer will need to enter custom text, so we'll have to add this in a future sprint.

We could one of these, or some combination:

• Allow a custom textarea to enter text at the front or end of every email template.
• Add form inputs that fill in custom parts of template [ex: "We'd like to schedule an interview on December 15 at 2:30pm."]
• Automatically include contact info from the reviewer's profile.
• Create a custom, blank template option. Users would have to compose the entire message from scratch.

It would help to have plays on the playbook.

Opening a link from a campaign card will direct to a show page with profile information for the candidate. Update (or create new/alternate version) the candidate show page to allow better integration with/navigation within the campaign.

To do

• Some way to see what campaign this candidate is attached to.
• Some way to navigate back to the campaign board.
• Some way to see the current status of the candidate (new, to contact, to interview, hired, rejected, etc).
• Some way to update the status of the candidate (?).

From 2/6/19 State meeting

As an applicant reviewer, I need to select alternate candidates for my internship. Add another list for Alternates.

• Change Accepted to something like Accepted - Primary
• Add Alternate list called something like Accepted - Alternates

Background:

During the 12/6 Dept of State meeting the subject of alternates came up. Maybe this has already been considered and I've missed it, but flagging it here just in case.

In their current process, reviewers get a chance to flag a couple of people that might be good in case their primary candidate(s) falls through. Often these alternates are being considered for, or in some cases have been accepted to, other internship opportunities. They therefore are potentially already going through further vetting/background checks and would be easily slotted in to another location. As a reviewer it'd be helpful to designate those people on my campaign board.

Potential ways to do that:

• Add extra step to the delete applicant process?
• Add list action to designate people in a list as alternates? (ex: flag everyone in the interviewed list)
• ... ?

It would be helpful to link to/see the original opportunity posting from the campaign board and index.

Campaign board

• add link to original JOA post (if it is still visible? if they have permission?)

Assigned campaign index

• Add link to original JOA post.

Notifications will be triggered manually. Here is how I think this interaction might go:

1. A campaign manager can take an action on a list, "Notify list" for example.
2. Then they select/unselect cards in the list before clicking "Create notification".
3. That action would bring up a list of email templates they can select from with an option to "Create from scratch" (there is no option to create a new template for now).
4. A text box would allow them to add to the email template (for now just an addendum or in one spot rather than multiple places within the template).

Emails would use the Open Opps responsive email template for all campaigns associated with an Open Opps community/program (all others would use an ATP template).

Reset password page
https://usajobs.github.io/design-system/agency-talent-portal/auth/reset-password/

Design System validation
https://usajobs.github.io/design-system/form-controls/#validation

Your password must:

• Not match your username
• Not to be a recently used password
• Be 8 to 20 characters long
• Have at least one upper case letter
• Have at least one lower case letter
• Have at least one number
• Missing valid symbol
  "Must not include any symbol other than ! @ # $ % ^ & * ( )"
• Invalid symbol entered
  "Must not include any symbol other than ! @ # $ % ^ & * ( )"

Quick mock-up

• Screengrab of single error
• Screengrab of multiple errors

Add release notes for v6.8.

These three jobs, supposedly, show all of the fields in the new API exposed:

https://www.uat.usajobs.gov/GetJob/ViewDetails/3258739400
https://www.uat.usajobs.gov/GetJob/ViewDetails/3258739600
https://www.uat.usajobs.gov/GetJob/ViewDetails/3258740400

Link to them from the playbook.

• Merge sign in and PIV options for when we have 1 PIV service.
• Create flow where 1st time users go to PIV then get username/password and are told why.

There is a thread in #support-questions where an agency was confused about when to use internal to an agency:

. I trained our HR staff yesterday. There were several offices that open announcements to Department of Transportation employees, not just FAA. They asked which hiring path would they include.

My initial thought is to select "federal employees - competitive service" and also "federal employees- excepted service"; however, the text under federal employees states current or former competitive service federal employees. In our scenario, FAA does not allow "former" federal to apply so it is misleading.

My other thought is to use "internal to an agency"; however, it is really internal to a "department". Is there any thoughts on a "Department" icon?

Can you provide guidance on which hiring path we should use?

The answer from @danthibodeau was "internal, they should use clarifying text to say all DoT employees can apply...using either federal option would appears as though all federal employees can apply". @dpboyd asked if we could make that clearer in the playbook.

We have added a new field to the SIF called Agency External Contact URL which will provide Agencies the ability to provide a URL as their external contact method. This field is only to be used for online ticketing systems, and should not be used for general URLs

First task is for @Piglady64: Please work with Drew and Bridget/Nora to determine and document how VSFS communicates status to applicants today. Michelle would like to mirror what they do in our communication. We may have screen shots of this on the google drive so I'd check there first. But, it may be something we need to revisit with Bridget and Nora (an email exchange should suffice).

Second task is for myself and @benjawin: Add notifications to our service blueprint for the State back-end.

Third task is for @dalenard21: Create content for any automatic notifications.

Fourth task is for @dalenard21 & @starrchen (now @dreeeeewwwww too): Code responsive email template for Open Opps communications with State "branding".

• When editing a user you manage, separate the kinds of alerts you get about given user.
• Edit color codes for types alerts?

This is just to capture how we might measure success on ATP:

More than N% (50%?) of applicants initially placed into a campaign end up accepting their offer. In other words, the algorithm did a good job of initial placement.

For the purpose of getting working product, we'll be "previewing" an email while composing ... BUT ... it'd be slick if you could preview what your final message to an individual/list will look like before sending.

• Add a Preview button to the cancel/send button bar
• Preview swaps the view to the full HTML email (with any custom text entered) to display what it'll actually look like.
• The preview view should let you Cancel (closes modal)**, Edit (returns to message compose view), or Send message.

** Would Cancel actually be confusing? Maybe you'd think you're canceling only the preview but you'd end up closing the modal and losing any work you did composing the message.

We never published our release notes for 7.3 to the playbook. @jdstill usually has an executive summary but with the delay of the release I missed this task.

We need to add a page to the Open Opps help center for "filters".

The page will be: How to use the filters.

It should live in a new help section called "Search".

1. Create a new section/tab called Search
2. Add a link to the page "How to use the filters" (or something like that).
3. Debbie will create the content for the how to use the filters page.
4. Provide the URL for "How to use filters" to the open opps dev team so they can link the help icon that's in the filters section of open opps.

npm test is failing in Travis (https://travis-ci.org/USAJOBS/ATP-Support) on

>> 30 files checked, 78 errors in 30 files
...
Task "htmllint:all" failed.

@dreeeeewwwww commented on Wed Oct 03 2018

From TFS:

• Brand like USAJOBS.

• Differentiate from core login.

• Two options exist for logging in but perform the same action.

• Continue with staffing directs to inaccurate PIV card image, if PIV card image is used make it correct.

• Build login page with PIV img OR login fields (ex: Facebook's login with img OR email/pass)

Questions and [Updates] from Matt:

• Can we combine PIV/CAC login? [Marshall says yes]
• Marshall says USAS may be using the same PIV service. Today it's not shared.
• Michelle has asked us to sync up with USAS.
• To register their PIV they have to login first with username and password. We don't tell them this.

Users who are able to review internship campaigns can see a nav link that directs them to an index of all assigned campaigns.

Opp index view

• Create view for opportunity index (see whiteboard sketch)
• View index has current opportunities
• View index has past opportunities?

Connected to/broken out from issue #45 .