Tech Articles


Quick start for contributing to Open Source PFC


Given that not everyone is fluent in using Git and or Github (where the Open Source PFC is hosted now), I put together a quick introduction in how to get started.  The video below walks through the steps, which in summary are:

  • Create a GitHub account if you don't already have one.  https://github.com/join
  • Navigate to the Open Source PFC and "Fork" a copy of the code into your account.  The 2019 version of the PFC can be found at: https://github.com/OpenSourcePFCLibraries/2019
  • Chose Code -> Clone and copy the HTTPS URL for your fork.
  • Open the PowerBuilder 2019 IDE and with no workspace open select File -> Connect to Workspace.
    • Source Control System:  Choose Git
    • Repository URL: Paste in the URL you copied above
    • Workspace File: Give it any name you choose
    • User ID:  Your Github user id (normally your email address)
    • Password:  Your Github password
    • Checkout Directory:  Select or create a new empty subdirectory on your local machine for the code to be copied to
  • Wait until the source code is downloaded and refreshed (12 to 15 minutes)

Now you're ready to start making changes.  The process for doing that is:

  • Make the change in your workspace
  • Commit it to your local repository (using the PowerBuilder IDE)
  • Push it to your fork in Github (using the PowerBuilder IDE)
  • Create a Pull Request in your fork of the code in Github

The Pull Request sends the suggested change back to the main Open Source PFC project.  It is then reviewed and if approved is then is merged into the main project.

 

 

 

Comments (5)
Wednesday, Jan 27 2021

Great stuff Bruce!
(just in case anyone gets into the same trouble as I did)
I'm an absolute noob on GitHub and forgot to first do the "Fork", I stupidly enough tried to connect in the new powerbuilder workspace to your repo.
After that, I also realized I cannot connect in powerbuilder using my password and created a token in my own github account, which I then used as the "password" in the powerbuilder workspace when connecting to git.
Thank you!
MiguelL

0

Thursday, Oct 07 2021

Hello Bruce!

I done everything as you did in video, but I have problem with connection to workspace from PB (PB 2019 R2 2328).
I always get notice (Cannot connect to the repository. Please make sure you have specified the correct repository URL, user ID and password)
For sure I use correct credentials.
What could be the problem?
Tomaz

0
Thursday, Oct 07 2021

Since I wrote that article Github has moved to the user of personal access tokens rather than using the password for the Github account.

https://github.blog/2020-07-30-token-authentication-requirements-for-api-and-git-operations/

Just generate a personal access token for your repository and use that instead of the password.

0

Thursday, Sep 07 2023

Hi,

Recently we migrated our application into Powerserver 2021 version. While migrating we faced some below Unsupported Powerserver features in PFC libraries

sqlreturndata
previewinsert
previewdelete
previewupdate
when i searched help docs

https://docs.appeon.com/ps2021/bk06ch02s01s05.html

https://docs.appeon.com/ps2021/bk06ch02s01s06.html

not able to find the workaround for the above PFC feature



Kindly help me to identify the workaround for the above features.



Thanks

Vignesh

0
Thursday, Sep 07 2023

I just turned on discussions in the PFC project in Github. That would be the more appropriate location to discuss this.

https://github.com/orgs/OpenSourcePFCLibraries/discussions

0

Find Articles by Tag

Windows OS OrcaScript RibbonBar Builder JSONParser Script Event Handling PFC PBDOM WinAPI CoderObject DragDrop Filter TFS Data JSON Source Control DataWindow JSON Event UI Themes PowerScript (PS) Transaction Database Table Data Resize TortoiseGit API Bug PDFlib Mobile Window Open Source PowerBuilder Database Branch & Merge COM Error Interface External Functions File SnapObjects UI PBVM Database Profile Authorization Model Class Debugging OAuth PostgreSQL CrypterObject SqlModelMapper .NET Std Framework Deployment Android Web Service Proxy Design Text Export JSON Encoding DataType Elevate Conference RichTextEdit Control InfoMaker Graph RESTClient OAuth 2.0 Charts Import Azure Database Object Expression SQL Server Stored Procedure TLS/SSL Repository PBNI Event Handler TreeView Database Table Source Code Import JSON Menu Variable Web API IDE Syntax Authentication Debug Excel SqlExecutor ActiveX License Performance 64-bit Database Connection Testing Linux OS Application GhostScript JSONGenerator Trial Validation Encryption C# BLOB SVN Export ODBC OLE SQL Array UI Modernization Windows 10 Icons Database Table Schema PDF SnapDevelop Icon Jenkins PowerServer Web Automated Testing Messagging CI/CD Migration DataWindow Configuration PowerBuilder (Appeon) iOS Oracle Installation PowerBuilder Compiler Visual Studio Sort .NET DataStore Git Platform PowerServer Mobile REST XML Outlook NativePDF DLL Debugger HTTPClient Database Painter 32-bit DevOps RibbonBar PostgreSQL ODBC driver MessageBox .NET Assembly Service WebBrowser SOAP SDK